# andrey31/colinas-inventario architecture

> Architecture diagram of the GitHub repository andrey31/colinas-inventario, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/andrey31/colinas-inventario
- Repository: https://github.com/andrey31/colinas-inventario

## Overview

Colinas is a Vue application for managing paper-roll warehouses and inventory. Staff sign in, then use permission-guarded screens to receive packing-list data, manage warehouse stock and transfers, track inventory activity, and produce operational reports. The graph includes the major capabilities named by the source tree and the documented component wiring; unsampled modules are represented only at the level supported by their paths and references. Firebase is visible in initialization and selected screen excerpts, but backend relationships are not inferred for unsampled screens.

Main entry points: [`src/router.js`](https://github.com/andrey31/colinas-inventario/blob/master/src/router.js) (Routes and permissions), [`src/views/Reportes.vue`](https://github.com/andrey31/colinas-inventario/blob/master/src/views/Reportes.vue) (Reports workspace), [`src/views/Inventario.vue`](https://github.com/andrey31/colinas-inventario/blob/master/src/views/Inventario.vue) (Inventory workspace), [`src/views/Almacenes.vue`](https://github.com/andrey31/colinas-inventario/blob/master/src/views/Almacenes.vue) (Warehouse stock)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and navigation"]
  node_app["Application shell<br/>[App.vue]"]
  node_router["Routes and permissions<br/>[router.js]"]
  node_login["Sign in<br/>[Login.vue]"]
end

subgraph group_warehouse["Warehouse operations"]
  node_warehouses["Warehouse stock<br/>[Almacenes.vue]"]
  node_warehouse_modal["Edit warehouse roll<br/>[ModalAlmacenes.vue]"]
  node_delete_modal["Delete warehouse"]
  node_dua_modal["Warehouse DUA"]
  node_packing["Packing list<br/>[PackingList.vue]"]
  node_transit_rolls["In-transit rolls<br/>[RollsInTransit.vue]"]
  node_excel_intake["Excel intake<br/>[ReadExcel.vue]"]
  node_transfers["Stock transfers<br/>[Traslados.vue]"]
end

subgraph group_inventory["Inventory control"]
  node_inventory_view["Inventory workspace<br/>[Inventario.vue]"]
  node_inventory_index["Inventory rolls<br/>[Index.vue]"]
  node_waste["Daily waste"]
  node_out_adjustment["Stock-out adjustment<br/>[AjusteSalida.vue]"]
  node_history["Inventory history<br/>[Historial.vue]"]
  node_leftovers["Inventory leftovers<br/>[Sobrantes.vue]"]
  node_change_log["Change register"]
end

subgraph group_reporting["Operational reporting"]
  node_reports_view["Reports workspace<br/>[Reportes.vue]"]
  node_quantity_report["Inventory by quantity"]
  node_consumption_report["Consumption report"]
  node_waste_report["Waste report"]
  node_stock_report["Stock report"]
  node_production_report["Production report"]
  node_report_logo["Report logo asset<br/>[logoBase64.js]"]
end

node_staff(("Staff user"))
node_firebase_auth["Firebase Auth"]
node_firebase_db[("Firebase Realtime DB")]
node_firebase_storage[("Firebase Storage")]

node_staff -->|"signs in"| node_login
node_app -->|"renders routes"| node_router
node_router -->|"routes to"| node_login
node_router -->|"routes to"| node_packing
node_router -->|"routes to"| node_excel_intake
node_router -->|"routes to"| node_inventory_view
node_router -->|"routes to"| node_transfers
node_router -->|"routes to"| node_warehouses
node_router -->|"routes to"| node_change_log
node_router -->|"routes to"| node_reports_view
node_login -.->|"authenticates with"| node_firebase_auth
node_router -->|"checks session"| node_firebase_auth
node_warehouses -->|"opens editor"| node_warehouse_modal
node_warehouses -->|"opens delete dialog"| node_delete_modal
node_warehouses -->|"opens DUA dialog"| node_dua_modal
node_packing -->|"displays rolls"| node_transit_rolls
node_packing -->|"opens editor"| node_warehouse_modal
node_excel_intake -->|"uploads workbook"| node_firebase_storage
node_excel_intake -->|"writes order data"| node_firebase_db
node_warehouse_modal -->|"writes roll data"| node_firebase_db
node_inventory_view -->|"renders tab"| node_inventory_index
node_inventory_view -->|"renders tab"| node_waste
node_inventory_view -->|"renders tab"| node_out_adjustment
node_inventory_view -->|"reads history"| node_firebase_db
node_inventory_index -->|"updates stock"| node_firebase_db
node_reports_view -->|"renders report"| node_quantity_report
node_reports_view -->|"renders report"| node_stock_report
node_reports_view -->|"renders report"| node_consumption_report
node_reports_view -->|"renders report"| node_waste_report
node_reports_view -->|"renders report"| node_production_report
node_consumption_report -->|"uses image asset"| node_report_logo
node_waste_report -->|"uses image asset"| node_report_logo
node_stock_report -->|"uses image asset"| node_report_logo
node_production_report -->|"uses image asset"| node_report_logo

click node_app "https://github.com/andrey31/colinas-inventario/blob/master/src/App.vue"
click node_router "https://github.com/andrey31/colinas-inventario/blob/master/src/router.js"
click node_login "https://github.com/andrey31/colinas-inventario/blob/master/src/views/Login.vue"
click node_warehouses "https://github.com/andrey31/colinas-inventario/blob/master/src/views/Almacenes.vue"
click node_warehouse_modal "https://github.com/andrey31/colinas-inventario/blob/master/src/components/ModalAlmacenes.vue"
click node_delete_modal "https://github.com/andrey31/colinas-inventario/blob/master/src/components/ModalDeleteAlmacen.vue"
click node_dua_modal "https://github.com/andrey31/colinas-inventario/blob/master/src/components/ModalDuaAlmacen.vue"
click node_packing "https://github.com/andrey31/colinas-inventario/blob/master/src/views/PackingList.vue"
click node_transit_rolls "https://github.com/andrey31/colinas-inventario/blob/master/src/components/RollsInTransit.vue"
click node_excel_intake "https://github.com/andrey31/colinas-inventario/blob/master/src/views/ReadExcel.vue"
click node_transfers "https://github.com/andrey31/colinas-inventario/blob/master/src/views/Traslados.vue"
click node_inventory_view "https://github.com/andrey31/colinas-inventario/blob/master/src/views/Inventario.vue"
click node_inventory_index "https://github.com/andrey31/colinas-inventario/blob/master/src/components/inventario/Index.vue"
click node_waste "https://github.com/andrey31/colinas-inventario/blob/master/src/components/inventario/DesperdiciosDiarios.vue"
click node_out_adjustment "https://github.com/andrey31/colinas-inventario/blob/master/src/components/inventario/AjusteSalida.vue"
click node_history "https://github.com/andrey31/colinas-inventario/blob/master/src/components/inventario/Historial.vue"
click node_leftovers "https://github.com/andrey31/colinas-inventario/blob/master/src/components/inventario/Sobrantes.vue"
click node_change_log "https://github.com/andrey31/colinas-inventario/blob/master/src/views/RegistroCambios.vue"
click node_reports_view "https://github.com/andrey31/colinas-inventario/blob/master/src/views/Reportes.vue"
click node_quantity_report "https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/InventarioPorCantidad.vue"
click node_consumption_report "https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/ReporteConsumos.vue"
click node_waste_report "https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/ReporteDesperdicios.vue"
click node_stock_report "https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/ReporteExistencias.vue"
click node_production_report "https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/ReporteProduccion.vue"
click node_report_logo "https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/logoBase64.js"

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_router,node_login,node_staff toneBlue
class node_warehouses,node_warehouse_modal,node_delete_modal,node_dua_modal,node_packing,node_transit_rolls,node_excel_intake,node_transfers,node_firebase_db,node_firebase_storage toneAmber
class node_inventory_view,node_inventory_index,node_waste,node_out_adjustment,node_history,node_leftovers,node_change_log toneMint
class node_reports_view,node_quantity_report,node_consumption_report,node_waste_report,node_stock_report,node_production_report,node_report_logo toneRose
class node_firebase_auth toneIndigo
```

## Components

### Access and navigation

- [Application shell](https://github.com/andrey31/colinas-inventario/blob/master/src/App.vue): `src/App.vue`
- [Routes and permissions](https://github.com/andrey31/colinas-inventario/blob/master/src/router.js): `src/router.js`
- [Sign in](https://github.com/andrey31/colinas-inventario/blob/master/src/views/Login.vue): `src/views/Login.vue`

### Warehouse operations

- [Warehouse stock](https://github.com/andrey31/colinas-inventario/blob/master/src/views/Almacenes.vue): `src/views/Almacenes.vue`
- [Edit warehouse roll](https://github.com/andrey31/colinas-inventario/blob/master/src/components/ModalAlmacenes.vue): `src/components/ModalAlmacenes.vue`
- [Delete warehouse](https://github.com/andrey31/colinas-inventario/blob/master/src/components/ModalDeleteAlmacen.vue): `src/components/ModalDeleteAlmacen.vue`
- [Warehouse DUA](https://github.com/andrey31/colinas-inventario/blob/master/src/components/ModalDuaAlmacen.vue): `src/components/ModalDuaAlmacen.vue`
- [Packing list](https://github.com/andrey31/colinas-inventario/blob/master/src/views/PackingList.vue): `src/views/PackingList.vue`
- [In-transit rolls](https://github.com/andrey31/colinas-inventario/blob/master/src/components/RollsInTransit.vue): `src/components/RollsInTransit.vue`
- [Excel intake](https://github.com/andrey31/colinas-inventario/blob/master/src/views/ReadExcel.vue): `src/views/ReadExcel.vue`
- [Stock transfers](https://github.com/andrey31/colinas-inventario/blob/master/src/views/Traslados.vue): `src/views/Traslados.vue`

### Inventory control

- [Inventory workspace](https://github.com/andrey31/colinas-inventario/blob/master/src/views/Inventario.vue): `src/views/Inventario.vue`
- [Inventory rolls](https://github.com/andrey31/colinas-inventario/blob/master/src/components/inventario/Index.vue): `src/components/inventario/Index.vue`
- [Daily waste](https://github.com/andrey31/colinas-inventario/blob/master/src/components/inventario/DesperdiciosDiarios.vue): `src/components/inventario/DesperdiciosDiarios.vue`
- [Stock-out adjustment](https://github.com/andrey31/colinas-inventario/blob/master/src/components/inventario/AjusteSalida.vue): `src/components/inventario/AjusteSalida.vue`
- [Inventory history](https://github.com/andrey31/colinas-inventario/blob/master/src/components/inventario/Historial.vue): `src/components/inventario/Historial.vue`
- [Inventory leftovers](https://github.com/andrey31/colinas-inventario/blob/master/src/components/inventario/Sobrantes.vue): `src/components/inventario/Sobrantes.vue`
- [Change register](https://github.com/andrey31/colinas-inventario/blob/master/src/views/RegistroCambios.vue): `src/views/RegistroCambios.vue`

### Operational reporting

- [Reports workspace](https://github.com/andrey31/colinas-inventario/blob/master/src/views/Reportes.vue): `src/views/Reportes.vue`
- [Inventory by quantity](https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/InventarioPorCantidad.vue): `src/components/reportes/InventarioPorCantidad.vue`
- [Consumption report](https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/ReporteConsumos.vue): `src/components/reportes/ReporteConsumos.vue`
- [Waste report](https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/ReporteDesperdicios.vue): `src/components/reportes/ReporteDesperdicios.vue`
- [Stock report](https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/ReporteExistencias.vue): `src/components/reportes/ReporteExistencias.vue`
- [Production report](https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/ReporteProduccion.vue): `src/components/reportes/ReporteProduccion.vue`
- [Report logo asset](https://github.com/andrey31/colinas-inventario/blob/master/src/components/reportes/logoBase64.js): `src/components/reportes/logoBase64.js`

### Other components

- **Staff user**
- **Firebase Auth**
- **Firebase Realtime DB**
- **Firebase Storage**

## Connections

- Staff user → Sign in: signs in
- Application shell → Routes and permissions: renders routes (evidence: `src/App.vue`)
- Routes and permissions → Sign in: routes to (evidence: `src/router.js`)
- Routes and permissions → Packing list: routes to (evidence: `src/router.js`)
- Routes and permissions → Excel intake: routes to (evidence: `src/router.js`)
- Routes and permissions → Inventory workspace: routes to (evidence: `src/router.js`)
- Routes and permissions → Stock transfers: routes to (evidence: `src/router.js`)
- Routes and permissions → Warehouse stock: routes to (evidence: `src/router.js`)
- Routes and permissions → Change register: routes to (evidence: `src/router.js`)
- Routes and permissions → Reports workspace: routes to (evidence: `src/router.js`)
- Sign in → Firebase Auth: authenticates with
- Routes and permissions → Firebase Auth: checks session (evidence: `src/router.js`)
- Warehouse stock → Edit warehouse roll: opens editor (evidence: `src/views/Almacenes.vue`)
- Warehouse stock → Delete warehouse: opens delete dialog (evidence: `src/views/Almacenes.vue`)
- Warehouse stock → Warehouse DUA: opens DUA dialog (evidence: `src/views/Almacenes.vue`)
- Packing list → In-transit rolls: displays rolls (evidence: `src/views/PackingList.vue`)
- Packing list → Edit warehouse roll: opens editor (evidence: `src/views/PackingList.vue`)
- Excel intake → Firebase Storage: uploads workbook (evidence: `src/views/ReadExcel.vue`)
- Excel intake → Firebase Realtime DB: writes order data (evidence: `src/views/ReadExcel.vue`)
- Edit warehouse roll → Firebase Realtime DB: writes roll data (evidence: `src/components/ModalAlmacenes.vue`)
- Inventory workspace → Inventory rolls: renders tab (evidence: `src/views/Inventario.vue`)
- Inventory workspace → Daily waste: renders tab (evidence: `src/views/Inventario.vue`)
- Inventory workspace → Stock-out adjustment: renders tab (evidence: `src/views/Inventario.vue`)
- Inventory workspace → Firebase Realtime DB: reads history (evidence: `src/views/Inventario.vue`)
- Inventory rolls → Firebase Realtime DB: updates stock (evidence: `src/components/inventario/Index.vue`)
- Reports workspace → Inventory by quantity: renders report (evidence: `src/views/Reportes.vue`)
- Reports workspace → Stock report: renders report (evidence: `src/views/Reportes.vue`)
- Reports workspace → Consumption report: renders report (evidence: `src/views/Reportes.vue`)
- Reports workspace → Waste report: renders report (evidence: `src/views/Reportes.vue`)
- Reports workspace → Production report: renders report (evidence: `src/views/Reportes.vue`)
- Consumption report → Report logo asset: uses image asset (evidence: `src/components/reportes/ReporteConsumos.vue`)
- Waste report → Report logo asset: uses image asset (evidence: `src/components/reportes/ReporteDesperdicios.vue`)
- Stock report → Report logo asset: uses image asset (evidence: `src/components/reportes/ReporteExistencias.vue`)
- Production report → Report logo asset: uses image asset (evidence: `src/components/reportes/ReporteProduccion.vue`)
