# nasora-group/nasora-crm architecture

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

- Interactive diagram: https://gitdiagram.com/nasora-group/nasora-crm
- Repository: https://github.com/nasora-group/nasora-crm

## Overview

NASORA CRM is a Flask sales-management application serving the NASDERM and NASMEDIC divisions. Field users record prospecting and professional visits, manage clients, submit sales and stock information, and maintain weekly plans; managers and administrators review revenue, activity, objectives, and evaluations. The graph preserves major documented and indexed product areas, while the excerpts provide detail mainly for prospecting, client records, visit metrics, and management reporting. Other route-to-domain links rely on the SOURCE INDEX references rather than inspected route bodies.

Main entry points: [`app/models.py`](https://github.com/nasora-group/nasora-crm/blob/main/app/models.py) (Accounts and sales data), [`app/models_clients.py`](https://github.com/nasora-group/nasora-crm/blob/main/app/models_clients.py) (Client and visit records), [`app/routes/dashboard.py`](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/dashboard.py) (Prospecting), [`app/routes/admin.py`](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/admin.py) (Administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and administration"]
  node_auth["Sign-in<br/>[auth.py]"]
  node_users["User accounts<br/>[users.py]"]
  node_permissions["Role permissions<br/>[permissions.py]"]
  node_admin_tools["Administration<br/>[admin.py]"]
end

subgraph group_field["Field operations"]
  node_planning["Weekly planning<br/>[planning.py]"]
  node_prospecting["Prospecting<br/>[dashboard.py]"]
  node_clients["Client CRM<br/>[clients.py]"]
  node_client_exports["Client exports<br/>[clients_export.py]"]
  node_visits["Visit metrics<br/>[visit_metrics.py]"]
  node_visit_sync["Visit synchronization<br/>[visit_sync.py]"]
end

subgraph group_commercial["Commercial operations"]
  node_sales["Supplier sales<br/>[sales.py]"]
  node_animation_sales["Animation sales<br/>[animation_sales.py]"]
  node_revenue["Revenue reporting<br/>[revenue.py]"]
  node_products["Product catalogue<br/>[products.py]"]
  node_stock["Stock management<br/>[stock.py]"]
end

subgraph group_insights["Management insights"]
  node_manager_cockpit["Manager cockpit<br/>[manager_cockpit.py]"]
  node_vm_cockpit["Field cockpit<br/>[vm_cockpit.py]"]
  node_evaluations["Staff evaluations<br/>[evaluations.py]"]
  node_objectives["Visit objectives"]
  node_notifications["Admin notifications"]
end

subgraph group_data["Domain data"]
  node_user_models[("Accounts and sales data<br/>[models.py]")]
  node_client_models[("Client and visit records<br/>[models_clients.py]")]
  node_stock_models[("Stock records<br/>[models_stock.py]")]
  node_extensions["Persistence services<br/>[extensions.py]"]
end

node_field_user(("Field user"))
node_admin_user(("Administrator"))

node_field_user -->|"signs in"| node_auth
node_admin_user -->|"signs in"| node_auth
node_auth -->|"authenticates against"| node_user_models
node_admin_user -->|"manages"| node_admin_tools
node_admin_tools -->|"checks access"| node_permissions
node_admin_tools -->|"reads and updates"| node_user_models
node_admin_tools -->|"reads"| node_client_models
node_field_user -->|"records prospecting"| node_prospecting
node_prospecting -->|"stores prospects"| node_user_models
node_prospecting -->|"links visit records"| node_client_models
node_prospecting -->|"notifies administrators"| node_notifications
node_prospecting -->|"uses visit KPIs"| node_visits
node_field_user -->|"manages clients"| node_clients
node_clients -->|"reads and writes"| node_client_models
node_field_user -->|"exports clients"| node_client_exports
node_client_exports -->|"reads"| node_client_models
node_field_user -->|"maintains plans"| node_planning
node_planning -->|"reads and writes"| node_user_models
node_planning -->|"notifies administrators"| node_notifications
node_field_user -->|"enters sales"| node_sales
node_sales -->|"records sales"| node_user_models
node_field_user -->|"records animation sales"| node_animation_sales
node_animation_sales -->|"records sales"| node_user_models
node_animation_sales -->|"notifies administrators"| node_notifications
node_field_user -->|"updates stock"| node_stock
node_stock -->|"reads and writes"| node_stock_models
node_admin_user -->|"manages catalogue"| node_products
node_products -->|"reads and writes"| node_user_models
node_field_user -->|"views revenue"| node_revenue
node_revenue -->|"reads sales"| node_user_models
node_admin_user -->|"reviews performance"| node_manager_cockpit
node_manager_cockpit -->|"reads revenue and users"| node_user_models
node_manager_cockpit -->|"reads visit data"| node_client_models
node_manager_cockpit -->|"reads visit targets"| node_objectives
node_field_user -->|"reviews activity"| node_vm_cockpit
node_vm_cockpit -->|"uses visit metrics"| node_visits
node_admin_user -->|"evaluates staff"| node_evaluations
node_evaluations -->|"reads and writes"| node_user_models
node_client_models -->|"uses ORM"| node_extensions
node_stock_models -->|"uses ORM"| node_extensions
node_user_models -->|"uses ORM"| node_extensions

click node_auth "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/auth.py"
click node_users "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/users.py"
click node_permissions "https://github.com/nasora-group/nasora-crm/blob/main/app/permissions.py"
click node_admin_tools "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/admin.py"
click node_planning "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/planning.py"
click node_prospecting "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/dashboard.py"
click node_clients "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/clients.py"
click node_client_exports "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/clients_export.py"
click node_visits "https://github.com/nasora-group/nasora-crm/blob/main/app/visit_metrics.py"
click node_visit_sync "https://github.com/nasora-group/nasora-crm/blob/main/app/visit_sync.py"
click node_sales "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/sales.py"
click node_animation_sales "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/animation_sales.py"
click node_revenue "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/revenue.py"
click node_products "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/products.py"
click node_stock "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/stock.py"
click node_manager_cockpit "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/manager_cockpit.py"
click node_vm_cockpit "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/vm_cockpit.py"
click node_evaluations "https://github.com/nasora-group/nasora-crm/blob/main/app/routes/evaluations.py"
click node_objectives "https://github.com/nasora-group/nasora-crm/blob/main/app/visit_objectives_readonly.py"
click node_notifications "https://github.com/nasora-group/nasora-crm/blob/main/app/services/admin_notifications.py"
click node_user_models "https://github.com/nasora-group/nasora-crm/blob/main/app/models.py"
click node_client_models "https://github.com/nasora-group/nasora-crm/blob/main/app/models_clients.py"
click node_stock_models "https://github.com/nasora-group/nasora-crm/blob/main/app/models_stock.py"
click node_extensions "https://github.com/nasora-group/nasora-crm/blob/main/app/extensions.py"

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_auth,node_users,node_permissions,node_admin_tools,node_field_user toneBlue
class node_planning,node_prospecting,node_clients,node_client_exports,node_visits,node_visit_sync toneAmber
class node_sales,node_animation_sales,node_revenue,node_products,node_stock toneMint
class node_manager_cockpit,node_vm_cockpit,node_evaluations,node_objectives,node_notifications toneRose
class node_user_models,node_client_models,node_stock_models,node_extensions,node_admin_user toneIndigo
```

## Components

### Access and administration

- [Sign-in](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/auth.py): `app/routes/auth.py`
- [User accounts](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/users.py): `app/routes/users.py`
- [Role permissions](https://github.com/nasora-group/nasora-crm/blob/main/app/permissions.py): `app/permissions.py`
- [Administration](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/admin.py): `app/routes/admin.py`

### Field operations

- [Weekly planning](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/planning.py): `app/routes/planning.py`
- [Prospecting](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/dashboard.py): `app/routes/dashboard.py`
- [Client CRM](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/clients.py): `app/routes/clients.py`
- [Client exports](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/clients_export.py): `app/routes/clients_export.py`
- [Visit metrics](https://github.com/nasora-group/nasora-crm/blob/main/app/visit_metrics.py): `app/visit_metrics.py`
- [Visit synchronization](https://github.com/nasora-group/nasora-crm/blob/main/app/visit_sync.py): `app/visit_sync.py`

### Commercial operations

- [Supplier sales](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/sales.py): `app/routes/sales.py`
- [Animation sales](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/animation_sales.py): `app/routes/animation_sales.py`
- [Revenue reporting](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/revenue.py): `app/routes/revenue.py`
- [Product catalogue](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/products.py): `app/routes/products.py`
- [Stock management](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/stock.py): `app/routes/stock.py`

### Management insights

- [Manager cockpit](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/manager_cockpit.py): `app/routes/manager_cockpit.py`
- [Field cockpit](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/vm_cockpit.py): `app/routes/vm_cockpit.py`
- [Staff evaluations](https://github.com/nasora-group/nasora-crm/blob/main/app/routes/evaluations.py): `app/routes/evaluations.py`
- [Visit objectives](https://github.com/nasora-group/nasora-crm/blob/main/app/visit_objectives_readonly.py): `app/visit_objectives_readonly.py`
- [Admin notifications](https://github.com/nasora-group/nasora-crm/blob/main/app/services/admin_notifications.py): `app/services/admin_notifications.py`

### Domain data

- [Accounts and sales data](https://github.com/nasora-group/nasora-crm/blob/main/app/models.py): `app/models.py`
- [Client and visit records](https://github.com/nasora-group/nasora-crm/blob/main/app/models_clients.py): `app/models_clients.py`
- [Stock records](https://github.com/nasora-group/nasora-crm/blob/main/app/models_stock.py): `app/models_stock.py`
- [Persistence services](https://github.com/nasora-group/nasora-crm/blob/main/app/extensions.py): `app/extensions.py`

### Other components

- **Field user**
- **Administrator**

## Connections

- Field user → Sign-in: signs in
- Administrator → Sign-in: signs in
- Sign-in → Accounts and sales data: authenticates against (evidence: `app/routes/auth.py`)
- Administrator → Administration: manages
- Administration → Role permissions: checks access (evidence: `app/routes/admin.py`)
- Administration → Accounts and sales data: reads and updates (evidence: `app/routes/admin.py`)
- Administration → Client and visit records: reads (evidence: `app/routes/admin.py`)
- Field user → Prospecting: records prospecting
- Prospecting → Accounts and sales data: stores prospects (evidence: `app/routes/dashboard.py`)
- Prospecting → Client and visit records: links visit records (evidence: `app/routes/dashboard.py`)
- Prospecting → Admin notifications: notifies administrators (evidence: `app/routes/dashboard.py`)
- Prospecting → Visit metrics: uses visit KPIs (evidence: `app/routes/dashboard.py`)
- Field user → Client CRM: manages clients
- Client CRM → Client and visit records: reads and writes (evidence: `app/routes/clients.py`)
- Field user → Client exports: exports clients (evidence: `app/routes/clients_export.py`)
- Client exports → Client and visit records: reads (evidence: `app/routes/clients_export.py`)
- Field user → Weekly planning: maintains plans
- Weekly planning → Accounts and sales data: reads and writes (evidence: `app/routes/planning.py`)
- Weekly planning → Admin notifications: notifies administrators (evidence: `app/routes/planning.py`)
- Field user → Supplier sales: enters sales
- Supplier sales → Accounts and sales data: records sales (evidence: `app/routes/sales.py`)
- Field user → Animation sales: records animation sales (evidence: `app/routes/animation_sales.py`)
- Animation sales → Accounts and sales data: records sales (evidence: `app/routes/animation_sales.py`)
- Animation sales → Admin notifications: notifies administrators (evidence: `app/routes/animation_sales.py`)
- Field user → Stock management: updates stock
- Stock management → Stock records: reads and writes (evidence: `app/routes/stock.py`)
- Administrator → Product catalogue: manages catalogue (evidence: `app/routes/products.py`)
- Product catalogue → Accounts and sales data: reads and writes (evidence: `app/routes/products.py`)
- Field user → Revenue reporting: views revenue
- Revenue reporting → Accounts and sales data: reads sales (evidence: `app/routes/revenue.py`)
- Administrator → Manager cockpit: reviews performance
- Manager cockpit → Accounts and sales data: reads revenue and users (evidence: `app/routes/manager_cockpit.py`)
- Manager cockpit → Client and visit records: reads visit data (evidence: `app/routes/manager_cockpit.py`)
- Manager cockpit → Visit objectives: reads visit targets (evidence: `app/routes/manager_cockpit.py`)
- Field user → Field cockpit: reviews activity (evidence: `app/routes/vm_cockpit.py`)
- Field cockpit → Visit metrics: uses visit metrics (evidence: `app/routes/vm_cockpit.py`)
- Administrator → Staff evaluations: evaluates staff
- Staff evaluations → Accounts and sales data: reads and writes (evidence: `app/routes/evaluations.py`)
- Client and visit records → Persistence services: uses ORM (evidence: `app/models_clients.py`)
- Stock records → Persistence services: uses ORM (evidence: `app/models_stock.py`)
- Accounts and sales data → Persistence services: uses ORM (evidence: `app/models.py`)
