alexei.dolgolyov
e6b50fb4f1
Fix all build/type/lint errors (zod 3.25 compat wrapper, Svelte 5 fixes), write 115 unit tests across 10 test files, expand seed script with demo data, update Docker config with migration on startup.
57 lines
2.6 KiB
Markdown
57 lines
2.6 KiB
Markdown
# 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
|
|
|
|
- [x] Phase 1: Project Scaffolding & Tooling [backend] → [subplan](./phase-1-scaffolding.md)
|
|
- [x] Phase 2: Database Schema & Services Layer [backend] → [subplan](./phase-2-database-services.md)
|
|
- [x] Phase 3: Authentication System [fullstack] → [subplan](./phase-3-authentication.md)
|
|
- [x] Phase 4: App Registry & Healthcheck [fullstack] → [subplan](./phase-4-app-healthcheck.md)
|
|
- [x] Phase 5: Board, Section & Widget System [fullstack] → [subplan](./phase-5-board-widgets.md)
|
|
- [x] Phase 6: Admin Panel [fullstack] → [subplan](./phase-6-admin-panel.md)
|
|
- [x] Phase 7: UI Polish & Ambient Backgrounds [frontend] → [subplan](./phase-7-ui-polish.md)
|
|
- [x] Phase 8: Integration, Testing & Deployment [fullstack] → [subplan](./phase-8-integration-deploy.md)
|
|
|
|
## 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 | ✅ Complete | ⬜ | ⬜ | ⬜ |
|
|
| Phase 8: Integration & Deploy | fullstack | ✅ Complete | ✅ | ✅ | ⬜ |
|
|
|
|
## Final Review
|
|
- [ ] Comprehensive code review
|
|
- [ ] Full build passes
|
|
- [ ] Full test suite passes
|
|
- [ ] Merged to `master`
|