How janupoju-sudo/lpl-financial-hackathon works
Ledgerline is an AI-assisted back office for independent advisor practices. The main workflow runs from document and bill handling through approval and ledger posting, then surfaces financial statements, revenue reconciliation, Q&A, and export in the workspace. The README also describes onboarding, library search, vendor memory, CSV import, and Google Drive import. Backend excerpts show selected handlers and shared services; several documented capabilities have unsampled implementations, so their links are marked unverified rather than inferred as calls.
Main entry points: api.ts Typed API client · repo.py Entity repository · workspace.tsx Workspace · bills.py Bill decisions
Components 23
Practice workspace
- Workspace
frontend/components/workspace.tsx - Onboarding
frontend/components/onboarding/wizard.tsx - Landing experience
frontend/components/landing.tsx - Typed API client
frontend/lib/api.ts - Drive import
frontend/components/google-drive-import.tsx
Documents and bills
- Document ingestion
backend/src/ingest - Document handlers
backend/src/handlers/documents.py - Bill decisions
backend/src/handlers/bills.py - Approval rules
backend/src/shared/rules_engine.py - Bill workflow
backend/src/workflow - Transactions
backend/src/handlers/transactions.py
Financial insights
- Financial statements
backend/src/financials/api.py - Revenue reconciliation
backend/src/financials/reconciliation.py - Ask books
backend/src/ask/handler.py - Answer context
backend/src/ask/context.py - Bedrock model
backend/src/ask/bedrock.py - ZIP export
backend/src/export/handler.py
Backend services
- Entity repository
backend/src/shared/repo.py - Ledger services
backend/src/shared/ledger.py - DynamoDB access
backend/src/shared/ddb.py - Caller identity
backend/src/shared/auth.py - HTTP routing
backend/src/shared/http.py
Other components
- Practice team
Connections 29
- Practice team → Workspace: uses
README.md - Workspace → Onboarding: opens
frontend/components/workspace.tsx - Workspace → Landing experience: opens
frontend/components/workspace.tsx - Workspace → Typed API client: requests
- Workspace → Drive import: offers
frontend/components/workspace.tsx - Typed API client → Document handlers: calls API
README.md - Typed API client → Bill decisions: calls API
README.md - Typed API client → Financial statements: calls API
README.md - Typed API client → Revenue reconciliation: calls API
README.md - Typed API client → Ask books: calls API
README.md - Typed API client → ZIP export: calls API
README.md - Document ingestion → Entity repository: stores records
- Document handlers → Entity repository: reads and writes
- Bill decisions → Entity repository: reads and writes
backend/src/handlers/bills.py - Bill decisions → Approval rules: evaluates rules
- Bill decisions → Bill workflow: dispatches workflow
backend/src/handlers/bills.py - Bill decisions → Ledger services: posts entries
backend/src/handlers/bills.py - Transactions → Ledger services: updates ledger
- Financial statements → Revenue reconciliation: uses
- Financial statements → Answer context: summarizes books
- Ask books → Answer context: builds context
- Ask books → Bedrock model: invokes model
backend/src/ask/handler.py - Ask books → Entity repository: loads documents
backend/src/ask/handler.py - ZIP export → Financial statements: builds financials
backend/src/export/handler.py - ZIP export → Entity repository: lists documents
backend/src/export/handler.py - Financial statements → DynamoDB access: reads ledger
backend/src/financials/handler.py - Revenue reconciliation → DynamoDB access: reads revenue
backend/src/financials/handler.py - Entity repository → DynamoDB access: queries entities
backend/src/shared/repo.py - HTTP routing → Caller identity: routes requests
backend/src/shared/auth.py