# luizcarlxs01/finly architecture

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

- Interactive diagram: https://gitdiagram.com/luizcarlxs01/finly
- Repository: https://github.com/luizcarlxs01/finly

## Overview

Finly is a personal-finance app with account-based and no-account modes, delivered through a Next.js web client, a .NET API, and a Flutter mobile shell. The account workflow runs from registration and email verification or login, through profile setup and financial activity, to dashboards, goals, rules, forecasts, and calendar views; the forum is a separate community capability. The web also supports local finance data without an account. Edges are limited to relationships shown in the supplied excerpts, source index, or README; several unsampled feature links are intentionally omitted.

Main entry points: [`apps/api/Finly.Infrastructure/Data/AppDbContext.cs`](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Infrastructure/Data/AppDbContext.cs) (Data access context), [`apps/web/src/app/page.tsx`](https://github.com/luizcarlxs01/finly/blob/main/apps/web/src/app/page.tsx) (Web client), [`apps/api/Finly.Application/Services/AuthService.cs`](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/AuthService.cs) (Account and verification), [`apps/api/Finly.Application/Services/TransactionService.cs`](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/TransactionService.cs) (Transactions and occurrences)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_web["Web client<br/>[page.tsx]"]
  node_mobile["Mobile shell<br/>[MainActivity.kt]"]
  node_local_mode["No-account finance"]
end

subgraph group_api["API endpoints"]
  node_auth_api["Authentication API<br/>[AuthController.cs]"]
  node_finance_api["Finance APIs"]
  node_goals_api["Goals API<br/>[GoalsController.cs]"]
  node_forum_api["Forum API<br/>[ForumController.cs]"]
end

subgraph group_services["Application services"]
  node_auth["Account and verification<br/>[AuthService.cs]"]
  node_transactions["Transactions and occurrences"]
  node_goals["Savings goals<br/>[GoalService.cs]"]
  node_rules["Financial rules"]
  node_forum["Community moderation<br/>[ForumService.cs]"]
  node_dashboard["Dashboard insights"]
  node_occurrence_generation["Occurrence generation"]
  node_rule_processing["Rule processing"]
end

subgraph group_infra["Persistence and integrations"]
  node_db_context["Data access context<br/>[AppDbContext.cs]"]
  node_database[("SQL data store")]
  node_token["JWT tokens<br/>[TokenService.cs]"]
  node_email["Resend email"]
end

node_person(("Finly user"))
node_resend["Resend service"]

node_person -->|"uses"| node_web
node_person -->|"uses"| node_mobile
node_web -.->|"stores locally"| node_local_mode
node_web -.->|"requests auth"| node_auth_api
node_web -.->|"requests finance"| node_finance_api
node_web -.->|"requests goals"| node_goals_api
node_web -.->|"requests forum"| node_forum_api
node_auth_api -->|"calls"| node_auth
node_finance_api -->|"calls"| node_transactions
node_goals_api -->|"calls"| node_goals
node_forum_api -->|"calls"| node_forum
node_auth -->|"reads and writes"| node_db_context
node_transactions -->|"reads and writes"| node_db_context
node_transactions -->|"generates occurrences"| node_occurrence_generation
node_rules -->|"reads and writes"| node_db_context
node_db_context -->|"persists data"| node_database
node_auth -->|"generates token"| node_token
node_auth -->|"sends verification"| node_email
node_email -.->|"delivers mail"| node_resend
node_goals -.->|"reads and writes"| node_db_context
node_forum -.->|"reads and writes"| node_db_context
node_dashboard -.->|"reads summaries"| node_db_context
node_rule_processing -.->|"reads and writes"| node_db_context

click node_web "https://github.com/luizcarlxs01/finly/blob/main/apps/web/src/app/page.tsx"
click node_mobile "https://github.com/luizcarlxs01/finly/blob/main/apps/mobile/android/app/src/main/kotlin/com/finly/finly_mobile/MainActivity.kt"
click node_auth_api "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Api/Controllers/AuthController.cs"
click node_finance_api "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Api/Controllers/TransactionsController.cs"
click node_goals_api "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Api/Controllers/GoalsController.cs"
click node_forum_api "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Api/Controllers/ForumController.cs"
click node_auth "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/AuthService.cs"
click node_transactions "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/TransactionService.cs"
click node_goals "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/GoalService.cs"
click node_rules "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/FinancialRuleService.cs"
click node_forum "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/ForumService.cs"
click node_dashboard "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/DashboardService.cs"
click node_occurrence_generation "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/OccurrenceGenerationService.cs"
click node_rule_processing "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/RuleProcessingService.cs"
click node_local_mode "https://github.com/luizcarlxs01/finly/blob/main/apps/web/src/hooks/use-local-finance.ts"
click node_db_context "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Infrastructure/Data/AppDbContext.cs"
click node_token "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Infrastructure/Security/TokenService.cs"
click node_email "https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Infrastructure/Email/ResendEmailSender.cs"

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_web,node_mobile,node_local_mode,node_person toneBlue
class node_auth_api,node_finance_api,node_goals_api,node_forum_api toneAmber
class node_auth,node_transactions,node_goals,node_rules,node_forum,node_dashboard,node_occurrence_generation,node_rule_processing toneMint
class node_db_context,node_database,node_token,node_email toneRose
class node_resend toneIndigo
```

## Components

### User clients

- [Web client](https://github.com/luizcarlxs01/finly/blob/main/apps/web/src/app/page.tsx): `apps/web/src/app/page.tsx`
- [Mobile shell](https://github.com/luizcarlxs01/finly/blob/main/apps/mobile/android/app/src/main/kotlin/com/finly/finly_mobile/MainActivity.kt): `apps/mobile/android/app/src/main/kotlin/com/finly/finly_mobile/MainActivity.kt`
- [No-account finance](https://github.com/luizcarlxs01/finly/blob/main/apps/web/src/hooks/use-local-finance.ts): `apps/web/src/hooks/use-local-finance.ts`

### API endpoints

- [Authentication API](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Api/Controllers/AuthController.cs): `apps/api/Finly.Api/Controllers/AuthController.cs`
- [Finance APIs](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Api/Controllers/TransactionsController.cs): `apps/api/Finly.Api/Controllers/TransactionsController.cs`
- [Goals API](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Api/Controllers/GoalsController.cs): `apps/api/Finly.Api/Controllers/GoalsController.cs`
- [Forum API](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Api/Controllers/ForumController.cs): `apps/api/Finly.Api/Controllers/ForumController.cs`

### Application services

- [Account and verification](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/AuthService.cs): `apps/api/Finly.Application/Services/AuthService.cs`
- [Transactions and occurrences](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/TransactionService.cs): `apps/api/Finly.Application/Services/TransactionService.cs`
- [Savings goals](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/GoalService.cs): `apps/api/Finly.Application/Services/GoalService.cs`
- [Financial rules](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/FinancialRuleService.cs): `apps/api/Finly.Application/Services/FinancialRuleService.cs`
- [Community moderation](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/ForumService.cs): `apps/api/Finly.Application/Services/ForumService.cs`
- [Dashboard insights](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/DashboardService.cs): `apps/api/Finly.Application/Services/DashboardService.cs`
- [Occurrence generation](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/OccurrenceGenerationService.cs): `apps/api/Finly.Application/Services/OccurrenceGenerationService.cs`
- [Rule processing](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Application/Services/RuleProcessingService.cs): `apps/api/Finly.Application/Services/RuleProcessingService.cs`

### Persistence and integrations

- [Data access context](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Infrastructure/Data/AppDbContext.cs): `apps/api/Finly.Infrastructure/Data/AppDbContext.cs`
- **SQL data store**
- [JWT tokens](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Infrastructure/Security/TokenService.cs): `apps/api/Finly.Infrastructure/Security/TokenService.cs`
- [Resend email](https://github.com/luizcarlxs01/finly/blob/main/apps/api/Finly.Infrastructure/Email/ResendEmailSender.cs): `apps/api/Finly.Infrastructure/Email/ResendEmailSender.cs`

### Other components

- **Finly user**
- **Resend service**

## Connections

- Finly user → Web client: uses (evidence: `README.md`)
- Finly user → Mobile shell: uses (evidence: `README.md`)
- Web client → No-account finance: stores locally
- Web client → Authentication API: requests auth
- Web client → Finance APIs: requests finance
- Web client → Goals API: requests goals
- Web client → Forum API: requests forum
- Authentication API → Account and verification: calls (evidence: `apps/api/Finly.Api/Controllers/AuthController.cs`)
- Finance APIs → Transactions and occurrences: calls (evidence: `apps/api/Finly.Api/Controllers/TransactionsController.cs`)
- Goals API → Savings goals: calls (evidence: `apps/api/Finly.Api/Controllers/GoalsController.cs`)
- Forum API → Community moderation: calls (evidence: `apps/api/Finly.Api/Controllers/ForumController.cs`)
- Account and verification → Data access context: reads and writes (evidence: `apps/api/Finly.Application/Services/AuthService.cs`)
- Transactions and occurrences → Data access context: reads and writes (evidence: `apps/api/Finly.Application/Services/TransactionService.cs`)
- Transactions and occurrences → Occurrence generation: generates occurrences (evidence: `apps/api/Finly.Application/Services/TransactionService.cs`)
- Financial rules → Data access context: reads and writes (evidence: `apps/api/Finly.Application/Services/FinancialRuleService.cs`)
- Data access context → SQL data store: persists data (evidence: `apps/api/Finly.Infrastructure/Data/AppDbContext.cs`)
- Account and verification → JWT tokens: generates token (evidence: `apps/api/Finly.Application/Services/AuthService.cs`)
- Account and verification → Resend email: sends verification (evidence: `apps/api/Finly.Application/Services/AuthService.cs`)
- Resend email → Resend service: delivers mail
- Savings goals → Data access context: reads and writes
- Community moderation → Data access context: reads and writes
- Dashboard insights → Data access context: reads summaries
- Rule processing → Data access context: reads and writes
