Archive: System v4 - Estado al 2024-12-24

v4-archive/architect/HST_INTEGRACION.md

@@ -0,0 +1,79 @@
+# Integración HST
+
+## Arquitectura
+
+```
+           HST (tzrtech.org)
+           Tags maestros + Imágenes
+                   │
+        ┌──────────┼──────────┐
+        ▼          ▼          ▼
+      DECK       CORP      Otros
+   (mirrors)  (mirrors)   (futuro)
+   Sin imgs   Sin imgs
+```
+
+## HST - Origen de verdad
+
+| Tabla | Registros | Descripción |
+|-------|-----------|-------------|
+| hst | 658 | Tags principales |
+| spe | 145 | Especies |
+| flg | 65 | Flags |
+| vsn | 84 | Vision |
+| vue | 21 | Vue |
+| **Total** | **973** | |
+
+API: https://tzrtech.org/api/
+
+## DECK (72.62.1.113)
+
+**Tablas creadas:**
+| Tabla | Registros | Descripción |
+|-------|-----------|-------------|
+| hst_mirror | 954 | Copia local de tags HST |
+| hsu | 0 | Tags de usuario |
+| spu | 0 | Especies de usuario |
+| flu | 0 | Flags de usuario |
+| vsu | 0 | Vision de usuario |
+| vuu | 0 | Vue de usuario |
+| pju | 0 | Proyectos de usuario |
+
+## CORP (92.112.181.188)
+
+Mismas 7 tablas que DECK.
+- hst_mirror: 973 registros sincronizados
+
+NocoDB: http://92.112.181.188:8080
+- Email: admin@tzrtech.com
+
+## Sync por grupo (CORP)
+
+| Grupo | Cantidad |
+|-------|----------|
+| hst | 639 |
+| spe | 145 |
+| vsn | 84 |
+| flg | 65 |
+| vue | 21 |
+
+## Pendiente
+
+**DECK/CORP:**
+- [ ] Webhook/polling para sync continuo con HST
+- [ ] Lógica descarga imágenes cuando HST elimina tags
+- [ ] API para usuarios
+
+**HST:**
+- [ ] Endpoint `/api/sync/changes`
+- [ ] Sistema de webhooks
+- [ ] Período de gracia para eliminación
+
+## Flujo de eliminación
+
+Cuando HST elimina un tag:
+1. Descargar imagen de `hst_ruta`
+2. Guardar en `/images/{ref}.png` local
+3. Actualizar `local_ruta`, `local_subdominio`
+4. Marcar `hst_activo = false`
+5. Tag permanece en mirror (no se borra)