# 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 |