How dannyahia/hermes works
Hermes is a personal-finance application for tracking money across accounts, transactions, budgets, categories, loans and recurring activity, with dashboards and financial reports. The main user path is authenticated web pages and actions into domain use cases, then repository-backed persistence; reports can also be exported, and spending can be captured through wallet and Telegram integrations. The source excerpts show several key wiring points, but not most page-to-use-case calls, so those links are marked unverified rather than assumed.
Main entry points: transaction.ts Finance entities · layout.tsx Finance pages · route.ts Report export API · drizzle-transaction.repository.ts Transaction repository
Components 27
Web experience
- Sign-in UI
src/app/(auth)/login/login-form.tsx - Finance pages
src/app/layout.tsx - Transactions UI
src/app/transactions/page.tsx - Accounts UI
src/app/accounts/page.tsx - Dashboard UI
src/app/dashboard/page.tsx - Reports UI
src/app/reports/page.tsx
Finance workflows
- Transaction operations
src/modules/transactions/application - Account operations
src/modules/accounts/application - Budget tracking
src/modules/budgets/application - Categories
src/modules/categories/application - Financial overview
src/modules/dashboard/application - Reports
src/modules/reports/application - Loans and plans
src/modules/installments/application/create-installment-plan.use-case.ts - Recurring activity
src/modules/recurring-transactions/application - Report export API
src/app/api/reports/export/route.ts
Domain model
- Finance entities
src/core/entities/transaction.ts - Repository contracts
src/core/contracts/transaction-repository.ts
Platform and storage
- Authentication
src/infra/auth/server.ts - Transaction repository
src/infra/repositories/drizzle-transaction.repository.ts - Installment repository
src/infra/repositories/drizzle-installment-plan.repository.ts - PostgreSQL
src/infra/database/schema.ts - Email sender
src/infra/email/resend-email-sender.adapter.ts
Capture integrations
- Payment capture
src/modules/capture/application - Wallet capture API
src/app/api/capture/wallet/route.ts - Chat orchestration
src/shared/server/chat.ts - Telegram adapter
src/infra/telegram/telegram-chat-channel.ts
Other components
- User
Connections 33
- User → Sign-in UI: signs in
- User → Finance pages: uses
- Sign-in UI → Authentication: authenticates
- Finance pages → Transactions UI: renders
- Transactions UI → Transaction operations: manages transactions
- Finance pages → Accounts UI: renders
- Accounts UI → Account operations: manages accounts
- Finance pages → Dashboard UI: renders
- Dashboard UI → Financial overview: loads overview
- Finance pages → Reports UI: renders
- Reports UI → Reports: loads reports
- Reports UI → Report export API: requests export
- Report export API → Reports: builds report
src/app/api/reports/export/route.ts - Report export API → Transaction repository: reads transactions
src/app/api/reports/export/route.ts - Report export API → PostgreSQL: exports PDF
src/app/api/reports/export/route.ts - Transaction operations → Transaction repository: persists transactions
- Transaction repository → PostgreSQL: queries tables
src/infra/repositories/drizzle-transaction.repository.ts - Installment repository → PostgreSQL: queries plans
src/infra/repositories/drizzle-installment-plan.repository.ts - Transaction repository → Repository contracts: implements contract
src/infra/repositories/drizzle-transaction.repository.ts - Installment repository → Finance entities: maps plans
src/infra/repositories/drizzle-installment-plan.repository.ts - Transaction operations → Finance entities: creates transactions
- Account operations → Finance entities: uses finance entities
- Budget tracking → Finance entities: uses finance entities
- Categories → Finance entities: uses finance entities
- Financial overview → Finance entities: calculates metrics
- Loans and plans → Repository contracts: uses repositories
src/modules/installments/application/create-installment-plan.use-case.ts - Loans and plans → Installment repository: loads and saves plans
src/modules/installments/application/create-installment-plan.use-case.ts - Recurring activity → Finance entities: uses finance entities
- Authentication → PostgreSQL: uses schema
src/infra/auth/server.ts - Authentication → Email sender: sends email
src/infra/auth/server.ts - Wallet capture API → Payment capture: records payment
src/app/api/capture/wallet/route.ts - Wallet capture API → Chat orchestration: announces capture
src/app/api/capture/wallet/route.ts - Chat orchestration → Telegram adapter: dispatches messages
src/shared/server/chat.ts