# cybarvickz/cridosales architecture

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

- Interactive diagram: https://gitdiagram.com/cybarvickz/cridosales
- Repository: https://github.com/cybarvickz/cridosales

## Overview

CridoSales is a browser-based sales and debt manager. Users record cash or credit sales, review today’s sales and customer balances, and record payments against outstanding debt. The app computes summaries and persists sales and payments in browser local storage. The graph groups responsibilities implemented within the single sampled runtime file; the HTML and CSS were not sampled, so UI wiring is not asserted.

Main entry points: [`app.js`](https://github.com/cybarvickz/cridosales/blob/main/app.js) (Render views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sales["Sales"]
  node_sale_entry["Record sale<br/>[app.js]"]
  node_daily_sales["Today’s sales<br/>[app.js]"]
  node_summary["Sales summary<br/>[app.js]"]
end

subgraph group_debts["Debts and payments"]
  node_balance["Customer balances<br/>[app.js]"]
  node_debtors["Debtor list<br/>[app.js]"]
  node_payment["Record payment<br/>[app.js]"]
end

subgraph group_runtime["Rendering and storage"]
  node_render["Render views<br/>[app.js]"]
  node_storage[("Browser local storage")]
end

node_user(("Shop user"))

node_user -.->|"records sales"| node_sale_entry
node_sale_entry -->|"saves data"| node_storage
node_payment -->|"checks balance"| node_balance
node_payment -->|"saves data"| node_storage
node_debtors -->|"calculates balances"| node_balance
node_summary -->|"calculates balances"| node_balance
node_render -->|"renders"| node_daily_sales
node_render -->|"renders"| node_debtors
node_render -->|"renders"| node_summary

click node_sale_entry "https://github.com/cybarvickz/cridosales/blob/main/app.js"
click node_daily_sales "https://github.com/cybarvickz/cridosales/blob/main/app.js"
click node_balance "https://github.com/cybarvickz/cridosales/blob/main/app.js"
click node_debtors "https://github.com/cybarvickz/cridosales/blob/main/app.js"
click node_payment "https://github.com/cybarvickz/cridosales/blob/main/app.js"
click node_summary "https://github.com/cybarvickz/cridosales/blob/main/app.js"
click node_render "https://github.com/cybarvickz/cridosales/blob/main/app.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_sale_entry,node_daily_sales,node_summary,node_user toneBlue
class node_balance,node_debtors,node_payment toneAmber
class node_render,node_storage toneMint
```

## Components

### Sales

- [Record sale](https://github.com/cybarvickz/cridosales/blob/main/app.js): `app.js`
- [Today’s sales](https://github.com/cybarvickz/cridosales/blob/main/app.js): `app.js`
- [Sales summary](https://github.com/cybarvickz/cridosales/blob/main/app.js): `app.js`

### Debts and payments

- [Customer balances](https://github.com/cybarvickz/cridosales/blob/main/app.js): `app.js`
- [Debtor list](https://github.com/cybarvickz/cridosales/blob/main/app.js): `app.js`
- [Record payment](https://github.com/cybarvickz/cridosales/blob/main/app.js): `app.js`

### Rendering and storage

- [Render views](https://github.com/cybarvickz/cridosales/blob/main/app.js): `app.js`
- **Browser local storage**

### Other components

- **Shop user**

## Connections

- Shop user → Record sale: records sales
- Record sale → Browser local storage: saves data (evidence: `app.js`)
- Record payment → Customer balances: checks balance (evidence: `app.js`)
- Record payment → Browser local storage: saves data (evidence: `app.js`)
- Debtor list → Customer balances: calculates balances (evidence: `app.js`)
- Sales summary → Customer balances: calculates balances (evidence: `app.js`)
- Render views → Today’s sales: renders (evidence: `app.js`)
- Render views → Debtor list: renders (evidence: `app.js`)
- Render views → Sales summary: renders (evidence: `app.js`)
