motovaultpro/archive/platform-services/README.md

Archived Platform Services

vehicles/

Archived: 2025-11-03 Reason: Integrated into backend as platform feature module

This Python FastAPI service was replaced by the TypeScript platform feature in backend/src/features/platform/.

What Was This Service?

The vehicles platform service provided:

• Vehicle hierarchical data (makes/models/trims/engines) via PostgreSQL
• VIN decoding via NHTSA vPIC API with circuit breaker
• Redis caching (6-hour TTL for vehicle data, 7-day TTL for VIN decode)
• JWT authentication
• Health checks and monitoring

Why Was It Archived?

1. Architecture Simplification: Reduced from 6 to 5 containers
2. Technology Stack Unification: Consolidated on Node.js/TypeScript
3. Development Experience: Eliminated inter-service HTTP calls
4. Deployment Complexity: Simplified Docker compose configuration

Migration Details

See: docs/PLATFORM-INTEGRATION-MIGRATION.md

New Implementation

Location: backend/src/features/platform/ API Endpoints: /api/platform/* Language: TypeScript (Fastify) Database: Same PostgreSQL vehicles schema Caching: Same Redis strategy

Original Architecture

mvp-platform (Python FastAPI)
├── Dockerfile
├── requirements.txt
├── api/
│   ├── routes/
│   ├── services/
│   ├── repositories/
│   └── models/
└── tests/

New Architecture

backend/src/features/platform/ (TypeScript Fastify)
├── api/
│   ├── platform.routes.ts
│   └── platform.controller.ts
├── domain/
│   ├── vin-decode.service.ts
│   ├── vehicle-data.service.ts
│   └── platform-cache.service.ts
├── data/
│   ├── vehicle-data.repository.ts
│   └── vpic-client.ts
└── tests/
    ├── unit/
    └── integration/

Restoration (if needed)

If you need to restore this service:

# 1. Move back from archive
mv archive/platform-services/vehicles mvp-platform-services/

# 2. Restore docker-compose.yml configuration
git restore docker-compose.yml

# 3. Rebuild containers
docker compose down
docker compose up -d

# 4. Verify 6 containers running
docker compose ps

Permanent Deletion

This directory can be permanently deleted after:

1. Platform feature proven stable in production (30+ days)
2. All stakeholders approve removal
3. Backup created of this archive directory
4. Git history confirms safe recovery if needed

Do not delete before 2025-12-03 at earliest.