# Entidades

**Versión:** 1.0  
**Estado:** Definición

---

## Visión General

Las entidades base son los bloques fundamentales del sistema. Cada una tiene un hash único SHA-256 que la identifica de forma unívoca.

```
DEFINICIÓN ORIGINAL  →  SHA-256  →  h_{tipo} (64 chars)
```

---

## Entidades del Sistema

| Entidad | Hash | Descripción | Estado |
|---------|------|-------------|--------|
| **HST** | h_maestro | Tags semánticos | Implementado |
| **ITM** | h_item | Plano ideal | Planificado |
| **PLY** | h_player | Identidad | Planificado |
| **LOC** | h_loc | Ubicaciones | Planificado |
| **FLG** | h_flag | Marcos jurídicos | Planificado |

---

## HST (Hash Semantic Tagging)

Sistema de etiquetas semánticas visuales.

### Fórmula

```
h_maestro = SHA-256(grupo:ref)
```

### Grupos

| Grupo | Cantidad |
|-------|----------|
| hst | 639 |
| spe | 145 |
| vsn | 84 |
| flg | 65 |
| vue | 21 |

---

## ITM (Items)

Plano ideal - definiciones abstractas.

### Tipos

| Tipo | Descripción |
|------|-------------|
| accion_ideal | Acción que debería ejecutarse |
| objetivo | Meta a alcanzar |
| requerimiento | Requisito a cumplir |

---

## PLY (Players)

Identidad de actores en el sistema.

### Tipos

| Tipo | Descripción |
|------|-------------|
| persona | Usuario individual |
| empresa | Organización |
| agente | Sistema automatizado |

---

## LOC (Locations)

Ubicaciones geográficas.

### Tipos

| Tipo | Descripción |
|------|-------------|
| punto | Coordenadas exactas |
| area | Zona delimitada |
| ruta | Trayecto |

---

## FLG (Flags)

Marcos jurídicos y normativas.

### Uso

- Países
- Normativas (RGPD, SOX, ISO)
- Jurisdicciones

---

## Relaciones Entre Entidades

```
ITM (ideal)
  │
  ├──► h_maestro (HST tags)
  ├──► h_player (PLY responsable)
  ├──► h_loc (LOC ubicación)
  └──► h_flag (FLG normativa)

MST (milestone)
  │
  ├──► item_asociado (ITM)
  └──► h_maestro (HST tags)

BCK (bloque)
  │
  ├──► item_asociado (ITM)
  ├──► milestone_asociado (MST)
  └──► h_maestro (HST tags)
```

---

## Extensiones de Usuario

| Tabla | Descripción |
|-------|-------------|
| hsu | HST Usuario |
| spu | SPE Usuario |
| vsu | VSN Usuario |
| vuu | VUE Usuario |
| pju | Proyectos Usuario |
| flu | FLG Usuario |