# willbugs/sintrafgv architecture

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

- Interactive diagram: https://gitdiagram.com/willbugs/sintrafgv
- Repository: https://github.com/willbugs/sintrafgv

## Overview

SintrafGV is modernizing a legacy union-management system into a .NET 8 platform with separate administrative and member-voting frontends. The main workflow spans staff login and administration of associates/elections, member identity validation, voting and receipt generation, plus election reporting. A separate legacy-import process supports preservation of existing records. The README documents capabilities beyond the sampled implementation; those are represented as subsystem nodes, while uncertain runtime links are omitted. Evidence is limited to the README, source index references, and excerpts provided.

Main entry points: [`src/backend/src/SintrafGv.Api/Controllers/AuthController.cs`](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Api/Controllers/AuthController.cs) (Member Authentication), [`src/backend/src/SintrafGv.Infrastructure/Repositories/AssociadoRepository.cs`](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Infrastructure/Repositories/AssociadoRepository.cs) (Associate Repository), [`src/backend/src/SintrafGv.Infrastructure/Data/AppDbContext.cs`](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Infrastructure/Data/AppDbContext.cs) (SQL Server Data), [`base conhecimento legado/Domain/CPessoas.cs`](https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/Domain/CPessoas.cs) (Legacy Associates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontends["User Applications"]
  node_adminui["Admin Panel<br/>[App.tsx]"]
  node_adminauth["Admin Authentication<br/>[AuthContext.tsx]"]
  node_votingui["Voting PWA<br/>[App.tsx]"]
  node_memberauth["Member Authentication<br/>[AuthController.cs]"]
end

subgraph group_api["API and Services"]
  node_associates["Associate Management"]
  node_elections["Elections and Voting"]
  node_reports["Reporting"]
  node_reportservice["Report Service"]
  node_authservice["Auth Service<br/>[AuthService.cs]"]
end

subgraph group_domain["Domain and Storage"]
  node_repository["Associate Repository"]
  node_models["Core Entities<br/>[Associado.cs]"]
  node_database[("SQL Server Data<br/>[AppDbContext.cs]")]
end

subgraph group_legacy["Legacy and Migration"]
  node_importer["Legacy Import<br/>[Program.cs]"]
  node_legacyadmin["Legacy Administration"]
  node_legacyvote["Legacy Voting"]
  node_legacyreports["Legacy Reports<br/>[RPessoas.cs]"]
  node_legacyassociates["Legacy Associates<br/>[CPessoas.cs]"]
  node_legacyemail["Legacy Email<br/>[Email.cs]"]
end

node_staff(("Staff"))
node_members(("Associates"))

node_staff -->|"uses"| node_adminui
node_adminui -->|"provides auth"| node_adminauth
node_members -->|"uses"| node_votingui
node_votingui -.->|"authenticates"| node_memberauth
node_staff -.->|"manages"| node_associates
node_staff -.->|"manages"| node_elections
node_members -.->|"casts votes"| node_elections
node_reports -->|"delegates to"| node_reportservice
node_reports -->|"uses"| node_reportservice
node_authservice -.->|"queries"| node_repository
node_memberauth -->|"calls"| node_authservice
node_memberauth -->|"validates member"| node_repository
node_repository -.->|"accesses"| node_database
node_database -->|"maps"| node_models
node_importer -->|"writes imported data"| node_database
node_importer -->|"creates records"| node_models
node_legacyadmin -->|"references"| node_legacyassociates
node_legacyvote -->|"loads voters"| node_legacyassociates
node_legacyreports -->|"reports on"| node_legacyassociates
node_legacyadmin -->|"uses report types"| node_legacyreports

click node_adminui "https://github.com/willbugs/sintrafgv/blob/main/src/frontend/admin/src/App.tsx"
click node_adminauth "https://github.com/willbugs/sintrafgv/blob/main/src/frontend/admin/src/contexts/AuthContext.tsx"
click node_votingui "https://github.com/willbugs/sintrafgv/blob/main/src/frontend/voting/src/App.tsx"
click node_memberauth "https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Api/Controllers/AuthController.cs"
click node_associates "https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Api/Controllers/AssociadosController.cs"
click node_elections "https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Api/Controllers/EnquetesController.cs"
click node_reports "https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Api/Controllers/RelatoriosController.cs"
click node_reportservice "https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Application/Services/RelatorioServiceSimplificado.cs"
click node_authservice "https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Application/Services/AuthService.cs"
click node_repository "https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Infrastructure/Repositories/AssociadoRepository.cs"
click node_models "https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Domain/Entities/Associado.cs"
click node_database "https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Infrastructure/Data/AppDbContext.cs"
click node_importer "https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/ImportacaoLegado/Program.cs"
click node_legacyadmin "https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/Web/Controllers/PadraoController.cs"
click node_legacyvote "https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/WebEnquete/Controllers/EIntegradController.cs"
click node_legacyreports "https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/Reports/RPessoas.cs"
click node_legacyassociates "https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/Domain/CPessoas.cs"
click node_legacyemail "https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/Negocios/Email.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_adminui,node_adminauth,node_votingui,node_memberauth toneBlue
class node_associates,node_elections,node_reports,node_reportservice,node_authservice toneAmber
class node_repository,node_models,node_database toneMint
class node_importer,node_legacyadmin,node_legacyvote,node_legacyreports,node_legacyassociates,node_legacyemail toneRose
class node_staff,node_members toneIndigo
```

## Components

### User Applications

- [Admin Panel](https://github.com/willbugs/sintrafgv/blob/main/src/frontend/admin/src/App.tsx): `src/frontend/admin/src/App.tsx`
- [Admin Authentication](https://github.com/willbugs/sintrafgv/blob/main/src/frontend/admin/src/contexts/AuthContext.tsx): `src/frontend/admin/src/contexts/AuthContext.tsx`
- [Voting PWA](https://github.com/willbugs/sintrafgv/blob/main/src/frontend/voting/src/App.tsx): `src/frontend/voting/src/App.tsx`
- [Member Authentication](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Api/Controllers/AuthController.cs): `src/backend/src/SintrafGv.Api/Controllers/AuthController.cs`

### API and Services

- [Associate Management](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Api/Controllers/AssociadosController.cs): `src/backend/src/SintrafGv.Api/Controllers/AssociadosController.cs`
- [Elections and Voting](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Api/Controllers/EnquetesController.cs): `src/backend/src/SintrafGv.Api/Controllers/EnquetesController.cs`
- [Reporting](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Api/Controllers/RelatoriosController.cs): `src/backend/src/SintrafGv.Api/Controllers/RelatoriosController.cs`
- [Report Service](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Application/Services/RelatorioServiceSimplificado.cs): `src/backend/src/SintrafGv.Application/Services/RelatorioServiceSimplificado.cs`
- [Auth Service](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Application/Services/AuthService.cs): `src/backend/src/SintrafGv.Application/Services/AuthService.cs`

### Domain and Storage

- [Associate Repository](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Infrastructure/Repositories/AssociadoRepository.cs): `src/backend/src/SintrafGv.Infrastructure/Repositories/AssociadoRepository.cs`
- [Core Entities](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Domain/Entities/Associado.cs): `src/backend/src/SintrafGv.Domain/Entities/Associado.cs`
- [SQL Server Data](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/SintrafGv.Infrastructure/Data/AppDbContext.cs): `src/backend/src/SintrafGv.Infrastructure/Data/AppDbContext.cs`

### Legacy and Migration

- [Legacy Import](https://github.com/willbugs/sintrafgv/blob/main/src/backend/src/ImportacaoLegado/Program.cs): `src/backend/src/ImportacaoLegado/Program.cs`
- [Legacy Administration](https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/Web/Controllers/PadraoController.cs): `base conhecimento legado/Web/Controllers/PadraoController.cs`
- [Legacy Voting](https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/WebEnquete/Controllers/EIntegradController.cs): `base conhecimento legado/WebEnquete/Controllers/EIntegradController.cs`
- [Legacy Reports](https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/Reports/RPessoas.cs): `base conhecimento legado/Reports/RPessoas.cs`
- [Legacy Associates](https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/Domain/CPessoas.cs): `base conhecimento legado/Domain/CPessoas.cs`
- [Legacy Email](https://github.com/willbugs/sintrafgv/blob/main/base%20conhecimento%20legado/Negocios/Email.cs): `base conhecimento legado/Negocios/Email.cs`

### Other components

- **Staff**
- **Associates**

## Connections

- Staff → Admin Panel: uses
- Admin Panel → Admin Authentication: provides auth (evidence: `src/frontend/admin/src/App.tsx`)
- Associates → Voting PWA: uses
- Voting PWA → Member Authentication: authenticates
- Staff → Associate Management: manages
- Staff → Elections and Voting: manages
- Associates → Elections and Voting: casts votes
- Reporting → Report Service: delegates to (evidence: `src/backend/src/SintrafGv.Api/Controllers/RelatoriosController.cs`)
- Reporting → Report Service: uses (evidence: `src/backend/src/SintrafGv.Api/Controllers/RelatoriosController.cs`)
- Auth Service → Associate Repository: queries
- Member Authentication → Auth Service: calls (evidence: `src/backend/src/SintrafGv.Api/Controllers/AuthController.cs`)
- Member Authentication → Associate Repository: validates member (evidence: `src/backend/src/SintrafGv.Api/Controllers/AuthController.cs`)
- Associate Repository → SQL Server Data: accesses (evidence: `src/backend/src/SintrafGv.Infrastructure/Repositories/AssociadoRepository.cs`)
- SQL Server Data → Core Entities: maps (evidence: `src/backend/src/SintrafGv.Infrastructure/Data/AppDbContext.cs`)
- Legacy Import → SQL Server Data: writes imported data (evidence: `src/backend/src/ImportacaoLegado/Program.cs`)
- Legacy Import → Core Entities: creates records (evidence: `src/backend/src/ImportacaoLegado/Program.cs`)
- Legacy Administration → Legacy Associates: references (evidence: `base conhecimento legado/Web/Controllers/PadraoController.cs`)
- Legacy Voting → Legacy Associates: loads voters (evidence: `base conhecimento legado/WebEnquete/Controllers/EIntegradController.cs`)
- Legacy Reports → Legacy Associates: reports on (evidence: `base conhecimento legado/Reports/RPessoas.cs`)
- Legacy Administration → Legacy Reports: uses report types (evidence: `base conhecimento legado/Web/Controllers/PadraoController.cs`)
