Documentar funcionalidad de debug en README y PLAN
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 16s

- Agregar sección de botones de debug (temporales) en README
- Documentar endpoints /api/debug/reset-database y /api/debug/seed-database
- Incluir advertencias y flujos de uso recomendados
- Marcar claramente como TEMPORALES con instrucciones de no eliminar
- Actualizar PLAN con endpoints de debug en sección Completado
This commit is contained in:
2025-11-21 19:55:26 -06:00
parent a6672cdcd0
commit fdb01ecb0c
2 changed files with 108 additions and 5 deletions

View File

@@ -112,11 +112,12 @@ UVA-001 (2086kg)
│ │ ├── composables/
│ │ │ ├── useLotes.ts # Lógica de negocio
│ │ │ └── useAuthentik.ts # Autenticación
│ │ └── app.vue # Aplicación principal
│ │ └── app.vue # Aplicación principal (con botones debug)
│ ├── server/
│ │ ├── api/
│ │ │ ├── lotes/ # Endpoints de lotes (6)
│ │ │ ── operaciones/ # Endpoints de operaciones (3)
│ │ │ ── operaciones/ # Endpoints de operaciones (3)
│ │ │ └── debug/ # ⚠️ Endpoints debug temporales (2)
│ │ ├── utils/
│ │ │ ├── db.ts # Pool de PostgreSQL
│ │ │ └── queries.ts # Funciones SQL
@@ -148,6 +149,13 @@ UVA-001 (2086kg)
- `POST /api/operaciones` - Crear operación con lotes
- `GET /api/operaciones/:id` - Obtener operación específica
### Debug (⚠️ Temporales)
- `POST /api/debug/reset-database` - Elimina todas las tablas (DROP)
- `POST /api/debug/seed-database` - Carga datos de ejemplo
**Nota**: Estos endpoints están marcados como temporales. No eliminar sin consultar.
### Ejemplo de Respuesta - Trazabilidad
```json
@@ -224,13 +232,45 @@ SELECT * FROM get_estadisticas_lote('id-del-lote');
### Modo Debug
El sistema incluye botones de prueba para verificar la API:
El sistema incluye varios botones de debug para desarrollo:
#### Botones de Prueba de API (azules)
1. Abre https://lotes.nucleoriofrio.com
2. Abre consola del navegador (F12)
3. Usa los botones "Probar API"
3. Usa los botones "Probar GET /api/lotes", "Probar GET /api/operaciones", "Probar Trazabilidad"
4. Verifica resultados en consola
#### ⚠️ Botones de Gestión de BD (rojos) - TEMPORALES
**ADVERTENCIA**: Estos botones son para desarrollo/debugging y están marcados como **TEMPORALES**.
**🗑️ BORRAR TODA LA BD**:
- Elimina completamente todas las tablas (`DROP TABLE`)
- Requiere confirmación antes de ejecutar
- Después de usar, hacer un push para que el workflow recree la BD con datos de ejemplo
**🌱 CARGAR DATOS DE EJEMPLO**:
- Ejecuta el script de seed (10 lotes, 7 operaciones, 16 relaciones)
- Útil para cargar datos después de un reset
**Flujo recomendado para resetear completamente**:
```bash
# 1. Click en "🗑️ BORRAR TODA LA BD" en la web
# 2. Trigger redeploy para que se recree automáticamente
git commit --allow-empty -m "Trigger reinit DB" && git push
# Alternativa rápida (sin redeploy):
# 1. Click en "🗑️ BORRAR TODA LA BD"
# 2. Click en "🌱 CARGAR DATOS DE EJEMPLO"
# 3. Recargar la página
```
**⚠️ IMPORTANTE**: Estos botones y endpoints están marcados con advertencias en el código:
- NO ELIMINAR sin consultar a Dario/Draganel/nucleo000
- Son temporales pero útiles durante desarrollo
- Ver comentarios en el código antes de modificar
## 🔐 Autenticación
Sistema protegido con Authentik Proxy Outpost: