# crimac90/inventra architecture

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

## Overview

INVENTRA is a SaaS inventory and sales-management application for liquor stores. The implemented user workflow in the supplied source centers on registration and account access, session-protected pages, subscription-status checks, and user/profile management through a React client and Django REST API. The README also describes inventory by PEPS lots, point-of-sale, branches, reports, and electronic invoicing; these are product capabilities, but the supplied tree does not show their implementation. The map distinguishes those documented capabilities from the sampled security and subscription runtime.

Main entry points: [`INVENTRA/frontend/src/api/cliente.js`](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/api/cliente.js) (API client), [`INVENTRA/frontend/src/api/seguridad.js`](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/api/seguridad.js) (Security API), [`INVENTRA/frontend/src/componentes/BarraLateral.jsx`](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/componentes/BarraLateral.jsx) (Module navigation), [`INVENTRA/backend/seguridad/views.py`](https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/seguridad/views.py) (Access handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web client"]
  node_app["Route map<br/>[App.jsx]"]
  node_session["Session context<br/>[ContextoSesion.jsx]"]
  node_private["Private routes<br/>[RutaPrivada.jsx]"]
  node_client["API client<br/>[cliente.js]"]
  node_security_api["Security API<br/>[seguridad.js]"]
  node_subscription_api["Subscription API<br/>[suscripciones.js]"]
  node_user_admin["User management<br/>[Usuarios.jsx]"]
  node_profile["User profile<br/>[Perfil.jsx]"]
  node_layout["Workspace layout<br/>[Disposicion.jsx]"]
  node_sidebar["Module navigation<br/>[BarraLateral.jsx]"]
end

subgraph group_security["Security and access"]
  node_security_views["Access handlers<br/>[views.py]"]
  node_security_serializers["Access serializers<br/>[serializers.py]"]
  node_email["Verification email<br/>[correo.py]"]
  node_account_models[("Account and roles<br/>[models.py]")]
end

subgraph group_subscription["Subscriptions"]
  node_subscription_views["Subscription handlers<br/>[views.py]"]
  node_subscription_serializers["Subscription serializers<br/>[serializers.py]"]
  node_module_catalog["Plan modules<br/>[modulos.py]"]
  node_subscription_models[("Plans and tenants<br/>[models.py]")]
end

subgraph group_data["Persistence"]
  node_mysql[("MySQL database")]
end

node_shopper(("Store user"))
node_commerce["Inventory and sales"]
node_branches["Branches and users"]
node_reporting["Reports and e-invoice"]

node_shopper -->|"uses"| node_app
node_app -->|"guards pages"| node_private
node_session -->|"authenticates"| node_security_api
node_session -->|"checks token"| node_client
node_user_admin -->|"manages users"| node_security_api
node_profile -->|"updates profile"| node_security_api
node_layout -->|"renders"| node_sidebar
node_sidebar -->|"checks modules"| node_subscription_api
node_security_api -->|"sends requests"| node_client
node_subscription_api -->|"sends requests"| node_client
node_client -->|"calls API"| node_security_views
node_security_views -->|"uses"| node_security_serializers
node_security_views -->|"uses"| node_account_models
node_security_serializers -->|"sends messages"| node_email
node_subscription_views -.->|"uses"| node_subscription_serializers
node_subscription_views -.->|"uses"| node_subscription_models
node_subscription_models -.->|"associates tenant users"| node_account_models
node_sidebar -.->|"shows availability"| node_module_catalog
node_account_models -.->|"persists accounts"| node_mysql
node_subscription_models -.->|"persists plans"| node_mysql
node_shopper -.->|"manages stock and sales"| node_commerce
node_shopper -.->|"manages locations"| node_branches
node_shopper -.->|"uses reports and invoicing"| node_reporting

click node_app "https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/App.jsx"
click node_session "https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/sesion/ContextoSesion.jsx"
click node_private "https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/sesion/RutaPrivada.jsx"
click node_client "https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/api/cliente.js"
click node_security_api "https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/api/seguridad.js"
click node_subscription_api "https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/api/suscripciones.js"
click node_user_admin "https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/paginas/Usuarios.jsx"
click node_profile "https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/paginas/Perfil.jsx"
click node_layout "https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/componentes/Disposicion.jsx"
click node_sidebar "https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/componentes/BarraLateral.jsx"
click node_security_views "https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/seguridad/views.py"
click node_security_serializers "https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/seguridad/serializers.py"
click node_email "https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/seguridad/correo.py"
click node_account_models "https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/seguridad/models.py"
click node_subscription_views "https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/suscripciones/views.py"
click node_subscription_serializers "https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/suscripciones/serializers.py"
click node_module_catalog "https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/suscripciones/modulos.py"
click node_subscription_models "https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/suscripciones/models.py"
click node_commerce "https://github.com/crimac90/inventra/tree/main/INVENTRA/backend"
click node_branches "https://github.com/crimac90/inventra/tree/main/INVENTRA/backend"
click node_reporting "https://github.com/crimac90/inventra/tree/main/INVENTRA/backend"

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_session,node_private,node_client,node_security_api,node_subscription_api,node_user_admin,node_profile,node_layout,node_sidebar,node_shopper,node_branches toneBlue
class node_security_views,node_security_serializers,node_email,node_account_models toneAmber
class node_subscription_views,node_subscription_serializers,node_module_catalog,node_subscription_models toneMint
class node_mysql toneRose
class node_commerce,node_reporting toneTeal
```

## Components

### Web client

- [Route map](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/App.jsx): `INVENTRA/frontend/src/App.jsx`
- [Session context](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/sesion/ContextoSesion.jsx): `INVENTRA/frontend/src/sesion/ContextoSesion.jsx`
- [Private routes](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/sesion/RutaPrivada.jsx): `INVENTRA/frontend/src/sesion/RutaPrivada.jsx`
- [API client](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/api/cliente.js): `INVENTRA/frontend/src/api/cliente.js`
- [Security API](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/api/seguridad.js): `INVENTRA/frontend/src/api/seguridad.js`
- [Subscription API](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/api/suscripciones.js): `INVENTRA/frontend/src/api/suscripciones.js`
- [User management](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/paginas/Usuarios.jsx): `INVENTRA/frontend/src/paginas/Usuarios.jsx`
- [User profile](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/paginas/Perfil.jsx): `INVENTRA/frontend/src/paginas/Perfil.jsx`
- [Workspace layout](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/componentes/Disposicion.jsx): `INVENTRA/frontend/src/componentes/Disposicion.jsx`
- [Module navigation](https://github.com/crimac90/inventra/blob/main/INVENTRA/frontend/src/componentes/BarraLateral.jsx): `INVENTRA/frontend/src/componentes/BarraLateral.jsx`

### Security and access

- [Access handlers](https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/seguridad/views.py): `INVENTRA/backend/seguridad/views.py`
- [Access serializers](https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/seguridad/serializers.py): `INVENTRA/backend/seguridad/serializers.py`
- [Verification email](https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/seguridad/correo.py): `INVENTRA/backend/seguridad/correo.py`
- [Account and roles](https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/seguridad/models.py): `INVENTRA/backend/seguridad/models.py`

### Subscriptions

- [Subscription handlers](https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/suscripciones/views.py): `INVENTRA/backend/suscripciones/views.py`
- [Subscription serializers](https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/suscripciones/serializers.py): `INVENTRA/backend/suscripciones/serializers.py`
- [Plan modules](https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/suscripciones/modulos.py): `INVENTRA/backend/suscripciones/modulos.py`
- [Plans and tenants](https://github.com/crimac90/inventra/blob/main/INVENTRA/backend/suscripciones/models.py): `INVENTRA/backend/suscripciones/models.py`

### Persistence

- **MySQL database**

### Other components

- **Store user**
- [Inventory and sales](https://github.com/crimac90/inventra/tree/main/INVENTRA/backend): `INVENTRA/backend`
- [Branches and users](https://github.com/crimac90/inventra/tree/main/INVENTRA/backend): `INVENTRA/backend`
- [Reports and e-invoice](https://github.com/crimac90/inventra/tree/main/INVENTRA/backend): `INVENTRA/backend`

## Connections

- Store user → Route map: uses (evidence: `INVENTRA/frontend/src/App.jsx`)
- Route map → Private routes: guards pages (evidence: `INVENTRA/frontend/src/App.jsx`)
- Session context → Security API: authenticates (evidence: `INVENTRA/frontend/src/sesion/ContextoSesion.jsx`)
- Session context → API client: checks token (evidence: `INVENTRA/frontend/src/sesion/ContextoSesion.jsx`)
- User management → Security API: manages users (evidence: `INVENTRA/frontend/src/paginas/Usuarios.jsx`)
- User profile → Security API: updates profile (evidence: `INVENTRA/frontend/src/paginas/Perfil.jsx`)
- Workspace layout → Module navigation: renders (evidence: `INVENTRA/frontend/src/componentes/Disposicion.jsx`)
- Module navigation → Subscription API: checks modules (evidence: `INVENTRA/frontend/src/componentes/BarraLateral.jsx`)
- Security API → API client: sends requests (evidence: `INVENTRA/frontend/src/api/seguridad.js`)
- Subscription API → API client: sends requests (evidence: `INVENTRA/frontend/src/api/suscripciones.js`)
- API client → Access handlers: calls API
- Access handlers → Access serializers: uses (evidence: `INVENTRA/backend/seguridad/views.py`)
- Access handlers → Account and roles: uses (evidence: `INVENTRA/backend/seguridad/views.py`)
- Access serializers → Verification email: sends messages (evidence: `INVENTRA/backend/seguridad/serializers.py`)
- Subscription handlers → Subscription serializers: uses
- Subscription handlers → Plans and tenants: uses
- Plans and tenants → Account and roles: associates tenant users
- Module navigation → Plan modules: shows availability
- Account and roles → MySQL database: persists accounts
- Plans and tenants → MySQL database: persists plans
- Store user → Inventory and sales: manages stock and sales
- Store user → Branches and users: manages locations
- Store user → Reports and e-invoice: uses reports and invoicing
