How jackson254365/lumen-fintech-system works
Lumen is a local-first finance platform whose primary documented runtime is the Rust/Axum server: users submit finance operations through the API, which routes them to accounting, payments, statement ingestion, or research and persists state in SQLite. The Rust ledger and its audit chain form a key internal layer. The tree also contains a Node/Express implementation; it is represented as a parallel legacy backend, not assumed to be called by Rust. README capability descriptions support major features whose implementation details were not sampled; unsampled connections are omitted.
Main entry points: routes/mod.rs API handlers · statement_engine/mod.rs Statement ingestion · main.rs Axum server · core.rs Double-entry ledger
Components 21
User interface
- Web client
app.js - Research SDK
sdk/research_client.py
Rust API runtime
- Axum server
src/main.rs - API handlers
src/routes/mod.rs - Request middleware
src/middleware
Accounting core
- Double-entry ledger
src/ledger/core.rs - Audit chain
src/ledger/audit_chain.rs - Chart of accounts
src/ledger/chart_of_accounts.rs
Finance capabilities
- Statement ingestion
src/statement_engine/mod.rs - Statement parser
src/statement_engine/parser.rs - Statement deduplicator
src/statement_engine/deduplicator.rs - Transaction categorizer
src/statement_engine/categorizer.rs - Payment rails
src/rails - Finance research
src/research_engine
Persistence
- SQLite database
src/db.rs
Legacy Node backend
- Express server
server/index.js - Node SQLite adapter
server/db.js - Node ledger
server/ledger/ledger-core.js - Node payment routes
server/routes/rails.js - Crypto rail
server/rails/crypto.js
Other components
- Finance user
Connections 23
- Finance user → Web client: uses
README.md - Finance user → API handlers: requests
README.md - Web client → API handlers: calls API
- Research SDK → API handlers: queries research
- Axum server → SQLite database: initializes
src/main.rs - Axum server → API handlers: creates router
src/main.rs - Axum server → Request middleware: applies
src/main.rs - API handlers → SQLite database: queries and writes
src/routes/mod.rs - API handlers → Double-entry ledger: posts entries
README.md - Double-entry ledger → Audit chain: hashes entries
src/ledger/core.rs - API handlers → Chart of accounts: builds trial balance
src/routes/mod.rs - API handlers → Statement ingestion: imports statements
README.md - Statement ingestion → Statement parser: parses
src/statement_engine/mod.rs - Statement ingestion → Statement deduplicator: deduplicates
src/statement_engine/mod.rs - Statement ingestion → Transaction categorizer: categorizes
src/statement_engine/mod.rs - API handlers → Payment rails: dispatches payments
README.md - Payment rails → Double-entry ledger: records transactions
README.md - API handlers → Finance research: serves analysis
README.md - Express server → Node SQLite adapter: initializes
server/index.js - Express server → Node payment routes: mounts routes
server/index.js - Node payment routes → Crypto rail: dispatches to
server/routes/rails.js - Crypto rail → Node ledger: posts entries
server/rails/crypto.js - Node ledger → Node SQLite adapter: reads and writes
server/ledger/ledger-core.js