# marcoviaweb/libreria-inventario-django architecture

> Architecture diagram of the GitHub repository marcoviaweb/libreria-inventario-django, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marcoviaweb/libreria-inventario-django
- Repository: https://github.com/marcoviaweb/libreria-inventario-django

## Overview

##### Project Type and Purpose
- This is a full-stack Django web application (“Sistema de Gestión de Inventario para Librería”) whose goal is to manage books, inventory movements, sales, suppliers, purchase orders, receptions, and generate reports.
- It follows Django’s MTV (Model-Template-View) pattern and uses Bootstrap for the frontend.

##### High-Level Components
a. Presentation Layer (Frontend)
- Browser clients accessing HTML templates (Bootstrap-based UI).
- Static assets served under `staticfiles/` and shared `templates/` (e.g., `base.html`, `login.html`).
b. Application Layer (Backend)
- Django project core (`libreria_inventario/`): settings, URL routing, WSGI/ASGI, middleware.
- Django apps (each a logical module):
- usuarios: roles & users
- libros: book CRUD
- inventario: stock adjustments & inventory movements
- ventas: sales processing
- proveedores: supplier management
- pedidos: purchase orders & reception
- reportes: inventory/sales reports
c. Data Layer
- Relational database (SQLite in dev; PostgreSQL/MySQL in prod).
- Django ORM models defined in each app (`models.py`) and migrations (`migrations/`).
d. External Services (optional/extension points)
- Email/SMS gateways for notifications (not in code but typical).
- Third-party analytics or reporting engines.

##### Relationships and Data Flows
- Users → HTTP(S) requests → Django URL router (`libreria_inventario/urls.py`).
- Requests → Views (`app/views.py`) → Forms & business logic (`forms.py`, `models.py`).
- Views → ORM queries → DB reads/writes → return context → Templates.
- Templates combine data + Bootstrap CSS/JS → rendered HTML → Browser.
- Admin tasks: superuser via Django admin.
- Static/media files served by Django in dev or by CDN/web server in prod.

##### Architectural Patterns & Principles
- Modular Monolith: each Django app is a cohesive module; they share the same process but have clear boundaries.
- MTV (Model-Template-View):
- Models = Data structures & DB schema.
- Templates = HTML UIs.
- Views = Controllers (request handlers).
- DRY and Single Source of Truth: settings centralized, URL patterns modular.
- Role-based Access Control: enforced in views and via `User`/`Group` models.

##### Technologies & Frameworks
- Python 3.x + Django 5.x
- SQLite (development)
- Bootstrap (CSS/JS)
- Django ORM, migrations, admin, built-in auth & permissions
- WSGI/ASGI for deployment

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer" 
        direction TB
        Browser(["Web Client (Browser)"]):::presentation
        Templates(["Django Templates"]):::presentation
        StaticFiles(["Static Assets (CSS/JS/Images)"]):::presentation
    end

    %% Application Layer
    subgraph "Django Application" 
        direction TB
        subgraph "Core" 
            direction TB
            Settings(["settings.py"]):::application
            URLRouter(["urls.py"]):::application
            Middleware(["middleware.py"]):::application
            ASGI(["asgi.py"]):::application
            WSGI(["wsgi.py"]):::application
        end

        subgraph "Apps" 
            direction TB
            Usuarios(["usuarios App"]):::application
            Libros(["libros App"]):::application
            Inventario(["inventario App"]):::application
            Ventas(["ventas App"]):::application
            Proveedores(["proveedores App"]):::application
            Pedidos(["pedidos App"]):::application
            Reportes(["reportes App"]):::application
            CreateAdmin(["create_admin.py"]):::application
        end
    end

    %% Data Layer
    subgraph "Data Layer" 
        direction TB
        DB(["Relational Database"]):::data
        Migrations(["Migrations (each app/migrations)"]):::data
    end

    %% External Services
    subgraph "External Services" 
        direction TB
        EmailGateway(["Email/SMS Gateway"]):::external
        Analytics(["Analytics Engine"]):::external
    end

    %% Relationships
    Browser -->|"HTTP Request"| URLRouter
    URLRouter -->|"auth & permission check"| Middleware
    Middleware -->|"dispatch to"| Usuarios
    Middleware -->|"dispatch to"| Libros
    Middleware -->|"dispatch to"| Inventario
    Middleware -->|"dispatch to"| Ventas
    Middleware -->|"dispatch to"| Proveedores
    Middleware -->|"dispatch to"| Pedidos
    Middleware -->|"dispatch to"| Reportes

    Usuarios -->|"ORM Query"| DB
    Libros -->|"ORM Query"| DB
    Inventario -->|"ORM Query"| DB
    Ventas -->|"ORM Query"| DB
    Proveedores -->|"ORM Query"| DB
    Pedidos -->|"ORM Query"| DB
    Reportes -->|"ORM Query"| DB

    DB -->|"data read/write"| Migrations
    Reportes -->|"generate reports"| Analytics

    Browser -->|"fetch CSS/JS"| StaticFiles
    Browser -->|"render HTML"| Browser
    Templates --> Browser
    StaticFiles --> Browser

    CreateAdmin --> Settings

    %% Click Events
    click Templates "https://github.com/marcoviaweb/libreria-inventario-django/tree/main/templates/"
    click StaticFiles "https://github.com/marcoviaweb/libreria-inventario-django/tree/main/staticfiles/"
    click Settings "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/libreria_inventario/settings.py"
    click URLRouter "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/libreria_inventario/urls.py"
    click Middleware "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/libreria_inventario/middleware.py"
    click ASGI "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/libreria_inventario/asgi.py"
    click WSGI "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/libreria_inventario/wsgi.py"
    click Usuarios "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/usuarios/models.py"
    click Libros "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/libros/models.py"
    click Inventario "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/inventario/models.py"
    click Ventas "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/ventas/models.py"
    click Proveedores "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/proveedores/models.py"
    click Pedidos "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/pedidos/models.py"
    click Reportes "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/reportes/models.py"
    click Migrations "https://github.com/marcoviaweb/libreria-inventario-django/blob/main/usuarios/migrations/0001_initial.py"

    %% Styles
    classDef presentation fill:#E3F2FD,stroke:#1E88E5,color:#0D47A1,stroke-width:1px;
    classDef application fill:#E8F5E9,stroke:#43A047,color:#1B5E20,stroke-width:1px;
    classDef data fill:#FFF3E0,stroke:#FB8C00,color:#E65100,stroke-width:1px;
    classDef external fill:#F3E5F5,stroke:#8E24AA,color:#4A148C,stroke-width:1px;
```
