How tex-corver/core works
Main Components
a. CI/CD pipeline
• GitHub Actions workflows (.github/workflows/ci.yaml, sync-to-A-Team-VPL.yaml)
• Docker build (Dockerfile, Makefile)
b. Microservice runtime
• Bootstrapper (src/core/bootstrap.py)
• Dependency Injection container (src/core/dependency_injection.py)
• Configurations loader (src/core/configurations.py)
c. Application layers (DDD style)
• Presentation layer (src/core/views.py) – HTTP or CLI entrypoints
• Application layer (src/core/message_bus.py, src/core/messages.py) – command/event dispatcher
• Domain layer (src/core/models.py, src/core/abstract.py, src/core/unit_of_work.py)
• Infrastructure layer (src/core/adapters/sqlalchemy_adapter.py, src/core/orm.py)
d. External systems
• PostgreSQL database (configured via env vars or files per README)
• Any external microservices or message brokers (hinted by microservices.yaml in .ci-config)
Relationships & Data Flows
• Developer push → triggers GitHub Actions (ci.yaml) → builds Docker image → runs tests → optionally deploys
• Container startup → bootstrap.py reads configurations.py → sets up DI container via dependency_injection.py
• Incoming request → hits views.py → translates to a Command/Query message → sent into message_bus.py
• message_bus dispatches to appropriate handler (registered via DI) → uses unit_of_work.py and domain models.py
• Repository implementations in sqlalchemy_adapter.py perform CRUD on PostgreSQL via orm.py
• Results or domain events flow back through message_bus to views, then returned as HTTP/CLI response
Architectural Patterns & Design Principles
• Layered (hexagonal/ports-and-adapters) architecture
• Dependency Injection for decoupling wiring (core vs adapters)
• Unit of Work pattern for transactional boundaries
• Message Bus (in-process) enabling commands/events routing
• Adapter pattern isolating ORM (SQLAlchemy) from domain
Technologies & Frameworks
• Python packaging (pyproject.toml, setup.py)
• SQLAlchemy (ORM)
• pytest for unit/integration/e2e tests
• Docker (containerization)
• GitHub Actions (CI/CD)