# vfvon/intranet-public architecture

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

- Interactive diagram: https://gitdiagram.com/vfvon/intranet-public
- Repository: https://github.com/vfvon/intranet-public

## Overview

Es un portal institucional de la Fundación Ave Fénix: el usuario inicia sesión, accede a módulos protegidos y trabaja con usuarios, sesiones, talleres, terapias, programas y proyectos. El frontend Vue enruta esas pantallas y comparte estado de autenticación; el backend Django expone la API y persiste el dominio. También hay administración de reservas, avisos, papelera y respaldos. Las relaciones de navegación y autenticación se apoyan en excerpts; donde no se mostró la llamada de una pantalla a la API, la conexión queda indicada como no verificada.

Main entry points: [`frontend/src/router.js`](https://github.com/vfvon/intranet-public/blob/main/frontend/src/router.js) (Rutas protegidas), [`backend/urls.py`](https://github.com/vfvon/intranet-public/blob/main/backend/urls.py) (API Django), [`frontend/src/App.vue`](https://github.com/vfvon/intranet-public/blob/main/frontend/src/App.vue) (Shell de aplicación), [`frontend/src/composables/useAuth.js`](https://github.com/vfvon/intranet-public/blob/main/frontend/src/composables/useAuth.js) (Autenticación cliente)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Portal Vue"]
  node_app["Shell de aplicación<br/>[App.vue]"]
  node_router["Rutas protegidas<br/>[router.js]"]
  node_auth["Autenticación cliente<br/>[useAuth.js]"]
end

subgraph group_people["Atención y usuarios"]
  node_usuarios["Gestión de usuarios<br/>[UsuarioDetalle.vue]"]
  node_sesion["Sesiones de atención<br/>[SesionDetalle.vue]"]
  node_profesionales["Profesionales"]
  node_primer_contacto["Primer contacto<br/>[PrimerContacto.vue]"]
  node_matricula["Matrícula<br/>[Matricula.vue]"]
end

subgraph group_activities["Programas y actividades"]
  node_talleres["Talleres<br/>[Talleres.vue]"]
  node_taller_detalle["Detalle de taller<br/>[TallerDetalle.vue]"]
  node_taller_sesion["Sesión de taller"]
  node_terapias["Terapias particulares"]
  node_programa["Detalle de programa"]
  node_proyecto["Detalle de proyecto"]
  node_reservas["Reservas y calendario<br/>[useReservas.js]"]
end

subgraph group_backend["API y dominio"]
  node_api["API Django<br/>[urls.py]"]
  node_views["Endpoints y lógica API<br/>[views.py]"]
  node_models[("Modelos del dominio<br/>[models.py]")]
  node_serializers["Serialización API<br/>[serializers.py]"]
end

subgraph group_operations["Operación"]
  node_papelera["Papelera y restauración<br/>[papelera.py]"]
  node_signals["Eventos de dominio<br/>[signals.py]"]
  node_backups["Generación de respaldos<br/>[generador.py]"]
  node_backup_tasks["Tareas de respaldo<br/>[tasks.py]"]
  node_notifier["Notificación de respaldos<br/>[__init__.py]"]
  node_avisos["Avisos pendientes<br/>[useAvisos.js]"]
end

node_actor(("Personal institucional"))

node_actor -->|"navega"| node_router
node_app -->|"muestra rutas"| node_router
node_app -->|"verifica sesión"| node_auth
node_app -->|"carga pendientes"| node_avisos
node_router -->|"valida acceso"| node_auth
node_router -->|"dirige ruta"| node_usuarios
node_router -->|"dirige ruta"| node_sesion
node_router -->|"dirige ruta"| node_profesionales
node_router -->|"dirige ruta"| node_primer_contacto
node_router -->|"dirige ruta"| node_matricula
node_router -->|"dirige ruta"| node_talleres
node_router -->|"dirige ruta"| node_taller_detalle
node_router -->|"dirige ruta"| node_taller_sesion
node_router -->|"dirige ruta"| node_terapias
node_router -->|"dirige ruta"| node_programa
node_router -->|"dirige ruta"| node_proyecto
node_views -->|"atiende endpoints"| node_api
node_views -->|"usa serialización"| node_serializers
node_serializers -->|"serializa modelos"| node_models
node_papelera -->|"archiva y restaura"| node_models
node_signals -->|"reacciona a cambios"| node_models
node_backup_tasks -->|"ejecuta respaldo"| node_backups
node_backup_tasks -->|"solicita notificación"| node_notifier
node_auth -->|"verifica cuenta"| node_api
node_usuarios -.->|"consulta API"| node_api
node_sesion -.->|"consulta API"| node_api
node_profesionales -.->|"consulta API"| node_api
node_talleres -.->|"consulta API"| node_api
node_terapias -.->|"consulta API"| node_api
node_programa -.->|"consulta API"| node_api
node_proyecto -.->|"consulta API"| node_api

click node_app "https://github.com/vfvon/intranet-public/blob/main/frontend/src/App.vue"
click node_router "https://github.com/vfvon/intranet-public/blob/main/frontend/src/router.js"
click node_auth "https://github.com/vfvon/intranet-public/blob/main/frontend/src/composables/useAuth.js"
click node_api "https://github.com/vfvon/intranet-public/blob/main/backend/urls.py"
click node_views "https://github.com/vfvon/intranet-public/blob/main/usuarios/views.py"
click node_models "https://github.com/vfvon/intranet-public/blob/main/usuarios/models.py"
click node_serializers "https://github.com/vfvon/intranet-public/blob/main/usuarios/serializers.py"
click node_usuarios "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/usuarios/UsuarioDetalle.vue"
click node_sesion "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/usuarios/SesionDetalle.vue"
click node_profesionales "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/ProfesionalDetalle.vue"
click node_primer_contacto "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/usuarios/PrimerContacto.vue"
click node_matricula "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/usuarios/Matricula.vue"
click node_talleres "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/particular/talleres/Talleres.vue"
click node_taller_detalle "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/particular/talleres/TallerDetalle.vue"
click node_taller_sesion "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/particular/talleres/SesionTallerDetalle.vue"
click node_terapias "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/particular/terapias/ParticularDetalle.vue"
click node_programa "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/programas/ProgramaDetalle.vue"
click node_proyecto "https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/proyectos/ProyectoDetalle.vue"
click node_reservas "https://github.com/vfvon/intranet-public/blob/main/frontend/src/composables/useReservas.js"
click node_papelera "https://github.com/vfvon/intranet-public/blob/main/usuarios/papelera.py"
click node_signals "https://github.com/vfvon/intranet-public/blob/main/usuarios/signals.py"
click node_backups "https://github.com/vfvon/intranet-public/blob/main/usuarios/backups/generador.py"
click node_backup_tasks "https://github.com/vfvon/intranet-public/blob/main/usuarios/tasks.py"
click node_notifier "https://github.com/vfvon/intranet-public/blob/main/usuarios/backups/notifications/__init__.py"
click node_avisos "https://github.com/vfvon/intranet-public/blob/main/frontend/src/composables/useAvisos.js"

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_router,node_auth toneBlue
class node_usuarios,node_sesion,node_profesionales,node_primer_contacto,node_matricula toneAmber
class node_talleres,node_taller_detalle,node_taller_sesion,node_terapias,node_programa,node_proyecto,node_reservas toneMint
class node_api,node_views,node_models,node_serializers toneRose
class node_papelera,node_signals,node_backups,node_backup_tasks,node_notifier,node_avisos,node_actor toneIndigo
```

## Components

### Portal Vue

- [Shell de aplicación](https://github.com/vfvon/intranet-public/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Rutas protegidas](https://github.com/vfvon/intranet-public/blob/main/frontend/src/router.js): `frontend/src/router.js`
- [Autenticación cliente](https://github.com/vfvon/intranet-public/blob/main/frontend/src/composables/useAuth.js): `frontend/src/composables/useAuth.js`

### Atención y usuarios

- [Gestión de usuarios](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/usuarios/UsuarioDetalle.vue): `frontend/src/views/usuarios/UsuarioDetalle.vue`
- [Sesiones de atención](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/usuarios/SesionDetalle.vue): `frontend/src/views/usuarios/SesionDetalle.vue`
- [Profesionales](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/ProfesionalDetalle.vue): `frontend/src/views/ProfesionalDetalle.vue`
- [Primer contacto](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/usuarios/PrimerContacto.vue): `frontend/src/views/usuarios/PrimerContacto.vue`
- [Matrícula](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/usuarios/Matricula.vue): `frontend/src/views/usuarios/Matricula.vue`

### Programas y actividades

- [Talleres](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/particular/talleres/Talleres.vue): `frontend/src/views/particular/talleres/Talleres.vue`
- [Detalle de taller](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/particular/talleres/TallerDetalle.vue): `frontend/src/views/particular/talleres/TallerDetalle.vue`
- [Sesión de taller](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/particular/talleres/SesionTallerDetalle.vue): `frontend/src/views/particular/talleres/SesionTallerDetalle.vue`
- [Terapias particulares](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/particular/terapias/ParticularDetalle.vue): `frontend/src/views/particular/terapias/ParticularDetalle.vue`
- [Detalle de programa](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/programas/ProgramaDetalle.vue): `frontend/src/views/programas/ProgramaDetalle.vue`
- [Detalle de proyecto](https://github.com/vfvon/intranet-public/blob/main/frontend/src/views/proyectos/ProyectoDetalle.vue): `frontend/src/views/proyectos/ProyectoDetalle.vue`
- [Reservas y calendario](https://github.com/vfvon/intranet-public/blob/main/frontend/src/composables/useReservas.js): `frontend/src/composables/useReservas.js`

### API y dominio

- [API Django](https://github.com/vfvon/intranet-public/blob/main/backend/urls.py): `backend/urls.py`
- [Endpoints y lógica API](https://github.com/vfvon/intranet-public/blob/main/usuarios/views.py): `usuarios/views.py`
- [Modelos del dominio](https://github.com/vfvon/intranet-public/blob/main/usuarios/models.py): `usuarios/models.py`
- [Serialización API](https://github.com/vfvon/intranet-public/blob/main/usuarios/serializers.py): `usuarios/serializers.py`

### Operación

- [Papelera y restauración](https://github.com/vfvon/intranet-public/blob/main/usuarios/papelera.py): `usuarios/papelera.py`
- [Eventos de dominio](https://github.com/vfvon/intranet-public/blob/main/usuarios/signals.py): `usuarios/signals.py`
- [Generación de respaldos](https://github.com/vfvon/intranet-public/blob/main/usuarios/backups/generador.py): `usuarios/backups/generador.py`
- [Tareas de respaldo](https://github.com/vfvon/intranet-public/blob/main/usuarios/tasks.py): `usuarios/tasks.py`
- [Notificación de respaldos](https://github.com/vfvon/intranet-public/blob/main/usuarios/backups/notifications/__init__.py): `usuarios/backups/notifications/__init__.py`
- [Avisos pendientes](https://github.com/vfvon/intranet-public/blob/main/frontend/src/composables/useAvisos.js): `frontend/src/composables/useAvisos.js`

### Other components

- **Personal institucional**

## Connections

- Personal institucional → Rutas protegidas: navega (evidence: `frontend/src/router.js`)
- Shell de aplicación → Rutas protegidas: muestra rutas (evidence: `frontend/src/main.js`)
- Shell de aplicación → Autenticación cliente: verifica sesión (evidence: `frontend/src/App.vue`)
- Shell de aplicación → Avisos pendientes: carga pendientes (evidence: `frontend/src/App.vue`)
- Rutas protegidas → Autenticación cliente: valida acceso (evidence: `frontend/src/router.js`)
- Rutas protegidas → Gestión de usuarios: dirige ruta (evidence: `frontend/src/router.js`)
- Rutas protegidas → Sesiones de atención: dirige ruta (evidence: `frontend/src/router.js`)
- Rutas protegidas → Profesionales: dirige ruta (evidence: `frontend/src/router.js`)
- Rutas protegidas → Primer contacto: dirige ruta (evidence: `frontend/src/router.js`)
- Rutas protegidas → Matrícula: dirige ruta (evidence: `frontend/src/router.js`)
- Rutas protegidas → Talleres: dirige ruta (evidence: `frontend/src/router.js`)
- Rutas protegidas → Detalle de taller: dirige ruta (evidence: `frontend/src/router.js`)
- Rutas protegidas → Sesión de taller: dirige ruta (evidence: `frontend/src/router.js`)
- Rutas protegidas → Terapias particulares: dirige ruta (evidence: `frontend/src/router.js`)
- Rutas protegidas → Detalle de programa: dirige ruta (evidence: `frontend/src/router.js`)
- Rutas protegidas → Detalle de proyecto: dirige ruta (evidence: `frontend/src/router.js`)
- Endpoints y lógica API → API Django: atiende endpoints (evidence: `backend/urls.py`)
- Endpoints y lógica API → Serialización API: usa serialización (evidence: `usuarios/views.py`)
- Serialización API → Modelos del dominio: serializa modelos (evidence: `usuarios/serializers.py`)
- Papelera y restauración → Modelos del dominio: archiva y restaura (evidence: `usuarios/papelera.py`)
- Eventos de dominio → Modelos del dominio: reacciona a cambios (evidence: `usuarios/signals.py`)
- Tareas de respaldo → Generación de respaldos: ejecuta respaldo (evidence: `usuarios/tasks.py`)
- Tareas de respaldo → Notificación de respaldos: solicita notificación (evidence: `usuarios/tasks.py`)
- Autenticación cliente → API Django: verifica cuenta (evidence: `frontend/src/composables/useAuth.js`)
- Gestión de usuarios → API Django: consulta API
- Sesiones de atención → API Django: consulta API
- Profesionales → API Django: consulta API
- Talleres → API Django: consulta API
- Terapias particulares → API Django: consulta API
- Detalle de programa → API Django: consulta API
- Detalle de proyecto → API Django: consulta API
