How bres777/stock-ledger-sim works
stock-ledger is a small Node.js command-line inventory ledger. A user invokes a command through the executable; the CLI dispatches movements, item settings, reports, or CSV import. Movements are appended to a JSONL ledger and settings to a separate JSONL file. CSV import parses and validates rows, then submits eligible movements to the ledger; reports combine ledger quantities with item settings. The graph follows documented commands and sampled call sites; unsampled implementation details are omitted.
Main entry points: cli.js Command dispatcher · import.js Import processor · items.js Item settings · ledger.js Movement ledger
Components 12
Command entry
- CLI executable
bin/stock-ledger.js - Command dispatcher
src/cli.js
Inventory records
- Movement ledger
src/ledger.js - Movement JSONL
src/ledger.js - Item settings
src/items.js - Settings JSONL
src/items.js
CSV import
- CSV file
- CSV parser
src/csv.js - Import processor
src/import.js - Rejects CSV
Reports
- Stock reports
src/reports.js
Other components
- User
Connections 16
- User → CLI executable: runs command
README.md - CLI executable → Command dispatcher: calls run
bin/stock-ledger.js - Command dispatcher → Movement ledger: records and reads
src/cli.js - Movement ledger → Movement JSONL: reads and appends
src/ledger.js - Command dispatcher → Item settings: sets and reads
src/cli.js - Item settings → Movement ledger: uses lock and validation
src/items.js - Item settings → Settings JSONL: reads and appends
src/items.js - Command dispatcher → Stock reports: requests report
src/cli.js - Stock reports → Item settings: uses price helpers
src/reports.js - Command dispatcher → Import processor: starts import
src/cli.js - Command dispatcher → CSV file: passes file path
src/cli.js - Import processor → CSV file: reads file
src/import.js - Import processor → CSV parser: parses text
src/import.js - Import processor → Movement ledger: records movements
src/import.js - Import processor → Rejects CSV: writes rejected rows
README.md - Command dispatcher → Stock reports: passes quantities and settings
src/cli.js