# mellowmir94/bateriku-finance-ledger architecture

> Architecture diagram of the GitHub repository mellowmir94/bateriku-finance-ledger, 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/mellowmir94/bateriku-finance-ledger
- Repository: https://github.com/mellowmir94/bateriku-finance-ledger

## Overview

Bateriku Finance Ledger is a standalone finance dashboard served by a Cloudflare Worker. Finance users work with commission and rider deductions, review History and payment statements, manage PERKESO defaults and job/booking records, and view finance dashboards. The Worker mediates dashboard and API requests, while Durable Object-backed deduction workflows and booking/source handlers manage records; Grafana and R2 support live data and backups. README documents several frontend capabilities whose implementation files are named in the tree but were not excerpted, so those branches are represented without inferred call links.

Main entry points: [`cloudflare/src/deductions.js`](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/deductions.js) (Deduction register API), [`cloudflare/src/data-source.js`](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/data-source.js) (Weekly data source), [`cloudflare/src/worker.js`](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/worker.js) (Cloudflare Worker), [`cloudflare/src/payment-formula.js`](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/payment-formula.js) (Payment formulas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Finance workflows"]
  node_commission["Commission Rider"]
  node_deduction_ui["Deduction workflows<br/>[deductions.js]"]
  node_history_ui["History workflow"]
  node_statements["Rider statements<br/>[rider-statement.js]"]
  node_additional_jobs["Additional Jobs<br/>[additional-jobs.js]"]
  node_booking_jobs["Booking Jobs<br/>[booking-jobs.js]"]
  node_audit_templates["Audit templates<br/>[audit-templates.js]"]
  node_finance_dashboards["Finance dashboards"]
end

subgraph group_api["Worker API"]
  node_worker["Cloudflare Worker<br/>[worker.js]"]
  node_concurrency["Concurrency and layout<br/>[concurrency.js]"]
end

subgraph group_records["Ledger records"]
  node_deduction_api["Deduction register API<br/>[deductions.js]"]
  node_booking_api["Booking records API<br/>[bookings.js]"]
end

subgraph group_support["Data and safeguards"]
  node_source_api["Weekly data source<br/>[data-source.js]"]
  node_formula["Payment formulas<br/>[payment-formula.js]"]
  node_perkeso["PERKESO defaults<br/>[perkeso-default.js]"]
  node_currency["Currency validation"]
  node_verification["Commission verification"]
  node_backup["Deduction backups"]
end

node_finance_user(("Finance user"))
node_grafana["Grafana finance service"]
node_r2[("R2 backup storage")]

node_finance_user -->|"uses"| node_commission
node_finance_user -->|"uses"| node_deduction_ui
node_finance_user -->|"reviews"| node_history_ui
node_finance_user -->|"exports"| node_statements
node_finance_user -->|"manages"| node_additional_jobs
node_finance_user -->|"manages"| node_booking_jobs
node_finance_user -->|"views"| node_finance_dashboards
node_worker -->|"routes to"| node_deduction_api
node_worker -->|"routes to"| node_booking_api
node_worker -->|"routes to"| node_source_api
node_worker -->|"dispatches"| node_concurrency
node_deduction_api -->|"delegates to"| node_booking_api
node_deduction_api -->|"delegates to"| node_source_api
node_deduction_api -->|"saves via"| node_formula
node_deduction_api -->|"saves via"| node_perkeso
node_deduction_api -->|"verifies with"| node_verification
node_deduction_api -->|"snapshots via"| node_backup
node_source_api -->|"snapshots via"| node_backup
node_formula -->|"validates via"| node_currency
node_perkeso -->|"validates via"| node_currency
node_verification -->|"fetches data"| node_grafana
node_source_api -->|"fetches data"| node_grafana
node_source_api -->|"reads and writes"| node_r2

click node_commission "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/commission-kpi-comparison.js"
click node_deduction_ui "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/deductions.js"
click node_history_ui "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/history-workflow-ui.js"
click node_statements "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/rider-statement.js"
click node_additional_jobs "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/additional-jobs.js"
click node_booking_jobs "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/booking-jobs.js"
click node_audit_templates "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/audit-templates.js"
click node_finance_dashboards "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/recharts-bridge.jsx"
click node_worker "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/worker.js"
click node_deduction_api "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/deductions.js"
click node_booking_api "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/bookings.js"
click node_source_api "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/data-source.js"
click node_formula "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/payment-formula.js"
click node_perkeso "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/perkeso-default.js"
click node_currency "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/deduction-currency.js"
click node_verification "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/deduction-verification.js"
click node_backup "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/deduction-backup.js"
click node_concurrency "https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/concurrency.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_commission,node_deduction_ui,node_history_ui,node_statements,node_additional_jobs,node_booking_jobs,node_audit_templates,node_finance_dashboards,node_finance_user toneBlue
class node_worker,node_concurrency,node_r2 toneAmber
class node_deduction_api,node_booking_api toneMint
class node_source_api,node_formula,node_perkeso,node_currency,node_verification,node_backup toneRose
class node_grafana toneIndigo
```

## Components

### Finance workflows

- [Commission Rider](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/commission-kpi-comparison.js): `commission-kpi-comparison.js`
- [Deduction workflows](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/deductions.js): `deductions.js`
- [History workflow](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/history-workflow-ui.js): `history-workflow-ui.js`
- [Rider statements](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/rider-statement.js): `rider-statement.js`
- [Additional Jobs](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/additional-jobs.js): `additional-jobs.js`
- [Booking Jobs](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/booking-jobs.js): `booking-jobs.js`
- [Audit templates](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/audit-templates.js): `audit-templates.js`
- [Finance dashboards](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/recharts-bridge.jsx): `recharts-bridge.jsx`

### Worker API

- [Cloudflare Worker](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/worker.js): `cloudflare/src/worker.js`
- [Concurrency and layout](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/concurrency.js): `cloudflare/src/concurrency.js`

### Ledger records

- [Deduction register API](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/deductions.js): `cloudflare/src/deductions.js`
- [Booking records API](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/bookings.js): `cloudflare/src/bookings.js`

### Data and safeguards

- [Weekly data source](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/data-source.js): `cloudflare/src/data-source.js`
- [Payment formulas](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/payment-formula.js): `cloudflare/src/payment-formula.js`
- [PERKESO defaults](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/perkeso-default.js): `cloudflare/src/perkeso-default.js`
- [Currency validation](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/deduction-currency.js): `cloudflare/src/deduction-currency.js`
- [Commission verification](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/deduction-verification.js): `cloudflare/src/deduction-verification.js`
- [Deduction backups](https://github.com/mellowmir94/bateriku-finance-ledger/blob/main/cloudflare/src/deduction-backup.js): `cloudflare/src/deduction-backup.js`

### Other components

- **Finance user**
- **Grafana finance service**
- **R2 backup storage**

## Connections

- Finance user → Commission Rider: uses (evidence: `README.md`)
- Finance user → Deduction workflows: uses (evidence: `README.md`)
- Finance user → History workflow: reviews (evidence: `README.md`)
- Finance user → Rider statements: exports (evidence: `README.md`)
- Finance user → Additional Jobs: manages (evidence: `README.md`)
- Finance user → Booking Jobs: manages (evidence: `README.md`)
- Finance user → Finance dashboards: views (evidence: `README.md`)
- Cloudflare Worker → Deduction register API: routes to (evidence: `cloudflare/src/worker.js`)
- Cloudflare Worker → Booking records API: routes to (evidence: `cloudflare/src/worker.js`)
- Cloudflare Worker → Weekly data source: routes to (evidence: `cloudflare/src/worker.js`)
- Cloudflare Worker → Concurrency and layout: dispatches (evidence: `cloudflare/src/worker.js`)
- Deduction register API → Booking records API: delegates to (evidence: `cloudflare/src/deductions.js`)
- Deduction register API → Weekly data source: delegates to (evidence: `cloudflare/src/deductions.js`)
- Deduction register API → Payment formulas: saves via (evidence: `cloudflare/src/deductions.js`)
- Deduction register API → PERKESO defaults: saves via (evidence: `cloudflare/src/deductions.js`)
- Deduction register API → Commission verification: verifies with (evidence: `cloudflare/src/deductions.js`)
- Deduction register API → Deduction backups: snapshots via (evidence: `cloudflare/src/deductions.js`)
- Weekly data source → Deduction backups: snapshots via (evidence: `cloudflare/src/data-source.js`)
- Payment formulas → Currency validation: validates via (evidence: `cloudflare/src/payment-formula.js`)
- PERKESO defaults → Currency validation: validates via (evidence: `cloudflare/src/perkeso-default.js`)
- Commission verification → Grafana finance service: fetches data (evidence: `cloudflare/src/deduction-verification.js`)
- Weekly data source → Grafana finance service: fetches data (evidence: `cloudflare/src/data-source.js`)
- Weekly data source → R2 backup storage: reads and writes (evidence: `cloudflare/src/data-source.js`)
