How jpaulovaz/cartoes-jp-app works
OrganizaPay is a financial-management web app and installable PWA centered on organizing card spending by monthly statement period, importing or entering transactions, splitting expenses, and following shared repayments. Its documented backend layers routes, controllers, services, and SQLite repositories; the README also describes sharing, messaging, administration, and backup capabilities. The graph includes those documented product areas, but their internal wiring is not fully shown in the sampled source, so uncertain links are omitted. External integrations are marked optional.
Main entry points: index.js Route registry · finances.repository.js SQLite repositories · import.service.js Statement imports · adminCore.service.js Admin controls
Components 24
Web and PWA
- Web client
public/app.js - Service worker
public/sw.js
Finance workflow
- Cards and periods
src/services/cards.service.js - Transactions and splits
src/services/finances.service.js - Statement imports
src/services/import.service.js - CSV importers
src/importers/index.js - Monthly summaries
src/services/summary.service.js
People and sharing
- Shared repayments
src/services/sharedDebts.service.js - Person sharing
src/services/socialShare.service.js - Notifications
src/services/notifications.service.js
Identity and operations
- Server bootstrap
server.js - App runtime
server.runtime.js - Route registry
src/routes/index.js - Google sign-in
src/services/auth.service.js - PIN and passkeys
src/services/security.service.js - Admin controls
src/services/adminCore.service.js - Backup and restore
src/backupEngine.js - SQLite repositories
src/repositories/finances.repository.js - Application database
src/db.js
Other components
- App user
- Google OAuth
- Web Push
- WhatsApp API
- Google Drive
Connections 27
- App user → Web client: uses
- Web client → Server bootstrap: requests
- Service worker → Web client: supports offline
- Server bootstrap → App runtime: loads runtime
- App runtime → Route registry: composes routes
- Route registry → Cards and periods: dispatches card routes
- Route registry → Transactions and splits: dispatches finance routes
- Route registry → Statement imports: dispatches import routes
- Route registry → Monthly summaries: dispatches summary routes
- Route registry → Shared repayments: dispatches debt routes
- Route registry → Person sharing: dispatches sharing routes
- Route registry → Notifications: dispatches notification routes
- Route registry → Google sign-in: dispatches auth routes
- Route registry → PIN and passkeys: dispatches security routes
- Route registry → Admin controls: dispatches admin routes
- Statement imports → CSV importers: uses importers
- Cards and periods → SQLite repositories: accesses data
- Transactions and splits → SQLite repositories: accesses data
- Statement imports → SQLite repositories: accesses data
- Monthly summaries → SQLite repositories: accesses data
- Shared repayments → SQLite repositories: accesses data
- SQLite repositories → Application database: reads and writes
- Google sign-in → Google OAuth: authenticates
- Notifications → Web Push: sends alerts
- Admin controls → WhatsApp API: configures messaging
- Backup and restore → Google Drive: uploads backups
- Admin controls → Backup and restore: manages backups