f1b1aa5975
Define full Prisma schema (10 models), run initial migration, build core services (auth, user, group, app, board, permission), Zod validators, type definitions, API response envelope, constants, and seed script.
2.7 KiB
2.7 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 | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
| Phase 4: App & Healthcheck | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
| Phase 5: Board & Widgets | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
| Phase 6: Admin Panel | fullstack | ⬜ Not Started | ⬜ | ⬜ | ⬜ |
| 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