# 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:
```bash
# 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.