# evandroabreu/ngov architecture

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

## Overview

Ngov is a multi-tenant public-sector management platform with a web application, an operations console, and a mobile app. In the main workflow, authenticated users navigate the web modules to manage access and settings, register people, and handle suppliers, creditors, payment destinations, and sanctions. The platform also exposes public queries and activation/console operations. The graph reflects controller-to-application calls visible in excerpts or the SOURCE INDEX; repository-to-repository HTTP links and most persistence wiring were not shown, so they are omitted or marked unverified.

Main entry points: [`frontend/apps/web/src/app/app.routes.ts`](https://github.com/evandroabreu/ngov/blob/main/frontend/apps/web/src/app/app.routes.ts) (Management web), [`backend/modules/pessoas/src/main/java/br/ngov/pessoas/infrastructure/web/PessoasController.java`](https://github.com/evandroabreu/ngov/blob/main/backend/modules/pessoas/src/main/java/br/ngov/pessoas/infrastructure/web/PessoasController.java) (People endpoints), [`frontend/apps/console/src/app/app.routes.ts`](https://github.com/evandroabreu/ngov/blob/main/frontend/apps/console/src/app/app.routes.ts) (Operations console), [`backend/modules/core/src/main/java/br/ngov/core/infrastructure/web/AdministracaoDeAcessoController.java`](https://github.com/evandroabreu/ngov/blob/main/backend/modules/core/src/main/java/br/ngov/core/infrastructure/web/AdministracaoDeAcessoController.java) (Access administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User applications"]
  node_web["Management web<br/>[app.routes.ts]"]
  node_webcore["Core screens<br/>[rotas.ts]"]
  node_webpeople["People screens<br/>[rotas.ts]"]
  node_webrcf["RCF screens<br/>[rotas.ts]"]
  node_consoleui["Operations console<br/>[app.routes.ts]"]
  node_mobile["Mobile app<br/>[app.routes.ts]"]
  node_auth["Authentication service<br/>[servico-auth.ts]"]
end

subgraph group_platform["Platform operations"]
  node_activationapi["Activation endpoints"]
  node_activation["Activation handling"]
  node_consoleapi["Console endpoints"]
  node_consoleops["Console operations"]
  node_publicapi["Public queries"]
  node_tenancy["Tenant context"]
end

subgraph group_core["Core governance"]
  node_access["Access administration"]
  node_parameters["Parameter settings"]
  node_coredata[("Core persistence")]
end

subgraph group_people["People registry"]
  node_peopleapi["People endpoints"]
  node_peopleapp["People registry"]
  node_peopledata[("People persistence<br/>[PessoasJdbc.java]")]
end

subgraph group_rcf["Suppliers and creditors"]
  node_rcfroles["Supplier and creditor roles<br/>[RcfController.java]"]
  node_destinations["Payment destinations"]
  node_sanctions["Sanctions"]
  node_documents["Enrollment documents"]
end

node_user(("User"))

node_user -->|"uses"| node_web
node_user -->|"uses"| node_consoleui
node_user -->|"uses"| node_mobile
node_web -->|"routes to"| node_webcore
node_web -->|"routes to"| node_webpeople
node_web -->|"routes to"| node_webrcf
node_web -->|"guards routes"| node_auth
node_consoleui -->|"guards routes"| node_auth
node_mobile -->|"presents start"| node_user
node_consoleui -.->|"calls API"| node_consoleapi
node_web -.->|"calls API"| node_access
node_web -.->|"calls API"| node_peopleapi
node_web -.->|"calls API"| node_rcfroles
node_web -.->|"calls API"| node_destinations
node_web -.->|"calls API"| node_sanctions
node_activationapi -->|"delegates to"| node_activation
node_consoleapi -->|"delegates to"| node_consoleops
node_publicapi -->|"uses queries"| node_consoleops
node_access -->|"reads context"| node_tenancy
node_access -.->|"persists via"| node_coredata
node_parameters -.->|"persists via"| node_coredata
node_peopleapi -->|"delegates to"| node_peopleapp
node_peopleapp -.->|"persists via"| node_peopledata
node_rcfroles -->|"uses people data"| node_peopleapi
node_rcfroles -->|"requests emission"| node_documents
node_destinations -->|"uses people data"| node_peopleapi
node_sanctions -.->|"uses people data"| node_peopleapi

click node_web "https://github.com/evandroabreu/ngov/blob/main/frontend/apps/web/src/app/app.routes.ts"
click node_webcore "https://github.com/evandroabreu/ngov/blob/main/frontend/apps/web/src/app/modulos/core/rotas.ts"
click node_webpeople "https://github.com/evandroabreu/ngov/blob/main/frontend/apps/web/src/app/modulos/pessoas/rotas.ts"
click node_webrcf "https://github.com/evandroabreu/ngov/blob/main/frontend/apps/web/src/app/modulos/rcf/rotas.ts"
click node_consoleui "https://github.com/evandroabreu/ngov/blob/main/frontend/apps/console/src/app/app.routes.ts"
click node_mobile "https://github.com/evandroabreu/ngov/blob/main/frontend/apps/mobile/src/app/app.routes.ts"
click node_auth "https://github.com/evandroabreu/ngov/blob/main/frontend/libs/comum/src/lib/auth/servico-auth.ts"
click node_activationapi "https://github.com/evandroabreu/ngov/blob/main/backend/plataforma/src/main/java/br/ngov/plataforma/web/AtivacoesController.java"
click node_activation "https://github.com/evandroabreu/ngov/blob/main/backend/plataforma/src/main/java/br/ngov/plataforma/aplicacao/RecebimentoDeAtivacoes.java"
click node_consoleapi "https://github.com/evandroabreu/ngov/blob/main/backend/plataforma/src/main/java/br/ngov/plataforma/web/ConsoleController.java"
click node_consoleops "https://github.com/evandroabreu/ngov/blob/main/backend/plataforma/src/main/java/br/ngov/plataforma/aplicacao/OperacoesDoConsole.java"
click node_publicapi "https://github.com/evandroabreu/ngov/blob/main/backend/plataforma/src/main/java/br/ngov/plataforma/web/ApiPublicaController.java"
click node_tenancy "https://github.com/evandroabreu/ngov/blob/main/backend/platform/tenancy/src/main/java/br/ngov/tenancy/ContextoDeAcesso.java"
click node_access "https://github.com/evandroabreu/ngov/blob/main/backend/modules/core/src/main/java/br/ngov/core/infrastructure/web/AdministracaoDeAcessoController.java"
click node_parameters "https://github.com/evandroabreu/ngov/blob/main/backend/modules/core/src/main/java/br/ngov/core/infrastructure/web/ParametrosController.java"
click node_coredata "https://github.com/evandroabreu/ngov/blob/main/backend/modules/core/src/main/java/br/ngov/core/infrastructure/AdministracaoJdbc.java"
click node_peopleapi "https://github.com/evandroabreu/ngov/blob/main/backend/modules/pessoas/src/main/java/br/ngov/pessoas/infrastructure/web/PessoasController.java"
click node_peopleapp "https://github.com/evandroabreu/ngov/blob/main/backend/modules/pessoas/src/main/java/br/ngov/pessoas/application/CadastroDePessoas.java"
click node_peopledata "https://github.com/evandroabreu/ngov/blob/main/backend/modules/pessoas/src/main/java/br/ngov/pessoas/infrastructure/PessoasJdbc.java"
click node_rcfroles "https://github.com/evandroabreu/ngov/blob/main/backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/RcfController.java"
click node_destinations "https://github.com/evandroabreu/ngov/blob/main/backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/DestinosController.java"
click node_sanctions "https://github.com/evandroabreu/ngov/blob/main/backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/SancoesController.java"
click node_documents "https://github.com/evandroabreu/ngov/blob/main/backend/modules/rcf/src/main/java/br/ngov/rcf/application/ComprovanteDeInscricao.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_web,node_webcore,node_webpeople,node_webrcf,node_consoleui,node_mobile,node_auth,node_user toneBlue
class node_activationapi,node_activation,node_consoleapi,node_consoleops,node_publicapi,node_tenancy toneAmber
class node_access,node_parameters,node_coredata toneMint
class node_peopleapi,node_peopleapp,node_peopledata toneRose
class node_rcfroles,node_destinations,node_sanctions,node_documents toneIndigo
```

## Components

### User applications

- [Management web](https://github.com/evandroabreu/ngov/blob/main/frontend/apps/web/src/app/app.routes.ts): `frontend/apps/web/src/app/app.routes.ts`
- [Core screens](https://github.com/evandroabreu/ngov/blob/main/frontend/apps/web/src/app/modulos/core/rotas.ts): `frontend/apps/web/src/app/modulos/core/rotas.ts`
- [People screens](https://github.com/evandroabreu/ngov/blob/main/frontend/apps/web/src/app/modulos/pessoas/rotas.ts): `frontend/apps/web/src/app/modulos/pessoas/rotas.ts`
- [RCF screens](https://github.com/evandroabreu/ngov/blob/main/frontend/apps/web/src/app/modulos/rcf/rotas.ts): `frontend/apps/web/src/app/modulos/rcf/rotas.ts`
- [Operations console](https://github.com/evandroabreu/ngov/blob/main/frontend/apps/console/src/app/app.routes.ts): `frontend/apps/console/src/app/app.routes.ts`
- [Mobile app](https://github.com/evandroabreu/ngov/blob/main/frontend/apps/mobile/src/app/app.routes.ts): `frontend/apps/mobile/src/app/app.routes.ts`
- [Authentication service](https://github.com/evandroabreu/ngov/blob/main/frontend/libs/comum/src/lib/auth/servico-auth.ts): `frontend/libs/comum/src/lib/auth/servico-auth.ts`

### Platform operations

- [Activation endpoints](https://github.com/evandroabreu/ngov/blob/main/backend/plataforma/src/main/java/br/ngov/plataforma/web/AtivacoesController.java): `backend/plataforma/src/main/java/br/ngov/plataforma/web/AtivacoesController.java`
- [Activation handling](https://github.com/evandroabreu/ngov/blob/main/backend/plataforma/src/main/java/br/ngov/plataforma/aplicacao/RecebimentoDeAtivacoes.java): `backend/plataforma/src/main/java/br/ngov/plataforma/aplicacao/RecebimentoDeAtivacoes.java`
- [Console endpoints](https://github.com/evandroabreu/ngov/blob/main/backend/plataforma/src/main/java/br/ngov/plataforma/web/ConsoleController.java): `backend/plataforma/src/main/java/br/ngov/plataforma/web/ConsoleController.java`
- [Console operations](https://github.com/evandroabreu/ngov/blob/main/backend/plataforma/src/main/java/br/ngov/plataforma/aplicacao/OperacoesDoConsole.java): `backend/plataforma/src/main/java/br/ngov/plataforma/aplicacao/OperacoesDoConsole.java`
- [Public queries](https://github.com/evandroabreu/ngov/blob/main/backend/plataforma/src/main/java/br/ngov/plataforma/web/ApiPublicaController.java): `backend/plataforma/src/main/java/br/ngov/plataforma/web/ApiPublicaController.java`
- [Tenant context](https://github.com/evandroabreu/ngov/blob/main/backend/platform/tenancy/src/main/java/br/ngov/tenancy/ContextoDeAcesso.java): `backend/platform/tenancy/src/main/java/br/ngov/tenancy/ContextoDeAcesso.java`

### Core governance

- [Access administration](https://github.com/evandroabreu/ngov/blob/main/backend/modules/core/src/main/java/br/ngov/core/infrastructure/web/AdministracaoDeAcessoController.java): `backend/modules/core/src/main/java/br/ngov/core/infrastructure/web/AdministracaoDeAcessoController.java`
- [Parameter settings](https://github.com/evandroabreu/ngov/blob/main/backend/modules/core/src/main/java/br/ngov/core/infrastructure/web/ParametrosController.java): `backend/modules/core/src/main/java/br/ngov/core/infrastructure/web/ParametrosController.java`
- [Core persistence](https://github.com/evandroabreu/ngov/blob/main/backend/modules/core/src/main/java/br/ngov/core/infrastructure/AdministracaoJdbc.java): `backend/modules/core/src/main/java/br/ngov/core/infrastructure/AdministracaoJdbc.java`

### People registry

- [People endpoints](https://github.com/evandroabreu/ngov/blob/main/backend/modules/pessoas/src/main/java/br/ngov/pessoas/infrastructure/web/PessoasController.java): `backend/modules/pessoas/src/main/java/br/ngov/pessoas/infrastructure/web/PessoasController.java`
- [People registry](https://github.com/evandroabreu/ngov/blob/main/backend/modules/pessoas/src/main/java/br/ngov/pessoas/application/CadastroDePessoas.java): `backend/modules/pessoas/src/main/java/br/ngov/pessoas/application/CadastroDePessoas.java`
- [People persistence](https://github.com/evandroabreu/ngov/blob/main/backend/modules/pessoas/src/main/java/br/ngov/pessoas/infrastructure/PessoasJdbc.java): `backend/modules/pessoas/src/main/java/br/ngov/pessoas/infrastructure/PessoasJdbc.java`

### Suppliers and creditors

- [Supplier and creditor roles](https://github.com/evandroabreu/ngov/blob/main/backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/RcfController.java): `backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/RcfController.java`
- [Payment destinations](https://github.com/evandroabreu/ngov/blob/main/backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/DestinosController.java): `backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/DestinosController.java`
- [Sanctions](https://github.com/evandroabreu/ngov/blob/main/backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/SancoesController.java): `backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/SancoesController.java`
- [Enrollment documents](https://github.com/evandroabreu/ngov/blob/main/backend/modules/rcf/src/main/java/br/ngov/rcf/application/ComprovanteDeInscricao.java): `backend/modules/rcf/src/main/java/br/ngov/rcf/application/ComprovanteDeInscricao.java`

### Other components

- **User**

## Connections

- User → Management web: uses
- User → Operations console: uses
- User → Mobile app: uses
- Management web → Core screens: routes to (evidence: `frontend/apps/web/src/app/app.routes.ts`)
- Management web → People screens: routes to (evidence: `frontend/apps/web/src/app/app.routes.ts`)
- Management web → RCF screens: routes to (evidence: `frontend/apps/web/src/app/app.routes.ts`)
- Management web → Authentication service: guards routes (evidence: `frontend/apps/web/src/app/app.routes.ts`)
- Operations console → Authentication service: guards routes (evidence: `frontend/apps/console/src/app/app.routes.ts`)
- Mobile app → User: presents start (evidence: `frontend/apps/mobile/src/app/app.routes.ts`)
- Operations console → Console endpoints: calls API
- Management web → Access administration: calls API
- Management web → People endpoints: calls API
- Management web → Supplier and creditor roles: calls API
- Management web → Payment destinations: calls API
- Management web → Sanctions: calls API
- Activation endpoints → Activation handling: delegates to (evidence: `backend/plataforma/src/main/java/br/ngov/plataforma/web/AtivacoesController.java`)
- Console endpoints → Console operations: delegates to (evidence: `backend/plataforma/src/main/java/br/ngov/plataforma/web/ConsoleController.java`)
- Public queries → Console operations: uses queries (evidence: `backend/plataforma/src/main/java/br/ngov/plataforma/web/ApiPublicaController.java`)
- Access administration → Tenant context: reads context (evidence: `backend/modules/core/src/main/java/br/ngov/core/infrastructure/web/AdministracaoDeAcessoController.java`)
- Access administration → Core persistence: persists via
- Parameter settings → Core persistence: persists via
- People endpoints → People registry: delegates to (evidence: `backend/modules/pessoas/src/main/java/br/ngov/pessoas/infrastructure/web/PessoasController.java`)
- People registry → People persistence: persists via
- Supplier and creditor roles → People endpoints: uses people data (evidence: `backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/RcfController.java`)
- Supplier and creditor roles → Enrollment documents: requests emission (evidence: `backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/RcfController.java`)
- Payment destinations → People endpoints: uses people data (evidence: `backend/modules/rcf/src/main/java/br/ngov/rcf/infrastructure/web/DestinosController.java`)
- Sanctions → People endpoints: uses people data
