# kamisso96/woroba architecture

> Architecture diagram of the GitHub repository kamisso96/woroba, 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/kamisso96/woroba
- Repository: https://github.com/kamisso96/woroba

## Overview

This is a multi-shop inventory and sales management application: users authenticate, select a shop, and manage its catalog, stock movements, sales, suppliers, and reporting/export needs. The backend’s sampled controllers show shop-scoped API operations, with authentication and shop access guards; the frontend tree indicates corresponding dashboard and management screens. Notifications and account/shop administration are additional capabilities. Frontend-to-backend wiring and several unsampled service internals are not established by the available excerpts, so those relationships are omitted.

Main entry points: [`backend/src/prisma/prisma.service.ts`](https://github.com/kamisso96/woroba/blob/main/backend/src/prisma/prisma.service.ts) (Application database), [`backend/src/auth/auth.service.ts`](https://github.com/kamisso96/woroba/blob/main/backend/src/auth/auth.service.ts) (Authentication), [`backend/src/shops/guards/shop-access.guard.ts`](https://github.com/kamisso96/woroba/blob/main/backend/src/shops/guards/shop-access.guard.ts) (Shop access), [`backend/src/auth/guards/jwt-auth.guard.ts`](https://github.com/kamisso96/woroba/blob/main/backend/src/auth/guards/jwt-auth.guard.ts) (JWT guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_catalog_ui["Catalog screens<br/>[page.tsx]"]
  node_reports_ui["Reports screens<br/>[page.tsx]"]
  node_sales_ui["Sales screens<br/>[page.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_identity["Identity and shop access"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_jwt_guard["JWT guard<br/>[jwt-auth.guard.ts]"]
  node_shop_guard["Shop access"]
  node_shop_admin["Shop administration<br/>[shops.service.ts]"]
end

subgraph group_inventory["Inventory operations"]
  node_categories["Categories"]
  node_products["Products"]
  node_movements["Stock movements"]
  node_suppliers["Suppliers"]
end

subgraph group_commerce["Sales and insights"]
  node_sales["Sales and receipts<br/>[sales.service.ts]"]
  node_exports["Data exports<br/>[export.service.ts]"]
end

subgraph group_support["Shop services"]
  node_notifications["Stock notifications"]
  node_users["User account<br/>[users.service.ts]"]
  node_database[("Application database<br/>[prisma.service.ts]")]
end

node_user(("Shop user"))

node_user -->|"authenticates"| node_auth
node_user --> node_dashboard
node_user --> node_catalog_ui
node_user --> node_reports_ui
node_user --> node_sales_ui
node_auth -->|"reads and writes"| node_database
node_jwt_guard -->|"guards shop routes"| node_shop_guard
node_shop_guard -->|"checks ownership"| node_database
node_categories -->|"persists categories"| node_database
node_products -->|"persists products"| node_database
node_movements -->|"persists movements"| node_database
node_suppliers -->|"persists suppliers"| node_database
node_sales -->|"persists sales"| node_database
node_exports -->|"reads export data"| node_database

click node_dashboard "https://github.com/kamisso96/woroba/blob/main/frontend/src/app/(app)/dashboard/page.tsx"
click node_catalog_ui "https://github.com/kamisso96/woroba/blob/main/frontend/src/app/(app)/products/page.tsx"
click node_reports_ui "https://github.com/kamisso96/woroba/blob/main/frontend/src/app/(app)/reports/page.tsx"
click node_sales_ui "https://github.com/kamisso96/woroba/blob/main/frontend/src/app/(app)/sales/new/page.tsx"
click node_api_client "https://github.com/kamisso96/woroba/blob/main/frontend/src/lib/api.ts"
click node_auth "https://github.com/kamisso96/woroba/blob/main/backend/src/auth/auth.service.ts"
click node_jwt_guard "https://github.com/kamisso96/woroba/blob/main/backend/src/auth/guards/jwt-auth.guard.ts"
click node_shop_guard "https://github.com/kamisso96/woroba/blob/main/backend/src/shops/guards/shop-access.guard.ts"
click node_shop_admin "https://github.com/kamisso96/woroba/blob/main/backend/src/shops/shops.service.ts"
click node_categories "https://github.com/kamisso96/woroba/blob/main/backend/src/categories/categories.service.ts"
click node_products "https://github.com/kamisso96/woroba/blob/main/backend/src/products/products.service.ts"
click node_movements "https://github.com/kamisso96/woroba/blob/main/backend/src/stock-movements/stock-movements.service.ts"
click node_suppliers "https://github.com/kamisso96/woroba/blob/main/backend/src/suppliers/suppliers.service.ts"
click node_sales "https://github.com/kamisso96/woroba/blob/main/backend/src/sales/sales.service.ts"
click node_exports "https://github.com/kamisso96/woroba/blob/main/backend/src/export/export.service.ts"
click node_notifications "https://github.com/kamisso96/woroba/blob/main/backend/src/notifications/notifications.service.ts"
click node_users "https://github.com/kamisso96/woroba/blob/main/backend/src/users/users.service.ts"
click node_database "https://github.com/kamisso96/woroba/blob/main/backend/src/prisma/prisma.service.ts"

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_dashboard,node_catalog_ui,node_reports_ui,node_sales_ui,node_api_client,node_user toneBlue
class node_auth,node_jwt_guard,node_shop_guard,node_shop_admin toneAmber
class node_categories,node_products,node_movements,node_suppliers toneMint
class node_sales,node_exports toneRose
class node_notifications,node_users,node_database toneIndigo
```

## Components

### Web application

- [Dashboard](https://github.com/kamisso96/woroba/blob/main/frontend/src/app/(app)/dashboard/page.tsx): `frontend/src/app/(app)/dashboard/page.tsx`
- [Catalog screens](https://github.com/kamisso96/woroba/blob/main/frontend/src/app/(app)/products/page.tsx): `frontend/src/app/(app)/products/page.tsx`
- [Reports screens](https://github.com/kamisso96/woroba/blob/main/frontend/src/app/(app)/reports/page.tsx): `frontend/src/app/(app)/reports/page.tsx`
- [Sales screens](https://github.com/kamisso96/woroba/blob/main/frontend/src/app/(app)/sales/new/page.tsx): `frontend/src/app/(app)/sales/new/page.tsx`
- [API client](https://github.com/kamisso96/woroba/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### Identity and shop access

- [Authentication](https://github.com/kamisso96/woroba/blob/main/backend/src/auth/auth.service.ts): `backend/src/auth/auth.service.ts`
- [JWT guard](https://github.com/kamisso96/woroba/blob/main/backend/src/auth/guards/jwt-auth.guard.ts): `backend/src/auth/guards/jwt-auth.guard.ts`
- [Shop access](https://github.com/kamisso96/woroba/blob/main/backend/src/shops/guards/shop-access.guard.ts): `backend/src/shops/guards/shop-access.guard.ts`
- [Shop administration](https://github.com/kamisso96/woroba/blob/main/backend/src/shops/shops.service.ts): `backend/src/shops/shops.service.ts`

### Inventory operations

- [Categories](https://github.com/kamisso96/woroba/blob/main/backend/src/categories/categories.service.ts): `backend/src/categories/categories.service.ts`
- [Products](https://github.com/kamisso96/woroba/blob/main/backend/src/products/products.service.ts): `backend/src/products/products.service.ts`
- [Stock movements](https://github.com/kamisso96/woroba/blob/main/backend/src/stock-movements/stock-movements.service.ts): `backend/src/stock-movements/stock-movements.service.ts`
- [Suppliers](https://github.com/kamisso96/woroba/blob/main/backend/src/suppliers/suppliers.service.ts): `backend/src/suppliers/suppliers.service.ts`

### Sales and insights

- [Sales and receipts](https://github.com/kamisso96/woroba/blob/main/backend/src/sales/sales.service.ts): `backend/src/sales/sales.service.ts`
- [Data exports](https://github.com/kamisso96/woroba/blob/main/backend/src/export/export.service.ts): `backend/src/export/export.service.ts`

### Shop services

- [Stock notifications](https://github.com/kamisso96/woroba/blob/main/backend/src/notifications/notifications.service.ts): `backend/src/notifications/notifications.service.ts`
- [User account](https://github.com/kamisso96/woroba/blob/main/backend/src/users/users.service.ts): `backend/src/users/users.service.ts`
- [Application database](https://github.com/kamisso96/woroba/blob/main/backend/src/prisma/prisma.service.ts): `backend/src/prisma/prisma.service.ts`

### Other components

- **Shop user**

## Connections

- Shop user → Authentication: authenticates (evidence: `backend/src/auth/auth.service.ts`)
- Shop user → Dashboard
- Shop user → Catalog screens
- Shop user → Reports screens
- Shop user → Sales screens
- Authentication → Application database: reads and writes (evidence: `backend/src/auth/auth.service.ts`)
- JWT guard → Shop access: guards shop routes (evidence: `backend/src/products/products.controller.ts`)
- Shop access → Application database: checks ownership (evidence: `backend/src/shops/guards/shop-access.guard.ts`)
- Categories → Application database: persists categories (evidence: `backend/src/categories/categories.service.ts`)
- Products → Application database: persists products
- Stock movements → Application database: persists movements
- Suppliers → Application database: persists suppliers
- Sales and receipts → Application database: persists sales (evidence: `backend/src/sales/sales.service.ts`)
- Data exports → Application database: reads export data (evidence: `backend/src/export/export.service.ts`)
