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
### 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.
Service Adapters
Python FastAPI service for integrating with external homelab services.
Purpose
- Integrate with Home Assistant, Frigate, Immich, n8n
- Transform external service data into standardized format
- Publish events to the message bus
- Provide unified API for service data
Technology Stack
- Language: Python 3.11
- Framework: FastAPI
- Port: 8000
- Message Bus: Redis
- Documentation: OpenAPI/Swagger
Features
- Home Assistant entity integration
- Frigate event processing
- Immich asset management
- n8n workflow triggers
- Event publishing to Redis
- Comprehensive OpenAPI documentation
- Modular architecture for maintainability
Project Structure
service-adapters/
├── main.py # FastAPI application (40 lines)
├── models/
│ ├── schemas.py # Pydantic models
├── routes/
│ ├── general.py # Root, health, services
│ ├── home_assistant.py # HA integration
│ ├── frigate.py # Frigate integration
│ ├── immich.py # Immich integration
│ └── events.py # Event management
└── services/
├── config.py # Service configurations
└── redis_client.py # Redis connection
API Endpoints
GET /- API informationGET /health- Health checkGET /services- Service statusGET /home-assistant/entities- HA entitiesGET /frigate/events- Frigate eventsGET /immich/assets- Immich assetsPOST /publish-event- Publish eventsGET /events- Retrieve events
Development Status
✅ Complete - Core functionality implemented with modular architecture and comprehensive testing
Testing
- Unit Tests: Comprehensive test coverage with pytest
- Coverage: HTML coverage reports in
htmlcov/ - Security: Bandit and Safety security scanning
- Quality: Black, isort, flake8, mypy code quality checks
- CI/CD: Automated testing in Gitea Actions pipeline
Clean Code Implementation
- Modular Structure: Separated concerns across models, routes, and services
- Type Safety: Pydantic models with comprehensive validation
- Error Handling: Consistent error responses and proper HTTP status codes
- Documentation: Auto-generated OpenAPI documentation
- Testing: Comprehensive test suite with high coverage
- Code Quality: Automated formatting and linting