How samnang-vouen/luy_flow works
This is a NestJS personal-finance API. Users authenticate, then manage accounts, categories, payment methods and transactions; statement imports add a background-assisted preview-and-confirm workflow. Other product areas cover budgets, reports and exports, savings, debts, shared groups, recommendations, recurring schedules, notifications and audit history. The graph preserves documented capabilities, but unsampled modules are linked only where the README or source index establishes a relationship; it does not imply recurring schedules execute transactions.
Main entry points: transactions.controller.ts Transactions API · groups.service.ts Group service · budgets.service.ts Budgets · auth.service.ts Auth service
Components 31
Identity and access
- Auth API
src/auth/auth.controller.ts - Auth service
src/auth/auth.service.ts - User profiles
src/users/users.service.ts - Sessions
src/sessions/sessions.service.ts - JWT guard
src/auth/guards/jwt-auth.guard.ts - Current user
src/auth/decorators/current-user.decorator.ts - Admin API
src/admin/admin.controller.ts
Finance records
- Accounts
src/accounts/accounts.service.ts - Categories
src/categories/categories.service.ts - Category model
src/categories/entities/category.entity.ts - Payment methods
src/payment-methods/payment-methods.service.ts - Transactions API
src/transactions/transactions.controller.ts - Transactions
src/transactions/transactions.service.ts - Transaction model
src/transactions/entities/transaction.entity.ts - Transaction input
src/transactions/dto/create-transaction.dto.ts - Transaction query
src/transactions/dto/list-transactions-query.dto.ts
Planning and sharing
- Budgets
src/budgets/budgets.service.ts - Budget input
src/budgets/dto/create-budget.dto.ts - Savings goals
src/savings-goals/savings-goals.controller.ts - Debts and payments
src/debts/debts.controller.ts - Shared groups
src/groups/groups.controller.ts - Group service
src/groups/groups.service.ts
Imports and insights
- Imports API
src/imports/imports.controller.ts - Statement imports
src/imports/imports.service.ts - Reports
src/reports/reports.controller.ts - Transaction exports
src/exports/exports.controller.ts - Recommendations
src/recommendations/recommendations.controller.ts
Automation and administration
- Recurring schedules
src/recurring-transactions/recurring-transactions.controller.ts - Notifications
src/notifications/notifications.service.ts - Audit history
src/audit-logs/audit-logs.service.ts
Other components
- User
Connections 29
- User → Auth API: authenticates
src/auth/auth.controller.ts - Auth API → Auth service: dispatches
src/auth/auth.controller.ts - Auth service → User profiles: looks up users
src/auth/auth.service.ts - Auth service → Sessions: manages sessions
src/auth/auth.service.ts - User → Transactions API: submits transactions
src/transactions/transactions.controller.ts - Transactions API → Transactions: dispatches
src/transactions/transactions.controller.ts - Transactions API → JWT guard: guards routes
src/transactions/transactions.controller.ts - Transactions API → Current user: extracts identity
src/transactions/transactions.controller.ts - Transactions API → Transaction input: accepts input
src/transactions/transactions.controller.ts - Transactions API → Transaction query: accepts filters
src/transactions/transactions.controller.ts - Transactions → Transaction model: uses entity
- User → Imports API: uploads statement
src/imports/imports.controller.ts - Imports API → Statement imports: dispatches
src/imports/imports.controller.ts - Imports API → JWT guard: guards routes
src/imports/imports.controller.ts - Statement imports → Transactions: creates transactions
- Shared groups → Group service: dispatches
src/groups/groups.controller.ts - Group service → User profiles: looks up users
src/groups/groups.service.ts - Group service → Notifications: creates notifications
src/groups/groups.service.ts - Group service → Audit history: records actions
src/groups/groups.service.ts - Budgets → Category model: reads category
src/budgets/budgets.service.ts - Budgets → Transaction model: reads transactions
src/budgets/budgets.service.ts - Budgets → Audit history: records actions
src/budgets/budgets.service.ts - User → Savings goals: manages goals
src/savings-goals/savings-goals.controller.ts - User → Debts and payments: manages debts
src/debts/debts.controller.ts - User → Reports: requests reports
src/reports/reports.controller.ts - User → Transaction exports: requests exports
src/exports/exports.controller.ts - User → Recommendations: requests advice
src/recommendations/recommendations.controller.ts - User → Recurring schedules: manages schedules
src/recurring-transactions/recurring-transactions.controller.ts - User → Admin API: administers users
src/admin/admin.controller.ts