Add CHANGELOG and Dockerfile - Session 2026-01-02
- Document API v5.2 changes - Document edge_type field - Document image cleanup and Airtable recovery - Add Dockerfile for containerization
This commit is contained in:
122
CHANGELOG.md
Normal file
122
CHANGELOG.md
Normal file
@@ -0,0 +1,122 @@
|
||||
# HST System - Changelog 2 Enero 2026
|
||||
|
||||
## Servidor: 72.62.2.84 (HST)
|
||||
|
||||
---
|
||||
|
||||
## 1. API Flask (hst-api) - v5.2
|
||||
|
||||
### Nuevos Endpoints
|
||||
|
||||
| Endpoint | Método | Descripción |
|
||||
|----------|--------|-------------|
|
||||
| `/api/graph/edges` | GET | Lista edges con `source_h`, `target_h`, `weight`, `type`, `id` |
|
||||
| `/api/graph/edges` | POST | Crear conexión: `{source_h, target_h, weight, type}` |
|
||||
| `/api/graph/edges/<id>` | DELETE | Eliminar conexión por ID |
|
||||
|
||||
### Campos Añadidos en Respuestas
|
||||
|
||||
```json
|
||||
{
|
||||
"als": "inv factura",
|
||||
"h_maestro": "abc123..."
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Base de Datos
|
||||
|
||||
### Tabla `graph` - Nuevo Campo
|
||||
|
||||
| Campo | Tipo | Descripción |
|
||||
|-------|------|-------------|
|
||||
| edge_type | varchar(30) | Clasificación de relación |
|
||||
|
||||
**Valores edge_type:**
|
||||
- `mirror` - Misma entidad en sistemas distintos
|
||||
- `sequence` - Orden temporal/lógico
|
||||
- `composition` - Parte de un todo
|
||||
- `dependency` - Requiere otra entidad
|
||||
- `maturity` - Evolución/versión
|
||||
- `manual` - Definido manualmente
|
||||
- `db` - Generado automáticamente
|
||||
|
||||
### Correcciones de Datos
|
||||
|
||||
| Acción | Detalles |
|
||||
|--------|----------|
|
||||
| Aliases flg | 65 registros: `"{ref} {nombre}"` → `"flg {nombre}"` |
|
||||
| Migración | SPE_VELOCIDAD, SPE_HERRAMIENTA_UNIVERSAL → tabla hst |
|
||||
| Duplicados | Eliminados cie, cil, cio de spe (mantenidos en hst) |
|
||||
|
||||
---
|
||||
|
||||
## 3. Imágenes
|
||||
|
||||
### Limpieza Ejecutada
|
||||
|
||||
| Acción | Cantidad |
|
||||
|--------|----------|
|
||||
| Thumbnails eliminados | Todos en /thumb/ |
|
||||
| Imágenes huérfanas eliminadas | 1,892 |
|
||||
| Placeholder creado | placeholder.png (150x150) |
|
||||
|
||||
### Recuperación desde Airtable
|
||||
|
||||
**10 banderas recuperadas:**
|
||||
|
||||
| País | Hash |
|
||||
|------|------|
|
||||
| sri lanka | 95cdad8b... |
|
||||
| saudi arabia | 6c1925d6... |
|
||||
| el salvador | 56e07143... |
|
||||
| United Arab Emirates | dd64913c... |
|
||||
| new zealand | 22c26429... |
|
||||
| Czech Republic | 1c769ecb... |
|
||||
| república dominicana | 79170726... |
|
||||
| united kindom | 1c75c7e1... |
|
||||
| hong kong | 21bd3229... |
|
||||
| Great Britain | b5cbec1a... |
|
||||
|
||||
### Estado Final Imágenes
|
||||
|
||||
| Tabla | Con imagen | Sin imagen | Total |
|
||||
|-------|------------|------------|-------|
|
||||
| hst | 81 | 9 | 90 |
|
||||
| flg | 65 | 0 | 65 |
|
||||
| spe | 705 | 0 | 705 |
|
||||
| vsn | 0 | 0 | 0 |
|
||||
| vue | 0 | 20 | 20 |
|
||||
| **Total** | **851** | **29** | **880** |
|
||||
|
||||
**Imágenes en disco:** 923 (922 asignadas + placeholder)
|
||||
|
||||
---
|
||||
|
||||
## 4. Frontend
|
||||
|
||||
### tzrtech.org/hst_images/index.html
|
||||
|
||||
- Filtro cambiado: `if (record.img || record.mrf)` → `if (record.mrf)`
|
||||
- Usa imágenes principales (no thumbnails)
|
||||
- Placeholder para tags sin imagen
|
||||
- Muestra alias en lugar de ref
|
||||
|
||||
### graph.tzrtech.org
|
||||
|
||||
- Edges visualizándose correctamente (776 conexiones)
|
||||
- Posiciones iniciales de líneas corregidas
|
||||
- Simulación reiniciada al cargar edges
|
||||
|
||||
---
|
||||
|
||||
## 5. Repositorio Git
|
||||
|
||||
**Gitea:** http://localhost:3000/admin/hst-api
|
||||
|
||||
### Commits
|
||||
|
||||
1. `22fb0ae` - HST API v5.2 - Add als, h_maestro, graph/edges endpoints
|
||||
2. `4df8ae2` - Add edge_type support to graph table and API
|
||||
3. `9891f50` - Add README with API documentation and edge_type reference
|
||||
Reference in New Issue
Block a user