# samnang-vouen/luy_flow architecture

> Architecture diagram of the GitHub repository samnang-vouen/luy_flow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/samnang-vouen/luy_flow
- Repository: https://github.com/samnang-vouen/luy_flow

## Overview

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: [`src/transactions/transactions.controller.ts`](https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/transactions.controller.ts) (Transactions API), [`src/groups/groups.service.ts`](https://github.com/samnang-vouen/luy_flow/blob/main/src/groups/groups.service.ts) (Group service), [`src/budgets/budgets.service.ts`](https://github.com/samnang-vouen/luy_flow/blob/main/src/budgets/budgets.service.ts) (Budgets), [`src/auth/auth.service.ts`](https://github.com/samnang-vouen/luy_flow/blob/main/src/auth/auth.service.ts) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth_api["Auth API<br/>[auth.controller.ts]"]
  node_auth_logic["Auth service<br/>[auth.service.ts]"]
  node_users["User profiles<br/>[users.service.ts]"]
  node_sessions[("Sessions")]
  node_jwt_guard["JWT guard<br/>[jwt-auth.guard.ts]"]
  node_current_user["Current user"]
  node_admin["Admin API"]
end

subgraph group_finance["Finance records"]
  node_accounts["Accounts"]
  node_categories["Categories"]
  node_category_model["Category model<br/>[category.entity.ts]"]
  node_payment_methods["Payment methods"]
  node_transactions_api["Transactions API"]
  node_transactions["Transactions"]
  node_transaction_model["Transaction model"]
  node_transaction_input["Transaction input"]
  node_transaction_query["Transaction query"]
end

subgraph group_planning["Planning and sharing"]
  node_budgets["Budgets<br/>[budgets.service.ts]"]
  node_budget_input["Budget input"]
  node_savings["Savings goals"]
  node_debts["Debts and payments"]
  node_groups["Shared groups"]
  node_group_logic["Group service<br/>[groups.service.ts]"]
end

subgraph group_insights["Imports and insights"]
  node_imports_api["Imports API"]
  node_imports["Statement imports<br/>[imports.service.ts]"]
  node_reports["Reports"]
  node_exports["Transaction exports"]
  node_recommendations["Recommendations"]
end

subgraph group_automation["Automation and administration"]
  node_recurring["Recurring schedules"]
  node_notifications["Notifications"]
  node_audit["Audit history"]
end

node_user(("User"))

node_user -->|"authenticates"| node_auth_api
node_auth_api -->|"dispatches"| node_auth_logic
node_auth_logic -->|"looks up users"| node_users
node_auth_logic -->|"manages sessions"| node_sessions
node_user -->|"submits transactions"| node_transactions_api
node_transactions_api -->|"dispatches"| node_transactions
node_transactions_api -->|"guards routes"| node_jwt_guard
node_transactions_api -->|"extracts identity"| node_current_user
node_transactions_api -->|"accepts input"| node_transaction_input
node_transactions_api -->|"accepts filters"| node_transaction_query
node_transactions -->|"uses entity"| node_transaction_model
node_user -->|"uploads statement"| node_imports_api
node_imports_api -->|"dispatches"| node_imports
node_imports_api -->|"guards routes"| node_jwt_guard
node_imports -.->|"creates transactions"| node_transactions
node_groups -->|"dispatches"| node_group_logic
node_group_logic -->|"looks up users"| node_users
node_group_logic -->|"creates notifications"| node_notifications
node_group_logic -->|"records actions"| node_audit
node_budgets -->|"reads category"| node_category_model
node_budgets -->|"reads transactions"| node_transaction_model
node_budgets -->|"records actions"| node_audit
node_user -->|"manages goals"| node_savings
node_user -->|"manages debts"| node_debts
node_user -->|"requests reports"| node_reports
node_user -->|"requests exports"| node_exports
node_user -->|"requests advice"| node_recommendations
node_user -->|"manages schedules"| node_recurring
node_user -->|"administers users"| node_admin

click node_auth_api "https://github.com/samnang-vouen/luy_flow/blob/main/src/auth/auth.controller.ts"
click node_auth_logic "https://github.com/samnang-vouen/luy_flow/blob/main/src/auth/auth.service.ts"
click node_users "https://github.com/samnang-vouen/luy_flow/blob/main/src/users/users.service.ts"
click node_sessions "https://github.com/samnang-vouen/luy_flow/blob/main/src/sessions/sessions.service.ts"
click node_jwt_guard "https://github.com/samnang-vouen/luy_flow/blob/main/src/auth/guards/jwt-auth.guard.ts"
click node_current_user "https://github.com/samnang-vouen/luy_flow/blob/main/src/auth/decorators/current-user.decorator.ts"
click node_admin "https://github.com/samnang-vouen/luy_flow/blob/main/src/admin/admin.controller.ts"
click node_accounts "https://github.com/samnang-vouen/luy_flow/blob/main/src/accounts/accounts.service.ts"
click node_categories "https://github.com/samnang-vouen/luy_flow/blob/main/src/categories/categories.service.ts"
click node_category_model "https://github.com/samnang-vouen/luy_flow/blob/main/src/categories/entities/category.entity.ts"
click node_payment_methods "https://github.com/samnang-vouen/luy_flow/blob/main/src/payment-methods/payment-methods.service.ts"
click node_transactions_api "https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/transactions.controller.ts"
click node_transactions "https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/transactions.service.ts"
click node_transaction_model "https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/entities/transaction.entity.ts"
click node_transaction_input "https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/dto/create-transaction.dto.ts"
click node_transaction_query "https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/dto/list-transactions-query.dto.ts"
click node_budgets "https://github.com/samnang-vouen/luy_flow/blob/main/src/budgets/budgets.service.ts"
click node_budget_input "https://github.com/samnang-vouen/luy_flow/blob/main/src/budgets/dto/create-budget.dto.ts"
click node_savings "https://github.com/samnang-vouen/luy_flow/blob/main/src/savings-goals/savings-goals.controller.ts"
click node_debts "https://github.com/samnang-vouen/luy_flow/blob/main/src/debts/debts.controller.ts"
click node_groups "https://github.com/samnang-vouen/luy_flow/blob/main/src/groups/groups.controller.ts"
click node_group_logic "https://github.com/samnang-vouen/luy_flow/blob/main/src/groups/groups.service.ts"
click node_imports_api "https://github.com/samnang-vouen/luy_flow/blob/main/src/imports/imports.controller.ts"
click node_imports "https://github.com/samnang-vouen/luy_flow/blob/main/src/imports/imports.service.ts"
click node_reports "https://github.com/samnang-vouen/luy_flow/blob/main/src/reports/reports.controller.ts"
click node_exports "https://github.com/samnang-vouen/luy_flow/blob/main/src/exports/exports.controller.ts"
click node_recommendations "https://github.com/samnang-vouen/luy_flow/blob/main/src/recommendations/recommendations.controller.ts"
click node_recurring "https://github.com/samnang-vouen/luy_flow/blob/main/src/recurring-transactions/recurring-transactions.controller.ts"
click node_notifications "https://github.com/samnang-vouen/luy_flow/blob/main/src/notifications/notifications.service.ts"
click node_audit "https://github.com/samnang-vouen/luy_flow/blob/main/src/audit-logs/audit-logs.service.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_api,node_auth_logic,node_users,node_sessions,node_jwt_guard,node_current_user,node_admin,node_user toneBlue
class node_accounts,node_categories,node_category_model,node_payment_methods,node_transactions_api,node_transactions,node_transaction_model,node_transaction_input,node_transaction_query toneAmber
class node_budgets,node_budget_input,node_savings,node_debts,node_groups,node_group_logic toneMint
class node_imports_api,node_imports,node_reports,node_exports,node_recommendations toneRose
class node_recurring,node_notifications,node_audit toneIndigo
```

## Components

### Identity and access

- [Auth API](https://github.com/samnang-vouen/luy_flow/blob/main/src/auth/auth.controller.ts): `src/auth/auth.controller.ts`
- [Auth service](https://github.com/samnang-vouen/luy_flow/blob/main/src/auth/auth.service.ts): `src/auth/auth.service.ts`
- [User profiles](https://github.com/samnang-vouen/luy_flow/blob/main/src/users/users.service.ts): `src/users/users.service.ts`
- [Sessions](https://github.com/samnang-vouen/luy_flow/blob/main/src/sessions/sessions.service.ts): `src/sessions/sessions.service.ts`
- [JWT guard](https://github.com/samnang-vouen/luy_flow/blob/main/src/auth/guards/jwt-auth.guard.ts): `src/auth/guards/jwt-auth.guard.ts`
- [Current user](https://github.com/samnang-vouen/luy_flow/blob/main/src/auth/decorators/current-user.decorator.ts): `src/auth/decorators/current-user.decorator.ts`
- [Admin API](https://github.com/samnang-vouen/luy_flow/blob/main/src/admin/admin.controller.ts): `src/admin/admin.controller.ts`

### Finance records

- [Accounts](https://github.com/samnang-vouen/luy_flow/blob/main/src/accounts/accounts.service.ts): `src/accounts/accounts.service.ts`
- [Categories](https://github.com/samnang-vouen/luy_flow/blob/main/src/categories/categories.service.ts): `src/categories/categories.service.ts`
- [Category model](https://github.com/samnang-vouen/luy_flow/blob/main/src/categories/entities/category.entity.ts): `src/categories/entities/category.entity.ts`
- [Payment methods](https://github.com/samnang-vouen/luy_flow/blob/main/src/payment-methods/payment-methods.service.ts): `src/payment-methods/payment-methods.service.ts`
- [Transactions API](https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/transactions.controller.ts): `src/transactions/transactions.controller.ts`
- [Transactions](https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/transactions.service.ts): `src/transactions/transactions.service.ts`
- [Transaction model](https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/entities/transaction.entity.ts): `src/transactions/entities/transaction.entity.ts`
- [Transaction input](https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/dto/create-transaction.dto.ts): `src/transactions/dto/create-transaction.dto.ts`
- [Transaction query](https://github.com/samnang-vouen/luy_flow/blob/main/src/transactions/dto/list-transactions-query.dto.ts): `src/transactions/dto/list-transactions-query.dto.ts`

### Planning and sharing

- [Budgets](https://github.com/samnang-vouen/luy_flow/blob/main/src/budgets/budgets.service.ts): `src/budgets/budgets.service.ts`
- [Budget input](https://github.com/samnang-vouen/luy_flow/blob/main/src/budgets/dto/create-budget.dto.ts): `src/budgets/dto/create-budget.dto.ts`
- [Savings goals](https://github.com/samnang-vouen/luy_flow/blob/main/src/savings-goals/savings-goals.controller.ts): `src/savings-goals/savings-goals.controller.ts`
- [Debts and payments](https://github.com/samnang-vouen/luy_flow/blob/main/src/debts/debts.controller.ts): `src/debts/debts.controller.ts`
- [Shared groups](https://github.com/samnang-vouen/luy_flow/blob/main/src/groups/groups.controller.ts): `src/groups/groups.controller.ts`
- [Group service](https://github.com/samnang-vouen/luy_flow/blob/main/src/groups/groups.service.ts): `src/groups/groups.service.ts`

### Imports and insights

- [Imports API](https://github.com/samnang-vouen/luy_flow/blob/main/src/imports/imports.controller.ts): `src/imports/imports.controller.ts`
- [Statement imports](https://github.com/samnang-vouen/luy_flow/blob/main/src/imports/imports.service.ts): `src/imports/imports.service.ts`
- [Reports](https://github.com/samnang-vouen/luy_flow/blob/main/src/reports/reports.controller.ts): `src/reports/reports.controller.ts`
- [Transaction exports](https://github.com/samnang-vouen/luy_flow/blob/main/src/exports/exports.controller.ts): `src/exports/exports.controller.ts`
- [Recommendations](https://github.com/samnang-vouen/luy_flow/blob/main/src/recommendations/recommendations.controller.ts): `src/recommendations/recommendations.controller.ts`

### Automation and administration

- [Recurring schedules](https://github.com/samnang-vouen/luy_flow/blob/main/src/recurring-transactions/recurring-transactions.controller.ts): `src/recurring-transactions/recurring-transactions.controller.ts`
- [Notifications](https://github.com/samnang-vouen/luy_flow/blob/main/src/notifications/notifications.service.ts): `src/notifications/notifications.service.ts`
- [Audit history](https://github.com/samnang-vouen/luy_flow/blob/main/src/audit-logs/audit-logs.service.ts): `src/audit-logs/audit-logs.service.ts`

### Other components

- **User**

## Connections

- User → Auth API: authenticates (evidence: `src/auth/auth.controller.ts`)
- Auth API → Auth service: dispatches (evidence: `src/auth/auth.controller.ts`)
- Auth service → User profiles: looks up users (evidence: `src/auth/auth.service.ts`)
- Auth service → Sessions: manages sessions (evidence: `src/auth/auth.service.ts`)
- User → Transactions API: submits transactions (evidence: `src/transactions/transactions.controller.ts`)
- Transactions API → Transactions: dispatches (evidence: `src/transactions/transactions.controller.ts`)
- Transactions API → JWT guard: guards routes (evidence: `src/transactions/transactions.controller.ts`)
- Transactions API → Current user: extracts identity (evidence: `src/transactions/transactions.controller.ts`)
- Transactions API → Transaction input: accepts input (evidence: `src/transactions/transactions.controller.ts`)
- Transactions API → Transaction query: accepts filters (evidence: `src/transactions/transactions.controller.ts`)
- Transactions → Transaction model: uses entity
- User → Imports API: uploads statement (evidence: `src/imports/imports.controller.ts`)
- Imports API → Statement imports: dispatches (evidence: `src/imports/imports.controller.ts`)
- Imports API → JWT guard: guards routes (evidence: `src/imports/imports.controller.ts`)
- Statement imports → Transactions: creates transactions
- Shared groups → Group service: dispatches (evidence: `src/groups/groups.controller.ts`)
- Group service → User profiles: looks up users (evidence: `src/groups/groups.service.ts`)
- Group service → Notifications: creates notifications (evidence: `src/groups/groups.service.ts`)
- Group service → Audit history: records actions (evidence: `src/groups/groups.service.ts`)
- Budgets → Category model: reads category (evidence: `src/budgets/budgets.service.ts`)
- Budgets → Transaction model: reads transactions (evidence: `src/budgets/budgets.service.ts`)
- Budgets → Audit history: records actions (evidence: `src/budgets/budgets.service.ts`)
- User → Savings goals: manages goals (evidence: `src/savings-goals/savings-goals.controller.ts`)
- User → Debts and payments: manages debts (evidence: `src/debts/debts.controller.ts`)
- User → Reports: requests reports (evidence: `src/reports/reports.controller.ts`)
- User → Transaction exports: requests exports (evidence: `src/exports/exports.controller.ts`)
- User → Recommendations: requests advice (evidence: `src/recommendations/recommendations.controller.ts`)
- User → Recurring schedules: manages schedules (evidence: `src/recurring-transactions/recurring-transactions.controller.ts`)
- User → Admin API: administers users (evidence: `src/admin/admin.controller.ts`)
