# maick721/pago_docentesv1 architecture

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

- Interactive diagram: https://gitdiagram.com/maick721/pago_docentesv1
- Repository: https://github.com/maick721/pago_docentesv1

## Overview

ITQ Conecta is an institutional FastAPI application with an Angular payment interface. Users access API routes for authentication and institutional services; the backend exposes admissions, documents, graduation, teacher payments, and vacation-management capabilities, with PostgreSQL-backed state. Vacation functionality spans requests, approvals, balances, reservations, permissions, holidays, adjustments, calculations, and history. The tree and README establish these capabilities, but only selected code was sampled, so internal links for unsampled modules are intentionally omitted.

Main entry points: [`backend/app/main.py`](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/main.py) (API Application), [`backend/app/modules/pagos_docentes/router.py`](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/modules/pagos_docentes/router.py) (Payment API), [`backend/app/core/database.py`](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/core/database.py) (Database Sessions), [`frontend/src/app/modules/pago_docentes/services/payments.service.ts`](https://github.com/maick721/pago_docentesv1/blob/main/frontend/src/app/modules/pago_docentes/services/payments.service.ts) (Payment API Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API Runtime"]
  node_main["API Application<br/>[main.py]"]
  node_security["JWT Security<br/>[security.py]"]
  node_config["Runtime Config<br/>[config.py]"]
  node_database["Database Sessions<br/>[database.py]"]
  node_health["Health Checks<br/>[health.py]"]
end

subgraph group_institutional["Institutional Services"]
  node_auth["Authentication<br/>[auth.py]"]
  node_core["Core Accounts<br/>[core.py]"]
  node_documents["Documents<br/>[documentos.py]"]
  node_graduation["Graduation<br/>[graduacion.py]"]
  node_admissions["Admissions CRM"]
end

subgraph group_vacations["Vacation Management"]
  node_vacation_requests["Requests"]
  node_vacation_approvals["Approvals"]
  node_vacation_balances["Balances"]
  node_vacation_reservations["Reservations"]
  node_vacation_permissions["Permissions"]
  node_vacation_support["Vacation Support"]
end

subgraph group_payments["Teacher Payments"]
  node_payments_api["Payment API<br/>[router.py]"]
  node_payments_services["Payment Services"]
  node_payments_ui["Payment Interface"]
  node_payments_client["Payment API Client"]
end

node_client(("API Client"))
node_postgres[("PostgreSQL")]

node_client -->|"sends requests"| node_main
node_main -->|"registers routes"| node_auth
node_main -->|"registers routes"| node_core
node_main -->|"registers routes"| node_documents
node_main -->|"registers routes"| node_graduation
node_main -->|"registers routes"| node_admissions
node_main -->|"registers routes"| node_payments_api
node_main -->|"registers routes"| node_vacation_requests
node_main -->|"registers routes"| node_vacation_approvals
node_main -->|"registers routes"| node_vacation_balances
node_main -->|"registers routes"| node_vacation_permissions
node_main -->|"registers routes"| node_vacation_support
node_main -->|"registers routes"| node_health
node_main -->|"uses authentication"| node_security
node_config -->|"configures connection"| node_database
node_database -.->|"opens sessions"| node_postgres
node_payments_ui -.->|"uses client"| node_payments_client
node_payments_client -.->|"calls API"| node_payments_api
node_payments_api -->|"uses services"| node_payments_services
node_main -->|"registers routes"| node_vacation_reservations

click node_main "https://github.com/maick721/pago_docentesv1/blob/main/backend/app/main.py"
click node_security "https://github.com/maick721/pago_docentesv1/blob/main/backend/app/core/security.py"
click node_config "https://github.com/maick721/pago_docentesv1/blob/main/backend/app/core/config.py"
click node_database "https://github.com/maick721/pago_docentesv1/blob/main/backend/app/core/database.py"
click node_health "https://github.com/maick721/pago_docentesv1/blob/main/backend/app/core/health.py"
click node_auth "https://github.com/maick721/pago_docentesv1/blob/main/backend/app/routers/auth.py"
click node_core "https://github.com/maick721/pago_docentesv1/blob/main/backend/app/modules/core/routers/core.py"
click node_documents "https://github.com/maick721/pago_docentesv1/blob/main/backend/app/modules/documentos/routers/documentos.py"
click node_graduation "https://github.com/maick721/pago_docentesv1/blob/main/backend/app/routers/graduacion.py"
click node_admissions "https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/admisiones"
click node_vacation_requests "https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones/solicitudes"
click node_vacation_approvals "https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones/aprobaciones"
click node_vacation_balances "https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones/saldos"
click node_vacation_reservations "https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones/reservas"
click node_vacation_permissions "https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones/permisos"
click node_vacation_support "https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones"
click node_payments_api "https://github.com/maick721/pago_docentesv1/blob/main/backend/app/modules/pagos_docentes/router.py"
click node_payments_services "https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/pagos_docentes/services"
click node_payments_ui "https://github.com/maick721/pago_docentesv1/blob/main/frontend/src/app/modules/pago_docentes/pago-docentes.page.ts"
click node_payments_client "https://github.com/maick721/pago_docentesv1/blob/main/frontend/src/app/modules/pago_docentes/services/payments.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_main,node_security,node_config,node_database,node_health,node_client toneBlue
class node_auth,node_core,node_documents,node_graduation,node_admissions,node_postgres toneAmber
class node_vacation_requests,node_vacation_approvals,node_vacation_balances,node_vacation_reservations,node_vacation_permissions,node_vacation_support toneMint
class node_payments_api,node_payments_services,node_payments_ui,node_payments_client toneRose
```

## Components

### API Runtime

- [API Application](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/main.py): `backend/app/main.py`
- [JWT Security](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [Runtime Config](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/core/config.py): `backend/app/core/config.py`
- [Database Sessions](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Health Checks](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/core/health.py): `backend/app/core/health.py`

### Institutional Services

- [Authentication](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [Core Accounts](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/modules/core/routers/core.py): `backend/app/modules/core/routers/core.py`
- [Documents](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/modules/documentos/routers/documentos.py): `backend/app/modules/documentos/routers/documentos.py`
- [Graduation](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/routers/graduacion.py): `backend/app/routers/graduacion.py`
- [Admissions CRM](https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/admisiones): `backend/app/modules/admisiones`

### Vacation Management

- [Requests](https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones/solicitudes): `backend/app/modules/vacaciones/solicitudes`
- [Approvals](https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones/aprobaciones): `backend/app/modules/vacaciones/aprobaciones`
- [Balances](https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones/saldos): `backend/app/modules/vacaciones/saldos`
- [Reservations](https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones/reservas): `backend/app/modules/vacaciones/reservas`
- [Permissions](https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones/permisos): `backend/app/modules/vacaciones/permisos`
- [Vacation Support](https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/vacaciones): `backend/app/modules/vacaciones`

### Teacher Payments

- [Payment API](https://github.com/maick721/pago_docentesv1/blob/main/backend/app/modules/pagos_docentes/router.py): `backend/app/modules/pagos_docentes/router.py`
- [Payment Services](https://github.com/maick721/pago_docentesv1/tree/main/backend/app/modules/pagos_docentes/services): `backend/app/modules/pagos_docentes/services`
- [Payment Interface](https://github.com/maick721/pago_docentesv1/blob/main/frontend/src/app/modules/pago_docentes/pago-docentes.page.ts): `frontend/src/app/modules/pago_docentes/pago-docentes.page.ts`
- [Payment API Client](https://github.com/maick721/pago_docentesv1/blob/main/frontend/src/app/modules/pago_docentes/services/payments.service.ts): `frontend/src/app/modules/pago_docentes/services/payments.service.ts`

### Other components

- **API Client**
- **PostgreSQL**

## Connections

- API Client → API Application: sends requests (evidence: `backend/app/main.py`)
- API Application → Authentication: registers routes (evidence: `backend/app/main.py`)
- API Application → Core Accounts: registers routes (evidence: `backend/app/main.py`)
- API Application → Documents: registers routes (evidence: `backend/app/main.py`)
- API Application → Graduation: registers routes (evidence: `backend/app/main.py`)
- API Application → Admissions CRM: registers routes (evidence: `backend/app/main.py`)
- API Application → Payment API: registers routes (evidence: `backend/app/main.py`)
- API Application → Requests: registers routes (evidence: `backend/app/main.py`)
- API Application → Approvals: registers routes (evidence: `backend/app/main.py`)
- API Application → Balances: registers routes (evidence: `backend/app/main.py`)
- API Application → Permissions: registers routes (evidence: `backend/app/main.py`)
- API Application → Vacation Support: registers routes (evidence: `backend/app/main.py`)
- API Application → Health Checks: registers routes (evidence: `backend/app/main.py`)
- API Application → JWT Security: uses authentication (evidence: `backend/app/main.py`)
- Runtime Config → Database Sessions: configures connection (evidence: `backend/app/core/database.py`)
- Database Sessions → PostgreSQL: opens sessions
- Payment Interface → Payment API Client: uses client
- Payment API Client → Payment API: calls API
- Payment API → Payment Services: uses services (evidence: `backend/app/modules/pagos_docentes/router.py`)
- API Application → Reservations: registers routes (evidence: `backend/app/main.py`)
