How victoazam/sapoupei works
sapoupei is a Flask financial-education and personal budgeting application with a separate administrator area for aggregated reporting. Users register or sign in, manage their own income and expenses, and view budget summaries, goals, and educational guidance; administrators view population-level metrics and export aggregated CSV reports. The graph reflects the sampled route, service, model, and application code plus documented capabilities. Some UI and PWA details are documented but not fully sampled, so their connections are limited to documented relationships.
Main entry points: app.py Flask app · financeiro.py Finance routes · admin.py Admin reports · auth.py Authentication routes
Components 24
Web application
- API entry
api/index.py - Flask app
app.py - Offline asset cache
static/service-worker.js - PWA installation metadata
static/manifest.json - Browser interactions
static/js/app.js
Identity and access
- Authentication routes
routes/auth.py - Reset tokens
services/auth.py
Personal finance
- Finance routes
routes/financeiro.py - Financial rules
services/financial.py - Personal dashboard
templates/painel.html - Movement pages
templates/financeiro - Monthly goal page
templates/financeiro/meta_mensal.html - Education and tips
templates/financeiro/dicas.html
Administration
- Admin reports
routes/admin.py - Admin dashboard
templates/admin/dashboard.html - CSV export
routes/admin.py
Shared services and data
- Forms and validation
forms.py - Flask extensions
extensions.py - Domain models
models.py - Database configuration
config.py - MySQL database
- Mail service
Other components
- User
- Administrator
Connections 29
- User → API entry: opens app
- API entry → Flask app: imports app
api/index.py - Flask app → Authentication routes: registers routes
app.py - Flask app → Finance routes: registers routes
app.py - Flask app → Admin reports: registers routes
app.py - Authentication routes → Forms and validation: validates forms
routes/auth.py - Finance routes → Forms and validation: validates forms
routes/financeiro.py - Authentication routes → Reset tokens: creates tokens
routes/auth.py - Authentication routes → Mail service: sends reset email
routes/auth.py - Authentication routes → Domain models: reads and writes users
routes/auth.py - Finance routes → Domain models: reads and writes finance data
routes/financeiro.py - Finance routes → Financial rules: refreshes profiles
routes/financeiro.py - Flask app → Financial rules: builds dashboard totals
app.py - Flask app → Domain models: queries dashboard data
app.py - Administrator → Admin reports: requests reports
routes/admin.py - Admin reports → Domain models: queries aggregates
routes/admin.py - Admin reports → Financial rules: classifies profiles
routes/admin.py - Admin reports → CSV export: exports CSV
routes/admin.py - Flask app → Personal dashboard: renders dashboard
app.py - Finance routes → Movement pages: renders movement views
routes/financeiro.py - Finance routes → Monthly goal page: renders goal page
routes/financeiro.py - Finance routes → Education and tips: renders tips
routes/financeiro.py - Admin reports → Admin dashboard: renders report
routes/admin.py - Domain models → MySQL database: persists records
models.py - Database configuration → MySQL database: configures connection
config.py - Flask app → Flask extensions: initializes extensions
app.py - Flask app → Offline asset cache: serves worker
app.py - User → PWA installation metadata: installs PWA
README.md - Offline asset cache → Browser interactions: caches static assets
static/service-worker.js