89 lines
2.5 KiB
Markdown
89 lines
2.5 KiB
Markdown
# 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.
|