How kachi72/ecommerce-back-end works
Ẹkúmidáyọ̀mí is a FastAPI backend for an ecommerce platform. The visible request path is an API client entering the application, which installs middleware and mounts health and versioned routes; health checks can probe PostgreSQL and Redis. Identity sessions use durable database state with Redis lookup hints. Other represented capabilities include audit recording, jobs, domain-event/outbox contracts, caching, and storage adapters. The README describes the product and local services but not domain endpoint coverage; several subsystem links therefore rely on SOURCE INDEX references, and unsampled wiring is omitted.
Main entry points: application.py App lifecycle · sessions.py Session service · base.py ORM metadata · service.py Audit service
Components 28
Application API
- App lifecycle
src/ekumidayomi/core/application.py - Request middleware
src/ekumidayomi/api/middleware.py - Health endpoints
src/ekumidayomi/api/health.py - Versioned API
src/ekumidayomi/api/v1/router.py
Identity and audit
- Session service
src/ekumidayomi/auth/sessions.py - Auth settings
src/ekumidayomi/auth/settings.py - User model
src/ekumidayomi/users/model.py - Audit service
src/ekumidayomi/audit/service.py - Audit record
src/ekumidayomi/audit/model.py
Persistence
- Database lifecycle
src/ekumidayomi/db/session.py - Unit of work
src/ekumidayomi/db/uow.py - ORM metadata
src/ekumidayomi/db/base.py
Events and operations
- Job service
src/ekumidayomi/jobs/service.py - Job models
src/ekumidayomi/jobs/models.py - Domain events
src/ekumidayomi/events.py - Outbox repository
src/ekumidayomi/outbox/repository.py - Outbox model
src/ekumidayomi/outbox/model.py
Shared infrastructure
- Cache client
src/ekumidayomi/cache/client.py - Cache codec
src/ekumidayomi/cache/codec.py - Memory storage
src/ekumidayomi/storage/memory.py - Storage ports
src/ekumidayomi/storage/ports.py - Shared value types
src/ekumidayomi/core/types.py - App settings
src/ekumidayomi/core/settings.py - Logging
src/ekumidayomi/core/logging.py - Observability
src/ekumidayomi/core/observability.py
Other components
- API client
- PostgreSQL
- Redis
Connections 33
- API client → App lifecycle: sends requests
README.md - App lifecycle → Request middleware: installs
src/ekumidayomi/core/application.py - App lifecycle → Health endpoints: mounts routes
src/ekumidayomi/core/application.py - App lifecycle → Versioned API: mounts routes
src/ekumidayomi/core/application.py - App lifecycle → App settings: loads configuration
src/ekumidayomi/core/application.py - App lifecycle → Database lifecycle: creates and disposes
src/ekumidayomi/core/application.py - App lifecycle → Redis: creates and closes
src/ekumidayomi/core/application.py - App lifecycle → Logging: configures
src/ekumidayomi/core/application.py - App lifecycle → Observability: initializes
src/ekumidayomi/core/application.py - Request middleware → Observability: uses
src/ekumidayomi/api/middleware.py - Health endpoints → Database lifecycle: checks connection
src/ekumidayomi/api/health.py - Health endpoints → Redis: checks connection
src/ekumidayomi/api/health.py - Session service → Auth settings: uses settings
src/ekumidayomi/auth/sessions.py - Session service → User model: validates user
src/ekumidayomi/auth/sessions.py - Session service → Unit of work: queries and stages
src/ekumidayomi/auth/sessions.py - Session service → Redis: reads and invalidates hints
src/ekumidayomi/auth/sessions.py - Audit service → Audit record: stages records
src/ekumidayomi/audit/service.py - Audit service → Unit of work: uses transaction
src/ekumidayomi/audit/service.py - Database lifecycle → PostgreSQL: opens connections
src/ekumidayomi/db/session.py - Audit record → ORM metadata: maps from
src/ekumidayomi/audit/model.py - User model → ORM metadata: maps from
src/ekumidayomi/users/model.py - Job models → ORM metadata: maps from
src/ekumidayomi/jobs/models.py - Outbox model → ORM metadata: maps from
src/ekumidayomi/outbox/model.py - Cache client → Cache codec: encodes and decodes
src/ekumidayomi/cache/client.py - Job service → Job models: uses
src/ekumidayomi/jobs/service.py - Outbox repository → Outbox model: persists
src/ekumidayomi/outbox/repository.py - Outbox repository → Domain events: serializes events
src/ekumidayomi/outbox/repository.py - Outbox model → Domain events: stores event data
src/ekumidayomi/outbox/model.py - Memory storage → Storage ports: implements
src/ekumidayomi/storage/memory.py - Job service → Shared value types: uses contracts
src/ekumidayomi/jobs/service.py - Audit service → Shared value types: uses contracts
src/ekumidayomi/audit/service.py - App settings → Auth settings: groups configuration
src/ekumidayomi/core/settings.py - Request middleware → Logging: uses
src/ekumidayomi/api/middleware.py