# 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 -->