Documentar funcionalidad de debug en README y PLAN
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 16s
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:
48
README.md
48
README.md
@@ -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:
|
||||
|
||||
Reference in New Issue
Block a user