# Proyecto: Retirar funcionalidad de chat con ia

## Descripcion:

Retirar y desincorporar del portal estudiantil la funcionalidad del chatbot con inteligencia artificial (Gemini), eliminando sus controladores, rutas, librerías de integración, modelos, comandos CLI y vistas asociadas para reducir la superficie de mantenimiento y remover código en desuso.

## Alcance del Proyecto

- Controladores y Rutas de Chat: Remueve el controlador `Chat.php` y cualquier punto de entrada o auto-routing asociado al asistente virtual.
- Vistas e Interfaces de Usuario: Elimina los directorios de vistas `app/Views/chat/` y `app/Views/chatbot/`, retirando los enlaces al chat en `app/Views/templates/header.php`.
- Modelos de Persistencia: Desincorpora los modelos en `App\Models\Bot` y `App\Models\Chat` dedicados al historial, agentes, conocimiento y tokens del bot.
- Librería de Integración con IA: Remueve `App\Libraries\GeminiClient` y dependencias del servicio de mensajería con Gemini.
- Comandos CLI y Aprovisionamiento: Elimina el comando `ChatbotSetup.php` y retira la ejecución del seeder y migraciones de chatbot en `InitPrincipalDb` y `SeedDemo`.
- Migraciones y Seeds: Da de baja o aísla la migración de tablas `bot_*` y el seeder `ChatbotDemoSeeder` para evitar la creación de tablas en desuso.
- Pruebas Automatizadas: Remueve las suites de pruebas obsoletas en `tests/app/Libraries/GeminiClientTest.php` y `tests/app/Models/BotChatSystemTest.php`.
- Assets y Recursos Públicos: Elimina el directorio `public/chatbot_resource/` y recursos estáticos asociados al asistente virtual.

## Reglas de Negocio

- Preservación de esquemas productivos: No se ejecutarán sentencias destructivas (DROP TABLE) sobre bases en producción; las tablas bot_* quedan inactivas sin alterar esquemas existentes.
- Idempotencia en aprovisionamiento: Los comandos init:principal y demo:seed deben ejecutarse sin invocar clases o seeders eliminados, garantizando despliegues limpios y reproducibles.
- Respuesta ante accesos residuales: Toda petición HTTP hacia /chat, /chatbot o sus submétodos debe responder 404 Not Found estándar sin arrojar excepciones no controladas.
- Aislamiento de navegación: La desincorporación de enlaces y vistas del chat no debe romper la estructura, responsividad ni el renderizado de cabeceras o plantillas del portal.
- Inocuidad de variables de entorno: El ciclo de vida del sistema debe operar sin dependencias ni advertencias ante la ausencia de configuraciones de IA (GEMINI_API_KEY).
- Estabilidad de suites de prueba: La remoción de pruebas huérfanas (GeminiClientTest, BotChatSystemTest) debe sanear la suite de pruebas del proyecto sin degradar la cobertura de módulos activos.

## Modelo

Definición conceptual de las entidades ajustadas con la inclusión de insumos y herramientas:

No aplica para este proyecto, ya que se trata de una desincorporación de funcionalidades existentes.


## Presentación

No aplica para este proyecto, ya que se trata de una desincorporación de funcionalidades existentes.


## Lista de Tareas (Checklist de Implementación)

> Orden de ejecución sugerido. Cada tarea indica el entregable técnico esperado y su identificador unívoco. No marcar como completada sin su respectiva verificación.

### Fase 0 — Preparación e Infraestructura

- [x] **T-01** Eliminar el comando CLI `app/Commands/ChatbotSetup.php` y desacoplar cualquier referencia al comando `chatbot:setup`.
- [x] **T-02** Remover la invocación de `ChatbotDemoSeeder` y el registro de la migración `CreateChatbotTables` en `app/Commands/InitPrincipalDb.php` y `app/Commands/SeedDemo.php`.

### Fase 1 — Base de Datos y Modelos

- [x] **T-10** Desincorporar y eliminar los modelos en `app/Models/Bot/` (`BotAgenteModel.php`, `BotChatModel.php`, `BotConocimientoModel.php`, `BotMensajeModel.php`, `BotAgenteConfiguracionModel.php`, `BotPreguntaNoRespondidaModel.php`, `BotUsuarioTemporalModel.php`, `BotLogExcesoModel.php`).
- [x] **T-11** Desincorporar y eliminar los modelos en `app/Models/Chat/` vinculados a tokens, recursos y conversaciones del chatbot.
- [x] **T-12** Aislar o desincorporar la migración `app/Database/Migrations/2026-10-12-000084_CreateChatbotTables.php` y el seeder `app/Database/Seeds/ChatbotDemoSeeder.php`, garantizando no ejecutar sentencias destructivas (`DROP TABLE`) sobre bases de datos en producción.

### Fase 2 — Backend y Servicios

- [x] **T-20** Eliminar la librería de integración `app/Libraries/GeminiClient.php` y limpiar referencias o inyecciones al cliente de Gemini.
- [x] **T-21** Eliminar el controlador `app/Controllers/Chat.php`, asegurando que las solicitudes hacia `/chat` y submétodos respondan HTTP 404 estándar sin excepciones no controladas.

### Fase 3 — Frontend y UI

- [x] **T-30** Retirar los enlaces y accesos de navegación al Asistente Virtual en la barra de navegación de `app/Views/templates/header.php`.
- [x] **T-31** Eliminar el directorio de vistas de chat activo `app/Views/chat/` (`chat_seleccion_view.php`, `chat_view.php`, `chat_vincular_view.php`).
- [x] **T-32** Eliminar el directorio de vistas legado `app/Views/chatbot/` (`chat_view.php`, `doc.php`, `home.php`, `index.php`, `init.php`).
- [x] **T-33** Eliminar el directorio público `public/chatbot_resource/` y assets estáticos asociados en `public/imagenes/chat/`.

### Fase 4 — Saneamiento de Pruebas y Validación

- [x] **T-40** Eliminar las suites de pruebas del chatbot en `tests/app/Libraries/GeminiClientTest.php` y `tests/app/Models/BotChatSystemTest.php`.
- [x] **T-41** Ejecutar la suite de pruebas del proyecto (`vendor/bin/phpunit tests/app`) verificando la eliminación del error preexistente de `DatabaseTestTrait` y asegurando cero regresiones en los módulos activos.
- [x] **T-42** Validar mediante verificación HTTP local que las rutas `/chat`, `/chat/seleccion` y `/chat/vincular` retornen 404 Not Found limpio sin generar registros de error en `writable/logs`.
