# API Documentation Service

A unified API documentation service that aggregates OpenAPI specifications from all LabFusion services.

## Purpose
- Provide a single entry point for all API documentation
- Aggregate OpenAPI specs from all active services
- Display unified Swagger UI for the entire LabFusion ecosystem
- Monitor service health and availability

## Technology Stack
- **Language**: Node.js
- **Port**: 8083
- **Dependencies**: Express, Swagger UI, Axios

## Features
- **Unified Documentation**: Single Swagger UI for all services
- **Service Health Monitoring**: Real-time status of all services
- **Dynamic Spec Generation**: Automatically fetches and merges OpenAPI specs
- **Service Prefixing**: Each service's endpoints are prefixed for clarity
- **Fallback Handling**: Graceful handling of unavailable services

## API Endpoints
- `GET /` - Swagger UI interface
- `GET /openapi.json` - Unified OpenAPI specification
- `GET /services` - Service health status
- `GET /health` - Documentation service health

## Development Status
✅ **Complete** - Ready for use with comprehensive testing and clean code implementation

## Testing
- **Unit Tests**: Jest test suite with comprehensive coverage
- **Coverage**: Test coverage reporting
- **CI/CD**: Automated testing in Gitea Actions pipeline
- **Quality**: ESLint code quality checks

## Clean Code Implementation
- **Single Purpose**: Focused on OpenAPI spec aggregation
- **Error Handling**: Graceful degradation when services are unavailable
- **Caching**: Performance optimization with intelligent caching
- **Health Monitoring**: Real-time service status tracking
- **Configuration**: Environment-based settings management
- **Documentation**: Comprehensive inline documentation