Version: 2.0 Last Updated: 2025-12-11 Status: Production-Ready Documentation
- Quick Start Guide - 5-minute setup
- Local Development Setup - Dev environment
- Architecture Overview - System design
- Deployment Checklist
⚠️ READ THIS FIRST - Pre-deployment requirements & P0 blockers - Deployment Guide - Comprehensive deployment guide
- Docker Deployment - Docker reference
- Docker Quickstart - Quick Docker setup
- Architecture Specification - Complete system architecture (61K)
- Lessons Learned - Code review findings & production readiness
- Technical Debt Resolution - Technical debt roadmap
- Multi-Tenant Domains - Domain routing & SEO
- Backup & Disaster Recovery - Backup procedures
- Production Readiness - Current score: 56/100
- Changelogs Index 🆕 - Recent system updates & bug fixes
- Photo Upload Feature - Vehicle photo upload
- WhatsApp LLM Integration - AI-powered WhatsApp bot
- WhatsApp Architecture - WhatsApp system design
docs/
├── README.md # This file - Master index
├── architecture.md # System architecture (CRITICAL)
├── LESSONS_LEARNED.md # Code review & production readiness
├── DEPLOYMENT_CHECKLIST.md # Pre-deployment checklist (CRITICAL)
├── deployment-guide.md # Comprehensive deployment guide
│
├── deployment/ # Deployment documentation
│ ├── DOCKER_DEPLOYMENT.md # Docker reference
│ └── DOCKER_QUICKSTART.md # Quick Docker setup
│
├── features/ # Feature specifications
│ └── PHOTO-UPLOAD-FEATURE.md # Photo upload feature
│
├── changelogs/ # Recent updates & fixes
│ ├── README.md # Changelog index
│ └── ... # Detailed fix records
│
├── whatsapp/ # WhatsApp AI integration
│ ├── README.md # WhatsApp index
│ └── ... # Architecture & flow analysis
│
├── ux/ # UX & Design specifications
│ └── ... # Specifications & themes
│
├── product/ # Product management
│ ├── prd.md # Product Requirements Document
│ ├── epics.md # Project Epics
│ └── backlog.md # Product backlog
│
├── archive/ # Historical documentation
│ ├── IMPLEMENTATION_AUDIT.md # Nov 21 audit (historical)
│ ├── MIGRATION_GUIDE.md # Migration guide (legacy)
│ └── PRODUCTION_DEPLOYMENT_LEGACY.md # Old deployment guide
│
└── (other directories)
├── api/ # API specifications
├── coding-standards/ # Coding standards
├── migration/ # Migration guides
├── sprint-artifacts/ # Sprint documentation
└── testing/ # Test documentation
BEFORE deploying to production, you MUST:
-
Read DEPLOYMENT_CHECKLIST.md - Contains P0 blocking issues
-
Fix 5 CRITICAL blockers (estimated 2-3 days):
- Remove mock authentication
- Fix next.config.js secret exposure
- Add authentication to admin routes
- Fix PrismaClient duplication
- Remove default passwords
-
Current Production Readiness Score: 56/100 (NOT READY)
See LESSONS_LEARNED.md for detailed analysis.
All deployments MUST be done via Coolify (cf.avolut.com)
- ❌ NO manual Docker Compose deployments
- ❌ NO SSH deployments to production
- ✅ ONLY via Coolify web interface
See DEPLOYMENT_CHECKLIST.md:261-272 for details.
- System Design: ⭐⭐⭐⭐⭐ Excellent multi-tenant architecture
- Prisma Schema: 100/100 - Zero circular dependencies
- Novel Patterns: 4 innovative patterns implemented
- TypeScript Compliance: 8.5/10
- Code Duplication: 23% (9,735 lines savable)
- Total Lines: 42,000+ TypeScript
- Files: 200+
- Overall Score: 56/100 (NOT READY)
- P0 Blockers: 5 issues (2-3 days to fix)
- P1 High Priority: 23 issues (1 week to fix)
- Read Quick Start Guide
- Review Architecture
- Check Development Setup
- Review Lessons Learned
- READ DEPLOYMENT_CHECKLIST.md FIRST
- Review Deployment Guide
- Check Backup & Recovery
- Review production readiness in LESSONS_LEARNED.md
- Review Product Brief
- Check PRD
- Review Epics
- See Multi-Tenant Domains for SEO strategy
- Application Down: See DEPLOYMENT_CHECKLIST.md#rollback-procedure
- Database Issues: See Troubleshooting
- Security Issues: Review LESSONS_LEARNED.md#security
This documentation is maintained in /docs/. All changes should be committed to the repository.
Last consolidated: 2025-12-11 (Merged /doc/ into /docs/)
Generated with Claude Code