How evelynlobo91/gastro_hub works
Gastro_Hub is a modular NestJS marketplace for multi-brand food ordering, with a React test console. The customer flow begins with registration or login, continues through brand-segmented menus and a unified order, then consolidated payment, kitchen sub-orders, and fulfillment tracking. The README documents this end-to-end product scope; sampled controllers and services confirm several API-to-domain calls, while other domain links are documented rather than verified in source. The repository is still in development: inventory and delivery are represented, while loyalty and financial settlement are capabilities without sampled implementation evidence.
Main entry points: orders.service.ts Order orchestration · auth.service.ts Authentication · delivery.service.ts Fulfillment tracking · App.tsx React console
Components 24
Client console
- React console
frontend/src/app/App.tsx - Auth forms
frontend/src/features/auth/LoginForm.tsx - Session panel
frontend/src/features/auth/SessionPanel.tsx - API client
frontend/src/shared/api.ts
Identity and access
- Auth API
src/features/auth/auth.controller.ts - Authentication
src/features/auth/auth.service.ts - User accounts
src/features/users/users.service.ts
Ordering and catalog
- Catalog API
src/features/catalog/catalog.controller.ts - Catalog
src/features/catalog/catalog.service.ts - Orders API
src/features/orders/orders.controller.ts - Order orchestration
src/features/orders/orders.service.ts - Order records
src/features/orders/entities/order.entity.ts - Consolidated payment
src/features/orders/entities/payment.entity.ts - Kitchen sub-orders
src/features/orders/entities/sub-order.entity.ts
Operations
- Stock and recipes
src/features/inventory/inventory.service.ts - Delivery API
src/features/delivery/delivery.controller.ts - Fulfillment tracking
src/features/delivery/delivery.service.ts - Delivery records
src/features/delivery/entities/delivery.entity.ts - Loyalty
src/contracts/loyalty.contract.ts
Platform services
- Session cache
src/shared/cache/session-cache.service.ts - PostgreSQL
src/shared/database/database.module.ts - Redis
src/shared/cache/redis.provider.ts - RabbitMQ
src/shared/messaging/rabbitmq.service.ts
Other components
- Customer
Connections 26
- Customer → React console: uses
- React console → Auth forms: renders
frontend/src/app/App.tsx - React console → Session panel: renders
frontend/src/app/App.tsx - Auth forms → API client: submits credentials
- Session panel → API client: requests session
frontend/src/features/auth/SessionPanel.tsx - API client → Auth API: calls API
- Auth API → Authentication: delegates
src/features/auth/auth.controller.ts - Authentication → User accounts: uses accounts
src/features/auth/auth.service.ts - Authentication → Session cache: stores sessions
src/features/auth/auth.service.ts - Session cache → Redis: reads and writes
src/shared/cache/session-cache.service.ts - Customer → Catalog API: browses menus
- Catalog API → Catalog: delegates
src/features/catalog/catalog.controller.ts - Customer → Orders API: places order
- Orders API → Order orchestration: delegates
src/features/orders/orders.controller.ts - Order orchestration → Order records: persists orders
src/features/orders/orders.service.ts - Order orchestration → Consolidated payment: records payment
src/features/orders/orders.service.ts - Order orchestration → Kitchen sub-orders: splits by kitchen
src/features/orders/orders.service.ts - Order orchestration → Fulfillment tracking: coordinates delivery
src/features/orders/orders.service.ts - Customer → Delivery API: tracks fulfillment
- Delivery API → Fulfillment tracking: delegates
src/features/delivery/delivery.controller.ts - Fulfillment tracking → Delivery records: updates status
src/features/delivery/delivery.service.ts - Fulfillment tracking → RabbitMQ: publishes events
src/features/delivery/delivery.service.ts - Customer → Stock and recipes: benefits from stock checks
- Customer → Loyalty: uses rewards
- Order orchestration → PostgreSQL: stores order data
- Authentication → PostgreSQL: stores refresh tokens