How luccasphilot/valora works
Valora is a personal-finance app: Open Finance imports account data, while users can also record transactions manually and manage budgets, goals, bills, and planned entries. The backend exposes these capabilities through a Fastify API, with PostgreSQL persistence; the React frontend is present in the tree, though the README describes its screens as still in progress. The graph emphasizes documented routes, service calls, synchronization, and storage. Unsampled subsystems are included where the README or tree supports their existence, but their internal links are omitted when evidence is unavailable.
Main entry points: app.ts API setup · dashboard.service.ts Dashboard · database.ts Database access · sync.service.ts Sync orchestration
Components 19
API and overview
- API setup
backend/src/app.ts - Dashboard
backend/src/modules/dashboard/dashboard.service.ts - React frontend
frontend/src/main.tsx
Finance features
- Accounts
backend/src/modules/accounts/accounts.service.ts - Transactions
backend/src/modules/transactions/transactions.service.ts - Categories
backend/src/modules/categories/categories.repository.ts - Budgets
backend/src/modules/budgets/budgets.service.ts - Card bills
backend/src/modules/credit-card-bills/credit-card-bills.service.ts - Goals
backend/src/modules/goals/goals.service.ts - Planned entries
backend/src/modules/planned-entries/planned-entries.service.ts - Projection
backend/src/modules/projection/projection.service.ts - Alerts
backend/src/modules/alerts/alerts.module.ts
Open Finance sync
- Connections
backend/src/modules/connections/connections.service.ts - Sync orchestration
backend/src/modules/sync/sync.service.ts - Meu Pluggy
Persistence
- Database access
backend/src/db/database.ts - Data schema
backend/src/db/schema.ts - PostgreSQL
Other components
- Person
Connections 28
- Person → API setup: uses API
README.md - API setup → Accounts: registers routes
backend/src/app.ts - API setup → Connections: registers routes
backend/src/app.ts - API setup → Dashboard: registers routes
backend/src/app.ts - API setup → Budgets: registers routes
backend/src/app.ts - API setup → Transactions: registers routes
backend/src/app.ts - Accounts → Database access: reads and writes
- Connections → Database access: reads and writes
- Categories → Database access: reads and writes
backend/src/modules/categories/categories.repository.ts - Goals → Database access: reads and writes
- Database access → Data schema: uses tables
backend/src/modules/connections/connections.repository.ts - Database access → PostgreSQL: queries
- API setup → Sync orchestration: registers routes
backend/src/app.ts - Sync orchestration → Meu Pluggy: fetches data
backend/src/modules/sync/sync.service.ts - Sync orchestration → Connections: uses connection records
backend/src/modules/sync/sync.service.ts - Sync orchestration → Alerts: evaluates alerts
backend/src/modules/sync/sync.service.ts - API setup → Alerts: registers routes
backend/src/app.ts - API setup → Planned entries: registers routes
backend/src/app.ts - API setup → Goals: registers routes
backend/src/app.ts - API setup → Card bills: registers routes
backend/src/app.ts - API setup → Projection: registers routes
backend/src/app.ts - API setup → Categories: registers routes
backend/src/app.ts - Dashboard → Accounts: uses account totals
backend/src/modules/dashboard/dashboard.service.ts - Dashboard → Budgets: loads budgets
backend/src/modules/dashboard/dashboard.service.ts - Dashboard → Goals: loads goals
backend/src/modules/dashboard/dashboard.service.ts - Dashboard → Projection: loads projection
backend/src/modules/dashboard/dashboard.service.ts - Dashboard → Transactions: loads transactions
backend/src/modules/dashboard/dashboard.service.ts - React frontend → API setup: calls API