# juangatti/stockmanagerapp architecture

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

- Interactive diagram: https://gitdiagram.com/juangatti/stockmanagerapp
- Repository: https://github.com/juangatti/stockmanagerapp

## Overview

##### Project type and purpose
- Este proyecto es una aplicación web full-stack para la gestión de inventario (“MauerApp – Gestor de Stock”), compuesta por un backend RESTful en Node/Express y un frontend en React (Vite).
- Su objetivo principal es ofrecer funcionalidades de CRUD para catálogo, registro de compras, procesamiento de ventas via Excel, ajustes de stock y visualización de historiales, con autenticación JWT y roles diferenciados.

##### Analizar la estructura de archivos
- Top-level:
- Backend/ → servidor, rutas, controladores, middleware, configuración de BD.
- Frontend/ → aplicación React organizada con Vite, Atomic Design (atoms, molecules, organisms), hooks, layouts, páginas, stores.
- README.md + .gitignore
- Backend sigue patrón MVC:
- server.js arranca Express + CORS + Rutas + Middleware global.
- config/db.js gestiona pool de conexión a MySQL.
- routes/ define endpoints agrupados por recurso (auth, admin, stock, sales, prebatch).
- controllers/ contienen la lógica de cada ruta.
- middleware/authMiddleware.js valida JWT y roles.
- Dependencias clave: mysql2/promise, jsonwebtoken, bcryptjs, multer+xlsx.
- Frontend usa React + Zustand para estado global + React Router para navegación.
- src/api/api.js abstrae llamadas Axios al backend.
- Atomic Design: atoms (botones, alertas), molecules (formularios pequeños, modals, sidebars), organisms (tablas, manager UIs), pages (rutas principales).
- Layouts definen protecciones (AdminRoute) y contorno (MainLayout).
- Stores con Zustand: useAuthStore, useStockStore.

##### Insights del README
- Tech Stack confirmado; flujo auth con JWT, cierre por inactividad, roles “admin” vs “operator”.
- Componente de subida de .xlsx para procesar ventas.
- Frontend consume API base vía VITE_API_BASE_URL.
- No hay colas ni microservicios; todo corre en un único proceso de Node y una única SPA de React.

a. Componentes principales:
- Cliente Web (React SPA)
- API Server (Node.js + Express)
- Base de Datos MySQL
- Servicio de Autenticación (JWT dentro del API)
- Procesador de Excel (Multer + XLSX dentro del API)
b. Relaciones e interacciones:
- Usuario → HTTP(S) → React Router → Componentes de UI → llamadas Axios
- Axios → API Server routes → authMiddleware (JWT) → controllers → config/db → MySQL
- Subida de .xlsx → Multer middleware → controller.salesController → lógica de receta → DB
c. Patrones y principios:
- Backend: MVC + Middleware para separación de responsabilidades (auth, rutas, lógica de negocio).
- Frontend: Atomic Design + State Management (Zustand).
- Single Page Application (SPA) separada del API (cliente-servidor estricto).
d. Tecnologías clave a anotar:
- Express.js, mysql2/promise, jsonwebtoken, bcryptjs, multer, xlsx
- React, Vite, React Router, Zustand, Tailwind CSS, Axios

##### Guías para este full-stack app
- Mostrar dos zonas bien diferenciadas: Frontend y Backend.
- En Frontend, agrupar: Router + Layouts → Pages → Organisms/Molecules/Atoms. Indicar el store de Zustand.
- En Backend, separar: server.js + middleware (CORS, auth), routers, controllers, config/db.
- Dibujar la Base de Datos como un componente externo con flechas de “read/write” desde controllers.
- Mostrar la parte de procesamiento de Excel como un sub-módulo de ventas dentro del API.

##### Elementos a incluir en el diagrama
- Etiquetas claras (por ejemplo: “AuthController”, “useAuthStore”, “InventoryTable Component”).
- Flechas direccionadas para flujo de datos y dependencias (HTTP calls, DB queries, middleware chain).
- Formas o colores distintos:
- Rectángulos azules para componentes frontend,
- Rectángulos verdes para capas backend (routers, controllers),
- Cilindro para la BD MySQL,
- Hexágono para servicios externos (JWT, Multer/XLSX).

##### Detalle y granularidad
- No hace falta desglosar cada uno de los 30 atomos de UI, pero sí destacar patrones: la folder structure atomic, el store global, el entrypoint App.jsx.
- En backend, es útil mostrar al menos un flujo completo: Login → authMiddleware → authController → DB, y otro: Upload .xlsx → salesController → Business Logic → DB.
- Evita simplificar demasiado; captura carpetas y responsabilidades clave.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Frontend (React SPA)"
        Main["main.jsx"]:::frontend
        App["App.jsx"]:::frontend
        APIClient["api.js"]:::frontend
        Atoms["Atoms"]:::frontend
        Molecules["Molecules"]:::frontend
        Organisms["Organisms"]:::frontend
        Pages["Pages"]:::frontend
        AdminRoute["AdminRoute.jsx"]:::frontend
        MainLayout["MainLayout.jsx"]:::frontend
        AuthStore["useAuthStore.js"]:::frontend
        StockStore["useStockStore.js"]:::frontend
        Hooks["Custom Hooks"]:::frontend
    end

    subgraph "Backend (Node.js + Express)"
        Server["server.js"]:::backend
        DBConfig["db.js"]:::backend
        Middleware["authMiddleware.js"]:::service
        JWTService["JWT Service"]:::service
        ExcelService["Multer+XLSX"]:::service
        RoutesAuth["auth_Routes.js"]:::backend
        RoutesAdmin["admin_Routes.js"]:::backend
        RoutesStock["stock_Routes.js"]:::backend
        RoutesSales["sales_Routes.js"]:::backend
        RoutesPrebatch["prebatch_Routes.js"]:::backend
        AuthController["authController.js"]:::backend
        AdminController["adminController.js"]:::backend
        StockController["stockController.js"]:::backend
        SalesController["salesController.js"]:::backend
        PrebatchController["prebatchController.js"]:::backend
    end

    MySQL["MySQL Database"]:::db

    Main --> App
    App --> APIClient
    App --> AdminRoute
    App --> MainLayout
    App --> Pages
    Pages --> Organisms
    Organisms --> Molecules
    Molecules --> Atoms
    App --> AuthStore
    App --> StockStore
    App --> Hooks

    APIClient -->|HTTP calls| Server

    Server --> DBConfig
    Server --> RoutesAuth
    Server --> RoutesAdmin
    Server --> RoutesStock
    Server --> RoutesSales
    Server --> RoutesPrebatch

    RoutesAuth --> Middleware
    Middleware --> AuthController
    AuthController --> MySQL

    RoutesAdmin --> AdminController
    AdminController --> MySQL

    RoutesStock --> StockController
    StockController --> MySQL

    RoutesSales --> SalesController
    SalesController --> ExcelService
    SalesController --> MySQL

    RoutesPrebatch --> PrebatchController
    PrebatchController --> MySQL

    click Main "https://github.com/juangatti/stockmanagerapp/blob/main/Frontend/src/main.jsx"
    click App "https://github.com/juangatti/stockmanagerapp/blob/main/Frontend/src/App.jsx"
    click APIClient "https://github.com/juangatti/stockmanagerapp/blob/main/Frontend/src/api/api.js"
    click Atoms "https://github.com/juangatti/stockmanagerapp/tree/main/Frontend/src/components/atoms/"
    click Molecules "https://github.com/juangatti/stockmanagerapp/tree/main/Frontend/src/components/molecules/"
    click Organisms "https://github.com/juangatti/stockmanagerapp/tree/main/Frontend/src/components/organisms/"
    click Pages "https://github.com/juangatti/stockmanagerapp/tree/main/Frontend/src/pages/"
    click AdminRoute "https://github.com/juangatti/stockmanagerapp/blob/main/Frontend/src/layouts/AdminRoute.jsx"
    click MainLayout "https://github.com/juangatti/stockmanagerapp/blob/main/Frontend/src/layouts/MainLayout.jsx"
    click AuthStore "https://github.com/juangatti/stockmanagerapp/blob/main/Frontend/src/stores/useAuthStore.js"
    click StockStore "https://github.com/juangatti/stockmanagerapp/blob/main/Frontend/src/stores/useStockStore.js"
    click Hooks "https://github.com/juangatti/stockmanagerapp/tree/main/Frontend/src/hooks/"

    click Server "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/server.js"
    click DBConfig "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/config/db.js"
    click Middleware "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/middleware/authMiddleware.js"
    click RoutesAuth "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/routes/auth_Routes.js"
    click RoutesAdmin "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/routes/admin_Routes.js"
    click RoutesStock "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/routes/stock_Routes.js"
    click RoutesSales "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/routes/sales_Routes.js"
    click RoutesPrebatch "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/routes/prebatch_Routes.js"
    click AuthController "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/controllers/authController.js"
    click AdminController "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/controllers/adminController.js"
    click StockController "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/controllers/stockController.js"
    click SalesController "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/controllers/salesController.js"
    click PrebatchController "https://github.com/juangatti/stockmanagerapp/blob/main/Backend/controllers/prebatchController.js"

    classDef frontend fill:#7FB3D5,stroke:#000,stroke-width:1px
    classDef backend fill:#82E0AA,stroke:#000,stroke-width:1px
    classDef db fill:#F7DC6F,stroke:#000,stroke-width:1px
    classDef service fill:#EBDEF0,stroke:#000,stroke-width:1px,stroke-dasharray:5 5
```
