Files
web-app-launcher/plans/mvp-web-app-launcher/PLAN.md
T
alexei.dolgolyov c5166ba3a9 feat(mvp): phase 6 - admin panel
Add admin layout with auth guard, user management (CRUD + group membership),
group management, system settings (auth mode, registration, theme, healthcheck),
permission editor component, and global search API endpoint.
2026-03-24 21:18:06 +03:00

2.6 KiB

Feature: Web App Launcher — MVP

Branch: feature/mvp-web-app-launcher Base branch: master Created: 2026-03-24 Status: 🟡 In Progress Strategy: Big Bang Mode: Automated Execution: Orchestrator

Summary

Build a self-hosted web application launcher/dashboard for a TrueNAS server environment. The MVP includes local auth + guest mode, app CRUD with healthchecks, a single default board with sections and app widgets, an admin panel, dark theme with ambient backgrounds, and Docker deployment with Gitea CI.

Build & Test Commands

  • Build: npm run build
  • Test: npm test
  • Lint: npm run lint
  • Type Check: npm run check

Tech Stack

  • Framework: SvelteKit (Svelte 5 runes mode) + TypeScript strict
  • UI: Tailwind CSS v4 + shadcn-svelte (Bits UI) + Lucide Svelte + Simple Icons
  • Data: Prisma ORM + SQLite + Superforms + Zod
  • Auth: bcrypt + JWT (HTTP-only cookies) + refresh token rotation
  • Background Jobs: node-cron
  • DevOps: Docker (multi-stage) + docker-compose + Gitea Actions

Phases

  • Phase 1: Project Scaffolding & Tooling [backend] → subplan
  • Phase 2: Database Schema & Services Layer [backend] → subplan
  • Phase 3: Authentication System [fullstack] → subplan
  • Phase 4: App Registry & Healthcheck [fullstack] → subplan
  • Phase 5: Board, Section & Widget System [fullstack] → subplan
  • Phase 6: Admin Panel [fullstack] → subplan
  • Phase 7: UI Polish & Ambient Backgrounds [frontend] → subplan
  • Phase 8: Integration, Testing & Deployment [fullstack] → subplan

Phase Progress Log

Phase Domain Status Review Build Committed
Phase 1: Scaffolding backend Complete
Phase 2: Database & Services backend Complete
Phase 3: Authentication fullstack Complete
Phase 4: App & Healthcheck fullstack Complete
Phase 5: Board & Widgets fullstack Complete
Phase 6: Admin Panel fullstack Complete
Phase 7: UI Polish frontend Not Started
Phase 8: Integration & Deploy fullstack Not Started

Final Review

  • Comprehensive code review
  • Full build passes
  • Full test suite passes
  • Merged to master