# atzur1/sistema-administrativo---cacc architecture

> Architecture diagram of the GitHub repository atzur1/sistema-administrativo---cacc, 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/atzur1/sistema-administrativo---cacc
- Repository: https://github.com/atzur1/sistema-administrativo---cacc

## Overview

Portal Administrativo CACC is a club-management application for player records, enrollment, fees, payments, discounts, debt, reporting, access control, and administrative audit. An administrator uses the Angular portal to initiate an operation; the ASP.NET API applies authorization and routes business work through services to SQL Server-backed data access. The graph preserves the README’s major capability areas. Many implementation links are based on the README’s layer descriptions and capability list; unsampled subsystem internals are not inferred.

Main entry points: [`ApiGestion/Program.cs`](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Program.cs) (HTTP API), [`frontend-cacc/src/app/app.routes.ts`](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/app.routes.ts) (Angular portal), [`ApiGestion/Controllers/PlayersController.cs`](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/PlayersController.cs) (Player endpoints), [`ApiGestion/Controllers/PlayerEnrollmentController.cs`](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/PlayerEnrollmentController.cs) (Enrollment endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Admin portal"]
  node_angular["Angular portal<br/>[app.routes.ts]"]
  node_players_ui["Player management<br/>[jugador-perfil.ts]"]
  node_finance_ui["Payments and debt<br/>[cuotas-pagos.ts]"]
  node_fees_ui["Fees and discounts"]
  node_reports_ui["Reports interface<br/>[reportes.ts]"]
  node_users_ui["Users interface"]
end

subgraph group_api["REST API"]
  node_api["HTTP API<br/>[Program.cs]"]
  node_players_api["Player endpoints"]
  node_enrollment_api["Enrollment endpoints"]
  node_payments_api["Payment endpoints<br/>[PagosController.cs]"]
  node_fees_api["Enrollment fee endpoints"]
  node_reporting_api["Reports endpoints"]
  node_users_api["User endpoints"]
end

subgraph group_business["Business services"]
  node_players_svc["Player onboarding"]
  node_payments_svc["Payment processing<br/>[PagosService.cs]"]
  node_tariffs_svc["Tariff management"]
  node_enrollment_svc["Enrollment payments"]
end

subgraph group_data["Data and domain"]
  node_players_dao["Player data access<br/>[PlayerDao.cs]"]
  node_payments_dao["Payment data access<br/>[PagosDao.cs]"]
  node_reports_dao["Report data access<br/>[ReportesDao.cs]"]
  node_entities["Club domain model<br/>[Player.cs]"]
end

subgraph group_crosscut["Access and reporting"]
  node_auth["Authentication and roles<br/>[AuthController.cs]"]
  node_audit["Administrative audit"]
  node_reports["PDF and CSV exports"]
end

node_admin(("Administrators"))
node_sql[("Club database")]

node_admin -->|"uses"| node_angular
node_angular -->|"calls API"| node_api
node_api -.->|"routes"| node_players_api
node_api -.->|"routes"| node_enrollment_api
node_api -.->|"routes"| node_payments_api
node_api -.->|"routes"| node_fees_api
node_api -.->|"routes"| node_reporting_api
node_api -.->|"routes"| node_users_api
node_players_api -.->|"delegates to"| node_players_svc
node_enrollment_api -->|"delegates to"| node_enrollment_svc
node_payments_api -->|"delegates to"| node_payments_svc
node_fees_api -->|"reads and writes"| node_sql
node_players_svc -.->|"uses"| node_players_dao
node_payments_svc -->|"uses"| node_payments_dao
node_tariffs_svc -.->|"uses data access"| node_sql
node_enrollment_svc -.->|"uses data access"| node_sql
node_players_dao -.->|"queries"| node_sql
node_payments_dao -.->|"queries"| node_sql
node_reports_dao -.->|"queries"| node_sql
node_reporting_api -.->|"exports"| node_reports
node_users_api -.->|"protects access"| node_auth
node_api -.->|"records activity"| node_audit
node_players_ui -.->|"part of portal"| node_angular
node_finance_ui -.->|"part of portal"| node_angular
node_fees_ui -.->|"part of portal"| node_angular
node_reports_ui -.->|"part of portal"| node_angular
node_users_ui -.->|"part of portal"| node_angular

click node_angular "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/app.routes.ts"
click node_players_ui "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/admin-portal/jugador-perfil/jugador-perfil.ts"
click node_finance_ui "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/admin-portal/cuotas-pagos/cuotas-pagos.ts"
click node_fees_ui "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/admin-portal/actualizacion-aranceles/actualizacion-aranceles.ts"
click node_reports_ui "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/admin-portal/reportes/reportes.ts"
click node_users_ui "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/admin-portal/usuarios-y-permisos/usuarios-y-permisos.ts"
click node_api "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Program.cs"
click node_players_api "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/PlayersController.cs"
click node_enrollment_api "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/PlayerEnrollmentController.cs"
click node_payments_api "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/PagosController.cs"
click node_fees_api "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/EnrollmentFeesController.cs"
click node_reporting_api "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/ReportesController.cs"
click node_users_api "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/UsuariosController.cs"
click node_players_svc "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ServiceLibrary/JugadoresAltaService.cs"
click node_payments_svc "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ServiceLibrary/PagosService.cs"
click node_tariffs_svc "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ServiceLibrary/ArancelesService.cs"
click node_enrollment_svc "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ServiceLibrary/InscripcionesService.cs"
click node_players_dao "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/DaoLibrary/PlayerDao.cs"
click node_payments_dao "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/DaoLibrary/PagosDao.cs"
click node_reports_dao "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/DaoLibrary/ReportesDao.cs"
click node_entities "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/EntityLibrary/Player.cs"
click node_auth "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/AuthController.cs"
click node_audit "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/AuditoriaController.cs"
click node_reports "https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Reports/PdfReportBuilder.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_angular,node_players_ui,node_finance_ui,node_fees_ui,node_reports_ui,node_users_ui toneBlue
class node_api,node_players_api,node_enrollment_api,node_payments_api,node_fees_api,node_reporting_api,node_users_api,node_sql toneAmber
class node_players_svc,node_payments_svc,node_tariffs_svc,node_enrollment_svc toneMint
class node_players_dao,node_payments_dao,node_reports_dao,node_entities toneRose
class node_auth,node_audit,node_reports,node_admin toneIndigo
```

## Components

### Admin portal

- [Angular portal](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/app.routes.ts): `frontend-cacc/src/app/app.routes.ts`
- [Player management](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/admin-portal/jugador-perfil/jugador-perfil.ts): `frontend-cacc/src/app/admin-portal/jugador-perfil/jugador-perfil.ts`
- [Payments and debt](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/admin-portal/cuotas-pagos/cuotas-pagos.ts): `frontend-cacc/src/app/admin-portal/cuotas-pagos/cuotas-pagos.ts`
- [Fees and discounts](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/admin-portal/actualizacion-aranceles/actualizacion-aranceles.ts): `frontend-cacc/src/app/admin-portal/actualizacion-aranceles/actualizacion-aranceles.ts`
- [Reports interface](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/admin-portal/reportes/reportes.ts): `frontend-cacc/src/app/admin-portal/reportes/reportes.ts`
- [Users interface](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/frontend-cacc/src/app/admin-portal/usuarios-y-permisos/usuarios-y-permisos.ts): `frontend-cacc/src/app/admin-portal/usuarios-y-permisos/usuarios-y-permisos.ts`

### REST API

- [HTTP API](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Program.cs): `ApiGestion/Program.cs`
- [Player endpoints](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/PlayersController.cs): `ApiGestion/Controllers/PlayersController.cs`
- [Enrollment endpoints](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/PlayerEnrollmentController.cs): `ApiGestion/Controllers/PlayerEnrollmentController.cs`
- [Payment endpoints](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/PagosController.cs): `ApiGestion/Controllers/PagosController.cs`
- [Enrollment fee endpoints](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/EnrollmentFeesController.cs): `ApiGestion/Controllers/EnrollmentFeesController.cs`
- [Reports endpoints](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/ReportesController.cs): `ApiGestion/Controllers/ReportesController.cs`
- [User endpoints](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/UsuariosController.cs): `ApiGestion/Controllers/UsuariosController.cs`

### Business services

- [Player onboarding](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ServiceLibrary/JugadoresAltaService.cs): `ServiceLibrary/JugadoresAltaService.cs`
- [Payment processing](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ServiceLibrary/PagosService.cs): `ServiceLibrary/PagosService.cs`
- [Tariff management](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ServiceLibrary/ArancelesService.cs): `ServiceLibrary/ArancelesService.cs`
- [Enrollment payments](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ServiceLibrary/InscripcionesService.cs): `ServiceLibrary/InscripcionesService.cs`

### Data and domain

- [Player data access](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/DaoLibrary/PlayerDao.cs): `DaoLibrary/PlayerDao.cs`
- [Payment data access](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/DaoLibrary/PagosDao.cs): `DaoLibrary/PagosDao.cs`
- [Report data access](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/DaoLibrary/ReportesDao.cs): `DaoLibrary/ReportesDao.cs`
- [Club domain model](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/EntityLibrary/Player.cs): `EntityLibrary/Player.cs`

### Access and reporting

- [Authentication and roles](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/AuthController.cs): `ApiGestion/Controllers/AuthController.cs`
- [Administrative audit](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Controllers/AuditoriaController.cs): `ApiGestion/Controllers/AuditoriaController.cs`
- [PDF and CSV exports](https://github.com/atzur1/sistema-administrativo---cacc/blob/main/ApiGestion/Reports/PdfReportBuilder.cs): `ApiGestion/Reports/PdfReportBuilder.cs`

### Other components

- **Administrators**
- **Club database**

## Connections

- Administrators → Angular portal: uses (evidence: `README.md`)
- Angular portal → HTTP API: calls API (evidence: `README.md`)
- HTTP API → Player endpoints: routes
- HTTP API → Enrollment endpoints: routes
- HTTP API → Payment endpoints: routes
- HTTP API → Enrollment fee endpoints: routes
- HTTP API → Reports endpoints: routes
- HTTP API → User endpoints: routes
- Player endpoints → Player onboarding: delegates to
- Enrollment endpoints → Enrollment payments: delegates to (evidence: `ApiGestion/Controllers/PlayerEnrollmentController.cs`)
- Payment endpoints → Payment processing: delegates to (evidence: `ApiGestion/Controllers/PagosController.cs`)
- Enrollment fee endpoints → Club database: reads and writes (evidence: `ApiGestion/Controllers/EnrollmentFeesController.cs`)
- Player onboarding → Player data access: uses
- Payment processing → Payment data access: uses (evidence: `ServiceLibrary/PagosService.cs`)
- Tariff management → Club database: uses data access
- Enrollment payments → Club database: uses data access
- Player data access → Club database: queries
- Payment data access → Club database: queries
- Report data access → Club database: queries
- Reports endpoints → PDF and CSV exports: exports
- User endpoints → Authentication and roles: protects access
- HTTP API → Administrative audit: records activity
- Player management → Angular portal: part of portal (evidence: `frontend-cacc/src/app/app.routes.ts`)
- Payments and debt → Angular portal: part of portal (evidence: `frontend-cacc/src/app/app.routes.ts`)
- Fees and discounts → Angular portal: part of portal (evidence: `frontend-cacc/src/app/app.routes.ts`)
- Reports interface → Angular portal: part of portal (evidence: `frontend-cacc/src/app/app.routes.ts`)
- Users interface → Angular portal: part of portal (evidence: `frontend-cacc/src/app/app.routes.ts`)
