docs: formalizar Principio 11 - estandares modernos de APIs (FastAPI/Pydantic) e integracion asincrona con LLMs

This commit is contained in:
2026-10-16 17:04:21 -03:00
parent e1cc2d1212
commit 76647e228b
16 changed files with 115 additions and 16 deletions
+17 -1
View File
@@ -2,7 +2,7 @@
## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
**Versión:** 3.5.6 (Principio 10 Tolerancia Cero a Errores, Robustez SystemSetting y Replicador)
**Versión:** 3.5.7 (Principio 11: Estándares Modernos de APIs, Pydantic e Integración de IA)
**Fecha de Actualización:** 16 de Octubre de 2026
**Rama Base:** `dev`
@@ -108,3 +108,19 @@ Fase 6: Despliegue en Servidores y Hardening [█████████░
- [ ] Automatización de workers persistentes en systemd para la cola asíncrona de Moodle.
- [ ] Configuración optimizada de `docker-compose.yml` de producción.
- [ ] Pruebas de estrés de concurrencia y validación final de performance sub-segundo.
---
### Fase 7: Integración con Modelos de IA Locales (LLMs) & Asistente Virtual en la App 🤖 *(Diseñada / Por Implementar)*
- [ ] **Pestaña de Asistente IA en Configuración Global**:
- Incorporar en la vista de configuración general del Administrador una pestaña dedicada a la configuración de IA.
- Parámetros configurables: URL del servidor de inferencia (Ollama, llama.cpp, vLLM, LiteLLM), Modelo seleccionado, Clave de API / Token, Timeout de conexión (por defecto 600s para entornos locales), y Switch de activación general.
- Almacenamiento seguro de credenciales con Fernet en base de datos (`system_settings`).
- [ ] **Módulo Backend Asíncrono de Inferencia (`httpx`)**:
- Implementar servicio `AIService` utilizando `httpx.AsyncClient` con funciones asíncronas no bloqueantes (`async def` / `await`).
- Gestión estructurada del historial y contexto mediante el estándar de roles (`system`, `user`, `assistant`).
- Timeout generoso (600 segundos) para mitigar demoras en carga de modelos a VRAM o prompts extensos.
- [ ] **Asistente Conversacional para Usuarios**:
- Componente de interfaz flotante para guiar a Bedelía, Docentes y Alumnos en el uso de la plataforma.
- Capacidades de consulta sobre asignaciones áulicas, cronogramas, comisiones y manuales operativos.