# jv2008/app-financa-pessoal architecture

> Architecture diagram of the GitHub repository jv2008/app-financa-pessoal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jv2008/app-financa-pessoal
- Repository: https://github.com/jv2008/app-financa-pessoal

## Overview

This is a personal-finance web app for replacing spreadsheet-based tracking. Users authenticate, review accounts and balances, record and manage transactions, then inspect financial summaries and analytics. The graph follows the evidenced dashboard and transaction flows through query modules to Neon Postgres; it also preserves the visible authentication, account, analytics, and investment areas. Several page and integration implementations were not excerpted, so relationships to those areas are omitted or marked unverified rather than inferred.

Main entry points: [`lib/auth.ts`](https://github.com/jv2008/app-financa-pessoal/blob/main/lib/auth.ts) (Authentication), [`app/(dashboard)/page.tsx`](https://github.com/jv2008/app-financa-pessoal/blob/main/app/(dashboard)/page.tsx) (Dashboard), [`app/transacoes/page.tsx`](https://github.com/jv2008/app-financa-pessoal/blob/main/app/transacoes/page.tsx) (Transaction statement), [`app/analise/page.tsx`](https://github.com/jv2008/app-financa-pessoal/blob/main/app/analise/page.tsx) (Analysis page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and navigation"]
  node_login["Login page<br/>[page.tsx]"]
  node_register["Registration page<br/>[page.tsx]"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_authapi["Auth API<br/>[route.ts]"]
  node_nav["App navigation<br/>[sidebar.tsx]"]
  node_registrationapi["Registration API<br/>[route.ts]"]
end

subgraph group_finance["Financial records"]
  node_transactionsview["Transaction statement<br/>[page.tsx]"]
  node_transactionui["Transaction controls"]
  node_transactionmodal["Transaction entry"]
  node_transactionapi["Transaction API<br/>[route.ts]"]
  node_transactionitemapi["Transaction item API<br/>[route.ts]"]
  node_accountui["Account controls<br/>[account-modal.tsx]"]
  node_accountapi["Accounts API<br/>[route.ts]"]
  node_investmentpage["Investments page<br/>[page.tsx]"]
  node_investmentapi["Investments API<br/>[route.ts]"]
end

subgraph group_insights["Summaries and analysis"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_summary["Financial summary"]
  node_analyticspage["Analysis page<br/>[page.tsx]"]
  node_analytics["Analytics dashboard"]
  node_charts["Analytics charts"]
end

subgraph group_data["Persistence"]
  node_accountqueries["Account queries<br/>[accounts.ts]"]
  node_transactionqueries["Transaction queries<br/>[transactions.ts]"]
  node_categoryqueries["Category queries<br/>[categories.ts]"]
  node_investmentqueries["Investment queries<br/>[investments.ts]"]
  node_dbclient["Database client<br/>[db.ts]"]
  node_postgres[("Neon Postgres")]
end

node_user(("User"))

node_user -->|"signs in"| node_login
node_user -->|"creates account"| node_register
node_login -.->|"authenticates"| node_auth
node_authapi -->|"routes auth"| node_auth
node_auth -->|"queries credentials"| node_dbclient
node_user -->|"views finances"| node_dashboard
node_dashboard -->|"checks session"| node_auth
node_dashboard -->|"loads accounts"| node_accountqueries
node_dashboard -->|"loads balances"| node_transactionqueries
node_dashboard -->|"loads categories"| node_categoryqueries
node_dashboard -->|"renders summary"| node_summary
node_dashboard -->|"renders entry"| node_transactionmodal
node_dashboard -->|"renders actions"| node_transactionui
node_user -->|"reviews transactions"| node_transactionsview
node_transactionsview -->|"checks session"| node_auth
node_transactionsview -->|"loads accounts"| node_accountqueries
node_transactionsview -->|"loads statement"| node_transactionqueries
node_transactionsview -->|"loads categories"| node_categoryqueries
node_transactionsview -->|"renders actions"| node_transactionui
node_transactionui -->|"sends edits"| node_transactionitemapi
node_user -->|"submits transaction"| node_transactionapi
node_transactionapi -->|"checks session"| node_auth
node_transactionapi -->|"validates account"| node_accountqueries
node_transactionapi -->|"reads or creates"| node_transactionqueries
node_transactionitemapi -->|"checks session"| node_auth
node_transactionitemapi -->|"updates or deletes"| node_transactionqueries
node_user -.->|"adds account"| node_accountui
node_user -.->|"manages accounts"| node_accountapi
node_accountapi -->|"checks session"| node_auth
node_accountapi -->|"reads or writes"| node_accountqueries
node_user -->|"opens analysis"| node_analyticspage
node_analyticspage -->|"checks session"| node_auth
node_analyticspage -->|"loads accounts"| node_accountqueries
node_analyticspage -->|"loads transactions"| node_transactionqueries
node_analyticspage -->|"loads categories"| node_categoryqueries
node_analyticspage -->|"renders analysis"| node_analytics
node_analytics -->|"renders charts"| node_charts
node_user -->|"views investments"| node_investmentpage
node_investmentpage -->|"checks session"| node_auth
node_investmentapi -.->|"delegates operations"| node_investmentqueries
node_registrationapi -->|"registers user"| node_dbclient
node_accountqueries -->|"runs SQL"| node_dbclient
node_transactionqueries -->|"runs SQL"| node_dbclient
node_categoryqueries -->|"runs SQL"| node_dbclient
node_dbclient -->|"connects to"| node_postgres

click node_login "https://github.com/jv2008/app-financa-pessoal/blob/main/app/(auth)/login/page.tsx"
click node_register "https://github.com/jv2008/app-financa-pessoal/blob/main/app/(auth)/register/page.tsx"
click node_auth "https://github.com/jv2008/app-financa-pessoal/blob/main/lib/auth.ts"
click node_authapi "https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/auth/%5B...nextauth%5D/route.ts"
click node_nav "https://github.com/jv2008/app-financa-pessoal/blob/main/components/ui/sidebar.tsx"
click node_dashboard "https://github.com/jv2008/app-financa-pessoal/blob/main/app/(dashboard)/page.tsx"
click node_summary "https://github.com/jv2008/app-financa-pessoal/blob/main/components/dashboard/financial-summary-card.tsx"
click node_analyticspage "https://github.com/jv2008/app-financa-pessoal/blob/main/app/analise/page.tsx"
click node_analytics "https://github.com/jv2008/app-financa-pessoal/blob/main/components/analytics/analytics-dashboard.tsx"
click node_charts "https://github.com/jv2008/app-financa-pessoal/tree/main/components/charts"
click node_transactionsview "https://github.com/jv2008/app-financa-pessoal/blob/main/app/transacoes/page.tsx"
click node_transactionui "https://github.com/jv2008/app-financa-pessoal/blob/main/components/transactions/transaction-actions.tsx"
click node_transactionmodal "https://github.com/jv2008/app-financa-pessoal/blob/main/components/transactions/transaction-modal.tsx"
click node_transactionapi "https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/transactions/route.ts"
click node_transactionitemapi "https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/transactions/%5Bid%5D/route.ts"
click node_accountui "https://github.com/jv2008/app-financa-pessoal/blob/main/components/accounts/account-modal.tsx"
click node_accountapi "https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/accounts/route.ts"
click node_investmentpage "https://github.com/jv2008/app-financa-pessoal/blob/main/app/(dashboard)/investments/page.tsx"
click node_investmentapi "https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/investments/route.ts"
click node_accountqueries "https://github.com/jv2008/app-financa-pessoal/blob/main/lib/queries/accounts.ts"
click node_transactionqueries "https://github.com/jv2008/app-financa-pessoal/blob/main/lib/queries/transactions.ts"
click node_categoryqueries "https://github.com/jv2008/app-financa-pessoal/blob/main/lib/queries/categories.ts"
click node_investmentqueries "https://github.com/jv2008/app-financa-pessoal/blob/main/lib/queries/investments.ts"
click node_registrationapi "https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/register/route.ts"
click node_dbclient "https://github.com/jv2008/app-financa-pessoal/blob/main/lib/db.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_login,node_register,node_auth,node_authapi,node_nav,node_registrationapi,node_user toneBlue
class node_transactionsview,node_transactionui,node_transactionmodal,node_transactionapi,node_transactionitemapi,node_accountui,node_accountapi,node_investmentpage,node_investmentapi toneAmber
class node_dashboard,node_summary,node_analyticspage,node_analytics,node_charts toneMint
class node_accountqueries,node_transactionqueries,node_categoryqueries,node_investmentqueries,node_dbclient,node_postgres toneRose
```

## Components

### Access and navigation

- [Login page](https://github.com/jv2008/app-financa-pessoal/blob/main/app/(auth)/login/page.tsx): `app/(auth)/login/page.tsx`
- [Registration page](https://github.com/jv2008/app-financa-pessoal/blob/main/app/(auth)/register/page.tsx): `app/(auth)/register/page.tsx`
- [Authentication](https://github.com/jv2008/app-financa-pessoal/blob/main/lib/auth.ts): `lib/auth.ts`
- [Auth API](https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/auth/%5B...nextauth%5D/route.ts): `app/api/auth/[...nextauth]/route.ts`
- [App navigation](https://github.com/jv2008/app-financa-pessoal/blob/main/components/ui/sidebar.tsx): `components/ui/sidebar.tsx`
- [Registration API](https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/register/route.ts): `app/api/register/route.ts`

### Financial records

- [Transaction statement](https://github.com/jv2008/app-financa-pessoal/blob/main/app/transacoes/page.tsx): `app/transacoes/page.tsx`
- [Transaction controls](https://github.com/jv2008/app-financa-pessoal/blob/main/components/transactions/transaction-actions.tsx): `components/transactions/transaction-actions.tsx`
- [Transaction entry](https://github.com/jv2008/app-financa-pessoal/blob/main/components/transactions/transaction-modal.tsx): `components/transactions/transaction-modal.tsx`
- [Transaction API](https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/transactions/route.ts): `app/api/transactions/route.ts`
- [Transaction item API](https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/transactions/%5Bid%5D/route.ts): `app/api/transactions/[id]/route.ts`
- [Account controls](https://github.com/jv2008/app-financa-pessoal/blob/main/components/accounts/account-modal.tsx): `components/accounts/account-modal.tsx`
- [Accounts API](https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/accounts/route.ts): `app/api/accounts/route.ts`
- [Investments page](https://github.com/jv2008/app-financa-pessoal/blob/main/app/(dashboard)/investments/page.tsx): `app/(dashboard)/investments/page.tsx`
- [Investments API](https://github.com/jv2008/app-financa-pessoal/blob/main/app/api/investments/route.ts): `app/api/investments/route.ts`

### Summaries and analysis

- [Dashboard](https://github.com/jv2008/app-financa-pessoal/blob/main/app/(dashboard)/page.tsx): `app/(dashboard)/page.tsx`
- [Financial summary](https://github.com/jv2008/app-financa-pessoal/blob/main/components/dashboard/financial-summary-card.tsx): `components/dashboard/financial-summary-card.tsx`
- [Analysis page](https://github.com/jv2008/app-financa-pessoal/blob/main/app/analise/page.tsx): `app/analise/page.tsx`
- [Analytics dashboard](https://github.com/jv2008/app-financa-pessoal/blob/main/components/analytics/analytics-dashboard.tsx): `components/analytics/analytics-dashboard.tsx`
- [Analytics charts](https://github.com/jv2008/app-financa-pessoal/tree/main/components/charts): `components/charts`

### Persistence

- [Account queries](https://github.com/jv2008/app-financa-pessoal/blob/main/lib/queries/accounts.ts): `lib/queries/accounts.ts`
- [Transaction queries](https://github.com/jv2008/app-financa-pessoal/blob/main/lib/queries/transactions.ts): `lib/queries/transactions.ts`
- [Category queries](https://github.com/jv2008/app-financa-pessoal/blob/main/lib/queries/categories.ts): `lib/queries/categories.ts`
- [Investment queries](https://github.com/jv2008/app-financa-pessoal/blob/main/lib/queries/investments.ts): `lib/queries/investments.ts`
- [Database client](https://github.com/jv2008/app-financa-pessoal/blob/main/lib/db.ts): `lib/db.ts`
- **Neon Postgres**

### Other components

- **User**

## Connections

- User → Login page: signs in
- User → Registration page: creates account
- Login page → Authentication: authenticates
- Auth API → Authentication: routes auth (evidence: `app/api/auth/[...nextauth]/route.ts`)
- Authentication → Database client: queries credentials (evidence: `lib/auth.ts`)
- User → Dashboard: views finances
- Dashboard → Authentication: checks session (evidence: `app/(dashboard)/page.tsx`)
- Dashboard → Account queries: loads accounts (evidence: `app/(dashboard)/page.tsx`)
- Dashboard → Transaction queries: loads balances (evidence: `app/(dashboard)/page.tsx`)
- Dashboard → Category queries: loads categories (evidence: `app/(dashboard)/page.tsx`)
- Dashboard → Financial summary: renders summary (evidence: `app/(dashboard)/page.tsx`)
- Dashboard → Transaction entry: renders entry (evidence: `app/(dashboard)/page.tsx`)
- Dashboard → Transaction controls: renders actions (evidence: `app/(dashboard)/page.tsx`)
- User → Transaction statement: reviews transactions
- Transaction statement → Authentication: checks session (evidence: `app/transacoes/page.tsx`)
- Transaction statement → Account queries: loads accounts (evidence: `app/transacoes/page.tsx`)
- Transaction statement → Transaction queries: loads statement (evidence: `app/transacoes/page.tsx`)
- Transaction statement → Category queries: loads categories (evidence: `app/transacoes/page.tsx`)
- Transaction statement → Transaction controls: renders actions (evidence: `app/transacoes/page.tsx`)
- Transaction controls → Transaction item API: sends edits (evidence: `components/transactions/transaction-actions.tsx`)
- User → Transaction API: submits transaction
- Transaction API → Authentication: checks session (evidence: `app/api/transactions/route.ts`)
- Transaction API → Account queries: validates account (evidence: `app/api/transactions/route.ts`)
- Transaction API → Transaction queries: reads or creates (evidence: `app/api/transactions/route.ts`)
- Transaction item API → Authentication: checks session (evidence: `app/api/transactions/[id]/route.ts`)
- Transaction item API → Transaction queries: updates or deletes (evidence: `app/api/transactions/[id]/route.ts`)
- User → Account controls: adds account
- User → Accounts API: manages accounts
- Accounts API → Authentication: checks session (evidence: `app/api/accounts/route.ts`)
- Accounts API → Account queries: reads or writes (evidence: `app/api/accounts/route.ts`)
- User → Analysis page: opens analysis
- Analysis page → Authentication: checks session (evidence: `app/analise/page.tsx`)
- Analysis page → Account queries: loads accounts (evidence: `app/analise/page.tsx`)
- Analysis page → Transaction queries: loads transactions (evidence: `app/analise/page.tsx`)
- Analysis page → Category queries: loads categories (evidence: `app/analise/page.tsx`)
- Analysis page → Analytics dashboard: renders analysis (evidence: `app/analise/page.tsx`)
- Analytics dashboard → Analytics charts: renders charts (evidence: `components/analytics/analytics-dashboard.tsx`)
- User → Investments page: views investments
- Investments page → Authentication: checks session (evidence: `app/(dashboard)/investments/page.tsx`)
- Investments API → Investment queries: delegates operations
- Registration API → Database client: registers user (evidence: `app/api/register/route.ts`)
- Account queries → Database client: runs SQL (evidence: `lib/queries/accounts.ts`)
- Transaction queries → Database client: runs SQL (evidence: `lib/queries/transactions.ts`)
- Category queries → Database client: runs SQL (evidence: `lib/queries/categories.ts`)
- Database client → Neon Postgres: connects to (evidence: `lib/db.ts`)
