# marilu-su/takeandgo architecture

> Architecture diagram of the GitHub repository marilu-su/takeandgo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marilu-su/takeandgo
- Repository: https://github.com/marilu-su/takeandgo

## Overview

Take&Go is a buffet take-away platform with customer ordering, store administration, kitchen operations, and pickup workflows. Customers browse a store catalog and place scheduled orders; staff manage catalog and stock, prepare orders, and confirm pickup. The graph reflects the sampled API wiring and documented frontend/API/database boundary. Several product capabilities are represented by repository subsystems, but their detailed execution paths were not sampled; MenIA is documented but has no implementation path in the supplied tree.

Main entry points: [`apps/api/src/app.ts`](https://github.com/marilu-su/takeandgo/blob/develop/apps/api/src/app.ts) (API application), [`apps/api/src/modules/order`](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/order) (Order handling), [`apps/api/src/modules/catalog`](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/catalog) (Catalog management), [`apps/web/src/app/(customer)`](https://github.com/marilu-su/takeandgo/tree/develop/apps/web/src/app/(customer)) (Customer views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Customer experience"]
  node_web["Web application"]
  node_customer_views["Customer views"]
  node_catalog_ui["Catalog interface<br/>[catalog.tsx]"]
  node_cart_ui["Cart interface<br/>[cart-panel.tsx]"]
  node_menia["MenIA assistant"]
end

subgraph group_operations["Buffet operations"]
  node_catalog_api["Catalog management"]
  node_stock_api["Stock control"]
  node_organization_api["Organization and stores"]
  node_customer_api["Customer profiles"]
  node_admin_ui["Store administration"]
end

subgraph group_fulfillment["Order fulfillment"]
  node_kitchen_api["Kitchen workflow"]
  node_kitchen_ui["Kitchen queue<br/>[kitchen-queue.tsx]"]
  node_order_api["Order handling"]
  node_payment_api["Payment processing"]
  node_pickup_api["Pickup confirmation"]
  node_pickup_ui["Pickup workflow<br/>[page.tsx]"]
end

subgraph group_platform["API platform"]
  node_api_app["API application<br/>[app.ts]"]
  node_auth["Authentication"]
  node_postgres[("PostgreSQL")]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_web
node_web -->|"calls API"| node_api_app
node_api_app -->|"checks database"| node_postgres
node_api_app -->|"registers"| node_auth
node_api_app -->|"registers routes"| node_catalog_api
node_api_app -->|"registers routes"| node_customer_api
node_api_app -->|"registers routes"| node_stock_api
node_api_app -->|"registers routes"| node_order_api
node_api_app -->|"registers routes"| node_kitchen_api
node_api_app -->|"registers routes"| node_pickup_api
node_api_app -->|"registers routes"| node_organization_api
node_customer_views -.->|"shows catalog"| node_catalog_ui
node_customer_views -.->|"builds orders"| node_cart_ui
node_admin_ui -.->|"manages catalog"| node_catalog_api
node_admin_ui -.->|"manages stock"| node_stock_api
node_kitchen_ui -.->|"supports preparation"| node_kitchen_api
node_pickup_ui -.->|"confirms pickup"| node_pickup_api
node_order_api -->|"reads catalog"| node_catalog_api
node_order_api -->|"reads preferences"| node_customer_api
node_order_api -.->|"uses payment"| node_payment_api
node_menia -.->|"assists ordering"| node_customer

click node_web "https://github.com/marilu-su/takeandgo/tree/develop/apps/web/src/app"
click node_customer_views "https://github.com/marilu-su/takeandgo/tree/develop/apps/web/src/app/(customer)"
click node_catalog_ui "https://github.com/marilu-su/takeandgo/blob/develop/apps/web/src/components/catalog.tsx"
click node_cart_ui "https://github.com/marilu-su/takeandgo/blob/develop/apps/web/src/components/cart-panel.tsx"
click node_catalog_api "https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/catalog"
click node_stock_api "https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/stock"
click node_organization_api "https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/organization"
click node_customer_api "https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/customer"
click node_admin_ui "https://github.com/marilu-su/takeandgo/tree/develop/apps/web/src/app/(store-admin)"
click node_kitchen_api "https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/kitchen"
click node_kitchen_ui "https://github.com/marilu-su/takeandgo/blob/develop/apps/web/src/components/kitchen-queue.tsx"
click node_order_api "https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/order"
click node_payment_api "https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/payment"
click node_pickup_api "https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/pickup"
click node_pickup_ui "https://github.com/marilu-su/takeandgo/blob/develop/apps/web/src/app/(customer)/pedidos/%5Bid%5D/page.tsx"
click node_api_app "https://github.com/marilu-su/takeandgo/blob/develop/apps/api/src/app.ts"
click node_auth "https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/infrastructure/auth"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_customer_views,node_catalog_ui,node_cart_ui,node_menia toneBlue
class node_catalog_api,node_stock_api,node_organization_api,node_customer_api,node_admin_ui toneAmber
class node_kitchen_api,node_kitchen_ui,node_order_api,node_payment_api,node_pickup_api,node_pickup_ui toneMint
class node_api_app,node_auth,node_postgres toneRose
class node_customer toneIndigo
```

## Components

### Customer experience

- [Web application](https://github.com/marilu-su/takeandgo/tree/develop/apps/web/src/app): `apps/web/src/app`
- [Customer views](https://github.com/marilu-su/takeandgo/tree/develop/apps/web/src/app/(customer)): `apps/web/src/app/(customer)`
- [Catalog interface](https://github.com/marilu-su/takeandgo/blob/develop/apps/web/src/components/catalog.tsx): `apps/web/src/components/catalog.tsx`
- [Cart interface](https://github.com/marilu-su/takeandgo/blob/develop/apps/web/src/components/cart-panel.tsx): `apps/web/src/components/cart-panel.tsx`
- **MenIA assistant**

### Buffet operations

- [Catalog management](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/catalog): `apps/api/src/modules/catalog`
- [Stock control](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/stock): `apps/api/src/modules/stock`
- [Organization and stores](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/organization): `apps/api/src/modules/organization`
- [Customer profiles](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/customer): `apps/api/src/modules/customer`
- [Store administration](https://github.com/marilu-su/takeandgo/tree/develop/apps/web/src/app/(store-admin)): `apps/web/src/app/(store-admin)`

### Order fulfillment

- [Kitchen workflow](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/kitchen): `apps/api/src/modules/kitchen`
- [Kitchen queue](https://github.com/marilu-su/takeandgo/blob/develop/apps/web/src/components/kitchen-queue.tsx): `apps/web/src/components/kitchen-queue.tsx`
- [Order handling](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/order): `apps/api/src/modules/order`
- [Payment processing](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/payment): `apps/api/src/modules/payment`
- [Pickup confirmation](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/modules/pickup): `apps/api/src/modules/pickup`
- [Pickup workflow](https://github.com/marilu-su/takeandgo/blob/develop/apps/web/src/app/(customer)/pedidos/%5Bid%5D/page.tsx): `apps/web/src/app/(customer)/pedidos/[id]/page.tsx`

### API platform

- [API application](https://github.com/marilu-su/takeandgo/blob/develop/apps/api/src/app.ts): `apps/api/src/app.ts`
- [Authentication](https://github.com/marilu-su/takeandgo/tree/develop/apps/api/src/infrastructure/auth): `apps/api/src/infrastructure/auth`
- **PostgreSQL**

### Other components

- **Customer**

## Connections

- Customer → Web application: uses (evidence: `README.md`)
- Web application → API application: calls API (evidence: `README.md`)
- API application → PostgreSQL: checks database (evidence: `README.md`)
- API application → Authentication: registers (evidence: `apps/api/src/app.ts`)
- API application → Catalog management: registers routes (evidence: `apps/api/src/app.ts`)
- API application → Customer profiles: registers routes (evidence: `apps/api/src/app.ts`)
- API application → Stock control: registers routes (evidence: `apps/api/src/app.ts`)
- API application → Order handling: registers routes (evidence: `apps/api/src/app.ts`)
- API application → Kitchen workflow: registers routes (evidence: `apps/api/src/app.ts`)
- API application → Pickup confirmation: registers routes (evidence: `apps/api/src/app.ts`)
- API application → Organization and stores: registers routes (evidence: `apps/api/src/app.ts`)
- Customer views → Catalog interface: shows catalog
- Customer views → Cart interface: builds orders
- Store administration → Catalog management: manages catalog
- Store administration → Stock control: manages stock
- Kitchen queue → Kitchen workflow: supports preparation
- Pickup workflow → Pickup confirmation: confirms pickup
- Order handling → Catalog management: reads catalog (evidence: `apps/api/src/modules/order/infrastructure/http/orderRoutes.ts`)
- Order handling → Customer profiles: reads preferences (evidence: `apps/api/src/modules/order/infrastructure/http/orderRoutes.ts`)
- Order handling → Payment processing: uses payment (evidence: `apps/api/src/modules/order/infrastructure/orderModule.ts`)
- MenIA assistant → Customer: assists ordering (evidence: `README.md`)
