# giorgiohzg/fchmn_inscripciones architecture

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

## Overview

La aplicación gestiona competencias de natación máster: usuarios administran personas, clubes y membresías; organizan competencias y reciben inscripciones individuales y de relevos; luego consultan reportes y exportan datos para Team Manager. El frontend presenta esas tareas y consume la API; sus rutas delegan en servicios de dominio. Autenticación, autorización y alcance de club protegen las operaciones. El README documenta las capacidades principales; las conexiones entre módulos no muestreados se omiten o se marcan como no verificadas.

Main entry points: [`frontend/src/shared/apiClient.ts`](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/shared/apiClient.ts) (Cliente API), [`frontend/src/App.tsx`](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/App.tsx) (Aplicación), [`backend/src/modules/competitions/competitions.routes.ts`](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/competitions/competitions.routes.ts) (Competencias API), [`backend/src/modules/auth/rbac.middleware.ts`](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/auth/rbac.middleware.ts) (Autorización RBAC)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Interfaz web"]
  node_app["Aplicación<br/>[App.tsx]"]
  node_api_client["Cliente API<br/>[apiClient.ts]"]
  node_auth_ui["Sesión web<br/>[AuthContext.tsx]"]
  node_people_ui["Gestión personas"]
  node_assignment_ui["Membresías"]
  node_competitions_ui["Gestión competencias"]
  node_individual_ui["Inscripción individual"]
  node_relay_ui["Inscripción relevos"]
  node_reports_ui["Reportes<br/>[ReportsPage.tsx]"]
end

subgraph group_identity["Identidad y acceso"]
  node_auth_api["Autenticación API<br/>[auth.service.ts]"]
  node_rbac["Autorización RBAC<br/>[rbac.middleware.ts]"]
  node_actor["Alcance actor<br/>[actorContext.ts]"]
end

subgraph group_registry["Personas y clubes"]
  node_people_api["Personas API<br/>[persons.routes.ts]"]
  node_clubs_api["Clubes API<br/>[clubs.routes.ts]"]
  node_assignment_api["Asignación nadadores"]
  node_incorporations["Altas y cambios"]
end

subgraph group_competition["Competencias e inscripciones"]
  node_catalogs_api["Catálogos deportivos<br/>[catalogs.routes.ts]"]
  node_competitions_api["Competencias API"]
  node_individual_api["Inscripciones individuales"]
  node_relay_api["Inscripciones relevos"]
  node_meet_import["Importar resultados"]
end

subgraph group_outputs["Reportes y exportación"]
  node_reports_api["Reportes API<br/>[reports.routes.ts]"]
  node_team_export["Exportación Team Manager"]
  node_audit["Auditoría<br/>[audit.service.ts]"]
end

node_user(("Usuario"))

node_user -->|"usa"| node_app
node_app -->|"monta sesión"| node_auth_ui
node_app -->|"muestra"| node_people_ui
node_app -->|"muestra"| node_assignment_ui
node_app -->|"muestra"| node_competitions_ui
node_auth_ui -->|"solicita API"| node_api_client
node_api_client -.->|"consume API"| node_auth_api
node_people_ui -.->|"solicita API"| node_api_client
node_assignment_ui -.->|"solicita API"| node_api_client
node_competitions_ui -.->|"solicita API"| node_api_client
node_individual_ui -.->|"solicita API"| node_api_client
node_relay_ui -.->|"solicita API"| node_api_client
node_reports_ui -.->|"solicita API"| node_api_client
node_people_api -->|"opera personas"| node_people_api
node_people_api -->|"protege rutas"| node_rbac
node_assignment_api -->|"protege rutas"| node_rbac
node_assignment_api -->|"resuelve alcance"| node_actor
node_assignment_api -->|"usa postulaciones"| node_incorporations
node_incorporations -->|"resuelve alcance"| node_actor
node_catalogs_api -->|"protege rutas"| node_rbac
node_competitions_api -->|"protege rutas"| node_rbac
node_competitions_api -->|"construye contexto"| node_actor
node_individual_api -->|"construye contexto"| node_actor
node_individual_api -->|"valida visibilidad"| node_competitions_api
node_reports_api -->|"usa auditoría"| node_audit
node_team_export -->|"registra exportación"| node_audit
node_competitions_api -->|"gestiona jornadas"| node_competitions_api

click node_app "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/App.tsx"
click node_api_client "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/shared/apiClient.ts"
click node_auth_ui "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/auth/AuthContext.tsx"
click node_auth_api "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/auth/auth.service.ts"
click node_rbac "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/auth/rbac.middleware.ts"
click node_actor "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/shared/actorContext.ts"
click node_people_ui "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/persons/PersonsListPage.tsx"
click node_people_api "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/persons/persons.routes.ts"
click node_clubs_api "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/clubs/clubs.routes.ts"
click node_assignment_ui "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/swimmer-assignment/SwimmerAssignmentsPage.tsx"
click node_assignment_api "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/swimmer-assignment/assignment.routes.ts"
click node_incorporations "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/incorporaciones/incorporaciones.routes.ts"
click node_catalogs_api "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/catalogs/catalogs.routes.ts"
click node_competitions_ui "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/competitions/CompetitionsListPage.tsx"
click node_competitions_api "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/competitions/competitions.routes.ts"
click node_individual_ui "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/registrations/RegistrationWizardPage.tsx"
click node_individual_api "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/registrations/registrations.routes.ts"
click node_relay_ui "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/relay-registrations/RelayRegistrationWizardPage.tsx"
click node_relay_api "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/relay-registrations/relay-registrations.routes.ts"
click node_meet_import "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/meet-import/meet-import.routes.ts"
click node_reports_ui "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/reports/ReportsPage.tsx"
click node_reports_api "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/reports/reports.routes.ts"
click node_team_export "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/team-manager-export/team-manager-export.service.ts"
click node_audit "https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/audit/audit.service.ts"

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,node_api_client,node_auth_ui,node_people_ui,node_assignment_ui,node_competitions_ui,node_individual_ui,node_relay_ui,node_reports_ui toneBlue
class node_auth_api,node_rbac,node_actor toneAmber
class node_people_api,node_clubs_api,node_assignment_api,node_incorporations toneMint
class node_catalogs_api,node_competitions_api,node_individual_api,node_relay_api,node_meet_import toneRose
class node_reports_api,node_team_export,node_audit,node_user toneIndigo
```

## Components

### Interfaz web

- [Aplicación](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Cliente API](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/shared/apiClient.ts): `frontend/src/shared/apiClient.ts`
- [Sesión web](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/auth/AuthContext.tsx): `frontend/src/modules/auth/AuthContext.tsx`
- [Gestión personas](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/persons/PersonsListPage.tsx): `frontend/src/modules/persons/PersonsListPage.tsx`
- [Membresías](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/swimmer-assignment/SwimmerAssignmentsPage.tsx): `frontend/src/modules/swimmer-assignment/SwimmerAssignmentsPage.tsx`
- [Gestión competencias](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/competitions/CompetitionsListPage.tsx): `frontend/src/modules/competitions/CompetitionsListPage.tsx`
- [Inscripción individual](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/registrations/RegistrationWizardPage.tsx): `frontend/src/modules/registrations/RegistrationWizardPage.tsx`
- [Inscripción relevos](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/relay-registrations/RelayRegistrationWizardPage.tsx): `frontend/src/modules/relay-registrations/RelayRegistrationWizardPage.tsx`
- [Reportes](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/frontend/src/modules/reports/ReportsPage.tsx): `frontend/src/modules/reports/ReportsPage.tsx`

### Identidad y acceso

- [Autenticación API](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [Autorización RBAC](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/auth/rbac.middleware.ts): `backend/src/modules/auth/rbac.middleware.ts`
- [Alcance actor](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/shared/actorContext.ts): `backend/src/shared/actorContext.ts`

### Personas y clubes

- [Personas API](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/persons/persons.routes.ts): `backend/src/modules/persons/persons.routes.ts`
- [Clubes API](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/clubs/clubs.routes.ts): `backend/src/modules/clubs/clubs.routes.ts`
- [Asignación nadadores](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/swimmer-assignment/assignment.routes.ts): `backend/src/modules/swimmer-assignment/assignment.routes.ts`
- [Altas y cambios](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/incorporaciones/incorporaciones.routes.ts): `backend/src/modules/incorporaciones/incorporaciones.routes.ts`

### Competencias e inscripciones

- [Catálogos deportivos](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/catalogs/catalogs.routes.ts): `backend/src/modules/catalogs/catalogs.routes.ts`
- [Competencias API](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/competitions/competitions.routes.ts): `backend/src/modules/competitions/competitions.routes.ts`
- [Inscripciones individuales](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/registrations/registrations.routes.ts): `backend/src/modules/registrations/registrations.routes.ts`
- [Inscripciones relevos](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/relay-registrations/relay-registrations.routes.ts): `backend/src/modules/relay-registrations/relay-registrations.routes.ts`
- [Importar resultados](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/meet-import/meet-import.routes.ts): `backend/src/modules/meet-import/meet-import.routes.ts`

### Reportes y exportación

- [Reportes API](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/reports/reports.routes.ts): `backend/src/modules/reports/reports.routes.ts`
- [Exportación Team Manager](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/team-manager-export/team-manager-export.service.ts): `backend/src/modules/team-manager-export/team-manager-export.service.ts`
- [Auditoría](https://github.com/giorgiohzg/fchmn_inscripciones/blob/main/backend/src/modules/audit/audit.service.ts): `backend/src/modules/audit/audit.service.ts`

### Other components

- **Usuario**

## Connections

- Usuario → Aplicación: usa (evidence: `frontend/src/App.tsx`)
- Aplicación → Sesión web: monta sesión (evidence: `frontend/src/App.tsx`)
- Aplicación → Gestión personas: muestra (evidence: `frontend/src/App.tsx`)
- Aplicación → Membresías: muestra (evidence: `frontend/src/App.tsx`)
- Aplicación → Gestión competencias: muestra (evidence: `frontend/src/App.tsx`)
- Sesión web → Cliente API: solicita API (evidence: `frontend/src/modules/auth/AuthContext.tsx`)
- Cliente API → Autenticación API: consume API
- Gestión personas → Cliente API: solicita API
- Membresías → Cliente API: solicita API
- Gestión competencias → Cliente API: solicita API
- Inscripción individual → Cliente API: solicita API
- Inscripción relevos → Cliente API: solicita API
- Reportes → Cliente API: solicita API
- Personas API → Personas API: opera personas (evidence: `backend/src/modules/persons/persons.routes.ts`)
- Personas API → Autorización RBAC: protege rutas (evidence: `backend/src/modules/persons/persons.routes.ts`)
- Asignación nadadores → Autorización RBAC: protege rutas (evidence: `backend/src/modules/swimmer-assignment/assignment.routes.ts`)
- Asignación nadadores → Alcance actor: resuelve alcance (evidence: `backend/src/modules/swimmer-assignment/assignment.routes.ts`)
- Asignación nadadores → Altas y cambios: usa postulaciones (evidence: `backend/src/modules/swimmer-assignment/assignment.routes.ts`)
- Altas y cambios → Alcance actor: resuelve alcance (evidence: `backend/src/modules/incorporaciones/incorporaciones.routes.ts`)
- Catálogos deportivos → Autorización RBAC: protege rutas (evidence: `backend/src/modules/catalogs/catalogs.routes.ts`)
- Competencias API → Autorización RBAC: protege rutas (evidence: `backend/src/modules/competitions/competitions.routes.ts`)
- Competencias API → Alcance actor: construye contexto (evidence: `backend/src/modules/competitions/competitions.routes.ts`)
- Inscripciones individuales → Alcance actor: construye contexto (evidence: `backend/src/modules/registrations/registrations.routes.ts`)
- Inscripciones individuales → Competencias API: valida visibilidad (evidence: `backend/src/modules/registrations/registrations.routes.ts`)
- Reportes API → Auditoría: usa auditoría (evidence: `backend/src/modules/reports/reports.routes.ts`)
- Exportación Team Manager → Auditoría: registra exportación (evidence: `backend/src/modules/team-manager-export/team-manager-export.service.ts`)
- Competencias API → Competencias API: gestiona jornadas (evidence: `backend/src/modules/competitions/competitions.routes.ts`)
