# veilen1/postgrados_frlp architecture

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

## Overview

SGAP is a web platform for postgraduate admissions and academic records. Applicants register and submit a pre-enrollment file with PDF documents; staff review applications, manage cohorts and legajo states, and approve records that receive an official number. The graph also preserves authentication/RBAC, statistics, and the documented teacher UI. Some frontend-to-API and backend domain links are based on the README and SOURCE INDEX; unsampled implementation details are not inferred beyond those references.

Main entry points: [`app/frontend/src/App.jsx`](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/App.jsx) (Role-based SPA), [`app/backend/src/shared/auth/dependencies.py`](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/shared/auth/dependencies.py) (Auth and RBAC), [`app/backend/src/shared/api/router.py`](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/shared/api/router.py) (API router), [`app/backend/src/auth/api.py`](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/auth/api.py) (Auth endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_app["Role-based SPA<br/>[App.jsx]"]
  node_preinscription_ui["Pre-enrollment<br/>[preinscripcion.jsx]"]
  node_student_record_ui["My legajo<br/>[MiLegajo.jsx]"]
  node_staff_applications_ui["Application review"]
  node_student_admin_ui["Student records"]
  node_cohorts_ui["Postgraduate cohorts"]
  node_statistics_ui["Statistics"]
  node_teacher_ui["Teacher panel<br/>[panelDocente.jsx]"]
end

subgraph group_front_services["Frontend services"]
  node_auth_service["Auth service<br/>[authService.js]"]
  node_api_client["API client<br/>[apiClient.js]"]
  node_enrollment_service["Enrollment service"]
  node_record_service["Legajo service<br/>[legajoService.js]"]
  node_cohort_service["Cohort service<br/>[cohorteService.js]"]
end

subgraph group_backend["API and domain"]
  node_api_router["API router<br/>[router.py]"]
  node_auth_api["Auth endpoints<br/>[api.py]"]
  node_cohort_api["Cohort endpoints<br/>[api.py]"]
  node_cohort_service_backend["Cohort management<br/>[service.py]"]
  node_legajo_api["Legajo endpoints<br/>[api.py]"]
  node_legajo_service["Legajo workflow<br/>[service.py]"]
  node_document_api["Document endpoints<br/>[document_api.py]"]
  node_document_service["Document handling"]
  node_document_storage["PDF storage"]
  node_legajo_model["Legajo records<br/>[models.py]"]
  node_cohort_model["Cohort records<br/>[models.py]"]
end

subgraph group_shared["Security and persistence"]
  node_security["JWT and passwords<br/>[security.py]"]
  node_auth_dependencies["Auth and RBAC<br/>[dependencies.py]"]
  node_database_session["Database sessions<br/>[database.py]"]
  node_user_model["User and sessions<br/>[models.py]"]
end

node_applicant(("Applicant"))
node_staff(("Conducción staff"))
node_teacher(("Teacher"))
node_postgres[("PostgreSQL")]
node_file_store[("PDF filesystem")]

node_applicant -->|"uses"| node_app
node_staff -->|"uses"| node_app
node_teacher -->|"uses"| node_app
node_app -->|"renders"| node_preinscription_ui
node_app -->|"renders"| node_student_record_ui
node_app -->|"renders"| node_staff_applications_ui
node_app -->|"renders"| node_student_admin_ui
node_app -->|"renders"| node_cohorts_ui
node_app -->|"renders"| node_statistics_ui
node_app -->|"renders"| node_teacher_ui
node_app -->|"authenticates via"| node_auth_service
node_preinscription_ui -->|"submits through"| node_enrollment_service
node_preinscription_ui -->|"registers via"| node_auth_service
node_student_record_ui -->|"loads via"| node_enrollment_service
node_staff_applications_ui -->|"manages via"| node_record_service
node_student_admin_ui -->|"loads via"| node_record_service
node_cohorts_ui -->|"manages via"| node_cohort_service
node_statistics_ui -->|"queries via"| node_record_service
node_statistics_ui -->|"queries via"| node_cohort_service
node_auth_service -->|"requests through"| node_api_client
node_cohort_service -->|"requests through"| node_api_client
node_record_service -->|"requests through"| node_api_client
node_enrollment_service -.->|"calls API"| node_api_router
node_api_client -.->|"sends HTTP"| node_api_router
node_api_router -->|"routes to"| node_auth_api
node_api_router -->|"routes to"| node_cohort_api
node_api_router -->|"routes to"| node_legajo_api
node_api_router -->|"routes to"| node_document_api
node_auth_api -->|"uses"| node_auth_dependencies
node_auth_api -->|"uses"| node_security
node_auth_api -->|"persists user data"| node_user_model
node_cohort_api -->|"delegates to"| node_cohort_service_backend
node_cohort_api -->|"checks access"| node_auth_dependencies
node_legajo_api -->|"delegates to"| node_legajo_service
node_legajo_api -->|"checks access"| node_auth_dependencies
node_document_api -->|"delegates to"| node_document_service
node_document_api -->|"checks access"| node_auth_dependencies
node_document_service -->|"stores and resolves"| node_document_storage
node_document_storage -->|"writes PDFs"| node_file_store
node_auth_dependencies -->|"decodes tokens"| node_security
node_auth_dependencies -->|"queries user"| node_database_session
node_auth_dependencies -->|"loads user"| node_user_model
node_cohort_service_backend -->|"queries and updates"| node_cohort_model
node_cohort_service_backend -->|"checks legajo numbers"| node_legajo_model
node_legajo_service -->|"creates and updates"| node_legajo_model
node_legajo_service -->|"checks cohort"| node_cohort_model
node_database_session -->|"connects to"| node_postgres
node_user_model -->|"maps onto"| node_database_session

click node_app "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/App.jsx"
click node_preinscription_ui "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/preinscripcion.jsx"
click node_student_record_ui "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/MiLegajo.jsx"
click node_staff_applications_ui "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/PanelConduccionInscripciones.jsx"
click node_student_admin_ui "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/PanelConduccionEstudiante.jsx"
click node_cohorts_ui "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/VistaPostgrados.jsx"
click node_statistics_ui "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/VistaEstadisticas.jsx"
click node_teacher_ui "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/panelDocente.jsx"
click node_auth_service "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/services/authService.js"
click node_api_client "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/services/apiClient.js"
click node_enrollment_service "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/services/inscripcionService.js"
click node_record_service "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/services/legajoService.js"
click node_cohort_service "https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/services/cohorteService.js"
click node_api_router "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/shared/api/router.py"
click node_auth_api "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/auth/api.py"
click node_cohort_api "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/cohortes/api.py"
click node_cohort_service_backend "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/cohortes/service.py"
click node_legajo_api "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/api.py"
click node_legajo_service "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/service.py"
click node_document_api "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/document_api.py"
click node_document_service "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/document_service.py"
click node_document_storage "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/document_storage.py"
click node_security "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/auth/security.py"
click node_auth_dependencies "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/shared/auth/dependencies.py"
click node_database_session "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/shared/database.py"
click node_user_model "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/shared/models.py"
click node_legajo_model "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/models.py"
click node_cohort_model "https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/cohortes/models.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_preinscription_ui,node_student_record_ui,node_staff_applications_ui,node_student_admin_ui,node_cohorts_ui,node_statistics_ui,node_teacher_ui toneBlue
class node_auth_service,node_api_client,node_enrollment_service,node_record_service,node_cohort_service,node_postgres,node_file_store toneAmber
class node_api_router,node_auth_api,node_cohort_api,node_cohort_service_backend,node_legajo_api,node_legajo_service,node_document_api,node_document_service,node_document_storage,node_legajo_model,node_cohort_model toneMint
class node_security,node_auth_dependencies,node_database_session,node_user_model toneRose
class node_applicant,node_staff,node_teacher toneIndigo
```

## Components

### Web interface

- [Role-based SPA](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/App.jsx): `app/frontend/src/App.jsx`
- [Pre-enrollment](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/preinscripcion.jsx): `app/frontend/src/components/preinscripcion.jsx`
- [My legajo](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/MiLegajo.jsx): `app/frontend/src/components/MiLegajo.jsx`
- [Application review](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/PanelConduccionInscripciones.jsx): `app/frontend/src/components/PanelConduccionInscripciones.jsx`
- [Student records](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/PanelConduccionEstudiante.jsx): `app/frontend/src/components/PanelConduccionEstudiante.jsx`
- [Postgraduate cohorts](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/VistaPostgrados.jsx): `app/frontend/src/components/VistaPostgrados.jsx`
- [Statistics](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/VistaEstadisticas.jsx): `app/frontend/src/components/VistaEstadisticas.jsx`
- [Teacher panel](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/components/panelDocente.jsx): `app/frontend/src/components/panelDocente.jsx`

### Frontend services

- [Auth service](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/services/authService.js): `app/frontend/src/services/authService.js`
- [API client](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/services/apiClient.js): `app/frontend/src/services/apiClient.js`
- [Enrollment service](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/services/inscripcionService.js): `app/frontend/src/services/inscripcionService.js`
- [Legajo service](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/services/legajoService.js): `app/frontend/src/services/legajoService.js`
- [Cohort service](https://github.com/veilen1/postgrados_frlp/blob/main/app/frontend/src/services/cohorteService.js): `app/frontend/src/services/cohorteService.js`

### API and domain

- [API router](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/shared/api/router.py): `app/backend/src/shared/api/router.py`
- [Auth endpoints](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/auth/api.py): `app/backend/src/auth/api.py`
- [Cohort endpoints](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/cohortes/api.py): `app/backend/src/cohortes/api.py`
- [Cohort management](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/cohortes/service.py): `app/backend/src/cohortes/service.py`
- [Legajo endpoints](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/api.py): `app/backend/src/legajos/api.py`
- [Legajo workflow](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/service.py): `app/backend/src/legajos/service.py`
- [Document endpoints](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/document_api.py): `app/backend/src/legajos/document_api.py`
- [Document handling](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/document_service.py): `app/backend/src/legajos/document_service.py`
- [PDF storage](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/document_storage.py): `app/backend/src/legajos/document_storage.py`
- [Legajo records](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/legajos/models.py): `app/backend/src/legajos/models.py`
- [Cohort records](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/cohortes/models.py): `app/backend/src/cohortes/models.py`

### Security and persistence

- [JWT and passwords](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/auth/security.py): `app/backend/src/auth/security.py`
- [Auth and RBAC](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/shared/auth/dependencies.py): `app/backend/src/shared/auth/dependencies.py`
- [Database sessions](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/shared/database.py): `app/backend/src/shared/database.py`
- [User and sessions](https://github.com/veilen1/postgrados_frlp/blob/main/app/backend/src/shared/models.py): `app/backend/src/shared/models.py`

### Other components

- **Applicant**
- **Conducción staff**
- **Teacher**
- **PostgreSQL**
- **PDF filesystem**

## Connections

- Applicant → Role-based SPA: uses (evidence: `README.md`)
- Conducción staff → Role-based SPA: uses (evidence: `README.md`)
- Teacher → Role-based SPA: uses (evidence: `README.md`)
- Role-based SPA → Pre-enrollment: renders (evidence: `app/frontend/src/App.jsx`)
- Role-based SPA → My legajo: renders (evidence: `app/frontend/src/App.jsx`)
- Role-based SPA → Application review: renders (evidence: `app/frontend/src/App.jsx`)
- Role-based SPA → Student records: renders (evidence: `app/frontend/src/App.jsx`)
- Role-based SPA → Postgraduate cohorts: renders (evidence: `app/frontend/src/App.jsx`)
- Role-based SPA → Statistics: renders (evidence: `app/frontend/src/App.jsx`)
- Role-based SPA → Teacher panel: renders (evidence: `app/frontend/src/App.jsx`)
- Role-based SPA → Auth service: authenticates via (evidence: `app/frontend/src/App.jsx`)
- Pre-enrollment → Enrollment service: submits through (evidence: `app/frontend/src/components/preinscripcion.jsx`)
- Pre-enrollment → Auth service: registers via (evidence: `app/frontend/src/components/preinscripcion.jsx`)
- My legajo → Enrollment service: loads via (evidence: `app/frontend/src/components/MiLegajo.jsx`)
- Application review → Legajo service: manages via (evidence: `app/frontend/src/components/PanelConduccionInscripciones.jsx`)
- Student records → Legajo service: loads via (evidence: `app/frontend/src/components/PanelConduccionEstudiante.jsx`)
- Postgraduate cohorts → Cohort service: manages via (evidence: `app/frontend/src/components/VistaPostgrados.jsx`)
- Statistics → Legajo service: queries via (evidence: `app/frontend/src/components/VistaEstadisticas.jsx`)
- Statistics → Cohort service: queries via (evidence: `app/frontend/src/components/VistaEstadisticas.jsx`)
- Auth service → API client: requests through (evidence: `app/frontend/src/services/authService.js`)
- Cohort service → API client: requests through (evidence: `app/frontend/src/services/cohorteService.js`)
- Legajo service → API client: requests through (evidence: `app/frontend/src/services/legajoService.js`)
- Enrollment service → API router: calls API (evidence: `README.md`)
- API client → API router: sends HTTP
- API router → Auth endpoints: routes to (evidence: `app/backend/src/shared/api/router.py`)
- API router → Cohort endpoints: routes to (evidence: `app/backend/src/shared/api/router.py`)
- API router → Legajo endpoints: routes to (evidence: `app/backend/src/shared/api/router.py`)
- API router → Document endpoints: routes to (evidence: `app/backend/src/shared/api/router.py`)
- Auth endpoints → Auth and RBAC: uses (evidence: `app/backend/src/auth/api.py`)
- Auth endpoints → JWT and passwords: uses (evidence: `app/backend/src/auth/api.py`)
- Auth endpoints → User and sessions: persists user data (evidence: `app/backend/src/auth/api.py`)
- Cohort endpoints → Cohort management: delegates to (evidence: `app/backend/src/cohortes/api.py`)
- Cohort endpoints → Auth and RBAC: checks access (evidence: `app/backend/src/cohortes/api.py`)
- Legajo endpoints → Legajo workflow: delegates to (evidence: `app/backend/src/legajos/api.py`)
- Legajo endpoints → Auth and RBAC: checks access (evidence: `app/backend/src/legajos/api.py`)
- Document endpoints → Document handling: delegates to (evidence: `app/backend/src/legajos/document_api.py`)
- Document endpoints → Auth and RBAC: checks access (evidence: `app/backend/src/legajos/document_api.py`)
- Document handling → PDF storage: stores and resolves (evidence: `app/backend/src/legajos/document_service.py`)
- PDF storage → PDF filesystem: writes PDFs (evidence: `app/backend/src/legajos/document_storage.py`)
- Auth and RBAC → JWT and passwords: decodes tokens (evidence: `app/backend/src/shared/auth/dependencies.py`)
- Auth and RBAC → Database sessions: queries user (evidence: `app/backend/src/shared/auth/dependencies.py`)
- Auth and RBAC → User and sessions: loads user (evidence: `app/backend/src/shared/auth/dependencies.py`)
- Cohort management → Cohort records: queries and updates (evidence: `app/backend/src/cohortes/service.py`)
- Cohort management → Legajo records: checks legajo numbers (evidence: `app/backend/src/cohortes/service.py`)
- Legajo workflow → Legajo records: creates and updates (evidence: `app/backend/src/legajos/service.py`)
- Legajo workflow → Cohort records: checks cohort (evidence: `app/backend/src/legajos/service.py`)
- Database sessions → PostgreSQL: connects to (evidence: `app/backend/src/shared/database.py`)
- User and sessions → Database sessions: maps onto (evidence: `app/backend/src/shared/models.py`)
