# rcamilorodriguez1/controlasistenciaupc architecture

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

- Interactive diagram: https://gitdiagram.com/rcamilorodriguez1/controlasistenciaupc
- Repository: https://github.com/rcamilorodriguez1/controlasistenciaupc

## Overview

UPC | Aula es una aplicación Streamlit para gestionar asignaturas, grupos y sesiones de clase, con portales para docentes, estudiantes y administración. El recorrido principal va del acceso y la selección del portal a las operaciones académicas: el docente organiza clases y revisa asistencias apoyadas por análisis facial o de voz; el estudiante consulta materias, registros y perfil; administración gestiona cuentas, excepciones y auditoría. Oracle persiste los datos y las sesiones de servidor. El README documenta capacidades no cubiertas por todos los extractos; no se inspeccionó el código de cada módulo.

Main entry points: [`src/pantallas/pantalla_profesor.py`](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/pantallas/pantalla_profesor.py) (Portal docente), [`src/interfaz/navegacion.py`](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/interfaz/navegacion.py) (Navegación), [`src/base_datos/bd.py`](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/bd.py) (Acceso Oracle), [`principal.py`](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/principal.py) (Entrada Streamlit)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Aplicación y portales"]
  node_entry["Entrada Streamlit<br/>[principal.py]"]
  node_navigation["Navegación<br/>[navegacion.py]"]
  node_teacher["Portal docente"]
  node_student["Portal estudiantil"]
  node_profile["Perfil estudiante"]
end

subgraph group_academic["Gestión académica"]
  node_academicops["Materias y matrículas<br/>[gestion.py]"]
  node_classops["Sesiones y asistencia<br/>[clases.py]"]
  node_attendanceui["Revisión de asistencia"]
  node_profiledata["Resumen académico"]
end

subgraph group_identity["Identidad y biometría"]
  node_facepipe["Análisis facial"]
  node_voicepipe["Análisis de voz"]
  node_deferred["Orquestación biométrica"]
  node_identitycheck["Verificación identidad"]
  node_exceptions["Excepciones biométricas"]
end

subgraph group_data["Datos y seguridad"]
  node_db["Acceso Oracle<br/>[bd.py]"]
  node_oracle[("Oracle Database")]
  node_serverauth["Sesiones servidor"]
  node_localstate["Estado de sesión<br/>[sesiones.py]"]
  node_auth["Control de acceso<br/>[autenticacion.py]"]
end

subgraph group_admin["Administración"]
  node_adminscreen["Portal administrativo"]
  node_adminops["Auditoría y cuentas<br/>[administracion.py]"]
  node_recovery["Recuperación de datos<br/>[recuperacion.py]"]
end

node_user(("Persona usuaria"))

node_user -->|"usa"| node_entry
node_entry -->|"inicia"| node_navigation
node_navigation -->|"enruta"| node_teacher
node_navigation -->|"enruta"| node_student
node_navigation -->|"enruta"| node_profile
node_navigation -->|"enruta"| node_adminscreen
node_teacher -->|"solicita análisis"| node_deferred
node_teacher -->|"presenta resultados"| node_attendanceui
node_teacher -.->|"gestiona materias"| node_academicops
node_teacher -.->|"registra sesiones"| node_classops
node_attendanceui -.->|"confirma registros"| node_classops
node_student -.->|"consulta e inscripción"| node_academicops
node_student -.->|"acredita acceso"| node_identitycheck
node_profile -->|"consulta resumen"| node_profiledata
node_profiledata -->|"lee registros"| node_db
node_deferred -->|"despacha facial"| node_facepipe
node_deferred -->|"despacha voz"| node_voicepipe
node_facepipe -->|"obtiene perfiles"| node_db
node_teacher -->|"consulta y registra"| node_db
node_db -->|"lee y escribe"| node_oracle
node_identitycheck -->|"valida credenciales"| node_oracle
node_identitycheck -->|"emite prueba"| node_serverauth
node_serverauth -->|"valida y registra sesiones"| node_oracle
node_entry -->|"vigila sesión"| node_serverauth
node_entry -->|"comprueba acceso"| node_auth
node_localstate -->|"valida identidad"| node_serverauth
node_adminscreen -->|"gestiona y audita"| node_adminops
node_adminscreen -->|"administra excepciones"| node_exceptions
node_adminops -->|"consulta datos"| node_db
node_adminops -->|"ejecuta operaciones"| node_oracle
node_adminscreen -.->|"usa restauración"| node_recovery
node_exceptions -->|"aplica autorizaciones"| node_identitycheck

click node_entry "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/principal.py"
click node_navigation "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/interfaz/navegacion.py"
click node_teacher "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/pantallas/pantalla_profesor.py"
click node_student "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/pantallas/pantalla_estudiante.py"
click node_profile "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/pantallas/perfil_estudiante.py"
click node_adminscreen "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/pantallas/pantalla_administrador.py"
click node_academicops "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/gestion.py"
click node_classops "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/clases.py"
click node_attendanceui "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/componentes/dialogo_resultado_asistencia.py"
click node_facepipe "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/canalizaciones/canalizacion_facial.py"
click node_voicepipe "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/canalizaciones/canalizacion_voz.py"
click node_deferred "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/biometria_diferida.py"
click node_identitycheck "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/verificacion_identidad.py"
click node_exceptions "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/excepciones_biometricas.py"
click node_profiledata "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/perfil_estudiante.py"
click node_db "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/bd.py"
click node_serverauth "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/sesiones_servidor.py"
click node_localstate "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/utilidades/sesiones.py"
click node_auth "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/autenticacion.py"
click node_adminops "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/administracion.py"
click node_recovery "https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/recuperacion.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_entry,node_navigation,node_teacher,node_student,node_profile toneBlue
class node_academicops,node_classops,node_attendanceui,node_profiledata toneAmber
class node_facepipe,node_voicepipe,node_deferred,node_identitycheck,node_exceptions toneMint
class node_db,node_oracle,node_serverauth,node_localstate,node_auth toneRose
class node_adminscreen,node_adminops,node_recovery,node_user toneIndigo
```

## Components

### Aplicación y portales

- [Entrada Streamlit](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/principal.py): `principal.py`
- [Navegación](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/interfaz/navegacion.py): `src/interfaz/navegacion.py`
- [Portal docente](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/pantallas/pantalla_profesor.py): `src/pantallas/pantalla_profesor.py`
- [Portal estudiantil](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/pantallas/pantalla_estudiante.py): `src/pantallas/pantalla_estudiante.py`
- [Perfil estudiante](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/pantallas/perfil_estudiante.py): `src/pantallas/perfil_estudiante.py`

### Gestión académica

- [Materias y matrículas](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/gestion.py): `src/base_datos/gestion.py`
- [Sesiones y asistencia](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/clases.py): `src/base_datos/clases.py`
- [Revisión de asistencia](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/componentes/dialogo_resultado_asistencia.py): `src/componentes/dialogo_resultado_asistencia.py`
- [Resumen académico](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/perfil_estudiante.py): `src/servicios/perfil_estudiante.py`

### Identidad y biometría

- [Análisis facial](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/canalizaciones/canalizacion_facial.py): `src/canalizaciones/canalizacion_facial.py`
- [Análisis de voz](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/canalizaciones/canalizacion_voz.py): `src/canalizaciones/canalizacion_voz.py`
- [Orquestación biométrica](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/biometria_diferida.py): `src/servicios/biometria_diferida.py`
- [Verificación identidad](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/verificacion_identidad.py): `src/servicios/verificacion_identidad.py`
- [Excepciones biométricas](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/excepciones_biometricas.py): `src/servicios/excepciones_biometricas.py`

### Datos y seguridad

- [Acceso Oracle](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/bd.py): `src/base_datos/bd.py`
- **Oracle Database**
- [Sesiones servidor](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/sesiones_servidor.py): `src/servicios/sesiones_servidor.py`
- [Estado de sesión](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/utilidades/sesiones.py): `src/utilidades/sesiones.py`
- [Control de acceso](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/servicios/autenticacion.py): `src/servicios/autenticacion.py`

### Administración

- [Portal administrativo](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/pantallas/pantalla_administrador.py): `src/pantallas/pantalla_administrador.py`
- [Auditoría y cuentas](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/administracion.py): `src/base_datos/administracion.py`
- [Recuperación de datos](https://github.com/rcamilorodriguez1/controlasistenciaupc/blob/main/src/base_datos/recuperacion.py): `src/base_datos/recuperacion.py`

### Other components

- **Persona usuaria**

## Connections

- Persona usuaria → Entrada Streamlit: usa
- Entrada Streamlit → Navegación: inicia (evidence: `principal.py`)
- Navegación → Portal docente: enruta (evidence: `principal.py`)
- Navegación → Portal estudiantil: enruta (evidence: `principal.py`)
- Navegación → Perfil estudiante: enruta (evidence: `principal.py`)
- Navegación → Portal administrativo: enruta (evidence: `principal.py`)
- Portal docente → Orquestación biométrica: solicita análisis (evidence: `src/pantallas/pantalla_profesor.py`)
- Portal docente → Revisión de asistencia: presenta resultados (evidence: `src/pantallas/pantalla_profesor.py`)
- Portal docente → Materias y matrículas: gestiona materias
- Portal docente → Sesiones y asistencia: registra sesiones
- Revisión de asistencia → Sesiones y asistencia: confirma registros
- Portal estudiantil → Materias y matrículas: consulta e inscripción
- Portal estudiantil → Verificación identidad: acredita acceso (evidence: `src/pantallas/pantalla_estudiante.py`)
- Perfil estudiante → Resumen académico: consulta resumen (evidence: `src/pantallas/perfil_estudiante.py`)
- Resumen académico → Acceso Oracle: lee registros (evidence: `src/servicios/perfil_estudiante.py`)
- Orquestación biométrica → Análisis facial: despacha facial (evidence: `src/servicios/biometria_diferida.py`)
- Orquestación biométrica → Análisis de voz: despacha voz (evidence: `src/servicios/biometria_diferida.py`)
- Análisis facial → Acceso Oracle: obtiene perfiles (evidence: `src/canalizaciones/canalizacion_facial.py`)
- Portal docente → Acceso Oracle: consulta y registra (evidence: `src/pantallas/pantalla_profesor.py`)
- Acceso Oracle → Oracle Database: lee y escribe (evidence: `src/base_datos/bd.py`)
- Verificación identidad → Oracle Database: valida credenciales (evidence: `src/servicios/verificacion_identidad.py`)
- Verificación identidad → Sesiones servidor: emite prueba (evidence: `src/servicios/verificacion_identidad.py`)
- Sesiones servidor → Oracle Database: valida y registra sesiones (evidence: `src/servicios/sesiones_servidor.py`)
- Entrada Streamlit → Sesiones servidor: vigila sesión (evidence: `principal.py`)
- Entrada Streamlit → Control de acceso: comprueba acceso (evidence: `principal.py`)
- Estado de sesión → Sesiones servidor: valida identidad (evidence: `src/utilidades/sesiones.py`)
- Portal administrativo → Auditoría y cuentas: gestiona y audita (evidence: `src/pantallas/pantalla_administrador.py`)
- Portal administrativo → Excepciones biométricas: administra excepciones (evidence: `src/pantallas/pantalla_administrador.py`)
- Auditoría y cuentas → Acceso Oracle: consulta datos (evidence: `src/base_datos/administracion.py`)
- Auditoría y cuentas → Oracle Database: ejecuta operaciones (evidence: `src/base_datos/administracion.py`)
- Portal administrativo → Recuperación de datos: usa restauración
- Excepciones biométricas → Verificación identidad: aplica autorizaciones (evidence: `src/componentes/gestion_excepciones.py`)
