# vanguard-systems-dos/gestor-inventario architecture

> Architecture diagram of the GitHub repository vanguard-systems-dos/gestor-inventario, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vanguard-systems-dos/gestor-inventario
- Repository: https://github.com/vanguard-systems-dos/gestor-inventario

## Overview

##### Project type and purpose
- This is a full-stack web application: an Inventory Management System.
- Frontend: Angular SPA (static maquette in /maqueta, actual Angular code in /frontend).
- Backend: Django REST API (in /backend, to be implemented) with PostgreSQL.
- Purpose: support user roles, CRUD on products, real-time stock control, alerts and historical view.

##### File structure
- Top-level directories:
- backend/ – Django project (readme present, code to come).
- frontend/ – Angular project (src/app organized by feature).
- maqueta/ – Prototype HTML/CSS/Bootstrap layout.
- Within frontend/src/app:
- features/ – each feature (home, login, dashboard sub-features).
- models/ – TypeScript interfaces.
- services/ – Angular services (API clients).
- shared/ – reusable components (header, footer, navbar) and shared CSS.
- app.routes.ts – routing configuration.
- Configuration/build files:
- angular.json, tsconfig.json, package.json in frontend.
- .gitignore at root and frontend.
- backend/readme.md signals an upcoming Django setup.

##### README for additional insights
- Architecture vision: Angular SPA + Django REST + PostgreSQL.
- Sprints plan: now in Angular static, next integrate API.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Browser / UI
    subgraph "Client Browser / UI"
        subgraph "Angular SPA"  
            APPRoutes["Routing Configuration"]:::frontend
            click APPRoutes "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/app.routes.ts"
            click APPRoutes "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/app.routes.server.ts"
            
            subgraph "Feature Modules"
                Home["Home Module"]:::frontend
                click Home "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/features/home/home.ts"
                
                Login["Login Module"]:::frontend
                click Login "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/features/login/login.ts"
                
                subgraph "Dashboard Module"
                    Dashboard["Dashboard Container"]:::frontend
                    click Dashboard "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/features/dashboard/dashboard.ts"
                    
                    BuscarProd["Buscar Producto"]:::frontend
                    click BuscarProd "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/features/dashboard/buscar-producto/buscar-producto.ts"
                    
                    RegistrarProd["Registrar Producto"]:::frontend
                    click RegistrarProd "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/features/dashboard/registrar-producto/registrar-producto.ts"
                    
                    RegistrarSalida["Registrar Salida"]:::frontend
                    click RegistrarSalida "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/features/dashboard/registrar-salida/registrar-salida.ts"
                end
                
                FormReg["User Registration Form"]:::frontend
                click FormReg "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/features/formulario-de-registro/formulario-de-registro.ts"
                
                AboutUs["Quiénes Somos"]:::frontend
                click AboutUs "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/features/quienes-somos/quienes-somos.ts"
            end
            
            subgraph "Shared Components"
                Header["Header"]:::frontend
                click Header "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/shared/header/header.ts"
                
                Footer["Footer"]:::frontend
                click Footer "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/shared/footer/footer.ts"
                
                Navbar["Navbar"]:::frontend
                click Navbar "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/shared/navbar/navbar.ts"
            end
            
            Models["Data Models"]:::frontend
            click Models "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/models/iprueba.ts"
            
            Services["API Services"]:::frontend
            click Services "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/src/app/services/prueba.service.ts"
            
            StaticAssets["Static Assets"]:::frontend
            click StaticAssets "https://github.com/vanguard-systems-dos/gestor-inventario/tree/main/frontend/public/img"
            click StaticAssets "https://github.com/vanguard-systems-dos/gestor-inventario/tree/main/frontend/public/portfolio"
            
            Config["Config & Build Files"]:::frontend
            click Config "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/angular.json"
            click Config "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/tsconfig.app.json"
            click Config "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/tsconfig.json"
            click Config "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/tsconfig.spec.json"
            click Config "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/package.json"
            click Config "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/package-lock.json"
            click Config "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/.gitignore"
            click Config "https://github.com/vanguard-systems-dos/gestor-inventario/blob/main/frontend/.editorconfig"
        end
        
        Maquette["Prototype Maquette"]:::frontend
        click Maquette "https://github.com/vanguard-systems-dos/gestor-inventario/tree/main/maqueta/"
    end

    API["Django REST API"]:::backend
    click API "https://github.com/vanguard-systems-dos/gestor-inventario/tree/main/backend/"

    DB["PostgreSQL Database"]:::database

    %% Connections
    User["End User"]:::external
    User -->|"Interacts via UI"| APPRoutes
    APPRoutes -->|"Triggers components"| Home
    APPRoutes --> Login
    APPRoutes --> Dashboard
    APPRoutes --> FormReg
    APPRoutes --> AboutUs

    APPRoutes --> Services
    Services -->|"HTTP/JSON"| API
    API -->|"SQL/ORM"| DB

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#0366d6,color:#0366d6
    classDef backend fill:#DFFFE0,stroke:#228B22,color:#228B22
    classDef database fill:#FFE6C0,stroke:#FF8C00,color:#8B4513
    classDef external fill:#F0F0F0,stroke:#999999,color:#333333,stroke-dasharray: 5 5
```
