# anubizaru/acc-app architecture

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

- Interactive diagram: https://gitdiagram.com/anubizaru/acc-app
- Repository: https://github.com/anubizaru/acc-app

## Overview

This repository implements a pawnshop account-management application: staff use a browser interface to manage pawned items, financial transactions, accounting entries, and reports. It includes a demo runtime and two backend options: Google Apps Script with Sheets, and a Cloudflare Worker with D1. The sampled frontend shows transaction actions, while backend excerpts show setup, authentication, and business operations. The README is empty, and unsampled runtime wiring is not assumed; dashed links mark unverified integration paths.

Main entry points: [`gas/backend.js`](https://github.com/anubizaru/acc-app/blob/main/gas/backend.js) (Apps Script backend), [`js/app.js`](https://github.com/anubizaru/acc-app/blob/main/js/app.js) (Application UI), [`js/api.js`](https://github.com/anubizaru/acc-app/blob/main/js/api.js) (API client), [`cloudflare/worker.js`](https://github.com/anubizaru/acc-app/blob/main/cloudflare/worker.js) (Cloudflare backend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser Application"]
  node_app["Application UI<br/>[app.js]"]
  node_api["API client<br/>[api.js]"]
  node_demo["Demo runtime<br/>[demo-engine.js]"]
end

subgraph group_domain["Pawnshop Operations"]
  node_business_rules["Business rules<br/>[logic.js]"]
  node_password_crypto["Password hashing<br/>[pbkdf2.js]"]
  node_pawn_records["Pawn records<br/>[backend.js]"]
  node_finance["Finance operations<br/>[backend.js]"]
  node_accounting_reports["Accounting and reports<br/>[backend.js]"]
  node_staff_admin["Staff and access<br/>[backend.js]"]
end

subgraph group_backends["Backend Options"]
  node_gas_backend["Apps Script backend<br/>[backend.js]"]
  node_worker_backend["Cloudflare backend<br/>[worker.js]"]
end

subgraph group_storage["Persistence"]
  node_sheets[("Google Sheets")]
  node_d1[("Cloudflare D1")]
end

node_staff(("Shop staff"))

node_staff -->|"uses"| node_app
node_app -.->|"requests data"| node_api
node_api -.->|"calls API"| node_gas_backend
node_api -.->|"calls API"| node_worker_backend
node_app -.->|"uses demo"| node_demo
node_gas_backend -.->|"reads and writes"| node_sheets
node_worker_backend -->|"uses database"| node_d1
node_gas_backend -.->|"routes operations"| node_pawn_records
node_gas_backend -.->|"routes operations"| node_finance
node_gas_backend -.->|"routes operations"| node_accounting_reports
node_gas_backend -.->|"routes operations"| node_staff_admin

click node_app "https://github.com/anubizaru/acc-app/blob/main/js/app.js"
click node_api "https://github.com/anubizaru/acc-app/blob/main/js/api.js"
click node_demo "https://github.com/anubizaru/acc-app/blob/main/js/demo-engine.js"
click node_business_rules "https://github.com/anubizaru/acc-app/blob/main/js/logic.js"
click node_password_crypto "https://github.com/anubizaru/acc-app/blob/main/js/pbkdf2.js"
click node_pawn_records "https://github.com/anubizaru/acc-app/blob/main/gas/backend.js"
click node_finance "https://github.com/anubizaru/acc-app/blob/main/gas/backend.js"
click node_accounting_reports "https://github.com/anubizaru/acc-app/blob/main/gas/backend.js"
click node_staff_admin "https://github.com/anubizaru/acc-app/blob/main/gas/backend.js"
click node_gas_backend "https://github.com/anubizaru/acc-app/blob/main/gas/backend.js"
click node_worker_backend "https://github.com/anubizaru/acc-app/blob/main/cloudflare/worker.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_api,node_demo toneBlue
class node_business_rules,node_password_crypto,node_pawn_records,node_finance,node_accounting_reports,node_staff_admin toneAmber
class node_gas_backend,node_worker_backend toneMint
class node_sheets,node_d1 toneRose
class node_staff toneIndigo
```

## Components

### Browser Application

- [Application UI](https://github.com/anubizaru/acc-app/blob/main/js/app.js): `js/app.js`
- [API client](https://github.com/anubizaru/acc-app/blob/main/js/api.js): `js/api.js`
- [Demo runtime](https://github.com/anubizaru/acc-app/blob/main/js/demo-engine.js): `js/demo-engine.js`

### Pawnshop Operations

- [Business rules](https://github.com/anubizaru/acc-app/blob/main/js/logic.js): `js/logic.js`
- [Password hashing](https://github.com/anubizaru/acc-app/blob/main/js/pbkdf2.js): `js/pbkdf2.js`
- [Pawn records](https://github.com/anubizaru/acc-app/blob/main/gas/backend.js): `gas/backend.js`
- [Finance operations](https://github.com/anubizaru/acc-app/blob/main/gas/backend.js): `gas/backend.js`
- [Accounting and reports](https://github.com/anubizaru/acc-app/blob/main/gas/backend.js): `gas/backend.js`
- [Staff and access](https://github.com/anubizaru/acc-app/blob/main/gas/backend.js): `gas/backend.js`

### Backend Options

- [Apps Script backend](https://github.com/anubizaru/acc-app/blob/main/gas/backend.js): `gas/backend.js`
- [Cloudflare backend](https://github.com/anubizaru/acc-app/blob/main/cloudflare/worker.js): `cloudflare/worker.js`

### Persistence

- **Google Sheets**
- **Cloudflare D1**

### Other components

- **Shop staff**

## Connections

- Shop staff → Application UI: uses (evidence: `js/app.js`)
- Application UI → API client: requests data
- API client → Apps Script backend: calls API
- API client → Cloudflare backend: calls API
- Application UI → Demo runtime: uses demo
- Apps Script backend → Google Sheets: reads and writes (evidence: `gas/backend.js`)
- Cloudflare backend → Cloudflare D1: uses database (evidence: `cloudflare/worker.js`)
- Apps Script backend → Pawn records: routes operations (evidence: `gas/backend.js`)
- Apps Script backend → Finance operations: routes operations (evidence: `gas/backend.js`)
- Apps Script backend → Accounting and reports: routes operations (evidence: `gas/backend.js`)
- Apps Script backend → Staff and access: routes operations (evidence: `gas/backend.js`)
