How anto-sujin/ai-financial-chatbot works
Personal Finance Assistant serves authenticated browser and Android users: sign in, manage transactions and financial plans, review insights, or ask the assistant to perform natural-language actions. The Flask application routes requests to domain services backed by Firestore; chat interprets requests with Groq and dispatches tools. The browser provides feature pages and SMS parsing, while Android hosts the site and forwards SMS. README documents reports and analytics alongside budgets, bills, goals, and transactions. Connections for unsampled feature pages are shown only where documented or indexed; the legacy Node backend is excluded as superseded.
Main entry points: app.py Flask routes · firebase_client.py Firebase client · expense_service.py Transactions · tools.py Assistant tools
Components 26
User interfaces
- Finance web UI
public/shared.js - Finance pages
public - SMS parsing
public/sms_parser.js - Android WebView
ai_mobile/app/src/main/java/com/financeai/mobile/MainActivity.kt - Mobile settings
ai_mobile/app/src/main/java/com/financeai/mobile/SettingsStore.kt - SMS bridge
ai_mobile/app/src/main/java/com/financeai/mobile/FinanceAiJavascriptBridge.kt - SMS receiver
ai_mobile/app/src/main/java/com/financeai/mobile/SmsReceiver.kt
Flask application
- Flask routes
finance_app/app.py - Token verification
finance_app/auth.py
Finance domains
- Transactions
finance_app/expense_service.py - Analytics
finance_app/analytics_service.py - Reports
finance_app/report_service.py - Budgets
finance_app/budget_service.py - Bills
finance_app/bill_service.py - Savings goals
finance_app/goal_service.py - Date utilities
finance_app/date_utils.py
Assistant runtime
- Chat orchestration
finance_app/chat_service.py - Assistant tools
finance_app/tools.py - Conversation state
finance_app/chat_state_service.py - Assistant prompt
finance_app/system_prompt.py - Groq API
Identity and storage
- Firebase client
finance_app/firebase_client.py - Firestore
- Firebase Authentication
Other components
- Finance user
- Flask service
Connections 45
- Finance user → Finance web UI: uses
README.md - Finance user → Android WebView: uses
README.md - Android WebView → Mobile settings: loads settings
ai_mobile/app/src/main/java/com/financeai/mobile/MainActivity.kt - Android WebView → SMS bridge: exposes bridge
ai_mobile/app/src/main/java/com/financeai/mobile/MainActivity.kt - SMS receiver → Android WebView: forwards SMS
ai_mobile/app/src/main/java/com/financeai/mobile/SmsReceiver.kt - SMS bridge → SMS parsing: delivers SMS
README.md - Finance web UI → Finance pages: supports pages
public/shared.js - Finance pages → Flask routes: calls API
- SMS parsing → Flask routes: posts transactions
README.md - Android WebView → Flask service: loads web app
README.md - Flask service → Flask routes: serves app
README.md - Flask routes → Token verification: protects routes
finance_app/app.py - Token verification → Firebase client: verifies token
finance_app/auth.py - Firebase client → Firebase Authentication: uses Admin SDK
finance_app/firebase_client.py - Flask routes → Chat orchestration: routes chat
finance_app/app.py - Flask routes → Transactions: routes transactions
finance_app/app.py - Flask routes → Analytics: routes analytics
finance_app/app.py - Flask routes → Reports: routes reports
finance_app/app.py - Flask routes → Budgets: routes budgets
finance_app/app.py - Flask routes → Bills: routes bills
finance_app/app.py - Flask routes → Savings goals: routes goals
finance_app/app.py - Chat orchestration → Assistant tools: dispatches tools
finance_app/chat_service.py - Chat orchestration → Conversation state: reads state
finance_app/chat_service.py - Chat orchestration → Assistant prompt: uses prompt
finance_app/chat_service.py - Chat orchestration → Groq API: requests completion
README.md - Assistant tools → Transactions: calls transaction actions
finance_app/tools.py - Assistant tools → Analytics: calls analytics
finance_app/tools.py - Assistant tools → Budgets: calls budget actions
finance_app/tools.py - Assistant tools → Bills: calls bill actions
finance_app/tools.py - Assistant tools → Savings goals: calls goal actions
finance_app/tools.py - Analytics → Transactions: reads transactions
finance_app/analytics_service.py - Reports → Analytics: uses analytics
finance_app/report_service.py - Reports → Budgets: uses budgets
finance_app/report_service.py - Budgets → Transactions: reads transactions
finance_app/budget_service.py - Bills → Transactions: creates transaction
finance_app/bill_service.py - Transactions → Date utilities: resolves dates
finance_app/expense_service.py - Bills → Date utilities: resolves dates
finance_app/bill_service.py - Budgets → Date utilities: uses date windows
finance_app/budget_service.py - Savings goals → Date utilities: resolves dates
finance_app/goal_service.py - Transactions → Firebase client: gets database
finance_app/expense_service.py - Budgets → Firebase client: gets database
finance_app/budget_service.py - Bills → Firebase client: gets database
finance_app/bill_service.py - Savings goals → Firebase client: gets database
finance_app/goal_service.py - Conversation state → Firebase client: gets database
finance_app/chat_state_service.py - Firebase client → Firestore: opens client
finance_app/firebase_client.py