docs: formalizar Principio 11 - estandares modernos de APIs (FastAPI/Pydantic) e integracion asincrona con LLMs
This commit is contained in:
@@ -11,6 +11,20 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
|
||||
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
|
||||
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
|
||||
|
||||
## [3.5.7] - 2026-10-16
|
||||
### Added
|
||||
- **Principio 11 de la Constitución: Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs)**:
|
||||
- **Arquitectura Modular en 4 Capas**: Desacople estricto en `main.py` (arranque/routers), `routers/` (APIRouters por dominio con prefijo y tags), `schemas/` (Pydantic `BaseModel`) y `storage.py` (acceso a DB). Prohibición de lógica de negocio en el frontend o archivos únicos.
|
||||
- **Contratos Fuertes y Pydantic**: Uso mandatorio de `Field` para validación (`min_length`, `max_length`, `gt`, `ge`), diferenciación estricta de Path Parameters (obligatorios) y Query Parameters (opcionales tipados), y respuestas automáticas de error `422 Unprocessable Entity` detalladas.
|
||||
- **Semántica HTTP y Excepciones**: Uso estricto de códigos `201 Created` en POST, `200 OK`, `204 No Content` en DELETE y excepciones controladas `HTTPException` (404 con mensaje explícito, 400, 409) prohibiendo el retorno de `null` o respuestas vacías ambiguas.
|
||||
- **Documentación Interactiva Automática**: Contratos OpenAPI expuestos en `/docs` (Swagger UI) con capacidades de prueba en vivo.
|
||||
- **Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual**:
|
||||
- Incorporación al Roadmap (Fase 7) de la pestaña de IA en la Configuración Global administrativa (URL de inferencia local Ollama/llama.cpp, modelo, token/clave API, switch de activación y timeout).
|
||||
- Uso obligatorio de clientes asíncronos no bloqueantes `httpx.AsyncClient` (`async def` / `await`).
|
||||
- Configuración de timeout generoso de 600 segundos previendo carga de modelos en VRAM o inferencia de prompts extensos.
|
||||
- Estructura de payload estandarizada por historial de roles (`system`, `user`, `assistant`).
|
||||
- Sincronización documental integral en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.opencode/agents/` (`coordinator.md`, `planner.md`, `implementer.md`, `reviewer.md`), `ROADMAP.md` y `MEMORY.md`.
|
||||
|
||||
## [3.5.6] - 2026-10-16
|
||||
### Added
|
||||
- **Principio 10 de la Constitución: Tolerancia Cero a Errores de Código y Diagnóstico (`@[current_problems]`)**:
|
||||
|
||||
Reference in New Issue
Block a user