motovaultpro/docs/redesign/FILE-MANIFEST.md

File Manifest - Complete File Change Inventory

Summary

Action	Count	Agent
DELETE	23 files + 1 directory	config-agent, backend-agent
MODIFY	45 files	All agents
CREATE	4 files	storage-agent
TOTAL	72 file operations	8 agents

Files to DELETE (23 files + 1 directory)

Backend Files (Agent: backend-agent, Phase 2)

backend/src/core/middleware/tenant.ts
backend/src/core/config/tenant.ts
backend/src/features/tenant-management/ (entire directory)
  ├── index.ts
  ├── tenant.controller.ts
  ├── tenant.service.ts
  ├── tenant.routes.ts
  ├── tenant.types.ts
  └── tests/
      ├── tenant.test.ts
      └── fixtures/

Configuration & Secrets (Agent: config-agent, Phase 4)

secrets/app/minio-access-key.txt
secrets/app/minio-secret-key.txt
secrets/app/platform-vehicles-api-key.txt
secrets/platform/ (entire directory)
  ├── postgres-password.txt
  ├── redis-password.txt
  └── api-keys/

Docker Services (Agent: infra-agent, Phase 1)

Note: These are removed from docker-compose.yml, not file deletions

Services removed:
- admin-minio
- mvp-platform-landing
- mvp-platform-tenants
- platform-postgres
- platform-redis
- mvp-platform-vehicles-db
- mvp-platform-vehicles-redis
- mvp-platform-vehicles-etl

---

Files to CREATE (4 files)

Storage Adapter (Agent: storage-agent, Phase 3)

backend/src/core/storage/adapters/filesystem.adapter.ts (NEW)
data/documents/.gitkeep (NEW - directory marker)

Volume Mount

./data/documents/ (directory created by Docker)

---

Files to MODIFY (45 files)

Phase 1: Docker Compose (Agent: infra-agent)

docker-compose.yml

Lines: Entire file restructure Changes:

• Rename all services: admin-* → mvp-*, mvp-platform-vehicles-api → mvp-platform
• Remove 8 service definitions
• Add volume mount: ./data/documents:/app/data/documents
• Update network assignments (5 → 3 networks)
• Update service discovery labels

---

Phase 2: Remove Tenant (Agent: backend-agent)

backend/src/app.ts

Lines: ~30-45, ~120-130 Changes:

• Remove tenant middleware import
• Remove tenant middleware registration
• Remove tenant-management feature registration

backend/src/core/plugins/auth.plugin.ts

Lines: ~55-75 Changes:

• Remove https://motovaultpro.com/tenant_id claim extraction
• Simplify JWT payload to only extract sub and roles

backend/src/features/vehicles/domain/vehicles.service.ts

Lines: Various Changes:

• Remove tenant context from function signatures (if any)
• Ensure only user_id is used for data isolation

backend/src/features/vehicles/domain/platform-integration.service.ts

Lines: ~20-30, ~100-120 Changes:

• Remove tenant context
• Update platform client URL to use mvp-platform

backend/src/features/fuel-logs/*.ts

Changes:

• Remove tenant references (verify user_id only)

backend/src/features/maintenance/*.ts

Changes:

• Remove tenant references (verify user_id only)

backend/src/features/stations/*.ts

Changes:

• Remove tenant references (verify user_id only)

backend/src/features/documents/*.ts

Changes:

• Remove tenant references (verify user_id only)

---

Phase 3: Filesystem Storage (Agent: storage-agent)

backend/src/core/storage/storage.service.ts

Lines: ~10-25 Changes:

• Update factory function to return FilesystemAdapter
• Remove MinIO configuration check

backend/src/features/documents/documents.controller.ts

Lines: ~176-269 (upload), ~271-319 (download), ~129-174 (delete) Changes:

• No changes needed (uses StorageService interface)
• Verify file paths work with filesystem adapter

backend/src/features/documents/documents.service.ts

Lines: ~40-80 Changes:

• Update storage_key format for filesystem paths
• Add filesystem-specific error handling

---

Phase 4: Config Cleanup (Agent: config-agent)

config/app/production.yml

Lines: Remove entire sections Changes:

• Remove platform_vehicles_api_url (add internal: http://mvp-platform:8000)
• Remove platform_vehicles_api_key
• Remove platform_tenants_api_url
• Remove MinIO configuration section
• Remove tenant-specific database URLs

.env

Lines: Remove variables Changes:

• Remove PLATFORM_VEHICLES_API_KEY
• Remove MINIO_ENDPOINT, MINIO_ACCESS_KEY, MINIO_SECRET_KEY
• Update PLATFORM_VEHICLES_API_URL=http://mvp-platform:8000
• Update DATABASE_URL to use mvp-postgres
• Update REDIS_URL to use mvp-redis

.env.development (if exists)

Changes: Same as .env

---

Phase 5: Network Simplification (Agent: infra-agent)

docker-compose.yml

Lines: Networks section Changes:

• Remove platform network
• Remove egress network
• Keep frontend, backend, database
• Update service network assignments

---

Phase 6: Backend Updates (Agent: backend-agent)

backend/src/core/config/config-loader.ts

Lines: ~50-80 Changes:

• Update database URL to use mvp-postgres
• Update Redis URL to use mvp-redis
• Remove tenant-specific config loading

backend/src/features/vehicles/external/platform-vehicles/platform-vehicles.client.ts

Lines: ~15-25 Changes:

• Update base URL to http://mvp-platform:8000
• Remove API key authentication (same network)

backend/src/index.ts

Changes:

• Verify service startup with new config

---

Phase 7: Database Updates (Agent: infra-agent)

backend/src/_system/migrations/

Changes:

• Review migrations for tenant references (should be none)
• Verify user_id isolation only

docker-compose.yml

Lines: mvp-postgres service Changes:

• Verify connection string
• Add volumes_platform schema initialization (if needed)

---

Phase 8: Platform Service (Agent: platform-agent)

mvp-platform-services/vehicles/

Entire service restructure:

mvp-platform-services/vehicles/Dockerfile

• Remove MSSQL dependencies
• Simplify to single-container deployment

mvp-platform-services/vehicles/main.py

• Update database connection to use mvp-postgres
• Update cache connection to use mvp-redis
• Remove ETL imports and endpoints

mvp-platform-services/vehicles/config.py

• Update DATABASE_URL
• Update REDIS_URL

mvp-platform-services/vehicles/requirements.txt

• Remove MSSQL drivers (pymssql, pyodbc)
• Keep PostgreSQL (psycopg2)

---

Phase 9: Documentation (Agent: docs-agent)

README.md

Lines: ~1-30 Changes:

• Update architecture description (14 → 6 containers)
• Update service names (admin-* → mvp-*)
• Update quick start instructions

CLAUDE.md

Lines: Various Changes:

• Remove multi-tenant architecture guidance
• Remove platform service development instructions
• Update container names in examples

AI-INDEX.md

Lines: ~3-24 Changes:

• Update architecture description
• Remove platform services section
• Update URLs and container names

.ai/context.json

Lines: Entire file Changes:

• Update architecture metadata (hybrid → simplified)
• Update service list (14 → 6)
• Remove tenant-management feature
• Update platform service description

docs/PLATFORM-SERVICES.md

Lines: Entire file restructure Changes:

• Document single mvp-platform service
• Remove tenant service documentation
• Remove landing service documentation
• Update architecture diagrams

docs/TESTING.md

Lines: ~24-60 Changes:

• Update container names (admin-* → mvp-*)
• Remove platform service test setup
• Update integration test patterns

docs/DATABASE-SCHEMA.md

Changes:

• Verify no tenant references
• Document vehicles_platform schema (if added)

Makefile

Lines: All commands Changes:

- docker compose exec admin-backend
+ docker compose exec mvp-backend

- docker compose exec admin-frontend
+ docker compose exec mvp-frontend

- docker compose exec admin-postgres
+ docker compose exec mvp-postgres

backend/src/features/*/README.md (5 files)

Changes:

• Update container names in examples
• Remove tenant context from feature descriptions
• Update testing instructions

---

Phase 10: Frontend Updates (Agent: frontend-agent)

frontend/src/App.tsx

Changes:

• Remove tenant selection UI (if exists)
• Remove tenant context provider (if exists)

frontend/src/core/auth/

Changes:

• Update Auth0 integration
• Remove tenant_id claim extraction
• Verify user authentication still works

frontend/src/core/api/

Changes:

• Remove tenant management API client (if exists)
• Update API base URLs (if hardcoded)

frontend/src/features/*/

Changes:

• Remove any tenant-related components
• Verify API calls work with new backend

---

Phase 11: Testing (Agent: test-agent)

backend/src/features/*/tests/

Changes:

• Update container name references in test helpers
• Remove tenant context from test fixtures
• Update integration tests

frontend/src/features/*/tests/

Changes:

• Update component tests
• Remove tenant-related test cases

---

File Conflict Resolution

Potential Conflicts

File	Agents	Resolution
docker-compose.yml	infra-agent (Phases 1, 5)	Sequential phases - no conflict
backend/src/app.ts	backend-agent (Phases 2, 6)	Sequential phases - no conflict
config/app/production.yml	config-agent (Phase 4)	Single agent - no conflict
Makefile	docs-agent (Phase 9)	Single agent - no conflict

No actual conflicts - All multi-phase modifications are by same agent in sequence.

Lock File Locations

If conflicts arise (they shouldn't), lock files would be created in:

docs/redesign/locks/
├── docker-compose.yml.lock
├── app.ts.lock
├── production.yml.lock
└── Makefile.lock

File Change Statistics

By Agent

Agent	DELETE	MODIFY	CREATE	Total
config-agent	6 files	3 files	0	9
backend-agent	7 files + 1 dir	12 files	0	19
storage-agent	0	3 files	2 files	5
infra-agent	0 (service removal)	8 files	0	8
platform-agent	0	6 files	0	6
docs-agent	0	10 files	0	10
frontend-agent	0	8 files	0	8
test-agent	0	7 files	0	7
TOTAL	13 + 1 dir	57	2	72

By File Type

Type	DELETE	MODIFY	CREATE
.ts/.tsx	7	35	2
.yml/.yaml	0	2	0
.md	0	10	0
.json	0	1	0
.txt (secrets)	6	0	0
.py	0	6	0
Makefile	0	1	0
.env	0	2	0

Version Control Strategy

Branch Strategy

# Main branch
git checkout main

# Create feature branch
git checkout -b simplify-architecture

# Each agent works on sub-branch
git checkout -b simplify/phase-1
git checkout -b simplify/phase-2
...

# Merge phases sequentially
# Or merge all at once after validation

Commit Strategy

Option A: Per-Phase Commits

git commit -m "Phase 1: Rename containers and update docker-compose"
git commit -m "Phase 2: Remove multi-tenant architecture"
...

Option B: Per-Agent Commits

git commit -m "config-agent: Clean up configuration and secrets"
git commit -m "backend-agent: Remove tenant code and update services"
...

Recommended: Per-Phase commits for better rollback granularity.

Backup Strategy

Before starting:

# Create backup branch
git checkout -b backup-before-simplification

# Tag current state
git tag -a pre-simplification -m "State before architecture simplification"

# Export docker volumes
docker run --rm -v mvp_postgres_data:/data -v $(pwd):/backup \
  alpine tar czf /backup/postgres-backup.tar.gz /data

File Verification Checklist

After all changes:

• No references to admin-backend (should be mvp-backend)
• No references to admin-frontend (should be mvp-frontend)
• No references to admin-postgres (should be mvp-postgres)
• No references to tenant_id in application code
• No references to MinIO in backend code
• No platform service API keys in config
• All tests updated for new container names
• All documentation reflects 6-container architecture