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
|
||||||
8
Dockerfile
Normal file
8
Dockerfile
Normal file
@@ -0,0 +1,8 @@
|
|||||||
|
FROM python:3.11-slim
|
||||||
|
WORKDIR /app
|
||||||
|
ENV PYTHONDONTWRITEBYTECODE=1
|
||||||
|
ENV PYTHONUNBUFFERED=1
|
||||||
|
RUN pip install flask flask-cors psycopg2-binary gunicorn
|
||||||
|
COPY app.py .
|
||||||
|
EXPOSE 5000
|
||||||
|
CMD ["gunicorn", "-w", "2", "-b", "0.0.0.0:5000", "--reload", "app:app"]
|
||||||
Reference in New Issue
Block a user