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:
root
2026-01-02 02:04:19 +00:00
parent 9891f504bf
commit 5d12e38715
2 changed files with 130 additions and 0 deletions

122
CHANGELOG.md Normal file
View 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