# dhait0/gestor_gastos_electiva architecture

> Architecture diagram of the GitHub repository dhait0/gestor_gastos_electiva, 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/dhait0/gestor_gastos_electiva
- Repository: https://github.com/dhait0/gestor_gastos_electiva

## Overview

Lukiva is a Spanish-language personal-finance app. Users authenticate and onboard, then record and organize money across accounts, categories, and transactions; they can plan budgets and obligations, manage debts and goals, and review dashboards, alerts, analysis, and simulations. Server actions mediate much of the app’s data access, with Supabase providing the persistence/auth client and domain modules supplying financial calculations. The README is empty; arrows are limited to relationships shown in excerpts or the SOURCE INDEX, so several unsampled feature links are intentionally omitted.

Main entry points: [`src/lib/supabase/server.ts`](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/lib/supabase/server.ts) (Supabase server client), [`src/domain`](https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/domain) (Domain calculations), [`src/app/actions/accounts.ts`](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/accounts.ts) (Accounts management), [`src/app/actions/auth.ts`](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/auth.ts) (Authentication actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app_shell["App navigation"]
  node_auth_pages["Sign in and registration"]
  node_onboarding["Financial onboarding<br/>[page.tsx]"]
  node_admin["Administration"]
  node_ui_primitives["UI primitives"]
  node_archive_control["Archive controls"]
end

subgraph group_tracking["Money tracking"]
  node_accounts["Accounts management<br/>[accounts.ts]"]
  node_categories["Category management<br/>[categories.ts]"]
  node_transactions["Transaction management<br/>[transactions.ts]"]
  node_transaction_domain["Transaction calculations<br/>[transactions.ts]"]
end

subgraph group_planning["Financial planning"]
  node_budgets["Budget planning<br/>[budgets.ts]"]
  node_budget_rules["Budget calculations<br/>[budgets.ts]"]
  node_obligations["Payment obligations<br/>[obligations.ts]"]
  node_debt_goals["Debts and goals"]
  node_recurring_subscriptions["Recurring and subscriptions"]
end

subgraph group_insights["Insights and analysis"]
  node_dashboard["Financial dashboard<br/>[page.tsx]"]
  node_alerts["Alerts<br/>[alerts.ts]"]
  node_analysis["Analysis reports<br/>[page.tsx]"]
  node_simulation["Purchase simulator<br/>[page.tsx]"]
end

subgraph group_platform["Application services"]
  node_auth_actions["Authentication actions<br/>[auth.ts]"]
  node_supabase_client["Supabase server client<br/>[server.ts]"]
  node_supabase[("Supabase")]
  node_domain_services["Domain calculations"]
end

node_user(("User"))

node_user -->|"uses"| node_app_shell
node_app_shell -->|"calls logout"| node_auth_actions
node_auth_pages -->|"submits to"| node_auth_actions
node_onboarding -->|"submits setup"| node_accounts
node_dashboard -->|"loads accounts"| node_accounts
node_dashboard -->|"loads recent"| node_transactions
node_dashboard -->|"parses period"| node_domain_services
node_dashboard -->|"renders charts"| node_ui_primitives
node_transactions -->|"uses rules"| node_transaction_domain
node_accounts -->|"calculates balances"| node_transaction_domain
node_accounts -->|"queries data"| node_supabase_client
node_transactions -->|"queries data"| node_supabase_client
node_budgets -->|"uses calculations"| node_budget_rules
node_budgets -->|"queries data"| node_supabase_client
node_categories -->|"queries data"| node_supabase_client
node_obligations -->|"queries data"| node_supabase_client
node_alerts -->|"queries data"| node_supabase_client
node_alerts -->|"uses budget data"| node_budgets
node_alerts -->|"uses alert rules"| node_domain_services
node_auth_actions -->|"authenticates via"| node_supabase_client
node_supabase_client -->|"creates client"| node_supabase
node_archive_control -->|"archives accounts"| node_accounts
node_archive_control -->|"archives categories"| node_categories
node_archive_control -->|"uses menus"| node_ui_primitives
node_auth_actions -->|"callback session"| node_supabase_client
node_transactions -->|"computes analytics"| node_domain_services
node_analysis -.->|"analyzes finances"| node_domain_services
node_simulation -.->|"simulates purchases"| node_domain_services
node_debt_goals -.->|"applies planning rules"| node_domain_services
node_recurring_subscriptions -.->|"detects recurrence"| node_domain_services
node_admin -.->|"uses permissions"| node_auth_actions

click node_app_shell "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/components/layout/AppLayoutClient.tsx"
click node_auth_pages "https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/app/(auth)"
click node_auth_actions "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/auth.ts"
click node_onboarding "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/(app)/onboarding/page.tsx"
click node_dashboard "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/(app)/dashboard/page.tsx"
click node_accounts "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/accounts.ts"
click node_categories "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/categories.ts"
click node_transactions "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/transactions.ts"
click node_transaction_domain "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/domain/transactions.ts"
click node_budgets "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/budgets.ts"
click node_budget_rules "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/domain/budgets.ts"
click node_obligations "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/obligations.ts"
click node_debt_goals "https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/app/(app)/deudas"
click node_recurring_subscriptions "https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/app/(app)/recurrentes"
click node_alerts "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/alerts.ts"
click node_analysis "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/(app)/analisis/page.tsx"
click node_simulation "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/(app)/simulador/page.tsx"
click node_admin "https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/app/(app)/admin"
click node_supabase_client "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/lib/supabase/server.ts"
click node_domain_services "https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/domain"
click node_ui_primitives "https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/components/ui"
click node_archive_control "https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/components/shared/ArchiveMenuItem.tsx"

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_app_shell,node_auth_pages,node_onboarding,node_admin,node_ui_primitives,node_archive_control,node_user toneBlue
class node_accounts,node_categories,node_transactions,node_transaction_domain toneAmber
class node_budgets,node_budget_rules,node_obligations,node_debt_goals,node_recurring_subscriptions toneMint
class node_dashboard,node_alerts,node_analysis,node_simulation toneRose
class node_auth_actions,node_supabase_client,node_supabase,node_domain_services toneIndigo
```

## Components

### App experience

- [App navigation](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/components/layout/AppLayoutClient.tsx): `src/components/layout/AppLayoutClient.tsx`
- [Sign in and registration](https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/app/(auth)): `src/app/(auth)`
- [Financial onboarding](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/(app)/onboarding/page.tsx): `src/app/(app)/onboarding/page.tsx`
- [Administration](https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/app/(app)/admin): `src/app/(app)/admin`
- [UI primitives](https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/components/ui): `src/components/ui`
- [Archive controls](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/components/shared/ArchiveMenuItem.tsx): `src/components/shared/ArchiveMenuItem.tsx`

### Money tracking

- [Accounts management](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/accounts.ts): `src/app/actions/accounts.ts`
- [Category management](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/categories.ts): `src/app/actions/categories.ts`
- [Transaction management](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/transactions.ts): `src/app/actions/transactions.ts`
- [Transaction calculations](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/domain/transactions.ts): `src/domain/transactions.ts`

### Financial planning

- [Budget planning](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/budgets.ts): `src/app/actions/budgets.ts`
- [Budget calculations](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/domain/budgets.ts): `src/domain/budgets.ts`
- [Payment obligations](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/obligations.ts): `src/app/actions/obligations.ts`
- [Debts and goals](https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/app/(app)/deudas): `src/app/(app)/deudas`
- [Recurring and subscriptions](https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/app/(app)/recurrentes): `src/app/(app)/recurrentes`

### Insights and analysis

- [Financial dashboard](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/(app)/dashboard/page.tsx): `src/app/(app)/dashboard/page.tsx`
- [Alerts](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/alerts.ts): `src/app/actions/alerts.ts`
- [Analysis reports](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/(app)/analisis/page.tsx): `src/app/(app)/analisis/page.tsx`
- [Purchase simulator](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/(app)/simulador/page.tsx): `src/app/(app)/simulador/page.tsx`

### Application services

- [Authentication actions](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/app/actions/auth.ts): `src/app/actions/auth.ts`
- [Supabase server client](https://github.com/dhait0/gestor_gastos_electiva/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- **Supabase**
- [Domain calculations](https://github.com/dhait0/gestor_gastos_electiva/tree/main/src/domain): `src/domain`

### Other components

- **User**

## Connections

- User → App navigation: uses (evidence: `src/components/layout/AppLayoutClient.tsx`)
- App navigation → Authentication actions: calls logout (evidence: `src/components/layout/AppLayoutClient.tsx`)
- Sign in and registration → Authentication actions: submits to (evidence: `src/app/(auth)/registro/page.tsx`)
- Financial onboarding → Accounts management: submits setup (evidence: `src/app/(app)/onboarding/page.tsx`)
- Financial dashboard → Accounts management: loads accounts (evidence: `src/app/(app)/dashboard/page.tsx`)
- Financial dashboard → Transaction management: loads recent (evidence: `src/app/(app)/dashboard/page.tsx`)
- Financial dashboard → Domain calculations: parses period (evidence: `src/app/(app)/dashboard/page.tsx`)
- Financial dashboard → UI primitives: renders charts (evidence: `src/app/(app)/dashboard/page.tsx`)
- Transaction management → Transaction calculations: uses rules (evidence: `src/app/actions/transactions.ts`)
- Accounts management → Transaction calculations: calculates balances (evidence: `src/app/actions/accounts.ts`)
- Accounts management → Supabase server client: queries data (evidence: `src/app/actions/accounts.ts`)
- Transaction management → Supabase server client: queries data (evidence: `src/app/actions/transactions.ts`)
- Budget planning → Budget calculations: uses calculations (evidence: `src/app/actions/budgets.ts`)
- Budget planning → Supabase server client: queries data (evidence: `src/app/actions/budgets.ts`)
- Category management → Supabase server client: queries data (evidence: `src/app/actions/categories.ts`)
- Payment obligations → Supabase server client: queries data (evidence: `src/app/actions/obligations.ts`)
- Alerts → Supabase server client: queries data (evidence: `src/app/actions/alerts.ts`)
- Alerts → Budget planning: uses budget data (evidence: `src/app/actions/alerts.ts`)
- Alerts → Domain calculations: uses alert rules (evidence: `src/app/actions/alerts.ts`)
- Authentication actions → Supabase server client: authenticates via (evidence: `src/app/actions/auth.ts`)
- Supabase server client → Supabase: creates client (evidence: `src/lib/supabase/server.ts`)
- Archive controls → Accounts management: archives accounts (evidence: `src/components/shared/ArchiveMenuItem.tsx`)
- Archive controls → Category management: archives categories (evidence: `src/components/shared/ArchiveMenuItem.tsx`)
- Archive controls → UI primitives: uses menus (evidence: `src/components/shared/ArchiveMenuItem.tsx`)
- Authentication actions → Supabase server client: callback session (evidence: `src/app/actions/auth.ts`)
- Transaction management → Domain calculations: computes analytics (evidence: `src/app/actions/transactions.ts`)
- Analysis reports → Domain calculations: analyzes finances
- Purchase simulator → Domain calculations: simulates purchases
- Debts and goals → Domain calculations: applies planning rules
- Recurring and subscriptions → Domain calculations: detects recurrence
- Administration → Authentication actions: uses permissions
