# mounabsf/tunisupply architecture

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

## Overview

This is a web application for managing allocation requests and commerce resources, with user roles, anomaly reports and alerts, and dashboard statistics. The main user flow runs through authenticated frontend routes to domain pages and the shared API client; the backend provides corresponding Django domain modules and data models. The graph preserves the major product areas visible in the tree and source index. Backend endpoint wiring is largely unsampled, so frontend-to-backend links are shown as unverified rather than asserted as confirmed calls.

Main entry points: [`frontend/src/api.js`](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/api.js) (API client), [`frontend/src/App.jsx`](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/App.jsx) (Routes and pages), [`dashboard/api.py`](https://github.com/mounabsf/tunisupply/blob/main/dashboard/api.py) (Dashboard API), [`anomalies/models.py`](https://github.com/mounabsf/tunisupply/blob/main/anomalies/models.py) (Reports and alerts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_app["Routes and pages<br/>[App.jsx]"]
  node_auth_provider["Auth provider<br/>[AuthProvider.jsx]"]
  node_auth_guard["Auth guard<br/>[RequireAuth.jsx]"]
  node_auth_context["Auth context<br/>[context.js]"]
  node_layout["Navigation layout<br/>[Layout.jsx]"]
  node_module_registry["Module registry<br/>[modules.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_request_pages["Request pages<br/>[Demandes.jsx]"]
  node_resource_pages["Resource pages<br/>[Ressources.jsx]"]
  node_anomaly_pages["Anomaly pages<br/>[Anomalies.jsx]"]
  node_alert_pages["Alert pages<br/>[Alertes.jsx]"]
  node_statistics_page["Statistics page<br/>[Statistiques.jsx]"]
  node_account_pages["Account pages<br/>[Comptes.jsx]"]
  node_charts["Charts<br/>[charts.jsx]"]
  node_frontend_stats["Dashboard data view<br/>[Home.jsx]"]
end

subgraph group_accounts["Accounts and access"]
  node_account_api["Account API<br/>[api.py]"]
  node_account_services["Account services<br/>[services.py]"]
  node_account_models[("Profiles and roles<br/>[models.py]")]
end

subgraph group_allocation["Allocation and resources"]
  node_request_api["Request API<br/>[api.py]"]
  node_request_models[("Requests and commerce<br/>[models.py]")]
  node_resource_api["Resource API<br/>[api.py]"]
  node_resource_models[("Resource records<br/>[models.py]")]
end

subgraph group_monitoring["Anomalies and alerts"]
  node_anomaly_api["Anomaly API<br/>[api.py]"]
  node_anomaly_services["Alert rules<br/>[services.py]"]
  node_anomaly_models[("Reports and alerts<br/>[models.py]")]
end

subgraph group_insights["Dashboard and statistics"]
  node_dashboard_api["Dashboard API<br/>[api.py]"]
  node_dashboard_registry["Statistics registry<br/>[registry.py]"]
  node_dashboard_sections["Base sections<br/>[sections_base.py]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_layout
node_app -->|"filters routes"| node_module_registry
node_app -->|"guards routes"| node_auth_guard
node_app -->|"routes to"| node_request_pages
node_app -->|"routes to"| node_resource_pages
node_app -->|"routes to"| node_anomaly_pages
node_app -->|"routes to"| node_alert_pages
node_app -->|"routes to"| node_statistics_page
node_app -->|"routes to"| node_account_pages
node_auth_provider -->|"requests session"| node_api_client
node_auth_provider -->|"provides state"| node_auth_context
node_auth_guard -->|"reads user"| node_auth_context
node_layout -->|"reads modules"| node_module_registry
node_layout -->|"reads user"| node_auth_context
node_request_pages -.->|"uses"| node_api_client
node_resource_pages -->|"calls"| node_api_client
node_anomaly_pages -->|"calls"| node_api_client
node_alert_pages -->|"calls"| node_api_client
node_statistics_page -->|"renders"| node_charts
node_statistics_page -.->|"uses"| node_api_client
node_api_client -.->|"sends HTTP"| node_account_api
node_api_client -.->|"sends HTTP"| node_request_api
node_api_client -.->|"sends HTTP"| node_resource_api
node_api_client -.->|"sends HTTP"| node_anomaly_api
node_api_client -.->|"sends HTTP"| node_dashboard_api
node_account_services -->|"updates profiles"| node_account_models
node_account_services -->|"creates inspector"| node_anomaly_models
node_anomaly_models -->|"references commerce and zone"| node_request_models
node_anomaly_services -->|"updates alerts"| node_anomaly_models
node_dashboard_api -->|"uses registry"| node_dashboard_registry
node_dashboard_api -->|"reads accounts"| node_account_models
node_dashboard_api -->|"reads requests"| node_request_models
node_dashboard_api -->|"reads anomalies"| node_anomaly_models
node_dashboard_sections -->|"registers sections"| node_dashboard_registry
node_dashboard_sections -->|"reads requests"| node_request_models
node_frontend_stats -.->|"uses"| node_api_client

click node_app "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/App.jsx"
click node_auth_provider "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/auth/AuthProvider.jsx"
click node_auth_guard "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/auth/RequireAuth.jsx"
click node_auth_context "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/auth/context.js"
click node_layout "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/components/Layout.jsx"
click node_module_registry "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/modules.js"
click node_api_client "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/api.js"
click node_request_pages "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Demandes.jsx"
click node_resource_pages "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Ressources.jsx"
click node_anomaly_pages "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Anomalies.jsx"
click node_alert_pages "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Alertes.jsx"
click node_statistics_page "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Statistiques.jsx"
click node_account_pages "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Comptes.jsx"
click node_account_api "https://github.com/mounabsf/tunisupply/blob/main/comptes/api.py"
click node_account_services "https://github.com/mounabsf/tunisupply/blob/main/comptes/services.py"
click node_account_models "https://github.com/mounabsf/tunisupply/blob/main/comptes/models.py"
click node_request_api "https://github.com/mounabsf/tunisupply/blob/main/demandes/api.py"
click node_request_models "https://github.com/mounabsf/tunisupply/blob/main/demandes/models.py"
click node_resource_api "https://github.com/mounabsf/tunisupply/blob/main/ressources/api.py"
click node_resource_models "https://github.com/mounabsf/tunisupply/blob/main/ressources/models.py"
click node_anomaly_api "https://github.com/mounabsf/tunisupply/blob/main/anomalies/api.py"
click node_anomaly_services "https://github.com/mounabsf/tunisupply/blob/main/anomalies/services.py"
click node_anomaly_models "https://github.com/mounabsf/tunisupply/blob/main/anomalies/models.py"
click node_dashboard_api "https://github.com/mounabsf/tunisupply/blob/main/dashboard/api.py"
click node_dashboard_registry "https://github.com/mounabsf/tunisupply/blob/main/dashboard/registry.py"
click node_dashboard_sections "https://github.com/mounabsf/tunisupply/blob/main/dashboard/sections_base.py"
click node_charts "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/components/charts.jsx"
click node_frontend_stats "https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Home.jsx"

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_app,node_auth_provider,node_auth_guard,node_auth_context,node_layout,node_module_registry,node_api_client,node_request_pages,node_resource_pages,node_anomaly_pages,node_alert_pages,node_statistics_page,node_account_pages,node_charts,node_frontend_stats,node_user toneBlue
class node_account_api,node_account_services,node_account_models toneAmber
class node_request_api,node_request_models,node_resource_api,node_resource_models toneMint
class node_anomaly_api,node_anomaly_services,node_anomaly_models toneRose
class node_dashboard_api,node_dashboard_registry,node_dashboard_sections toneIndigo
```

## Components

### Web interface

- [Routes and pages](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth provider](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/auth/AuthProvider.jsx): `frontend/src/auth/AuthProvider.jsx`
- [Auth guard](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/auth/RequireAuth.jsx): `frontend/src/auth/RequireAuth.jsx`
- [Auth context](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/auth/context.js): `frontend/src/auth/context.js`
- [Navigation layout](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/components/Layout.jsx): `frontend/src/components/Layout.jsx`
- [Module registry](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/modules.js): `frontend/src/modules.js`
- [API client](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/api.js): `frontend/src/api.js`
- [Request pages](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Demandes.jsx): `frontend/src/pages/Demandes.jsx`
- [Resource pages](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Ressources.jsx): `frontend/src/pages/Ressources.jsx`
- [Anomaly pages](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Anomalies.jsx): `frontend/src/pages/Anomalies.jsx`
- [Alert pages](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Alertes.jsx): `frontend/src/pages/Alertes.jsx`
- [Statistics page](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Statistiques.jsx): `frontend/src/pages/Statistiques.jsx`
- [Account pages](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Comptes.jsx): `frontend/src/pages/Comptes.jsx`
- [Charts](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/components/charts.jsx): `frontend/src/components/charts.jsx`
- [Dashboard data view](https://github.com/mounabsf/tunisupply/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`

### Accounts and access

- [Account API](https://github.com/mounabsf/tunisupply/blob/main/comptes/api.py): `comptes/api.py`
- [Account services](https://github.com/mounabsf/tunisupply/blob/main/comptes/services.py): `comptes/services.py`
- [Profiles and roles](https://github.com/mounabsf/tunisupply/blob/main/comptes/models.py): `comptes/models.py`

### Allocation and resources

- [Request API](https://github.com/mounabsf/tunisupply/blob/main/demandes/api.py): `demandes/api.py`
- [Requests and commerce](https://github.com/mounabsf/tunisupply/blob/main/demandes/models.py): `demandes/models.py`
- [Resource API](https://github.com/mounabsf/tunisupply/blob/main/ressources/api.py): `ressources/api.py`
- [Resource records](https://github.com/mounabsf/tunisupply/blob/main/ressources/models.py): `ressources/models.py`

### Anomalies and alerts

- [Anomaly API](https://github.com/mounabsf/tunisupply/blob/main/anomalies/api.py): `anomalies/api.py`
- [Alert rules](https://github.com/mounabsf/tunisupply/blob/main/anomalies/services.py): `anomalies/services.py`
- [Reports and alerts](https://github.com/mounabsf/tunisupply/blob/main/anomalies/models.py): `anomalies/models.py`

### Dashboard and statistics

- [Dashboard API](https://github.com/mounabsf/tunisupply/blob/main/dashboard/api.py): `dashboard/api.py`
- [Statistics registry](https://github.com/mounabsf/tunisupply/blob/main/dashboard/registry.py): `dashboard/registry.py`
- [Base sections](https://github.com/mounabsf/tunisupply/blob/main/dashboard/sections_base.py): `dashboard/sections_base.py`

### Other components

- **User**

## Connections

- User → Routes and pages: uses
- Routes and pages → Navigation layout: renders (evidence: `frontend/src/App.jsx`)
- Routes and pages → Module registry: filters routes (evidence: `frontend/src/App.jsx`)
- Routes and pages → Auth guard: guards routes (evidence: `frontend/src/App.jsx`)
- Routes and pages → Request pages: routes to (evidence: `frontend/src/App.jsx`)
- Routes and pages → Resource pages: routes to (evidence: `frontend/src/App.jsx`)
- Routes and pages → Anomaly pages: routes to (evidence: `frontend/src/App.jsx`)
- Routes and pages → Alert pages: routes to (evidence: `frontend/src/App.jsx`)
- Routes and pages → Statistics page: routes to (evidence: `frontend/src/App.jsx`)
- Routes and pages → Account pages: routes to (evidence: `frontend/src/App.jsx`)
- Auth provider → API client: requests session (evidence: `frontend/src/auth/AuthProvider.jsx`)
- Auth provider → Auth context: provides state (evidence: `frontend/src/auth/AuthProvider.jsx`)
- Auth guard → Auth context: reads user (evidence: `frontend/src/auth/RequireAuth.jsx`)
- Navigation layout → Module registry: reads modules (evidence: `frontend/src/components/Layout.jsx`)
- Navigation layout → Auth context: reads user (evidence: `frontend/src/components/Layout.jsx`)
- Request pages → API client: uses
- Resource pages → API client: calls (evidence: `frontend/src/pages/Ressources.jsx`)
- Anomaly pages → API client: calls (evidence: `frontend/src/pages/Anomalies.jsx`)
- Alert pages → API client: calls (evidence: `frontend/src/pages/Alertes.jsx`)
- Statistics page → Charts: renders (evidence: `frontend/src/pages/Statistiques.jsx`)
- Statistics page → API client: uses
- API client → Account API: sends HTTP
- API client → Request API: sends HTTP
- API client → Resource API: sends HTTP
- API client → Anomaly API: sends HTTP
- API client → Dashboard API: sends HTTP
- Account services → Profiles and roles: updates profiles (evidence: `comptes/services.py`)
- Account services → Reports and alerts: creates inspector (evidence: `comptes/services.py`)
- Reports and alerts → Requests and commerce: references commerce and zone (evidence: `anomalies/models.py`)
- Alert rules → Reports and alerts: updates alerts (evidence: `anomalies/services.py`)
- Dashboard API → Statistics registry: uses registry (evidence: `dashboard/api.py`)
- Dashboard API → Profiles and roles: reads accounts (evidence: `dashboard/api.py`)
- Dashboard API → Requests and commerce: reads requests (evidence: `dashboard/api.py`)
- Dashboard API → Reports and alerts: reads anomalies (evidence: `dashboard/api.py`)
- Base sections → Statistics registry: registers sections (evidence: `dashboard/sections_base.py`)
- Base sections → Requests and commerce: reads requests (evidence: `dashboard/sections_base.py`)
- Dashboard data view → API client: uses
