# lusdrey523/semaforo architecture

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

- Interactive diagram: https://gitdiagram.com/lusdrey523/semaforo
- Repository: https://github.com/lusdrey523/semaforo

## Overview

Semáforo is a standalone, offline-first inventory and cash-control panel for a temporary resale operation. The documented workflow is to record a cash close, estimate units sold from stock differences, and review updated stock and period totals; receipts store confirmed details and a Drive link. The README describes localStorage persistence and CSV/text export. Only README relationships are shown: no source excerpts were available to verify screen-level calls or internal implementation boundaries.

Main entry points: [`index.html`](https://github.com/lusdrey523/semaforo/blob/main/index.html) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_operator(("Luis / operator"))
node_dashboard["Dashboard<br/>[index.html]"]
node_closure["Cash close<br/>[index.html]"]
node_inventory["Inventory view<br/>[index.html]"]
node_receipts["Receipts<br/>[index.html]"]
node_summary["Period summary<br/>[index.html]"]
node_browser_store[("Browser localStorage")]
node_drive[("Google Drive")]
node_csv_text["CSV / text export"]

node_operator -->|"opens panel"| node_dashboard
node_dashboard -->|"starts new close"| node_closure
node_operator -->|"records close"| node_closure
node_operator -->|"checks stock"| node_inventory
node_operator -->|"records receipt"| node_receipts
node_operator -->|"reviews totals"| node_summary
node_dashboard -->|"uses saved data"| node_browser_store
node_closure -->|"saves panel data"| node_browser_store
node_receipts -->|"saves receipt details"| node_browser_store
node_operator -->|"stores photos"| node_drive
node_summary -->|"exports totals"| node_csv_text

click node_dashboard "https://github.com/lusdrey523/semaforo/blob/main/index.html"
click node_closure "https://github.com/lusdrey523/semaforo/blob/main/index.html"
click node_inventory "https://github.com/lusdrey523/semaforo/blob/main/index.html"
click node_receipts "https://github.com/lusdrey523/semaforo/blob/main/index.html"
click node_summary "https://github.com/lusdrey523/semaforo/blob/main/index.html"

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_operator,node_csv_text toneIndigo
class node_dashboard,node_closure,node_receipts,node_summary toneTeal
class node_inventory toneBlue
class node_browser_store,node_drive toneAmber
```

## Components

### Other components

- **Luis / operator**
- [Dashboard](https://github.com/lusdrey523/semaforo/blob/main/index.html): `index.html`
- [Cash close](https://github.com/lusdrey523/semaforo/blob/main/index.html): `index.html`
- [Inventory view](https://github.com/lusdrey523/semaforo/blob/main/index.html): `index.html`
- [Receipts](https://github.com/lusdrey523/semaforo/blob/main/index.html): `index.html`
- [Period summary](https://github.com/lusdrey523/semaforo/blob/main/index.html): `index.html`
- **Browser localStorage**
- **Google Drive**
- **CSV / text export**

## Connections

- Luis / operator → Dashboard: opens panel (evidence: `README.md`)
- Dashboard → Cash close: starts new close (evidence: `README.md`)
- Luis / operator → Cash close: records close (evidence: `README.md`)
- Luis / operator → Inventory view: checks stock (evidence: `README.md`)
- Luis / operator → Receipts: records receipt (evidence: `README.md`)
- Luis / operator → Period summary: reviews totals (evidence: `README.md`)
- Dashboard → Browser localStorage: uses saved data (evidence: `README.md`)
- Cash close → Browser localStorage: saves panel data (evidence: `README.md`)
- Receipts → Browser localStorage: saves receipt details (evidence: `README.md`)
- Luis / operator → Google Drive: stores photos (evidence: `README.md`)
- Period summary → CSV / text export: exports totals (evidence: `README.md`)
