# enzomascena/postgrados_frlpgrupo architecture

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

## Overview

Sistema Postgrados centraliza la preinscripción y la gestión académica de posgrado. El aspirante completa una inscripción pública, continúa mediante un enlace de seguimiento y aporta documentación; el coordinador inicia sesión para revisar legajos, consultar información y cambiar estados. El backend expone estos módulos como API y persiste sus datos en PostgreSQL. El README documenta también el envío de enlaces por email y capacidades adicionales; las relaciones entre servicios no muestreados se omiten cuando no hay evidencia directa.

Main entry points: [`backend/main.py`](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/main.py) (Aplicación API), [`frontend/src/App.tsx`](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/App.tsx) (Rutas web), [`frontend/src/shared/api/client.ts`](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/shared/api/client.ts) (Cliente API), [`backend/src/legajos/presentation/router.py`](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/legajos/presentation/router.py) (Gestión de legajos)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Experiencia web"]
  node_app["Rutas web<br/>[App.tsx]"]
  node_login["Inicio de sesión<br/>[Login.tsx]"]
  node_api_client["Cliente API<br/>[client.ts]"]
end

subgraph group_intake["Ingreso y documentos"]
  node_enroll_ui["Formulario inscripción"]
  node_tracking_ui["Seguimiento<br/>[Seguimiento.tsx]"]
end

subgraph group_admin["Gestión académica"]
  node_admin_ui["Dashboard y legajo<br/>[Dashboard.tsx]"]
  node_academic_ui["Vistas académicas<br/>[Estadisticas.tsx]"]
end

subgraph group_backend["Servicios API"]
  node_auth_api["Autenticación<br/>[router.py]"]
  node_enrollment_api["Inscripción pública<br/>[router.py]"]
  node_tracking_api["Seguimiento trámite<br/>[seguimiento.py]"]
  node_cohort_api["Cohortes y períodos<br/>[router.py]"]
  node_documents_api["Gestión documental<br/>[router.py]"]
  node_records_api["Gestión de legajos<br/>[router.py]"]
  node_state_machine["Estados y transiciones<br/>[estados.py]"]
  node_record_store["Repositorio de legajos<br/>[pg_repository.py]"]
  node_document_store["Almacenamiento PDF<br/>[almacenamiento.py]"]
  node_api_entry["Aplicación API<br/>[main.py]"]
end

subgraph group_platform["Plataforma compartida"]
  node_database[("PostgreSQL")]
  node_email["Correo electrónico"]
end

node_aspirant(("Aspirante"))
node_coordinator(("Coordinador"))

node_app -->|"muestra ruta"| node_login
node_app -->|"muestra ruta"| node_enroll_ui
node_app -->|"muestra ruta"| node_tracking_ui
node_app -->|"muestra ruta"| node_admin_ui
node_app -->|"muestra ruta"| node_academic_ui
node_aspirant -->|"completa"| node_enroll_ui
node_aspirant -->|"consulta trámite"| node_tracking_ui
node_coordinator -->|"inicia sesión"| node_login
node_coordinator -->|"gestiona legajos"| node_admin_ui
node_enroll_ui -.->|"solicita API"| node_api_client
node_tracking_ui -.->|"solicita API"| node_api_client
node_admin_ui -->|"solicita API"| node_api_client
node_api_client -->|"envía HTTP"| node_api_entry
node_api_entry -->|"registra router"| node_auth_api
node_api_entry -->|"registra router"| node_cohort_api
node_api_entry -->|"registra router"| node_enrollment_api
node_api_entry -->|"registra router"| node_tracking_api
node_api_entry -->|"registra router"| node_documents_api
node_api_entry -->|"registra router"| node_records_api
node_records_api -->|"valida transiciones"| node_state_machine
node_records_api -->|"consulta y guarda"| node_record_store
node_record_store -.->|"lee y escribe"| node_database
node_documents_api -->|"gestiona archivos"| node_document_store
node_enrollment_api -.->|"envía enlace"| node_email

click node_app "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/App.tsx"
click node_login "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/auth/pages/Login.tsx"
click node_enroll_ui "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/inscripcion/pages/FormularioInscripcion.tsx"
click node_tracking_ui "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/seguimiento/pages/Seguimiento.tsx"
click node_admin_ui "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/dashboard/pages/Dashboard.tsx"
click node_academic_ui "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/estadisticas/pages/Estadisticas.tsx"
click node_api_client "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/shared/api/client.ts"
click node_auth_api "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/autenticacion/presentation/router.py"
click node_enrollment_api "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/inscripcion/presentation/router.py"
click node_tracking_api "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/inscripcion/presentation/seguimiento.py"
click node_cohort_api "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/cohortes/presentation/router.py"
click node_documents_api "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/gestion_documental/presentation/router.py"
click node_records_api "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/legajos/presentation/router.py"
click node_state_machine "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/legajos/domain/estados.py"
click node_record_store "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/legajos/infrastructure/pg_repository.py"
click node_document_store "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/gestion_documental/infrastructure/almacenamiento.py"
click node_api_entry "https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/main.py"

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_login,node_api_client toneBlue
class node_enroll_ui,node_tracking_ui toneAmber
class node_admin_ui,node_academic_ui toneMint
class node_auth_api,node_enrollment_api,node_tracking_api,node_cohort_api,node_documents_api,node_records_api,node_state_machine,node_record_store,node_document_store,node_api_entry toneRose
class node_database,node_email,node_aspirant,node_coordinator toneIndigo
```

## Components

### Experiencia web

- [Rutas web](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Inicio de sesión](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/auth/pages/Login.tsx): `frontend/src/auth/pages/Login.tsx`
- [Cliente API](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/shared/api/client.ts): `frontend/src/shared/api/client.ts`

### Ingreso y documentos

- [Formulario inscripción](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/inscripcion/pages/FormularioInscripcion.tsx): `frontend/src/inscripcion/pages/FormularioInscripcion.tsx`
- [Seguimiento](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/seguimiento/pages/Seguimiento.tsx): `frontend/src/seguimiento/pages/Seguimiento.tsx`

### Gestión académica

- [Dashboard y legajo](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/dashboard/pages/Dashboard.tsx): `frontend/src/dashboard/pages/Dashboard.tsx`
- [Vistas académicas](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/frontend/src/estadisticas/pages/Estadisticas.tsx): `frontend/src/estadisticas/pages/Estadisticas.tsx`

### Servicios API

- [Autenticación](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/autenticacion/presentation/router.py): `backend/src/autenticacion/presentation/router.py`
- [Inscripción pública](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/inscripcion/presentation/router.py): `backend/src/inscripcion/presentation/router.py`
- [Seguimiento trámite](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/inscripcion/presentation/seguimiento.py): `backend/src/inscripcion/presentation/seguimiento.py`
- [Cohortes y períodos](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/cohortes/presentation/router.py): `backend/src/cohortes/presentation/router.py`
- [Gestión documental](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/gestion_documental/presentation/router.py): `backend/src/gestion_documental/presentation/router.py`
- [Gestión de legajos](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/legajos/presentation/router.py): `backend/src/legajos/presentation/router.py`
- [Estados y transiciones](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/legajos/domain/estados.py): `backend/src/legajos/domain/estados.py`
- [Repositorio de legajos](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/legajos/infrastructure/pg_repository.py): `backend/src/legajos/infrastructure/pg_repository.py`
- [Almacenamiento PDF](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/src/gestion_documental/infrastructure/almacenamiento.py): `backend/src/gestion_documental/infrastructure/almacenamiento.py`
- [Aplicación API](https://github.com/enzomascena/postgrados_frlpgrupo/blob/main/backend/main.py): `backend/main.py`

### Plataforma compartida

- **PostgreSQL**
- **Correo electrónico**

### Other components

- **Aspirante**
- **Coordinador**

## Connections

- Rutas web → Inicio de sesión: muestra ruta (evidence: `frontend/src/App.tsx`)
- Rutas web → Formulario inscripción: muestra ruta (evidence: `frontend/src/App.tsx`)
- Rutas web → Seguimiento: muestra ruta (evidence: `frontend/src/App.tsx`)
- Rutas web → Dashboard y legajo: muestra ruta (evidence: `frontend/src/App.tsx`)
- Rutas web → Vistas académicas: muestra ruta (evidence: `frontend/src/App.tsx`)
- Aspirante → Formulario inscripción: completa
- Aspirante → Seguimiento: consulta trámite (evidence: `README.md`)
- Coordinador → Inicio de sesión: inicia sesión (evidence: `README.md`)
- Coordinador → Dashboard y legajo: gestiona legajos
- Formulario inscripción → Cliente API: solicita API
- Seguimiento → Cliente API: solicita API
- Dashboard y legajo → Cliente API: solicita API
- Cliente API → Aplicación API: envía HTTP (evidence: `README.md`)
- Aplicación API → Autenticación: registra router (evidence: `backend/main.py`)
- Aplicación API → Cohortes y períodos: registra router (evidence: `backend/main.py`)
- Aplicación API → Inscripción pública: registra router (evidence: `backend/main.py`)
- Aplicación API → Seguimiento trámite: registra router (evidence: `backend/main.py`)
- Aplicación API → Gestión documental: registra router (evidence: `backend/main.py`)
- Aplicación API → Gestión de legajos: registra router (evidence: `backend/main.py`)
- Gestión de legajos → Estados y transiciones: valida transiciones (evidence: `backend/src/legajos/presentation/router.py`)
- Gestión de legajos → Repositorio de legajos: consulta y guarda (evidence: `backend/src/legajos/presentation/router.py`)
- Repositorio de legajos → PostgreSQL: lee y escribe
- Gestión documental → Almacenamiento PDF: gestiona archivos (evidence: `backend/src/gestion_documental/presentation/router.py`)
- Inscripción pública → Correo electrónico: envía enlace
