# Example Wiki Outline

This is a sample output from the wiki structure generation step, showing the expected format for a medium-sized web application (a task management API with React frontend).

---

## TaskFlow Wiki

A full-stack task management application with a React frontend, Express.js API, and PostgreSQL database.

### Pages

1. **Project Overview**
   - Description: High-level introduction to TaskFlow — purpose, tech stack, project structure, and getting started guide.
   - Key files: `README.md`, `package.json`, `docker-compose.yml`, `src/index.ts`, `.env.example`
   - Diagrams: High-level architecture overview (frontend, API, database, auth service)

2. **System Architecture**
   - Description: Overall system design including the layered backend architecture, frontend SPA structure, and how components communicate.
   - Key files: `src/index.ts`, `src/app.ts`, `src/routes/index.ts`, `src/middleware/index.ts`, `frontend/src/App.tsx`, `frontend/src/api/client.ts`
   - Diagrams: System architecture flowchart, request lifecycle sequence diagram

3. **Authentication and Authorization**
   - Description: JWT-based authentication flow, role-based access control, session management, and OAuth integration.
   - Key files: `src/middleware/auth.ts`, `src/routes/auth.ts`, `src/services/auth.service.ts`, `src/models/user.ts`, `src/utils/jwt.ts`, `frontend/src/contexts/AuthContext.tsx`
   - Diagrams: Authentication flow sequence diagram, RBAC decision flowchart

4. **Task Management Core**
   - Description: CRUD operations for tasks, task state machine, assignment logic, and filtering/sorting capabilities.
   - Key files: `src/routes/tasks.ts`, `src/services/task.service.ts`, `src/models/task.ts`, `src/validators/task.validator.ts`, `src/types/task.ts`
   - Diagrams: Task state machine diagram, task creation sequence diagram

5. **Database Schema and Data Access**
   - Description: PostgreSQL schema design, migrations, query patterns, and the repository layer.
   - Key files: `src/models/task.ts`, `src/models/user.ts`, `src/models/project.ts`, `src/db/migrations/001_initial.ts`, `src/db/connection.ts`, `src/repositories/task.repository.ts`
   - Diagrams: ER diagram of the database schema, data access layer class diagram

6. **API Endpoints**
   - Description: Complete REST API reference — routes, request/response formats, validation, error handling, and rate limiting.
   - Key files: `src/routes/tasks.ts`, `src/routes/auth.ts`, `src/routes/projects.ts`, `src/middleware/validation.ts`, `src/middleware/rateLimit.ts`, `src/utils/errors.ts`
   - Diagrams: API route map flowchart

7. **Frontend Architecture**
   - Description: React component hierarchy, state management with Context API, routing, and API integration layer.
   - Key files: `frontend/src/App.tsx`, `frontend/src/pages/Dashboard.tsx`, `frontend/src/components/TaskBoard.tsx`, `frontend/src/contexts/TaskContext.tsx`, `frontend/src/api/client.ts`, `frontend/src/hooks/useTasks.ts`
   - Diagrams: Component tree diagram, state management flow

8. **Real-time Notifications**
   - Description: WebSocket-based notification system for task updates, user mentions, and project activity.
   - Key files: `src/services/notification.service.ts`, `src/websocket/handler.ts`, `src/websocket/events.ts`, `frontend/src/hooks/useNotifications.ts`, `frontend/src/components/NotificationPanel.tsx`
   - Diagrams: WebSocket event flow sequence diagram

9. **Deployment and Infrastructure**
   - Description: Docker containerization, CI/CD pipeline, environment configuration, and monitoring setup.
   - Key files: `Dockerfile`, `docker-compose.yml`, `.github/workflows/ci.yml`, `.github/workflows/deploy.yml`, `.env.example`, `src/config/index.ts`
   - Diagrams: Deployment pipeline flowchart, container architecture diagram