36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
# 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)
|
|
```bash
|
|
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;"` |