egullickson/motovaultpro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Redesign

Browse Source
This commit is contained in:
Eric Gullickson
2025-11-01 21:27:42 -05:00
parent 20953c6dee
commit 046c66fc7d
203 changed files with 5699 additions and 404943 deletions
Download Patch File Download Diff File Expand all files Collapse all files

135
.ai/context.json
View File

@@ -1,39 +1,26 @@
{
"version": "4.0.0",
"architecture": "hybrid-platform-microservices-modular-monolith",
"version": "5.0.0",
"architecture": "simplified-6-container",
"critical_requirements": {
"mobile_desktop_development": "ALL features MUST be implemented and tested on BOTH mobile and desktop",
"context_efficiency": "95%",
"single_load_completeness": "100%",
"feature_capsule_organization": "100%",
"platform_service_independence": "100%",
"hybrid_deployment_model": "100%",
"single_tenant": true,
"production_only_development": true,
"docker_first": true
"docker_first": true,
"multi_tenant": false
},
"ai_loading_strategy": {
"project_overview": {
"instruction": "Start with README.md for complete microservices context",
"instruction": "Start with README.md for complete architecture context",
"files": ["README.md"],
"completeness": "100% - all navigation and distributed architecture information"
"completeness": "100% - all navigation and 6-container architecture information"
},
"application_feature_work": {
"instruction": "Load entire application feature directory (features are modules within monolith)",
"instruction": "Load entire application feature directory (features are modules within backend)",
"pattern": "backend/src/features/{feature}/",
"completeness": "100% - everything needed is in one directory, deployed together as single service"
},
"platform_service_work": {
"instruction": "Load platform services documentation for service architecture",
"files": ["docs/PLATFORM-SERVICES.md"],
"completeness": "100% - complete service architecture, API patterns, development workflow"
},
"service_integration_work": {
"instruction": "Load platform service docs + consuming application feature docs",
"files": [
"docs/PLATFORM-SERVICES.md",
"backend/src/features/{feature}/README.md"
],
"completeness": "Complete service integration patterns"
"completeness": "100% - everything needed is in one directory"
},
"cross_feature_work": {
"instruction": "Load index.ts and README.md from each application feature",
@@ -56,44 +43,42 @@
"completeness": "All documentation links and navigation"
}
},
"platform_services": {
"mvp-platform-vehicles": {
"type": "hierarchical_vehicle_api",
"architecture": "3_container_microservice",
"containers": ["db", "etl", "api"],
"api_framework": "FastAPI",
"database": "PostgreSQL with vpic schema",
"port": 8000,
"db_port": 5433,
"endpoints": [
"GET /vehicles/makes?year={year}",
"GET /vehicles/models?year={year}&make_id={make_id}",
"GET /vehicles/trims?year={year}&make_id={make_id}&model_id={model_id}",
"GET /vehicles/engines?year={year}&make_id={make_id}&model_id={model_id}",
"GET /vehicles/transmissions?year={year}&make_id={make_id}&model_id={model_id}",
"POST /vehicles/vindecode"
],
"cache_strategy": "Year-based hierarchical caching",
"data_source": "Weekly ETL from NHTSA MSSQL database",
"auth": "Service token via PLATFORM_VEHICLES_API_KEY"
"services": {
"mvp-traefik": {
"type": "reverse_proxy",
"description": "Routes all HTTP/HTTPS traffic"
},
"mvp-frontend": {
"type": "react_app",
"description": "Vite-based React frontend"
},
"mvp-backend": {
"type": "fastify_api",
"description": "Node.js backend with feature modules"
},
"mvp-postgres": {
"type": "database",
"description": "PostgreSQL database",
"port": 5432
},
"mvp-redis": {
"type": "cache",
"description": "Redis cache",
"port": 6379
},
"mvp-platform": {
"type": "integrated_platform",
"description": "Integrated platform service for vehicle data and other capabilities"
}
},
"application_features": {
"tenant-management": {
"path": "backend/src/features/tenant-management/",
"type": "cross_cutting_feature",
"self_contained": false,
"database_tables": [],
"status": "basic_implementation"
},
"vehicles": {
"path": "backend/src/features/vehicles/",
"type": "platform_service_consumer",
"type": "core_feature",
"self_contained": true,
"platform_service": "mvp-platform-vehicles",
"database_tables": ["vehicles"],
"cache_strategy": "User vehicle lists: 5 minutes",
"status": "ready_for_platform_migration"
"status": "implemented"
},
"fuel-logs": {
"path": "backend/src/features/fuel-logs/",
@@ -123,24 +108,17 @@
"status": "partial_implementation"
}
},
"service_dependencies": {
"platform_services": {
"explanation": "Platform services are independent and can be deployed separately",
"sequence": ["mvp-platform-vehicles"]
},
"application_features": {
"explanation": "Logical dependencies within single application service - all deploy together",
"sequence": ["vehicles", "fuel-logs", "maintenance", "stations", "tenant-management"]
}
"feature_dependencies": {
"explanation": "Logical dependencies within single application service - all deploy together",
"sequence": ["vehicles", "fuel-logs", "maintenance", "stations", "documents"]
},
"development_environment": {
"type": "production_only_docker",
"ssl_enabled": true,
"application_frontend_url": "https://admin.motovaultpro.com",
"platform_landing_url": "https://motovaultpro.com",
"frontend_url": "https://admin.motovaultpro.com",
"backend_url": "http://localhost:3001",
"cert_path": "./certs",
"hosts_file_entry": "127.0.0.1 motovaultpro.com admin.motovaultpro.com"
"hosts_file_entry": "127.0.0.1 admin.motovaultpro.com"
},
"testing_strategy": {
"framework": "Jest (backend + frontend)",
@@ -154,26 +132,12 @@
},
"authentication": {
"provider": "Auth0",
"backend_framework": "Fastify with @fastify/jwt",
"service_auth": "Service tokens for platform service communication",
"environment_variables": [
"PLATFORM_VEHICLES_API_URL",
"PLATFORM_VEHICLES_API_KEY"
]
"backend_framework": "Fastify with @fastify/jwt"
},
"external_services": {
"application": {
"PostgreSQL": "port 5432",
"Redis": "port 6379",
"MinIO": "port 9000/9001"
},
"platform": {
"Platform PostgreSQL": "port 5434",
"Platform Redis": "port 6381",
"MVP Platform Vehicles DB": "port 5433",
"MVP Platform Vehicles Redis": "port 6380",
"MVP Platform Vehicles API": "port 8000",
"MVP Platform Tenants API": "port 8001"
"containers": {
"PostgreSQL": "mvp-postgres:5432",
"Redis": "mvp-redis:6379"
},
"external_apis": [
"Google Maps API",
@@ -182,12 +146,9 @@
},
"ai_optimization_metadata": {
"feature_capsule_pattern": "backend/src/features/{name}/",
"platform_service_pattern": "docs/PLATFORM-SERVICES.md",
"single_directory_context": true,
"hybrid_architecture_context": true,
"modular_monolith_deployment": true,
"platform_microservices_deployment": true,
"migration_dependency_aware": true,
"single_tenant_architecture": true,
"simplified_deployment": true,
"docker_first_development": true
}
}