How shreya-14-git/ledgerlens works
LedgerLens reconciles order, payment, and settlement records, surfaces exceptions, and supports investigation and transaction entry through a dashboard. The main path runs from CSV inputs through the reconciliation script to persisted results; the FastAPI service exposes those results and AI analysis to the React interface. The README also documents dashboard metrics, search/filtering, validation, persistent additions, and an audit trail. The frontend excerpt confirms API requests in places but omits most request-loading code, so only documented or directly evidenced connections are drawn; data files are represented as sources, not implementation modules.
Main entry points: main.py FastAPI service · reconcile.py Reconciliation engine · App.jsx Dashboard and forms · reconciliation_results.csv Reconciliation results
Components 15
Reconciliation
- Order records
data/orders.csv - Payment records
data/payments.csv - Settlement records
data/settlements.csv - Reconciliation engine
reconcile.py - Reconciliation results
data/reconciliation_results.csv
Investigation
- CLI investigation
investigate.py - Transaction analysis
ai_analysis.py - OpenAI connectivity probe
ai_agent.py
API and state
- FastAPI service
backend/main.py - Added transactions
data/new_transactions.json - Audit trail
backend/main.py
Dashboard
- Dashboard and forms
frontend/src/App.jsx - React app entry
frontend/src/main.jsx
Other components
- Finance operator
- Dashboard user
Connections 14
- Reconciliation engine → Order records: reads
reconcile.py - Reconciliation engine → Payment records: reads
reconcile.py - Reconciliation engine → Settlement records: reads
reconcile.py - Reconciliation engine → Reconciliation results: writes
reconcile.py - CLI investigation → Reconciliation results: reads
investigate.py - FastAPI service → Reconciliation results: reads
backend/main.py - FastAPI service → Added transactions: loads and saves
backend/main.py - FastAPI service → Transaction analysis: calls
backend/main.py - FastAPI service → Audit trail: records activity
backend/main.py - Dashboard user → Dashboard and forms: uses
- Dashboard and forms → FastAPI service: requests API
frontend/src/App.jsx - React app entry → Dashboard and forms: renders
frontend/src/main.jsx - Finance operator → CLI investigation: enters order ID
investigate.py - OpenAI connectivity probe → Finance operator: prints response
ai_agent.py