# jeronimoauritip/cibus architecture

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

- Interactive diagram: https://gitdiagram.com/jeronimoauritip/cibus
- Repository: https://github.com/jeronimoauritip/cibus

## Overview

Cibus is a multisucursal restaurant-management system: staff authenticate by PIN or credentials, then manage tables, orders, kitchen status and checkout; administrators and managers also maintain branches, staff and menus and review metrics. The graph separates the Angular role-based workflow from backend domain services and persistence. README capabilities fill in important unsampled areas, but excerpts do not show most backend controller-to-service wiring or runtime API bindings, so those connections are omitted rather than inferred.

Main entry points: [`frontend/src/app/app.routes.ts`](https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/app.routes.ts) (Role routes), [`frontend/src/app/components/orders/service/order-service.ts`](https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/components/orders/service/order-service.ts) (Order workflow), [`backend/src/main/java/com/jll/cibus/order/entity/OrderEntity.java`](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/order/entity/OrderEntity.java) (Orders store), [`backend/src/main/java/com/jll/cibus/order/service/OrderService.java`](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/order/service/OrderService.java) (Order service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular operations"]
  node_routes["Role routes<br/>[app.routes.ts]"]
  node_authui["Sign-in session<br/>[auth-service.ts]"]
  node_tablesui["Table map<br/>[table-map.ts]"]
  node_ordersui["Order workflow<br/>[order-service.ts]"]
  node_kitchenui["Kitchen monitor"]
  node_checkoutui["Table checkout"]
end

subgraph group_identity["Identity and access"]
  node_authbackend["Authentication<br/>[AuthService.java]"]
  node_security["JWT security<br/>[JwtService.java]"]
  node_users["User management<br/>[UserService.java]"]
end

subgraph group_restaurant["Restaurant operations"]
  node_tables["Table service<br/>[TableService.java]"]
  node_orders["Order service<br/>[OrderService.java]"]
  node_orderdetails["Order items"]
  node_payments["Payments"]
  node_ordersdb[("Orders store<br/>[OrderEntity.java]")]
end

subgraph group_catalog["Branch and catalog"]
  node_branch["Branch management<br/>[BranchEntity.java]"]
  node_products["Product catalog"]
  node_branchproducts["Branch menu"]
  node_categories["Menu categories"]
end

subgraph group_insights["Analytics"]
  node_statistics["Business metrics"]
end

node_staff(("Restaurant staff"))

node_staff -->|"uses"| node_routes
node_routes -->|"routes sign-in"| node_authui
node_routes -->|"routes tables"| node_tablesui
node_routes -->|"routes ordering"| node_ordersui
node_routes -->|"routes kitchen"| node_kitchenui
node_routes -->|"routes checkout"| node_checkoutui
node_ordersui -.->|"requests order data"| node_ordersdb
node_orders -.->|"manages orders"| node_ordersdb

click node_routes "https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/app.routes.ts"
click node_authui "https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/Auth/services/auth-service.ts"
click node_tablesui "https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/components/tables/pages/table-map/table-map.ts"
click node_ordersui "https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/components/orders/service/order-service.ts"
click node_kitchenui "https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/components/orders/pages/kitchen-view-component/kitchen-view-component.ts"
click node_checkoutui "https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/components/orders/pages/order-close-component/order-close-component.ts"
click node_authbackend "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/auth/AuthService.java"
click node_security "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/common/config/security/JwtService.java"
click node_users "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/user/service/UserService.java"
click node_branch "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/branch/entity/BranchEntity.java"
click node_products "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/product/service/ProductService.java"
click node_branchproducts "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/branchproduct/service/BranchProductService.java"
click node_categories "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/productcategory/service/ProductCategoryService.java"
click node_tables "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/table/service/TableService.java"
click node_orders "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/order/service/OrderService.java"
click node_orderdetails "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/orderdetail/service/OrderDetailService.java"
click node_payments "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/payment/service/PaymentService.java"
click node_statistics "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/statistics/service/StatisticsService.java"
click node_ordersdb "https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/order/entity/OrderEntity.java"

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_routes,node_authui,node_tablesui,node_ordersui,node_kitchenui,node_checkoutui toneBlue
class node_authbackend,node_security,node_users toneAmber
class node_tables,node_orders,node_orderdetails,node_payments,node_ordersdb toneMint
class node_branch,node_products,node_branchproducts,node_categories toneRose
class node_statistics,node_staff toneIndigo
```

## Components

### Angular operations

- [Role routes](https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Sign-in session](https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/Auth/services/auth-service.ts): `frontend/src/app/Auth/services/auth-service.ts`
- [Table map](https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/components/tables/pages/table-map/table-map.ts): `frontend/src/app/components/tables/pages/table-map/table-map.ts`
- [Order workflow](https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/components/orders/service/order-service.ts): `frontend/src/app/components/orders/service/order-service.ts`
- [Kitchen monitor](https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/components/orders/pages/kitchen-view-component/kitchen-view-component.ts): `frontend/src/app/components/orders/pages/kitchen-view-component/kitchen-view-component.ts`
- [Table checkout](https://github.com/jeronimoauritip/cibus/blob/main/frontend/src/app/components/orders/pages/order-close-component/order-close-component.ts): `frontend/src/app/components/orders/pages/order-close-component/order-close-component.ts`

### Identity and access

- [Authentication](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/auth/AuthService.java): `backend/src/main/java/com/jll/cibus/auth/AuthService.java`
- [JWT security](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/common/config/security/JwtService.java): `backend/src/main/java/com/jll/cibus/common/config/security/JwtService.java`
- [User management](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/user/service/UserService.java): `backend/src/main/java/com/jll/cibus/user/service/UserService.java`

### Restaurant operations

- [Table service](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/table/service/TableService.java): `backend/src/main/java/com/jll/cibus/table/service/TableService.java`
- [Order service](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/order/service/OrderService.java): `backend/src/main/java/com/jll/cibus/order/service/OrderService.java`
- [Order items](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/orderdetail/service/OrderDetailService.java): `backend/src/main/java/com/jll/cibus/orderdetail/service/OrderDetailService.java`
- [Payments](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/payment/service/PaymentService.java): `backend/src/main/java/com/jll/cibus/payment/service/PaymentService.java`
- [Orders store](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/order/entity/OrderEntity.java): `backend/src/main/java/com/jll/cibus/order/entity/OrderEntity.java`

### Branch and catalog

- [Branch management](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/branch/entity/BranchEntity.java): `backend/src/main/java/com/jll/cibus/branch/entity/BranchEntity.java`
- [Product catalog](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/product/service/ProductService.java): `backend/src/main/java/com/jll/cibus/product/service/ProductService.java`
- [Branch menu](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/branchproduct/service/BranchProductService.java): `backend/src/main/java/com/jll/cibus/branchproduct/service/BranchProductService.java`
- [Menu categories](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/productcategory/service/ProductCategoryService.java): `backend/src/main/java/com/jll/cibus/productcategory/service/ProductCategoryService.java`

### Analytics

- [Business metrics](https://github.com/jeronimoauritip/cibus/blob/main/backend/src/main/java/com/jll/cibus/statistics/service/StatisticsService.java): `backend/src/main/java/com/jll/cibus/statistics/service/StatisticsService.java`

### Other components

- **Restaurant staff**

## Connections

- Restaurant staff → Role routes: uses
- Role routes → Sign-in session: routes sign-in (evidence: `frontend/src/app/app.routes.ts`)
- Role routes → Table map: routes tables (evidence: `frontend/src/app/app.routes.ts`)
- Role routes → Order workflow: routes ordering (evidence: `frontend/src/app/app.routes.ts`)
- Role routes → Kitchen monitor: routes kitchen (evidence: `frontend/src/app/app.routes.ts`)
- Role routes → Table checkout: routes checkout (evidence: `frontend/src/app/app.routes.ts`)
- Order workflow → Orders store: requests order data
- Order service → Orders store: manages orders (evidence: `backend/src/main/java/com/jll/cibus/order/service/OrderService.java`)
