66 lines
3.0 KiB
Markdown
66 lines
3.0 KiB
Markdown
# Phase 8: Integration, Testing & Deployment
|
|
|
|
**Status:** ⬜ Not Started
|
|
**Parent plan:** [PLAN.md](./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
|
|
<!-- Final phase — no handoff needed -->
|