# capstone-gestion-practicas/gestion-practicas-profesionales architecture

> Architecture diagram of the GitHub repository capstone-gestion-practicas/gestion-practicas-profesionales, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/capstone-gestion-practicas/gestion-practicas-profesionales
- Repository: https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales

## Overview

PracticaLink es una aplicación web monolítica modular para gestionar prácticas profesionales: usuarios acceden, estudiantes registran prácticas y gestores revisan solicitudes. La documentación también contempla estados, seguimiento, incidencias, alertas y cierre, aunque esos módulos no aparecen en el árbol disponible. El frontend Angular consume la API FastAPI; esta persiste en PostgreSQL/Supabase y puede consultar un servicio externo de empresas. Las conexiones principales se basan en rutas y servicios excerptados o referencias del índice; las ramas documentadas sin implementación visible se indican como no verificadas.

Main entry points: [`PracticaLink/backend/app/main.py`](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/main.py) (FastAPI), [`PracticaLink/frontend/src/app/app.routes.ts`](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/app.routes.ts) (Rutas y roles), [`PracticaLink/backend/app/core/database.py`](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/core/database.py) (Sesiones de datos), [`PracticaLink/frontend/src/app/pages/home/home.ts`](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/home/home.ts) (Inicio estudiante)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Aplicación web"]
  node_angular["Angular app<br/>[app.ts]"]
  node_routing["Rutas y roles<br/>[app.routes.ts]"]
  node_login["Acceso<br/>[login.ts]"]
  node_home["Inicio estudiante<br/>[home.ts]"]
  node_practiceform["Formulario práctica<br/>[practica-form.ts]"]
  node_reviewlist["Solicitudes revisión<br/>[revisiones.ts]"]
  node_reviewdetail["Detalle revisión"]
  node_users["Gestión usuarios<br/>[usuarios.ts]"]
  node_authclient["Cliente autenticación<br/>[auth.service.ts]"]
  node_authstate["Estado de sesión<br/>[auth.store.ts]"]
  node_practiceclient["Cliente prácticas"]
  node_reviewclient["Cliente revisión"]
  node_userclient["Cliente usuarios<br/>[usuario.service.ts]"]
end

subgraph group_api["API y dominio"]
  node_backend["FastAPI<br/>[main.py]"]
  node_authroutes["Rutas autenticación<br/>[routes.py]"]
  node_studentapi["Gestión estudiantes<br/>[estudiantes.py]"]
  node_userapi["Gestión usuarios API<br/>[usuarios.py]"]
  node_companyapi["Consulta empresas<br/>[empresas.py]"]
  node_companyservice["Servicio empresas<br/>[empresa_service.py]"]
end

subgraph group_infra["Identidad y persistencia"]
  node_authservice["Servicio autenticación<br/>[service.py]"]
  node_security["JWT y contraseñas<br/>[security.py]"]
  node_dbsession["Sesiones de datos<br/>[database.py]"]
  node_settings["Configuración<br/>[config.py]"]
  node_postgres[("PostgreSQL Supabase")]
  node_companycache[("Caché empresas<br/>[empresa_service.py]")]
end

subgraph group_proceso["Proceso de práctica"]
  node_practice["Registro práctica<br/>[routes.py]"]
  node_practice_logic["Lógica práctica<br/>[service.py]"]
  node_review["Revisión solicitudes<br/>[routes.py]"]
  node_review_logic["Decisiones revisión<br/>[service.py]"]
  node_lifecycle["Estados, seguimiento, incidencias y cierre"]
end

node_user(("Usuario"))
node_companylookup["API tributaria empresas"]

node_user -->|"usa"| node_angular
node_angular -.->|"carga rutas"| node_routing
node_routing -->|"dirige"| node_login
node_routing -->|"dirige"| node_home
node_routing -->|"dirige"| node_users
node_routing -->|"dirige"| node_reviewlist
node_routing -->|"dirige"| node_reviewdetail
node_login -->|"solicita acceso"| node_authclient
node_login -->|"actualiza sesión"| node_authstate
node_home -->|"consulta y registra"| node_practiceclient
node_home -->|"lee sesión"| node_authstate
node_home -->|"abre formulario"| node_practiceform
node_reviewlist -->|"lista solicitudes"| node_reviewclient
node_reviewdetail -->|"consulta y decide"| node_reviewclient
node_users -->|"gestiona cuentas"| node_userclient
node_authclient -->|"llama API"| node_backend
node_practiceclient -.->|"llama API"| node_backend
node_reviewclient -->|"llama API"| node_backend
node_userclient -.->|"llama API"| node_backend
node_backend -->|"registra rutas"| node_authroutes
node_backend -->|"registra rutas"| node_practice
node_backend -->|"registra rutas"| node_review
node_backend -->|"registra rutas"| node_studentapi
node_backend -->|"registra rutas"| node_userapi
node_backend -->|"registra rutas"| node_companyapi
node_authroutes -->|"invoca"| node_authservice
node_authservice -->|"genera y verifica"| node_security
node_practice -->|"invoca"| node_practice_logic
node_review -->|"invoca"| node_review_logic
node_authroutes -->|"obtiene sesión"| node_dbsession
node_practice -->|"obtiene sesión"| node_dbsession
node_review -->|"obtiene sesión"| node_dbsession
node_dbsession -->|"lee conexión"| node_settings
node_dbsession -.->|"conecta"| node_postgres
node_companyapi -->|"delegación"| node_companyservice
node_companyservice -->|"lee y escribe"| node_companycache
node_companyservice -->|"consulta"| node_companylookup
node_companyservice -->|"lee credenciales"| node_settings
node_lifecycle -.->|"continúa el proceso"| node_practice

click node_angular "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/app.ts"
click node_routing "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/app.routes.ts"
click node_login "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/login/login.ts"
click node_home "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/home/home.ts"
click node_practiceform "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/practica-form/practica-form.ts"
click node_reviewlist "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/revisiones/revisiones.ts"
click node_reviewdetail "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/revision-detalle/revision-detalle.ts"
click node_users "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/usuarios/usuarios.ts"
click node_authclient "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/core/services/auth.service.ts"
click node_authstate "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/core/store/auth.store.ts"
click node_practiceclient "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/core/services/practica.service.ts"
click node_reviewclient "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/core/services/revision.service.ts"
click node_userclient "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/core/services/usuario.service.ts"
click node_backend "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/main.py"
click node_authroutes "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/auth/routes.py"
click node_authservice "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/auth/service.py"
click node_security "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/core/security.py"
click node_practice "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/practicas/routes.py"
click node_practice_logic "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/practicas/service.py"
click node_review "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/revisiones/routes.py"
click node_review_logic "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/revisiones/service.py"
click node_studentapi "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/api/routes/estudiantes.py"
click node_userapi "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/api/routes/usuarios.py"
click node_companyapi "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/api/routes/empresas.py"
click node_companyservice "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/services/empresa_service.py"
click node_dbsession "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/core/database.py"
click node_settings "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/core/config.py"
click node_companycache "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/services/empresa_service.py"
click node_lifecycle "https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/tree/main/PracticaLink/backend/app"

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_routing,node_login,node_home,node_practiceform,node_reviewlist,node_reviewdetail,node_users,node_authclient,node_authstate,node_practiceclient,node_reviewclient,node_userclient toneBlue
class node_backend,node_authroutes,node_studentapi,node_userapi,node_companyapi,node_companyservice toneAmber
class node_authservice,node_security,node_dbsession,node_settings,node_postgres,node_companycache,node_companylookup toneMint
class node_practice,node_practice_logic,node_review,node_review_logic,node_lifecycle toneRose
class node_user toneIndigo
```

## Components

### Aplicación web

- [Angular app](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/app.ts): `PracticaLink/frontend/src/app/app.ts`
- [Rutas y roles](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/app.routes.ts): `PracticaLink/frontend/src/app/app.routes.ts`
- [Acceso](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/login/login.ts): `PracticaLink/frontend/src/app/pages/login/login.ts`
- [Inicio estudiante](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/home/home.ts): `PracticaLink/frontend/src/app/pages/home/home.ts`
- [Formulario práctica](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/practica-form/practica-form.ts): `PracticaLink/frontend/src/app/pages/practica-form/practica-form.ts`
- [Solicitudes revisión](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/revisiones/revisiones.ts): `PracticaLink/frontend/src/app/pages/revisiones/revisiones.ts`
- [Detalle revisión](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/revision-detalle/revision-detalle.ts): `PracticaLink/frontend/src/app/pages/revision-detalle/revision-detalle.ts`
- [Gestión usuarios](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/pages/usuarios/usuarios.ts): `PracticaLink/frontend/src/app/pages/usuarios/usuarios.ts`
- [Cliente autenticación](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/core/services/auth.service.ts): `PracticaLink/frontend/src/app/core/services/auth.service.ts`
- [Estado de sesión](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/core/store/auth.store.ts): `PracticaLink/frontend/src/app/core/store/auth.store.ts`
- [Cliente prácticas](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/core/services/practica.service.ts): `PracticaLink/frontend/src/app/core/services/practica.service.ts`
- [Cliente revisión](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/core/services/revision.service.ts): `PracticaLink/frontend/src/app/core/services/revision.service.ts`
- [Cliente usuarios](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/frontend/src/app/core/services/usuario.service.ts): `PracticaLink/frontend/src/app/core/services/usuario.service.ts`

### API y dominio

- [FastAPI](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/main.py): `PracticaLink/backend/app/main.py`
- [Rutas autenticación](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/auth/routes.py): `PracticaLink/backend/app/auth/routes.py`
- [Gestión estudiantes](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/api/routes/estudiantes.py): `PracticaLink/backend/app/api/routes/estudiantes.py`
- [Gestión usuarios API](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/api/routes/usuarios.py): `PracticaLink/backend/app/api/routes/usuarios.py`
- [Consulta empresas](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/api/routes/empresas.py): `PracticaLink/backend/app/api/routes/empresas.py`
- [Servicio empresas](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/services/empresa_service.py): `PracticaLink/backend/app/services/empresa_service.py`

### Identidad y persistencia

- [Servicio autenticación](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/auth/service.py): `PracticaLink/backend/app/auth/service.py`
- [JWT y contraseñas](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/core/security.py): `PracticaLink/backend/app/core/security.py`
- [Sesiones de datos](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/core/database.py): `PracticaLink/backend/app/core/database.py`
- [Configuración](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/core/config.py): `PracticaLink/backend/app/core/config.py`
- **PostgreSQL Supabase**
- [Caché empresas](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/services/empresa_service.py): `PracticaLink/backend/app/services/empresa_service.py`

### Proceso de práctica

- [Registro práctica](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/practicas/routes.py): `PracticaLink/backend/app/practicas/routes.py`
- [Lógica práctica](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/practicas/service.py): `PracticaLink/backend/app/practicas/service.py`
- [Revisión solicitudes](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/revisiones/routes.py): `PracticaLink/backend/app/revisiones/routes.py`
- [Decisiones revisión](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/blob/main/PracticaLink/backend/app/revisiones/service.py): `PracticaLink/backend/app/revisiones/service.py`
- [Estados, seguimiento, incidencias y cierre](https://github.com/capstone-gestion-practicas/gestion-practicas-profesionales/tree/main/PracticaLink/backend/app): `PracticaLink/backend/app`

### Other components

- **Usuario**
- **API tributaria empresas**

## Connections

- Usuario → Angular app: usa (evidence: `README.md`)
- Angular app → Rutas y roles: carga rutas
- Rutas y roles → Acceso: dirige (evidence: `PracticaLink/frontend/src/app/app.routes.ts`)
- Rutas y roles → Inicio estudiante: dirige (evidence: `PracticaLink/frontend/src/app/app.routes.ts`)
- Rutas y roles → Gestión usuarios: dirige (evidence: `PracticaLink/frontend/src/app/app.routes.ts`)
- Rutas y roles → Solicitudes revisión: dirige (evidence: `PracticaLink/frontend/src/app/app.routes.ts`)
- Rutas y roles → Detalle revisión: dirige (evidence: `PracticaLink/frontend/src/app/app.routes.ts`)
- Acceso → Cliente autenticación: solicita acceso (evidence: `PracticaLink/frontend/src/app/pages/login/login.ts`)
- Acceso → Estado de sesión: actualiza sesión (evidence: `PracticaLink/frontend/src/app/pages/login/login.ts`)
- Inicio estudiante → Cliente prácticas: consulta y registra (evidence: `PracticaLink/frontend/src/app/pages/home/home.ts`)
- Inicio estudiante → Estado de sesión: lee sesión (evidence: `PracticaLink/frontend/src/app/pages/home/home.ts`)
- Inicio estudiante → Formulario práctica: abre formulario (evidence: `PracticaLink/frontend/src/app/pages/home/home.ts`)
- Solicitudes revisión → Cliente revisión: lista solicitudes (evidence: `PracticaLink/frontend/src/app/pages/revisiones/revisiones.ts`)
- Detalle revisión → Cliente revisión: consulta y decide (evidence: `PracticaLink/frontend/src/app/pages/revision-detalle/revision-detalle.ts`)
- Gestión usuarios → Cliente usuarios: gestiona cuentas (evidence: `PracticaLink/frontend/src/app/pages/usuarios/usuarios.ts`)
- Cliente autenticación → FastAPI: llama API (evidence: `PracticaLink/frontend/src/app/core/services/auth.service.ts`)
- Cliente prácticas → FastAPI: llama API
- Cliente revisión → FastAPI: llama API (evidence: `PracticaLink/frontend/src/app/core/services/revision.service.ts`)
- Cliente usuarios → FastAPI: llama API
- FastAPI → Rutas autenticación: registra rutas (evidence: `PracticaLink/backend/app/main.py`)
- FastAPI → Registro práctica: registra rutas (evidence: `PracticaLink/backend/app/main.py`)
- FastAPI → Revisión solicitudes: registra rutas (evidence: `PracticaLink/backend/app/main.py`)
- FastAPI → Gestión estudiantes: registra rutas (evidence: `PracticaLink/backend/app/main.py`)
- FastAPI → Gestión usuarios API: registra rutas (evidence: `PracticaLink/backend/app/main.py`)
- FastAPI → Consulta empresas: registra rutas (evidence: `PracticaLink/backend/app/main.py`)
- Rutas autenticación → Servicio autenticación: invoca (evidence: `PracticaLink/backend/app/auth/routes.py`)
- Servicio autenticación → JWT y contraseñas: genera y verifica (evidence: `PracticaLink/backend/app/auth/service.py`)
- Registro práctica → Lógica práctica: invoca (evidence: `PracticaLink/backend/app/practicas/routes.py`)
- Revisión solicitudes → Decisiones revisión: invoca (evidence: `PracticaLink/backend/app/revisiones/routes.py`)
- Rutas autenticación → Sesiones de datos: obtiene sesión (evidence: `PracticaLink/backend/app/auth/routes.py`)
- Registro práctica → Sesiones de datos: obtiene sesión (evidence: `PracticaLink/backend/app/practicas/routes.py`)
- Revisión solicitudes → Sesiones de datos: obtiene sesión (evidence: `PracticaLink/backend/app/revisiones/routes.py`)
- Sesiones de datos → Configuración: lee conexión (evidence: `PracticaLink/backend/app/core/database.py`)
- Sesiones de datos → PostgreSQL Supabase: conecta (evidence: `README.md`)
- Consulta empresas → Servicio empresas: delegación (evidence: `PracticaLink/backend/app/api/routes/empresas.py`)
- Servicio empresas → Caché empresas: lee y escribe (evidence: `PracticaLink/backend/app/services/empresa_service.py`)
- Servicio empresas → API tributaria empresas: consulta (evidence: `PracticaLink/backend/app/services/empresa_service.py`)
- Servicio empresas → Configuración: lee credenciales (evidence: `PracticaLink/backend/app/services/empresa_service.py`)
- Estados, seguimiento, incidencias y cierre → Registro práctica: continúa el proceso (evidence: `README.md`)
