How kunapranavsai/personal-finance-dashboard works
Penny Pilot is a personal-finance web app whose main workflow is recording financial activity, storing it in the user’s Google Drive or device-local storage, and presenting it through dashboard, analytics, and reports. The README documents account security and a separate admin console as major capabilities. Some route-to-controller and frontend page-to-service wiring is not shown, so those links are omitted rather than inferred.
Main entry points: dataService.ts Drive collection data · page.tsx Finance workspace · api.ts API client · app.ts Express API
Components 24
Finance experience
- Finance workspace
frontend/src/app/(app)/dashboard/page.tsx - Mobile experience
frontend/src/components/mobile/MobileShell.tsx - Offline queue and PWA
frontend/src/lib/offlineQueue.ts - API client
frontend/src/lib/api.ts
Finance processing
- Express API
backend/src/app.ts - Finance endpoints
backend/src/routes/transactions.routes.ts - Transactions
backend/src/controllers/transactions.controller.ts - Budget planning
backend/src/controllers/budget.controller.ts - Dashboard metrics
backend/src/controllers/dashboard.controller.ts - Analytics and reports
frontend/src/lib/services/analyticsService.ts - Report exports
backend/src/services/export/index.ts
Data storage
- Drive collection data
backend/src/services/drive/dataService.ts - Google Drive access
backend/src/services/drive/googleDriveClient.ts - Drive workspace setup
backend/src/services/drive/init.ts - Drive storage provider
frontend/src/lib/storage/driveStorageProvider.ts - Local storage provider
frontend/src/lib/storage/localStorageProvider.ts - Browser data store
frontend/src/lib/storage/localDb.ts - Platform database
backend/src/lib/prisma.ts
Identity and security
- Authentication flows
backend/src/routes/auth.routes.ts - Session and access checks
backend/src/middleware/auth.ts
Platform operations
- Admin console API
backend/src/routes/admin.routes.ts - Automated email
backend/src/services/email/automation.ts - Outbound email
backend/src/lib/notify.ts
Other components
- Signed-in user
Connections 23
- Signed-in user → Finance workspace: uses
README.md - Finance workspace → API client: requests data
README.md - API client → Express API: calls over HTTP
README.md - Finance workspace → Mobile experience: renders mobile views
README.md - API client → Offline queue and PWA: queues offline work
- Express API → Authentication flows: mounts routes
backend/src/app.ts - Express API → Finance endpoints: mounts routes
backend/src/app.ts - Transactions → Drive collection data: reads and writes
backend/src/controllers/transactions.controller.ts - Budget planning → Drive collection data: reads and writes
backend/src/controllers/budget.controller.ts - Dashboard metrics → Drive collection data: reads data
backend/src/controllers/dashboard.controller.ts - Drive collection data → Google Drive access: reads Drive files
backend/src/services/drive/dataService.ts - Drive collection data → Drive storage provider: serves finance data
README.md - Drive storage provider → API client: calls API
frontend/src/lib/storage/driveStorageProvider.ts - Drive workspace setup → Google Drive access: creates workspace
backend/src/services/drive/init.ts - Local storage provider → Browser data store: reads and writes
frontend/src/lib/storage/localStorageProvider.ts - Authentication flows → Platform database: manages accounts
README.md - Authentication flows → Session and access checks: uses access checks
backend/src/routes/auth.routes.ts - Session and access checks → Platform database: checks sessions
backend/src/middleware/auth.ts - Finance workspace → Analytics and reports: requests analytics
- Analytics and reports → Report exports: exports reports
- Admin console API → Platform database: manages platform data
README.md - Admin console API → Automated email: configures email
backend/src/routes/admin.routes.ts - Automated email → Outbound email: sends messages
backend/src/services/email/automation.ts