How arsalanfarooq12/finance-agent works
FinanceAI is a personal-finance web app: users authenticate, then track expenses via chat or PDF statements, manage budgets, and review spending in a dashboard. The frontend calls an authenticated Express API; chat requests enter a LangGraph orchestrator that routes to expense, budget, advice, or general responses. Supabase provides authentication and persistent user data, while Google Gemini powers chat and documented embeddings. The graph follows the documented product capabilities and sampled call sites; unsampled upload and advice details are represented only where the README or source index supports them.
Main entry points: database.ts Data access · index.ts Express server · orchestrator.ts Intent orchestrator · api.ts API client
Components 29
User interface
- Landing page
frontend/src/pages/LandingPage.tsx - Sign-in and registration
frontend/src/pages/AuthPage.tsx - Auth session
frontend/src/contexts/AuthContext.tsx - Workspace shell
frontend/src/App.tsx - Streaming chat
frontend/src/components/Chat.tsx - Spending dashboard
frontend/src/components/Dashboard.tsx - Budget panel
frontend/src/components/BudgetPanel.tsx - Statement upload
frontend/src/components/PDFUpload.tsx - Upload wrapper
frontend/src/components/UploadStatement.tsx - API client
frontend/src/api.ts
API and security
- Express server
backend/src/index.ts - JWT verification
backend/src/middleware/verifyToken.ts - Chat endpoints
backend/src/routes/chat.ts - Expense endpoints
backend/src/routes/expenses.ts - Budget endpoints
backend/src/routes/budget.ts - PDF processing
backend/src/routes/upload.ts
Finance agent
- Intent orchestrator
backend/src/agent/orchestrator.ts - Expense agent
backend/src/agent/subgraphs/expenseAgent.ts - Budget agent
backend/src/agent/subgraphs/budgetAgent.ts - Advice agent
backend/src/agent/subgraphs/adviceAgent.ts - Budget status logic
backend/src/agent/budgetTools.ts - Model fallback
backend/src/agent/llm.ts - Financial knowledge base
backend/src/agent/knowledgeBase.ts
Persistence and AI
- Data access
backend/src/db/database.ts - Supabase service client
backend/src/lib/supabase.ts
Other components
- Finance user
- Supabase Auth
- Supabase database
- Google Gemini
Connections 42
- Finance user → Landing page: opens
- Finance user → Sign-in and registration: signs in
frontend/src/pages/AuthPage.tsx - Sign-in and registration → Auth session: requests auth
frontend/src/pages/AuthPage.tsx - Auth session → Supabase Auth: authenticates
frontend/src/contexts/AuthContext.tsx - Workspace shell → Auth session: checks session
frontend/src/App.tsx - Workspace shell → Streaming chat: renders
frontend/src/App.tsx - Workspace shell → Spending dashboard: renders
frontend/src/App.tsx - Spending dashboard → API client: loads and edits
frontend/src/components/Dashboard.tsx - Spending dashboard → Budget panel: renders
frontend/src/components/Dashboard.tsx - Spending dashboard → Upload wrapper: renders
frontend/src/components/Dashboard.tsx - Upload wrapper → Statement upload: renders
frontend/src/components/UploadStatement.tsx - Statement upload → API client: uploads statement
frontend/src/components/PDFUpload.tsx - Budget panel → API client: manages budgets
frontend/src/components/BudgetPanel.tsx - Streaming chat → API client: streams messages
frontend/src/components/Chat.tsx - API client → Express server: calls API
frontend/src/api.ts - Express server → Chat endpoints: routes chat
backend/src/index.ts - Express server → Expense endpoints: routes expenses
backend/src/index.ts - Express server → Budget endpoints: routes budgets
backend/src/index.ts - Express server → PDF processing: routes uploads
backend/src/index.ts - Express server → JWT verification: guards API
backend/src/index.ts - JWT verification → Supabase Auth: verifies token
backend/src/middleware/verifyToken.ts - Chat endpoints → Intent orchestrator: runs agent
backend/src/routes/chat.ts - Expense endpoints → Data access: reads and writes
backend/src/routes/expenses.ts - Budget endpoints → Data access: reads and writes
backend/src/routes/budget.ts - Intent orchestrator → Expense agent: dispatches
backend/src/agent/orchestrator.ts - Intent orchestrator → Budget agent: dispatches
backend/src/agent/orchestrator.ts - Intent orchestrator → Advice agent: dispatches
backend/src/agent/orchestrator.ts - Intent orchestrator → Model fallback: classifies and answers
backend/src/agent/orchestrator.ts - Intent orchestrator → Data access: loads and saves history
backend/src/agent/orchestrator.ts - Expense agent → Data access: manages expenses
backend/src/agent/subgraphs/expenseAgent.ts - Expense agent → Budget status logic: checks budgets
backend/src/agent/subgraphs/expenseAgent.ts - Budget agent → Data access: manages budgets
backend/src/agent/subgraphs/budgetAgent.ts - Advice agent → Financial knowledge base: uses guidance
backend/src/agent/subgraphs/adviceAgent.ts - Advice agent → Model fallback: generates advice
backend/src/agent/subgraphs/adviceAgent.ts - Expense agent → Model fallback: calls model
backend/src/agent/subgraphs/expenseAgent.ts - Budget agent → Model fallback: calls model
backend/src/agent/subgraphs/budgetAgent.ts - Data access → Supabase service client: queries through
backend/src/db/database.ts - Supabase service client → Supabase database: connects to
- Model fallback → Google Gemini: invokes models
- Financial knowledge base → Google Gemini: embeds documents
- API client → Supabase Auth: gets access token
frontend/src/api.ts - PDF processing → Data access: saves extracted expenses