.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
   }
 }

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
 

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

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
 

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