Files
labFusion/services/api-docs
GSRN 4b2ef7e246
Some checks failed
API Gateway (Java Spring Boot) / test (21) (push) Successful in 2m2s
API Gateway (Java Spring Boot) / test (17) (push) Successful in 2m2s
Frontend (React) / test (20) (push) Successful in 2m11s
Integration Tests / integration-tests (push) Failing after 25s
Integration Tests / performance-tests (push) Has been skipped
API Docs (Node.js Express) / test (20) (push) Successful in 2m36s
API Gateway (Java Spring Boot) / build (push) Failing after 40s
Service Adapters (Python FastAPI) / test (3.11) (push) Successful in 1m24s
Service Adapters (Python FastAPI) / test (3.12) (push) Successful in 1m27s
Service Adapters (Python FastAPI) / test (3.13) (push) Successful in 1m27s
Frontend (React) / build (push) Failing after 58s
Service Adapters (Python FastAPI) / build (push) Failing after 21s
Frontend (React) / lighthouse (push) Has been skipped
API Docs (Node.js Express) / build (push) Failing after 1m24s
chore: Remove legacy Docker configuration and documentation
### Summary of Changes
- Deleted `docker-compose.dev.yml` and `docker-compose.yml` files to streamline the project structure.
- Removed outdated Dockerfiles for services (API Gateway, Service Adapters, API Docs, and Frontend) to eliminate redundancy.
- Updated `env.example` to reflect changes in service configurations, including local host settings for PostgreSQL and Redis.
- Revised `README.md` to remove references to Docker deployment and clarify local development setup instructions.
- Cleaned up documentation structure by removing obsolete files related to Docker rate limits and compatibility fixes.

### Expected Results
- Simplified project setup and improved clarity for developers by focusing on current configurations and removing legacy artifacts.
2025-09-18 00:50:03 +02:00
..
2025-09-17 23:41:26 +02:00

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