web-app-launcher/plans/mvp-web-app-launcher/phase-8-integration-deploy.md

Phase 8: Integration, Testing & Deployment

Status: ⬜ Not Started Parent plan: PLAN.md Domain: fullstack

Objective

Integrate all phases into a fully working application. Fix all build errors, add test coverage, verify Docker deployment, and finalize the CI pipeline. This is the Big Bang convergence phase — everything must work after this.

Tasks

• Task 1: Fix all TypeScript/build errors across the entire codebase
• Task 2: Verify npm run build succeeds with adapter-node output
• Task 3: Verify npm run check (svelte-check) passes
• Task 4: Verify npm run lint passes
• Task 5: Write unit tests for services (authService, appService, boardService, etc.)
• Task 6: Write unit tests for utilities (jwt, password, iconResolver, validators)
• Task 7: Write integration tests for API endpoints (auth, apps, boards, admin)
• Task 8: Write component tests for key Svelte components (AppWidget, Board, Section)
• Task 9: Verify test coverage ≥ 80%
• Task 10: Update prisma/seed.ts with comprehensive demo data
• Task 11: Verify Docker build succeeds (docker build .)
• Task 12: Verify docker-compose up starts the app correctly
• Task 13: Verify healthcheck endpoint works in Docker
• Task 14: Finalize .gitea/workflows/ci.yml — ensure all CI steps pass
• Task 15: Create .env.example with documentation for all env vars
• Task 16: End-to-end smoke test: register → login → view board → add app → verify healthcheck

Files to Modify/Create

• Various source files — fix build errors
• src/lib/server/services/__tests__/*.test.ts — service unit tests
• src/lib/server/utils/__tests__/*.test.ts — utility unit tests
• src/routes/api/**/*.test.ts — API integration tests
• src/lib/components/**/*.test.ts — component tests
• prisma/seed.ts — update
• Dockerfile — verify/fix
• docker-compose.yml — verify/fix
• .gitea/workflows/ci.yml — finalize
• .env.example — update

Acceptance Criteria

• npm run build succeeds
• npm run check passes with no errors
• npm run lint passes
• npm test passes with ≥ 80% coverage
• Docker image builds and runs successfully
• App is fully functional: auth, apps, boards, admin, search, theme
• Healthcheck scheduler runs on startup
• CI pipeline runs all checks successfully

Notes

• This is the Big Bang convergence — all previous phases may have left broken imports, missing types, or incomplete wiring. This phase resolves ALL of that.
• Priority order: build errors → type errors → lint errors → tests → Docker → CI
• If coverage is below 80%, prioritize testing critical paths: auth flow, app CRUD, board rendering
• The seed script should create a realistic demo: admin user, 2 regular users, 8-10 sample apps, 1 board with 3 sections

Review Checklist

• All tasks completed
• Code follows project conventions
• No unintended side effects
• Build passes
• Tests pass (new + existing)

Handoff to Next Phase