Update to Skynet v7 - Complete documentation restructure
- Nueva estructura de carpetas según Skynet v7 - Añadidos schemas SQL completos - Documentación de entidades, componentes e integraciones - Modelo de seguridad actualizado - Infraestructura y operaciones reorganizadas
This commit is contained in:
95
01_ARQUITECTURA/entidades/hst.md
Normal file
95
01_ARQUITECTURA/entidades/hst.md
Normal file
@@ -0,0 +1,95 @@
|
||||
# HST - Hash Semantic Tagging
|
||||
|
||||
**Tipo:** Sistema de Etiquetado
|
||||
**Estado:** Implementado
|
||||
|
||||
---
|
||||
|
||||
## Descripción
|
||||
|
||||
Sistema de etiquetas semánticas visuales de 3 caracteres. Cada tag tiene un hash SHA-256 único (h_maestro) y una imagen asociada.
|
||||
|
||||
---
|
||||
|
||||
## Fórmula
|
||||
|
||||
```
|
||||
h_maestro = SHA-256(grupo:ref)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Grupos
|
||||
|
||||
| Grupo | Cantidad | Descripción |
|
||||
|-------|----------|-------------|
|
||||
| **hst** | 639 | Tags del sistema base |
|
||||
| **spe** | 145 | Tags específicos |
|
||||
| **vsn** | 84 | Visiones |
|
||||
| **flg** | 65 | Banderas/países |
|
||||
| **vue** | 21 | Vistas |
|
||||
|
||||
**Total:** 954 tags maestros
|
||||
|
||||
---
|
||||
|
||||
## Schema
|
||||
|
||||
```sql
|
||||
CREATE TABLE hst_tags (
|
||||
id SERIAL PRIMARY KEY,
|
||||
ref VARCHAR(100) UNIQUE NOT NULL,
|
||||
h_maestro VARCHAR(64) UNIQUE NOT NULL,
|
||||
grupo VARCHAR(50) NOT NULL,
|
||||
nombre_es VARCHAR(255),
|
||||
nombre_en VARCHAR(255),
|
||||
descripcion TEXT,
|
||||
imagen_url TEXT,
|
||||
activo BOOLEAN DEFAULT true,
|
||||
version INTEGER DEFAULT 1,
|
||||
created_at TIMESTAMP DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Ejemplo
|
||||
|
||||
```json
|
||||
{
|
||||
"ref": "person",
|
||||
"h_maestro": "a1b2c3d4e5f6...",
|
||||
"grupo": "hst",
|
||||
"nombre_es": "Persona",
|
||||
"nombre_en": "Person",
|
||||
"imagen_url": "https://tzrtech.org/a1b2c3d4e5f6...png"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Extensiones de Usuario
|
||||
|
||||
Los usuarios pueden crear sus propios tags:
|
||||
|
||||
| Tabla | Descripción |
|
||||
|-------|-------------|
|
||||
| **hsu** | HST Usuario |
|
||||
| **spu** | SPE Usuario |
|
||||
| **vsu** | VSN Usuario |
|
||||
| **vuu** | VUE Usuario |
|
||||
| **pju** | Proyectos Usuario |
|
||||
| **flu** | FLG Usuario |
|
||||
|
||||
---
|
||||
|
||||
## API
|
||||
|
||||
**Base URL:** https://tzrtech.org/api
|
||||
|
||||
| Endpoint | Método | Descripción |
|
||||
|----------|--------|-------------|
|
||||
| /tags | GET | Lista todos los tags |
|
||||
| /tags/{ref} | GET | Obtiene tag por ref |
|
||||
| /tags/search | GET | Busca tags |
|
||||
| /biblioteca | GET | Tags de usuario |
|
||||
Reference in New Issue
Block a user