Community 93 Premium feature complete

docs/PLATFORM-SERVICES.md

@@ -13,13 +13,30 @@ The platform module runs as part of the backend service:
 
 ## Platform Capabilities
 
-### Vehicle Data Service
+### Vehicle Data Service (Implemented)
 
-The platform provides vehicle data capabilities including:
-- Vehicle makes, models, trims
+The platform provides vehicle hierarchical data lookups:
+- Vehicle years (distinct, descending)
+- Vehicle makes for a specific year
+- Vehicle models for year and make
+- Vehicle trims for year, make, and model
 - Engine and transmission data
-- VIN decoding
-- Year-based vehicle information
+
+**Endpoints**:
+- `GET /api/platform/years` - Available model years
+- `GET /api/platform/makes?year={year}` - Makes for year
+- `GET /api/platform/models?year={year}&make={make}` - Models for year/make
+- `GET /api/platform/trims?year={year}&make={make}&model={model}` - Trims
+- `GET /api/platform/engines?year={year}&make={make}&model={model}&trim={trim}` - Engines
+- `GET /api/platform/transmissions?...` - Transmissions
+
+### VIN Decoding (Planned/Future)
+
+VIN decoding is planned but not yet implemented. Future capabilities will include:
+- `GET /api/platform/vehicle?vin={vin}` - Decode VIN to vehicle details
+- PostgreSQL-based VIN decode function
+- NHTSA vPIC API fallback with circuit breaker
+- Redis caching (7-day TTL for successful decodes)
 
 **Data Source**: Vehicle data from standardized sources
 **Cache Strategy**: Year-based hierarchical caching using mvp-redis