# gnmmoraes/planeja architecture

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

- Interactive diagram: https://gitdiagram.com/gnmmoraes/planeja
- Repository: https://github.com/gnmmoraes/planeja

## Overview

Planeja is a personal-finance app for managing cards, categories and income/expense transactions, then reviewing monthly totals and spending by category. Users navigate a dashboard or domain pages; forms and lists use Angular services to reach a Spring API, whose services validate and map domain data around repository operations. The excerpts show several backend calls and the route configuration; frontend-to-API links are inferred from service URLs and are marked unverified because the corresponding endpoint wiring was not sampled.

Main entry points: [`planeja-app/src/app/app.routes.ts`](https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/app.routes.ts) (Page routes), [`planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoService.java`](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoService.java) (Transaction operations), [`planeja-app/src/app/cartoes`](https://github.com/gnmmoraes/planeja/tree/main/planeja-app/src/app/cartoes) (Card pages), [`planeja-app/src/app/categorias`](https://github.com/gnmmoraes/planeja/tree/main/planeja-app/src/app/categorias) (Category pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_routes["Page routes<br/>[app.routes.ts]"]
  node_cardui["Card pages"]
  node_categoryui["Category pages"]
  node_entryui["Transaction pages"]
  node_dashboardui["Dashboard page<br/>[dashboard-page.ts]"]
  node_cardclient["Card client<br/>[cartao-service.ts]"]
  node_categoryclient["Category client"]
  node_entryclient["Transaction client"]
  node_dashboardclient["Dashboard client"]
end

subgraph group_api["Spring API"]
  node_cardcontroller["Card API"]
  node_categorycontroller["Category API"]
  node_entrycontroller["Transaction API"]
  node_entrylistapi["Transaction listing API"]
  node_dashboardcontroller["Dashboard API"]
end

subgraph group_finance["Finance domains"]
  node_cardservice["Card operations<br/>[CartaoService.java]"]
  node_categoryservice["Category operations"]
  node_entryservice["Transaction operations"]
  node_dashboardservice["Monthly summaries"]
  node_cardrepo[("Card records")]
  node_categoryrepo[("Category records")]
  node_entryrepo[("Transaction records")]
end

subgraph group_shared["Shared API support"]
  node_sharederrors["Exception handling"]
end

node_user(("User"))

node_user -->|"navigates"| node_routes
node_routes -->|"routes to"| node_dashboardui
node_routes -->|"routes to"| node_cardui
node_routes -->|"routes to"| node_categoryui
node_routes -->|"routes to"| node_entryui
node_cardui -.->|"uses"| node_cardclient
node_categoryui -.->|"uses"| node_categoryclient
node_entryui -->|"calls"| node_entryclient
node_dashboardui -.->|"uses"| node_dashboardclient
node_cardclient -.->|"HTTP requests"| node_cardcontroller
node_categoryclient -.->|"HTTP requests"| node_categorycontroller
node_entryclient -.->|"HTTP requests"| node_entrycontroller
node_dashboardclient -.->|"HTTP requests"| node_dashboardcontroller
node_cardcontroller -->|"delegates to"| node_cardservice
node_categorycontroller -->|"delegates to"| node_categoryservice
node_entrycontroller -.->|"delegates to"| node_entryservice
node_entrylistapi -->|"delegates to"| node_entryservice
node_dashboardcontroller -->|"delegates to"| node_dashboardservice
node_cardservice -->|"reads and writes"| node_cardrepo
node_categoryservice -->|"reads and writes"| node_categoryrepo
node_entryservice -->|"reads and writes"| node_entryrepo
node_entryservice -->|"looks up category"| node_categoryrepo
node_entryservice -->|"looks up card"| node_cardrepo
node_dashboardservice -->|"aggregates records"| node_entryrepo

click node_routes "https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/app.routes.ts"
click node_cardui "https://github.com/gnmmoraes/planeja/tree/main/planeja-app/src/app/cartoes"
click node_categoryui "https://github.com/gnmmoraes/planeja/tree/main/planeja-app/src/app/categorias"
click node_entryui "https://github.com/gnmmoraes/planeja/tree/main/planeja-app/src/app/lancamentos"
click node_dashboardui "https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/dashboard/dashboard-page/dashboard-page.ts"
click node_cardclient "https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/cartoes/cartao-service.ts"
click node_categoryclient "https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/categorias/categoria-service.ts"
click node_entryclient "https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/lancamentos/lancamento-service.ts"
click node_dashboardclient "https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/dashboard/dashboard-service.ts"
click node_cardcontroller "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoController.java"
click node_categorycontroller "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaController.java"
click node_entrycontroller "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/CadastroLancamentoController.java"
click node_entrylistapi "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/ListagemLancamentoController.java"
click node_dashboardcontroller "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/dashboard/DashboardController.java"
click node_cardservice "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoService.java"
click node_categoryservice "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaService.java"
click node_entryservice "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoService.java"
click node_dashboardservice "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/dashboard/DashboardService.java"
click node_cardrepo "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoRepository.java"
click node_categoryrepo "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaRepository.java"
click node_entryrepo "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoRepository.java"
click node_sharederrors "https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/infra/handlers/GlobalExceptionHandler.java"

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_routes,node_cardui,node_categoryui,node_entryui,node_dashboardui,node_cardclient,node_categoryclient,node_entryclient,node_dashboardclient,node_user toneBlue
class node_cardcontroller,node_categorycontroller,node_entrycontroller,node_entrylistapi,node_dashboardcontroller toneAmber
class node_cardservice,node_categoryservice,node_entryservice,node_dashboardservice,node_cardrepo,node_categoryrepo,node_entryrepo toneMint
class node_sharederrors toneRose
```

## Components

### Angular client

- [Page routes](https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/app.routes.ts): `planeja-app/src/app/app.routes.ts`
- [Card pages](https://github.com/gnmmoraes/planeja/tree/main/planeja-app/src/app/cartoes): `planeja-app/src/app/cartoes`
- [Category pages](https://github.com/gnmmoraes/planeja/tree/main/planeja-app/src/app/categorias): `planeja-app/src/app/categorias`
- [Transaction pages](https://github.com/gnmmoraes/planeja/tree/main/planeja-app/src/app/lancamentos): `planeja-app/src/app/lancamentos`
- [Dashboard page](https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/dashboard/dashboard-page/dashboard-page.ts): `planeja-app/src/app/dashboard/dashboard-page/dashboard-page.ts`
- [Card client](https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/cartoes/cartao-service.ts): `planeja-app/src/app/cartoes/cartao-service.ts`
- [Category client](https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/categorias/categoria-service.ts): `planeja-app/src/app/categorias/categoria-service.ts`
- [Transaction client](https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/lancamentos/lancamento-service.ts): `planeja-app/src/app/lancamentos/lancamento-service.ts`
- [Dashboard client](https://github.com/gnmmoraes/planeja/blob/main/planeja-app/src/app/dashboard/dashboard-service.ts): `planeja-app/src/app/dashboard/dashboard-service.ts`

### Spring API

- [Card API](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoController.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoController.java`
- [Category API](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaController.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaController.java`
- [Transaction API](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/CadastroLancamentoController.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/CadastroLancamentoController.java`
- [Transaction listing API](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/ListagemLancamentoController.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/ListagemLancamentoController.java`
- [Dashboard API](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/dashboard/DashboardController.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/dashboard/DashboardController.java`

### Finance domains

- [Card operations](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoService.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoService.java`
- [Category operations](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaService.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaService.java`
- [Transaction operations](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoService.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoService.java`
- [Monthly summaries](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/dashboard/DashboardService.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/dashboard/DashboardService.java`
- [Card records](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoRepository.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoRepository.java`
- [Category records](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaRepository.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaRepository.java`
- [Transaction records](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoRepository.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoRepository.java`

### Shared API support

- [Exception handling](https://github.com/gnmmoraes/planeja/blob/main/planeja-api/src/main/java/com/github/gnmmoraes/planeja/infra/handlers/GlobalExceptionHandler.java): `planeja-api/src/main/java/com/github/gnmmoraes/planeja/infra/handlers/GlobalExceptionHandler.java`

### Other components

- **User**

## Connections

- User → Page routes: navigates (evidence: `planeja-app/src/app/app.routes.ts`)
- Page routes → Dashboard page: routes to (evidence: `planeja-app/src/app/app.routes.ts`)
- Page routes → Card pages: routes to (evidence: `planeja-app/src/app/app.routes.ts`)
- Page routes → Category pages: routes to (evidence: `planeja-app/src/app/app.routes.ts`)
- Page routes → Transaction pages: routes to (evidence: `planeja-app/src/app/app.routes.ts`)
- Card pages → Card client: uses (evidence: `planeja-app/src/app/cartoes/cadastro-cartao/cadastro-cartao.ts`)
- Category pages → Category client: uses (evidence: `planeja-app/src/app/categorias/categoria-service.ts`)
- Transaction pages → Transaction client: calls (evidence: `planeja-app/src/app/lancamentos/cadastro-lancamento/cadastro-lancamento.ts`)
- Dashboard page → Dashboard client: uses
- Card client → Card API: HTTP requests
- Category client → Category API: HTTP requests
- Transaction client → Transaction API: HTTP requests
- Dashboard client → Dashboard API: HTTP requests
- Card API → Card operations: delegates to (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoController.java`)
- Category API → Category operations: delegates to (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaController.java`)
- Transaction API → Transaction operations: delegates to (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/CadastroLancamentoController.java`)
- Transaction listing API → Transaction operations: delegates to (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/ListagemLancamentoController.java`)
- Dashboard API → Monthly summaries: delegates to (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/dashboard/DashboardController.java`)
- Card operations → Card records: reads and writes (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/cartao/CartaoService.java`)
- Category operations → Category records: reads and writes (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/categoria/CategoriaService.java`)
- Transaction operations → Transaction records: reads and writes (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoService.java`)
- Transaction operations → Category records: looks up category (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoService.java`)
- Transaction operations → Card records: looks up card (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/lancamento/LancamentoService.java`)
- Monthly summaries → Transaction records: aggregates records (evidence: `planeja-api/src/main/java/com/github/gnmmoraes/planeja/dominio/dashboard/DashboardService.java`)
