How fbkfriend/store-tracker works
My Sari-Sari Store is an offline-first Flutter app for neighborhood-store inventory, point-of-sale, customer credit (utang), and reporting. The principal workflow is selling stocked items, taking cash or partial payment, and recording any balance as customer credit; the app also tracks stock and preserves sales history. Separate branches cover inventory management, customer balances, reports and printable PDFs, plus local and optional Google Drive backups and device security. The excerpts contain no Dart source, so links between implementation components are limited to capabilities explicitly described in the README.
Main entry points: repositories Store data access · utang_screen.dart Customer credit · transaction_history_screen.dart Transaction history · cart_controller.dart Cart and payment
Components 23
App flow
- App entry
lib/main.dart - Startup and navigation
lib/features/shell
Store operations
- Point of sale
lib/features/pos/pos_screen.dart - Cart and payment
lib/features/pos/cart_controller.dart - Inventory management
lib/features/inventory/inventory_screen.dart - Category management
lib/features/inventory/category_manager.dart - Transaction history
lib/features/history/transaction_history_screen.dart - Customer credit
lib/features/utang/utang_screen.dart - Customer account history
lib/features/utang/customer_detail_screen.dart - Local store data
lib/data/app_database.dart - Store data access
lib/data/repositories
Reports and documents
- Dashboard and reports
lib/features/reports/reports_screen.dart - End-of-day report
lib/features/reports/end_of_day_report_screen.dart - Printable reports
lib/features/reports/pdf_reports.dart
Security and settings
- PIN and fingerprint
lib/core/security/pin_controller.dart - App settings
lib/features/settings/settings_screen.dart
Backup and restore
- Backup controls
lib/features/backup/backup_screen.dart - Backup and restore
lib/core/backup/backup_service.dart - Phone backup file
lib/core/backup/local_backup_file.dart - Automatic backups
lib/core/backup/auto_backup_service.dart - Google sign-in
lib/core/auth/google_auth_service.dart
Other components
- Store user
- Google Drive
Connections 24
- Store user → App entry: uses
- App entry → Startup and navigation: starts
- Store user → Point of sale: records sales
README.md - Point of sale → Cart and payment: adds items
- Cart and payment → Store data access: records sale
README.md - Cart and payment → Customer credit: records balance
README.md - Inventory management → Store data access: manages stock
README.md - Category management → Store data access: manages categories
README.md - Transaction history → Store data access: reads and voids sales
README.md - Transaction history → Inventory management: restores stock
README.md - Transaction history → Customer credit: reverses credit
README.md - Customer credit → Store data access: tracks balances
README.md - Customer account history → Customer credit: shows customer history
README.md - Store data access → Local store data: uses local data
README.md - Dashboard and reports → Store data access: summarizes store activity
README.md - End-of-day report → Store data access: reports a day
README.md - Printable reports → Inventory management: prints inventory lists
README.md - Store user → PIN and fingerprint: unlocks app
README.md - Store user → App settings: configures app
- Store user → Backup controls: manages backups
README.md - Backup controls → Backup and restore: requests backup or restore
- Backup and restore → Phone backup file: saves phone backup
README.md - Automatic backups → Google Drive: backs up daily
README.md - Google sign-in → Automatic backups: enables optional backups
README.md