How kirubakaran83/expense_tracker works
AI Finance Tracker is a Django personal-finance application. Users manage transactions and budgets, then view summaries, charts, alerts, and financial-health insights; they can also use AI chat and voice-assisted transaction entry. The graph preserves documented capabilities such as recurring entries, PDF reports, and PWA support. Some implementation details are unsampled, so those branches rely on README documentation and are shown only where the relationship is explicit.
Main entry points: views.py Finance dashboard · models.py Transactions & budgets · services.py Summaries & snapshots · chat_engine.py Finance chatbot
Components 22
Accounts & Access
- Registration & profile
accounts/views.py - User profiles
accounts/models.py
Finance Records
- Finance dashboard
transactions/views.py - Transactions & budgets
transactions/models.py - Recurring entries
transactions/management/commands/run_recurring.py
Analytics & Budgets
- Summaries & snapshots
insights/services.py - Budget alerts
insights/budget_alerts.py - Budget progress
insights/budget_progress.py - Budget suggestions
insights/budget_suggest.py - Financial health
insights/health_score.py - Month comparison
insights/month_compare.py - Charts
insights/charts.py - Insight snapshots
insights/models.py
AI & Capture
- Finance chatbot
insights/chat_engine.py - Transaction classifier
insights/ai_engine.py - Transaction text parser
insights/transaction_parser.py - Voice entry
insights/voice_service.py
Reports & App
- Monthly PDF report
transactions/pdf.py - Offline PWA support
static/service-worker.js
Other components
- Finance user
- Groq AI service
- Ollama / OpenAI
Connections 26
- Finance user → Registration & profile: registers
accounts/views.py - Finance user → Finance dashboard: manages finances
README.md - Finance dashboard → Transactions & budgets: reads and writes
transactions/views.py - Transactions & budgets → Transaction classifier: classifies descriptions
transactions/models.py - Recurring entries → Transactions & budgets: creates entries
transactions/management/commands/run_recurring.py - Finance dashboard → Summaries & snapshots: requests summaries
transactions/views.py - Summaries & snapshots → Transactions & budgets: aggregates records
insights/services.py - Summaries & snapshots → Insight snapshots: updates snapshots
insights/services.py - Summaries & snapshots → Budget alerts: generates alerts
insights/services.py - Budget alerts → Transactions & budgets: checks spending
insights/budget_alerts.py - Finance dashboard → Budget progress: requests progress
transactions/views.py - Finance dashboard → Budget suggestions: requests suggestions
transactions/views.py - Finance dashboard → Financial health: requests health score
transactions/views.py - Finance dashboard → Month comparison: requests comparison
transactions/views.py - Finance dashboard → Charts: serves chart data
- Finance user → Finance chatbot: asks questions
README.md - Finance dashboard → Finance chatbot: dispatches chat
transactions/views.py - Finance chatbot → Transactions & budgets: builds financial context
insights/chat_engine.py - Finance chatbot → Groq AI service: requests completions
insights/chat_engine.py - Transaction classifier → Groq AI service: classifies with LLM
insights/ai_engine.py - Finance dashboard → Transaction text parser: parses entry text
transactions/views.py - Finance dashboard → Voice entry: handles voice entry
- Finance user → Monthly PDF report: downloads report
README.md - Monthly PDF report → Summaries & snapshots: gets monthly summary
transactions/pdf.py - Finance user → Offline PWA support: installs app
README.md - Transaction classifier → Ollama / OpenAI: may use alternate AI
README.md