# josemariarava/sigel-cheques architecture

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

- Interactive diagram: https://gitdiagram.com/josemariarava/sigel-cheques
- Repository: https://github.com/josemariarava/sigel-cheques

## Overview

This is a local cheque-writing and printing application. A user enters cheque details, previews and positions fields, then prints a raster cheque; the browser loads and saves settings through the local Express server. The UI also supports batch printing, signatures, print calibration, printer status, and used-number/history tracking. These capabilities are represented where supported by the file tree and excerpts; some UI and server internals were only partially sampled, so uncertain links are omitted.

Main entry points: [`server.js`](https://github.com/josemariarava/sigel-cheques/blob/main/server.js) (HTTP API), [`js/40-ui.js`](https://github.com/josemariarava/sigel-cheques/blob/main/js/40-ui.js) (Cheque controls), [`js/50-init.js`](https://github.com/josemariarava/sigel-cheques/blob/main/js/50-init.js) (App startup), [`js/30-print.js`](https://github.com/josemariarava/sigel-cheques/blob/main/js/30-print.js) (Raster printing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Cheque workspace"]
  node_page["Cheque page<br/>[index.html]"]
  node_ui["Cheque controls<br/>[40-ui.js]"]
  node_init["App startup<br/>[50-init.js]"]
  node_core["UI state<br/>[00-core.js]"]
  node_format["Cheque formatting<br/>[10-format.js]"]
  node_render["Preview renderer<br/>[20-render.js]"]
  node_printclient["Raster printing<br/>[30-print.js]"]
end

subgraph group_server["Local server"]
  node_serverapi["HTTP API<br/>[server.js]"]
end

subgraph group_state["Local records"]
  node_config[("Settings<br/>[server.js]")]
  node_history[("Print history<br/>[server.js]")]
  node_numbers[("Used numbers<br/>[server.js]")]
end

subgraph group_output["Print output"]
  node_queue["Print queue<br/>[server.js]"]
  node_powershell["Windows print bridge<br/>[server.js]"]
end

node_user(("User"))
node_printer{{"Cheque printer"}}

node_user -->|"opens"| node_page
node_page -->|"loads app"| node_init
node_init -->|"loads settings"| node_serverapi
node_init -->|"sets state"| node_core
node_ui -->|"uses state"| node_core
node_ui -->|"formats fields"| node_format
node_ui -->|"renders preview"| node_render
node_ui -->|"requests printing"| node_printclient
node_printclient -->|"renders cheque"| node_render
node_printclient -->|"posts raster"| node_serverapi
node_ui -.->|"saves settings"| node_serverapi
node_serverapi -->|"reads and writes"| node_config
node_serverapi -->|"records prints"| node_history
node_serverapi -->|"checks and records"| node_numbers
node_serverapi -->|"queues jobs"| node_queue
node_queue -->|"runs print bridge"| node_powershell
node_powershell -->|"sends raster"| node_printer
node_serverapi -->|"checks status"| node_printer

click node_page "https://github.com/josemariarava/sigel-cheques/blob/main/index.html"
click node_ui "https://github.com/josemariarava/sigel-cheques/blob/main/js/40-ui.js"
click node_init "https://github.com/josemariarava/sigel-cheques/blob/main/js/50-init.js"
click node_core "https://github.com/josemariarava/sigel-cheques/blob/main/js/00-core.js"
click node_format "https://github.com/josemariarava/sigel-cheques/blob/main/js/10-format.js"
click node_render "https://github.com/josemariarava/sigel-cheques/blob/main/js/20-render.js"
click node_printclient "https://github.com/josemariarava/sigel-cheques/blob/main/js/30-print.js"
click node_serverapi "https://github.com/josemariarava/sigel-cheques/blob/main/server.js"
click node_config "https://github.com/josemariarava/sigel-cheques/blob/main/server.js"
click node_history "https://github.com/josemariarava/sigel-cheques/blob/main/server.js"
click node_numbers "https://github.com/josemariarava/sigel-cheques/blob/main/server.js"
click node_queue "https://github.com/josemariarava/sigel-cheques/blob/main/server.js"
click node_powershell "https://github.com/josemariarava/sigel-cheques/blob/main/server.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_page,node_ui,node_init,node_core,node_format,node_render,node_printclient,node_user toneBlue
class node_serverapi toneAmber
class node_config,node_history,node_numbers toneMint
class node_queue,node_powershell toneRose
class node_printer toneIndigo
```

## Components

### Cheque workspace

- [Cheque page](https://github.com/josemariarava/sigel-cheques/blob/main/index.html): `index.html`
- [Cheque controls](https://github.com/josemariarava/sigel-cheques/blob/main/js/40-ui.js): `js/40-ui.js`
- [App startup](https://github.com/josemariarava/sigel-cheques/blob/main/js/50-init.js): `js/50-init.js`
- [UI state](https://github.com/josemariarava/sigel-cheques/blob/main/js/00-core.js): `js/00-core.js`
- [Cheque formatting](https://github.com/josemariarava/sigel-cheques/blob/main/js/10-format.js): `js/10-format.js`
- [Preview renderer](https://github.com/josemariarava/sigel-cheques/blob/main/js/20-render.js): `js/20-render.js`
- [Raster printing](https://github.com/josemariarava/sigel-cheques/blob/main/js/30-print.js): `js/30-print.js`

### Local server

- [HTTP API](https://github.com/josemariarava/sigel-cheques/blob/main/server.js): `server.js`

### Local records

- [Settings](https://github.com/josemariarava/sigel-cheques/blob/main/server.js): `server.js`
- [Print history](https://github.com/josemariarava/sigel-cheques/blob/main/server.js): `server.js`
- [Used numbers](https://github.com/josemariarava/sigel-cheques/blob/main/server.js): `server.js`

### Print output

- [Print queue](https://github.com/josemariarava/sigel-cheques/blob/main/server.js): `server.js`
- [Windows print bridge](https://github.com/josemariarava/sigel-cheques/blob/main/server.js): `server.js`

### Other components

- **User**
- **Cheque printer**

## Connections

- User → Cheque page: opens
- Cheque page → App startup: loads app
- App startup → HTTP API: loads settings (evidence: `js/50-init.js`)
- App startup → UI state: sets state (evidence: `js/50-init.js`)
- Cheque controls → UI state: uses state (evidence: `js/40-ui.js`)
- Cheque controls → Cheque formatting: formats fields (evidence: `js/40-ui.js`)
- Cheque controls → Preview renderer: renders preview (evidence: `js/40-ui.js`)
- Cheque controls → Raster printing: requests printing (evidence: `js/40-ui.js`)
- Raster printing → Preview renderer: renders cheque (evidence: `js/30-print.js`)
- Raster printing → HTTP API: posts raster (evidence: `js/30-print.js`)
- Cheque controls → HTTP API: saves settings
- HTTP API → Settings: reads and writes (evidence: `server.js`)
- HTTP API → Print history: records prints (evidence: `server.js`)
- HTTP API → Used numbers: checks and records (evidence: `server.js`)
- HTTP API → Print queue: queues jobs (evidence: `server.js`)
- Print queue → Windows print bridge: runs print bridge (evidence: `server.js`)
- Windows print bridge → Cheque printer: sends raster
- HTTP API → Cheque printer: checks status (evidence: `server.js`)
