How solitarybear/pocketlog works
PocketLog is an offline desktop app for recording shared expenses and repayments, then showing balances and period reports. The user works through the Qt window and feature pages; those pages call a report/service layer that coordinates participant, expense, settlement and card operations over a local SQLite database. The graph also preserves exact-paise handling, dashboard/report filtering, card repayments, and shared UI presentation. Some feature implementations were not excerpted; their inclusion and limited links rely on README statements and the SOURCE INDEX, not claims of inspecting unsampled code.
Main entry points: reports.py Report service · main_window.py Navigation window · expenses.py Expense records · db.py SQLite database
Components 23
Desktop interface
- Application startup
pocketlog/app.py - Navigation window
pocketlog/ui/main_window.py - Expense editor and list
pocketlog/ui/expense_dialog.py - People and settings
pocketlog/ui/settings_page.py - Card activity
pocketlog/ui/cards_page.py - Dashboard
pocketlog/ui/dashboard_page.py - Balances
pocketlog/ui/balances_page.py - Reports
pocketlog/ui/reports_page.py - Settlements
pocketlog/ui/settlements_page.py - Period filter
pocketlog/ui/period_filter.py
Expense domain
- Participants
pocketlog/participants.py - Expense records
pocketlog/expenses.py - Settlement records
pocketlog/settlements.py - Cards and repayments
pocketlog/cards.py - Domain records
pocketlog/models.py - Exact-paise rules
pocketlog/money.py
Balances and reporting
- Report service
pocketlog/reports.py - Balance calculation
pocketlog/balances.py
Local data
- SQLite database
pocketlog/db.py - Data location
pocketlog/config.py
Shared UI and money
- Reusable widgets
pocketlog/ui/widgets.py - Light and dark themes
pocketlog/ui/theme.py
Other components
- Group member
Connections 34
- Group member → Application startup: launches
README.md - Application startup → Navigation window: opens
pocketlog/app.py - Application startup → Data location: resolves data path
pocketlog/app.py - Application startup → SQLite database: opens
pocketlog/app.py - Navigation window → Expense editor and list: shows
pocketlog/ui/main_window.py - Navigation window → People and settings: shows
pocketlog/ui/main_window.py - Navigation window → Card activity: shows
pocketlog/ui/main_window.py - Navigation window → Dashboard: shows
pocketlog/ui/main_window.py - Navigation window → Balances: shows
pocketlog/ui/main_window.py - Navigation window → Reports: shows
pocketlog/ui/main_window.py - Navigation window → Settlements: shows
pocketlog/ui/main_window.py - Expense editor and list → Expense records: saves expenses
pocketlog/ui/expense_dialog.py - People and settings → Participants: manages people
pocketlog/ui/settings_page.py - Card activity → Cards and repayments: records repayments
README.md - Dashboard → Report service: requests summaries
pocketlog/ui/dashboard_page.py - Balances → Report service: requests balances
pocketlog/ui/balances_page.py - Reports → Report service: requests reports
pocketlog/ui/reports_page.py - Settlements → Report service: requests settlement data
pocketlog/ui/settlements_page.py - Period filter → Report service: resolves periods
pocketlog/ui/period_filter.py - Report service → Participants: reads participants
pocketlog/reports.py - Report service → Expense records: queries expenses
pocketlog/reports.py - Report service → Settlement records: queries settlements
pocketlog/reports.py - Report service → Cards and repayments: queries card activity
pocketlog/reports.py - Report service → Balance calculation: builds balances
pocketlog/reports.py - Participants → SQLite database: reads and writes
pocketlog/participants.py - Expense records → SQLite database: reads and writes
pocketlog/expenses.py - Settlement records → SQLite database: reads and writes
pocketlog/settlements.py - Cards and repayments → SQLite database: reads and writes
pocketlog/cards.py - Expense records → Exact-paise rules: validates splits
pocketlog/expenses.py - Expense editor and list → Exact-paise rules: computes split
pocketlog/ui/expense_dialog.py - Report service → Domain records: builds report records
pocketlog/reports.py - Expense records → Domain records: returns expense records
pocketlog/expenses.py - Navigation window → Reusable widgets: uses components
pocketlog/ui/main_window.py - Reusable widgets → Light and dark themes: uses styles
pocketlog/ui/widgets.py