Files
web-app-launcher/plans/mvp-web-app-launcher/PLAN.md
T
alexei.dolgolyov f1b1aa5975 feat(mvp): phase 2 - database schema & services layer
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.
2026-03-24 20:00:21 +03:00

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