How xavierdev25/nomi-backend works
Nomi is a campus food-ordering backend: students browse stores and products, place orders for aula delivery, pay through MercadoPago, and follow fulfillment; the service also handles identity, recommendations, favorites, ratings, and notifications. A separate postest runner prepares a controlled environment, seeds accounts and catalog data, observes purchase sessions, and records results. The backend’s documented hexagonal structure and selected source references support the main boundaries; unsampled integrations are shown only where the README documents them.
Main entry points: OrderController.java REST API · CreateOrderHandler.java Order handlers · postest.py Postest CLI · entorno.py Environment control
Components 21
API and access
- REST API
src/main/java/com/nomi/backend/infrastructure/web/controller/OrderController.java - Identity and access
src/main/java/com/nomi/backend/infrastructure/security/OwnershipService.java
Commerce domain
- Order operations
src/main/java/com/nomi/backend/domain/port/in/order/CreateOrderUseCase.java - Order handlers
src/main/java/com/nomi/backend/application/order/CreateOrderHandler.java - Stores and catalog
src/main/java/com/nomi/backend/domain/model/product/Product.java - Order lifecycle
src/main/java/com/nomi/backend/domain/model/order/OrderStatus.java - Payments
src/main/java/com/nomi/backend/application/payment/CreatePaymentHandler.java - Recommendations
src/main/java/com/nomi/backend/application/ai/GetRecommendationsHandler.java - Favorites and ratings
src/main/java/com/nomi/backend/application/favorite/FavoriteHandler.java
Infrastructure adapters
- PostgreSQL
src/main/java/com/nomi/backend/infrastructure/persistence/adapter/OrderRepositoryAdapter.java - MercadoPago
- AI service
- Push and WebSocket
src/main/java/com/nomi/backend/infrastructure/notification/FcmNotificationAdapter.java
Postest observation
- Postest CLI
qa/postest/runner/postest.py - Environment control
qa/postest/runner/nomi_postest/entorno.py - Test data seeding
qa/postest/runner/nomi_postest/seed.py - Purchase observation
qa/postest/runner/nomi_postest/sesion.py - Result validation
qa/postest/runner/nomi_postest/val.py - Postest database
qa/postest/runner/nomi_postest/db.py - Runner configuration
qa/postest/runner/nomi_postest/config.py
Other components
- Student or staff
Connections 26
- Student or staff → REST API: sends requests
README.md - REST API → Order operations: invokes use cases
src/main/java/com/nomi/backend/infrastructure/web/controller/OrderController.java - Order handlers → Order operations: implements
src/main/java/com/nomi/backend/application/order/CreateOrderHandler.java - Order handlers → Stores and catalog: reads catalog
src/main/java/com/nomi/backend/application/order/CreateOrderHandler.java - Order handlers → Order lifecycle: creates orders
src/main/java/com/nomi/backend/application/order/CreateOrderHandler.java - Order handlers → PostgreSQL: persists orders
- REST API → Identity and access: checks ownership
src/main/java/com/nomi/backend/infrastructure/web/controller/OrderController.java - REST API → Payments: handles payment routes
README.md - Payments → MercadoPago: creates checkout
README.md - MercadoPago → REST API: sends signed webhook
- REST API → Recommendations: serves AI routes
README.md - Recommendations → AI service: requests suggestions
README.md - REST API → Favorites and ratings: serves engagement routes
- Order handlers → Push and WebSocket: notifies users
- Postest CLI → Environment control: controls services
qa/postest/runner/postest.py - Postest CLI → Test data seeding: seeds fixtures
qa/postest/runner/postest.py - Postest CLI → Purchase observation: runs observations
qa/postest/runner/postest.py - Postest CLI → Result validation: validates results
qa/postest/runner/postest.py - Environment control → Runner configuration: uses settings
qa/postest/runner/nomi_postest/entorno.py - Environment control → AI service: starts service
qa/postest/runner/nomi_postest/entorno.py - Environment control → MercadoPago: checks sandbox
qa/postest/runner/nomi_postest/entorno.py - Test data seeding → Postest database: writes test data
qa/postest/runner/nomi_postest/seed.py - Purchase observation → Test data seeding: prepares account
qa/postest/runner/nomi_postest/sesion.py - Purchase observation → Postest database: queries observations
qa/postest/runner/nomi_postest/sesion.py - Purchase observation → MercadoPago: checks payments
qa/postest/runner/nomi_postest/sesion.py - Result validation → Postest database: reads test state
qa/postest/runner/nomi_postest/val.py