[Alaashamel]

Summary

Comprehensive architecture diagrams and API/AI/database documentation — 1,636 lines of new docs.

Architecture Diagrams (docs/architecture/diagrams.md)
8 Mermaid diagrams rendering in GitHub's markdown viewer:

• System architecture (5-service Docker Compose topology)
• Request lifecycle (sequence diagram: browser → nginx → API → DB)
• Authentication & authorization flow (registration → login → refresh)
• RBAC permission matrix (5 roles × 9 permissions)
• AI pipeline flow (job intent → ingestion → model → validation → result)
• Real-time Socket.io architecture (rooms, events, presence)
• Data model ERD (29 tables, all relationships)
• Deployment topology (load balancer, scaling, external services)

API Reference (docs/api/README.md)
Complete endpoint documentation for all 85 HTTP endpoints + 6 Socket.io events:

• Authentication (register, login, refresh, logout, verify, password reset)
• Organizations, projects, milestones, labels (CRUD + RBAC)
• Tasks (CRUD, comments, labels, activity, dependencies with cycle detection)
• GitHub OAuth + repository management (import, sync, webhooks)
• Analytics (overview, velocity, health, developers, repositories)
• Notifications, activity feed, chat
• AI module (analyses, jobs, conversations, streaming assistant)
• Real-time events (room join, presence, typing, live updates)
• Request/response examples, error codes, pagination, filtering

AI Service Docs (docs/ai/README.md)

• Pipeline architecture (6-stage pattern)
• Provider gateway (OpenAI, Anthropic, Local)
• Security model (prompt injection defense, secret redaction)
• Repository ingestion pipeline (9 steps)
• RAG retrieval (hybrid vector + keyword)
• Job intent protocol (signed HMAC tokens)
• Engineering assistant SSE streaming flow
• Testing guide (145+ pytest tests)

Database Docs (docs/database/README.md)

• Schema overview (29 tables, 7 domains)
• 12 versioned migrations with changelog
• Entity relationship diagrams
• Seed data reference
• Redis key patterns
• pgvector setup (HNSW index for embeddings)
• Performance indexes