Homepage Redesign

archive/platform-services/README.md

@@ -0,0 +1,88 @@
+# 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.