How sjtecnologia/equili works
Equili is a family-finance application: users authenticate, record income, debts, accounts and transactions, then review dashboards, reports and AI-assisted plans or chat. The React client routes users through those workflows and communicates with a FastAPI API; route handlers operate on persisted finance data. Additional branches cover investments, invoices, lists, voice, push alerts and account administration. The map follows documented routes and cited imports; some UI-to-API and unsampled feature connections remain dashed because their call paths were not shown.
Main entry points: router.py API router · models Finance models · main.py FastAPI runtime · api.ts API client
Components 31
Client experience
- React app
frontend/src/App.tsx - Finance screens
frontend/src/pages - Reports screens
frontend/src/pages/relatorios/RelatoriosPage.tsx - API client
frontend/src/services/api.ts
API and identity
- API router
backend/app/api/v1/router.py - Authentication
backend/app/api/v1/routes/auth.py - User management
backend/app/api/v1/routes/usuarios.py
Finance workflows
- Income
backend/app/api/v1/routes/rendas.py - Debt management
backend/app/api/v1/routes/dividas.py - Payables
backend/app/api/v1/routes/contas_pagar.py - Receivables
backend/app/api/v1/routes/contas_receber.py - Bank accounts
backend/app/api/v1/routes/contas_bancarias.py - Account transactions
backend/app/api/v1/routes/lancamentos_conta.py - Card transactions
backend/app/api/v1/routes/lancamentos_cartao.py - Dashboard
backend/app/api/v1/routes/dashboard.py - Financial reports
backend/app/api/v1/routes/relatorio.py - Investments
backend/app/api/v1/routes/investimentos.py
Assistance and alerts
- AI plan and chat
backend/app/api/v1/routes/plano_acao.py - AI chat
backend/app/api/v1/routes/chat.py - Voice assistant
backend/app/api/v1/routes/voz.py - Invoice capture
backend/app/api/v1/routes/nfs.py - Finance lists
backend/app/api/v1/routes/listas.py - Push notifications
backend/app/api/v1/routes/notificacoes.py - Due-date alerts
backend/app/tasks/alertas.py
Persistence and runtime
- PostgreSQL
- DB sessions
backend/app/db/session.py - Finance models
backend/app/models - FastAPI runtime
backend/app/main.py - Rastro telemetry
backend/app/core/rastro_client.py
Other components
- Finance user
- GitHub Models
Connections 37
- Finance user → React app: uses
README.md - React app → Finance screens: routes to
frontend/src/App.tsx - React app → API client: calls
- Finance screens → API client: requests data
- Reports screens → API client: requests reports
- API client → FastAPI runtime: HTTP API
- FastAPI runtime → API router: mounts
backend/app/main.py - API router → Authentication: registers
backend/app/api/v1/router.py - API router → User management: registers
backend/app/api/v1/router.py - API router → Income: registers
backend/app/api/v1/router.py - API router → Debt management: registers
backend/app/api/v1/router.py - API router → Payables: registers
backend/app/api/v1/router.py - API router → Receivables: registers
backend/app/api/v1/router.py - API router → Bank accounts: registers
backend/app/api/v1/router.py - API router → Account transactions: registers
backend/app/api/v1/router.py - API router → Card transactions: registers
backend/app/api/v1/router.py - API router → Dashboard: registers
backend/app/api/v1/router.py - API router → Financial reports: registers
backend/app/api/v1/router.py - API router → Investments: registers
backend/app/api/v1/router.py - API router → AI plan and chat: registers
backend/app/api/v1/router.py - API router → AI chat: registers
backend/app/api/v1/router.py - API router → Voice assistant: registers
backend/app/api/v1/router.py - API router → Invoice capture: registers
backend/app/api/v1/router.py - API router → Finance lists: registers
backend/app/api/v1/router.py - API router → Push notifications: registers
backend/app/api/v1/router.py - Authentication → Finance models: reads/writes
backend/app/api/v1/routes/auth.py - Debt management → Finance models: reads/writes
backend/app/api/v1/routes/dividas.py - Payables → Finance models: reads/writes
backend/app/api/v1/routes/contas_pagar.py - Dashboard → Finance models: reads
backend/app/api/v1/routes/dashboard.py - AI chat → GitHub Models: queries
backend/app/api/v1/routes/chat.py - AI chat → Finance models: reads
backend/app/api/v1/routes/chat.py - Due-date alerts → Finance models: reads due items
backend/app/tasks/alertas.py - FastAPI runtime → Due-date alerts: starts
backend/app/main.py - Due-date alerts → Push notifications: sends alerts
- Finance models → DB sessions: uses sessions
- DB sessions → PostgreSQL: persists data
backend/app/db/session.py - FastAPI runtime → Rastro telemetry: reports events
backend/app/main.py