How ikaique26/mertilo works
Mertilo is an Electron desktop personal-finance application with a React interface and a Node/TypeScript API. Users enter through the desktop UI, authenticate, and access financial tracking, imports, and Brazilian income-tax preparation. The API separates HTTP routing, business services, and persistence; IRPF additionally handles document processing and tax assistance. The README documents the desktop/frontend/backend stack and core finance capabilities. Some frontend-to-API wiring and unsampled subsystem internals are not shown, so those links are omitted rather than inferred.
Main entry points: app.ts HTTP application · App.jsx React application · irpf.controller.ts Tax controller · irpf.service.ts Tax domain service
Components 26
Desktop interface
- Electron host
resources/app/electron/main.cjs - React application
resources/app/src/App.jsx - Finance views
resources/app/src/pages/Dashboard/index.jsx - Tax workflow UI
resources/app/src/modules/irpf/pages/index.jsx - Finance API client
resources/app/src/services/api/financial.ts - Import interface
resources/app/src/pages/ImportacaoFinanceira/index.jsx
Finance API
- HTTP application
resources/app/api/src/app.ts - Finance routes
resources/app/api/src/modules - Accounts service
resources/app/api/src/services/account.service.ts - Categories service
resources/app/api/src/services/category.service.ts - History service
resources/app/api/src/services/history.service.ts - Salary service
resources/app/api/src/services/salary.service.ts - Vehicle expenses
resources/app/api/src/services/vehicle-expense.service.ts - Financial import
resources/app/api/src/modules/financial-import.ts
Tax preparation
- Tax routes
resources/app/api/src/modules/irpf/routes.ts - Tax controller
resources/app/api/src/controllers/irpf.controller.ts - Tax domain service
resources/app/api/src/services/irpf.service.ts - Document processor
resources/app/api/src/services/file-processor.ts - Tax assistant
resources/app/api/src/services/irpf-assistant.ts - Tax repositories
resources/app/api/src/repositories/irpf.repository.ts
Identity and persistence
- Authentication
resources/app/api/src/services/auth.service.ts - Auth routes
resources/app/api/src/routes/auth.ts - User repository
resources/app/api/src/repositories/users.repository.ts - SQLite database
resources/app/api/src/database/db.ts - Email delivery
resources/app/api/src/services/email.service.ts
Other components
- Desktop user
Connections 26
- Desktop user → Electron host: opens
README.md - Electron host → React application: hosts
README.md - Desktop user → React application: uses
README.md - React application → Finance views: routes
resources/app/src/App.jsx - React application → Tax workflow UI: routes
resources/app/src/App.jsx - React application → Finance API client: provides finance context
resources/app/src/App.jsx - React application → Import interface: routes
resources/app/src/App.jsx - HTTP application → Finance routes: mounts
resources/app/api/src/app.ts - HTTP application → Auth routes: mounts
resources/app/api/src/app.ts - HTTP application → Tax routes: mounts
resources/app/api/src/app.ts - HTTP application → Accounts service: calls
resources/app/api/src/app.ts - HTTP application → Categories service: calls
resources/app/api/src/app.ts - HTTP application → History service: calls
resources/app/api/src/app.ts - HTTP application → Salary service: calls
resources/app/api/src/app.ts - HTTP application → Vehicle expenses: calls
resources/app/api/src/app.ts - HTTP application → Financial import: mounts
resources/app/api/src/app.ts - Auth routes → Authentication: dispatches
- Authentication → User repository: reads and writes
resources/app/api/src/services/auth.service.ts - User repository → SQLite database: queries
resources/app/api/src/repositories/users.repository.ts - Authentication → Email delivery: sends verification
resources/app/api/src/services/auth.service.ts - Tax routes → Tax controller: dispatches
resources/app/api/src/modules/irpf/routes.ts - Tax controller → Tax domain service: delegates
resources/app/api/src/controllers/irpf.controller.ts - Tax controller → Document processor: processes uploads
resources/app/api/src/controllers/irpf.controller.ts - Tax controller → Tax assistant: requests analysis
resources/app/api/src/controllers/irpf.controller.ts - Tax domain service → Tax repositories: persists tax data
resources/app/api/src/services/irpf.service.ts - Tax domain service → SQLite database: uses transactions
resources/app/api/src/services/irpf.service.ts