MotoVaultPro — Simplified Architecture

Simplified 5-container architecture with integrated platform feature.

Requirements

• Mobile + Desktop: Implement and test every feature on both.
• Docker-first, production-only: All testing and validation in containers.
• See CLAUDE.md for development partnership guidelines.

Quick Start (containers)

make setup    # build + start + migrate (uses mvp-* containers)
make start    # start 5 services
make rebuild  # rebuild on changes
make logs     # tail all logs
make migrate  # run DB migrations

Documentation

• AI context: .ai/context.json (architecture, quick start, metadata)
• Sprint workflow: .ai/workflow-contract.json (issue tracking)
• Docs hub: docs/README.md
• Features: backend/src/features/{name}/README.md
• Frontend: frontend/README.md
• Backend core: backend/src/core/README.md

URLs and Hosts

• Frontend: https://motovaultpro.com
• Backend health: https://motovaultpro.com/api/health

Operational Commands

• View active environment on production: sudo cat /opt/motovaultpro/config/deployment/state.json
• Switch traffic between environments on production: sudo ./scripts/ci/switch-traffic.sh blue instant
• View which container images are running: docker ps --format 'table {{.Names}}\t{{.Image}}'
• Flush all redis cache: docker compose exec -T mvp-redis sh -lc "redis-cli FLUSHALL"
• Flush all backup data on staging before restoring: docker compose exec mvp-postgres psql -U postgres -d motovaultpro -c "TRUNCATE TABLE backup_history, backup_schedules, backup_settings RESTART IDENTITY CASCADE;"