diff --git a/.ai/context.json b/.ai/context.json index c343144..736a130 100644 --- a/.ai/context.json +++ b/.ai/context.json @@ -1,6 +1,6 @@ { "version": "6.2.0", - "architecture": "simplified-5-container", + "architecture": "9-container", "repository": { "host": "gitea", "owner": "egullickson", @@ -51,7 +51,7 @@ "project_overview": { "instruction": "Start with README.md for complete architecture context", "files": ["README.md"], - "completeness": "100% - all navigation and 5-container architecture information" + "completeness": "100% - all navigation and 9-container architecture information" }, "application_feature_work": { "instruction": "Load entire application feature directory (features are modules within backend)", @@ -104,6 +104,26 @@ "type": "cache", "description": "Redis cache with AOF persistence", "port": 6379 + }, + "mvp-ocr": { + "type": "ocr_service", + "description": "Python-based OCR for document text extraction", + "port": 8000 + }, + "mvp-loki": { + "type": "log_aggregation", + "description": "Grafana Loki for centralized log storage (30-day retention)", + "port": 3100 + }, + "mvp-alloy": { + "type": "log_collector", + "description": "Grafana Alloy for log collection and forwarding to Loki", + "port": 12345 + }, + "mvp-grafana": { + "type": "log_visualization", + "description": "Grafana for log querying and visualization", + "port": 3000 } }, "application_features": { @@ -290,6 +310,6 @@ "single_tenant_architecture": true, "simplified_deployment": true, "docker_first_development": true, - "container_count": 5 + "container_count": 9 } } diff --git a/config/CLAUDE.md b/config/CLAUDE.md index 5e688c8..dd73d62 100644 --- a/config/CLAUDE.md +++ b/config/CLAUDE.md @@ -1,6 +1,6 @@ # config/ -Configuration files for the 5-container architecture. +Configuration files for the 9-container architecture (6 application + 3 logging). ## Subdirectories diff --git a/docs/ARCHITECTURE-OVERVIEW.md b/docs/ARCHITECTURE-OVERVIEW.md index 55af73c..eb0239b 100644 --- a/docs/ARCHITECTURE-OVERVIEW.md +++ b/docs/ARCHITECTURE-OVERVIEW.md @@ -2,14 +2,20 @@ ## Architecture Summary -MotoVaultPro is a single-tenant vehicle management application built with a **5-container Docker-first architecture**. All development and deployment occurs in production-configured containers with no local installation dependencies. +MotoVaultPro is a single-tenant vehicle management application built with a **9-container Docker-first architecture** (6 application + 3 logging). All development and deployment occurs in production-configured containers with no local installation dependencies. -### Core Containers +### Application Containers (6) 1. **Traefik** - Reverse proxy and service discovery 2. **Frontend** - React SPA with Vite (Node.js 20 + nginx) 3. **Backend** - Node.js API with Fastify (Node.js 20) - includes platform feature module -4. **PostgreSQL** - Primary database (PostgreSQL 18) -5. **Redis** - Caching layer (Redis 8) +4. **OCR** - Python-based document text extraction +5. **PostgreSQL** - Primary database (PostgreSQL 18) +6. **Redis** - Caching layer (Redis 8) + +### Logging Containers (3) +7. **Loki** - Centralized log storage (30-day retention) +8. **Alloy** - Log collection and forwarding +9. **Grafana** - Log querying and visualization ### Key Architectural Principles - **Production-Only**: All services use production builds and configuration diff --git a/docs/AUDIT.md b/docs/AUDIT.md index c101259..6f17a52 100644 --- a/docs/AUDIT.md +++ b/docs/AUDIT.md @@ -4,7 +4,7 @@ **Classification:** Internal/Confidential **Audit Date:** December 13, 2025 **Application Version:** 1.0.0 -**Architecture:** 5-Container Single-Tenant Docker Stack +**Architecture:** 9-Container Single-Tenant Docker Stack (6 application + 3 logging) --- @@ -12,7 +12,7 @@ ### 1.1 High-Level Assessment -**MotoVaultPro** is an automotive vehicle management platform built on a modern 5-container Docker architecture. The application demonstrates solid architectural foundations with proper authentication, modular feature design, and production-ready deployment configuration. +**MotoVaultPro** is an automotive vehicle management platform built on a modern 9-container Docker architecture (6 application + 3 logging). The application demonstrates solid architectural foundations with proper authentication, modular feature design, and production-ready deployment configuration. ### 1.2 Key Findings Summary diff --git a/docs/DATABASE-SCHEMA.md b/docs/DATABASE-SCHEMA.md index ced6224..553dc05 100644 --- a/docs/DATABASE-SCHEMA.md +++ b/docs/DATABASE-SCHEMA.md @@ -1,6 +1,6 @@ # Database Schema Overview -Complete database schema for MotoVaultPro 5-container architecture with 15 feature capsules. +Complete database schema for MotoVaultPro 9-container architecture with 15 feature capsules. ## Migration System