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:
ARCHITECT
89
01_ARQUITECTURA/entidades/corp.md
Normal file
89
01_ARQUITECTURA/entidades/corp.md
Normal file
@@ -0,0 +1,89 @@
|
||||
# CORP
|
||||
|
||||
**Tipo:** Servidor Empresarial
|
||||
**IP:** 92.112.181.188
|
||||
**Dominio:** tzzrcorp.me
|
||||
**Estado:** Operativo
|
||||
|
||||
---
|
||||
|
||||
## Descripción
|
||||
|
||||
CORP es el **servidor empresarial** del ecosistema. Gestiona múltiples usuarios y mayor complejidad que DECK.
|
||||
|
||||
---
|
||||
|
||||
## Arquitectura
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────────────┐
|
||||
│ CORP │
|
||||
│ (Servidor Empresarial) │
|
||||
├──────────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
|
||||
│ │ DIRECTUS │ │ NEXTCLOUD │ │ ODOO │ │
|
||||
│ │ (admin) │ │ (archivos) │ │ (ERP) │ │
|
||||
│ └─────────────┘ └─────────────┘ └─────────────┘ │
|
||||
│ │
|
||||
│ ┌───────────────────────────────────────────────────────────┐ │
|
||||
│ │ Componentes Internos │ │
|
||||
│ │ Margaret (secretaría) │ Jared (producción) │ │
|
||||
│ │ Mason (administración) │ Feldman (contable) │ │
|
||||
│ │ Sentinel (auditoría) │ │
|
||||
│ └───────────────────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
│ ┌───────────────────────────────────────────────┐ │
|
||||
│ │ PostgreSQL + Redis │ │
|
||||
│ └───────────────────────────────────────────────┘ │
|
||||
│ │
|
||||
└──────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Componentes Internos
|
||||
|
||||
| Componente | Puerto | Función |
|
||||
|------------|--------|---------|
|
||||
| Margaret (secretaría) | 5051 | Ingesta inmutable, múltiples usuarios |
|
||||
| Jared (producción) | 5052 | Flujos predefinidos, mayor complejidad |
|
||||
| Mason (administración) | 5053 | Enriquecimiento |
|
||||
| Feldman (contable) | 5054 | Consolidación |
|
||||
| Sentinel (auditoría) | - | Verificación LIGHT/DEEP |
|
||||
|
||||
---
|
||||
|
||||
## Servicios Docker
|
||||
|
||||
| Servicio | Puerto | Estado |
|
||||
|----------|--------|--------|
|
||||
| Directus | 8055 | OK |
|
||||
| Nextcloud | 8080 | OK |
|
||||
| Vaultwarden | 8081 | OK |
|
||||
| Shlink | 8082 | OK |
|
||||
| Odoo | 8069 | OK |
|
||||
| ntfy | 8880 | OK |
|
||||
| HSU API | 5002 | OK |
|
||||
| Redis | 6379 | OK |
|
||||
| PostgreSQL | 5432 | OK |
|
||||
| Caddy | 80/443 | OK |
|
||||
|
||||
---
|
||||
|
||||
## Almacenamiento
|
||||
|
||||
- **Bucket R2:** corp
|
||||
- **Protocolo:** locker://corp/...
|
||||
|
||||
---
|
||||
|
||||
## Diferencias con DECK
|
||||
|
||||
| Aspecto | DECK | CORP |
|
||||
|---------|------|------|
|
||||
| Dominio | tzzrdeck.me | tzzrcorp.me |
|
||||
| Usuarios | Uno | Múltiples |
|
||||
| Secretaría | Clara | Margaret |
|
||||
| Producción | Alfred | Jared |
|
||||
| Complejidad | Menor | Mayor |
|
||||
254
01_ARQUITECTURA/entidades/deck.md
Normal file
254
01_ARQUITECTURA/entidades/deck.md
Normal file
@@ -0,0 +1,254 @@
|
||||
# DECK
|
||||
|
||||
**Tipo:** Servidor Personal
|
||||
**IP:** 72.62.1.113
|
||||
**Dominio:** tzzrdeck.me
|
||||
|
||||
---
|
||||
|
||||
## Rol en el Ecosistema
|
||||
|
||||
DECK es el **servidor central** y **punto de iniciación** de todas las conexiones hacia los servicios de IA.
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ PRINCIPIO DECK │
|
||||
│ │
|
||||
│ "DECK inicia TODAS las conexiones. Los servicios son │
|
||||
│ stateless. Cada request lleva su contexto completo." │
|
||||
└─────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Funciones
|
||||
|
||||
| Función | Descripción |
|
||||
|---------|-------------|
|
||||
| **Iniciador** | Todas las llamadas a GRACE, PENNY, FACTORY se originan aquí |
|
||||
| **Gestor contexto** | Envía información de contexto con cada request |
|
||||
| **Router despliegue** | Decide si usar self-hosted o externos |
|
||||
| **Almacén credenciales** | Gestiona API keys vía Key Vault |
|
||||
|
||||
---
|
||||
|
||||
## Arquitectura
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ DECK │
|
||||
│ (Servidor Central) │
|
||||
├─────────────────────────────────────────────────────────────────┤
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ PostgreSQL │ │ Directus │ │ FileBrowser │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ Vaultwarden │ │ Shlink │ │ Addy.io │ │
|
||||
│ │ (Key Vault) │ │ │ │ │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||
│ │
|
||||
│ ┌──────────────────────────────────────────────────────────┐ │
|
||||
│ │ DEPLOYMENT ROUTER │ │
|
||||
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
|
||||
│ │ │ GRACE │ │ PENNY │ │ FACTORY │ │ │
|
||||
│ │ │ Connector │ │ Connector │ │ Connector │ │ │
|
||||
│ │ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ │
|
||||
│ └─────────┼────────────────┼────────────────┼───────────────┘ │
|
||||
└────────────┼────────────────┼────────────────┼──────────────────┘
|
||||
│ │ │
|
||||
▼ ▼ ▼
|
||||
┌────────────────────────────────────────────────────┐
|
||||
│ SERVICIOS DE IA │
|
||||
├────────────────────────────────────────────────────┤
|
||||
│ ┌─────────────────┐ ┌─────────────────┐ │
|
||||
│ │ SELF-HOSTED │ │ EXTERNAL │ │
|
||||
│ │ (RunPod/GPU) │ │ (APIs) │ │
|
||||
│ ├─────────────────┤ ├─────────────────┤ │
|
||||
│ │ Faster Whisper │ │ Groq API │ │
|
||||
│ │ Local LLM │ │ OpenRouter │ │
|
||||
│ │ Tesseract │ │ OpenAI │ │
|
||||
│ │ Embeddings │ │ Anthropic │ │
|
||||
│ └─────────────────┘ └─────────────────┘ │
|
||||
└────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Componentes Internos
|
||||
|
||||
| Componente | Puerto | Función |
|
||||
|------------|--------|---------|
|
||||
| Clara (secretaría) | 5051 | Ingesta inmutable |
|
||||
| Alfred (producción) | 5052 | Flujos predefinidos |
|
||||
| Mason (administración) | 5053 | Enriquecimiento |
|
||||
| Feldman (contable) | 5054 | Consolidación |
|
||||
|
||||
---
|
||||
|
||||
## Modos de Despliegue
|
||||
|
||||
### EXTERNAL
|
||||
|
||||
```yaml
|
||||
grace:
|
||||
mode: EXTERNAL
|
||||
external:
|
||||
providers_allowed: [groq, openrouter, openai, anthropic]
|
||||
```
|
||||
|
||||
- Todas las llamadas a proveedores externos
|
||||
- Sin infraestructura propia
|
||||
- Ideal para: inicio rápido, bajo volumen
|
||||
|
||||
### SELF_HOSTED
|
||||
|
||||
```yaml
|
||||
grace:
|
||||
mode: SELF_HOSTED
|
||||
self_hosted:
|
||||
endpoint: "https://your-runpod-endpoint.runpod.net"
|
||||
timeout_ms: 30000
|
||||
```
|
||||
|
||||
- Todas las llamadas a infraestructura propia
|
||||
- Requiere RunPod/GPU configurado
|
||||
- Ideal para: privacidad total, alto volumen
|
||||
|
||||
### SEMI (Recomendado)
|
||||
|
||||
```yaml
|
||||
grace:
|
||||
mode: SEMI
|
||||
tier_preference:
|
||||
- SELF_HOSTED
|
||||
- EXTERNAL
|
||||
self_hosted:
|
||||
endpoint: "..."
|
||||
retry_on_failure: true
|
||||
external:
|
||||
providers_allowed: [groq, openrouter]
|
||||
```
|
||||
|
||||
- Intenta self-hosted primero
|
||||
- Fallback automático a external
|
||||
- Balance privacidad/disponibilidad
|
||||
|
||||
---
|
||||
|
||||
## Flujo de Request
|
||||
|
||||
```
|
||||
┌──────────┐ ┌──────────┐ ┌───────────────┐ ┌──────────────┐
|
||||
│ Cliente │────▶│ DECK │────▶│ Deployment │────▶│ Servicio │
|
||||
│ │ │ │ │ Router │ │ (IA) │
|
||||
└──────────┘ └────┬─────┘ └───────┬───────┘ └──────────────┘
|
||||
│ │
|
||||
│ 1. Recibe request │
|
||||
│ 2. Lee config/deployment.yaml
|
||||
│ 3. Obtiene credenciales de Vaultwarden
|
||||
│ 4. Construye S-CONTRACT request
|
||||
│ │
|
||||
│ ┌────────▼────────┐
|
||||
│ │ mode: SEMI │
|
||||
│ ├─────────────────┤
|
||||
│ │ 1. Try SELF_HOSTED
|
||||
│ │ 2. If fail → EXTERNAL
|
||||
│ └─────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Servicios Docker
|
||||
|
||||
| Servicio | Puerto | Descripción |
|
||||
|----------|--------|-------------|
|
||||
| PostgreSQL | 5432 | Base de datos principal |
|
||||
| Directus | 8055 | Interface datos |
|
||||
| FileBrowser | 8081 | Gestión archivos |
|
||||
| Vaultwarden | 8082 | Key Vault |
|
||||
| Shlink | 8083 | Acortador URLs |
|
||||
| Addy.io | 8084 | Alias correo |
|
||||
| Redis | 6379 | Cache y colas |
|
||||
|
||||
---
|
||||
|
||||
## Conectores de IA
|
||||
|
||||
### GRACE Connector
|
||||
|
||||
- Procesa requests de módulos GRACE
|
||||
- Soporta todos los M-CONTRACTs
|
||||
- Maneja fallback chain según M-CONTRACT
|
||||
|
||||
### PENNY Connector
|
||||
|
||||
- Conexión WebSocket para real-time voice
|
||||
- Sesiones de voz bidireccionales
|
||||
- Integración con ASR/TTS
|
||||
|
||||
### FACTORY Connector
|
||||
|
||||
- Jobs de generación iterativa
|
||||
- Gestión de iteraciones y convergencia
|
||||
- Tracking de costos
|
||||
|
||||
---
|
||||
|
||||
## Gestión de Credenciales
|
||||
|
||||
Las credenciales se referencian con URIs `kv://`:
|
||||
|
||||
| URI | Contenido |
|
||||
|-----|-----------|
|
||||
| `kv://deck/credentials/groq` | API key Groq |
|
||||
| `kv://deck/credentials/openrouter` | API key OpenRouter |
|
||||
| `kv://deck/credentials/runpod` | API key RunPod |
|
||||
| `kv://deck/credentials/grace` | Credenciales consolidadas GRACE |
|
||||
| `kv://deck/credentials/penny` | Credenciales PENNY |
|
||||
| `kv://deck/credentials/factory` | Credenciales FACTORY |
|
||||
|
||||
---
|
||||
|
||||
## Integración S-CONTRACT
|
||||
|
||||
DECK construye requests siguiendo S-CONTRACT v2.1:
|
||||
|
||||
```json
|
||||
{
|
||||
"contract_version": "2.1",
|
||||
"profile": "FULL",
|
||||
"envelope": {
|
||||
"trace_id": "uuid-generado-por-deck",
|
||||
"idempotency_key": "sha256-del-contenido"
|
||||
},
|
||||
"routing": {
|
||||
"module": "ASR_ENGINE"
|
||||
},
|
||||
"deployment": {
|
||||
"mode": "SEMI",
|
||||
"tier_preference": ["SELF_HOSTED", "EXTERNAL"],
|
||||
"credentials_ref": "kv://deck/credentials/grace"
|
||||
},
|
||||
"payload": {
|
||||
"type": "audio",
|
||||
"encoding": "url",
|
||||
"content": "https://storage.tzzrdeck.me/audio/file.mp3"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Estructura de Directorios
|
||||
|
||||
```
|
||||
deck/
|
||||
├── config/
|
||||
│ └── deployment.yaml # Modos de despliegue
|
||||
├── docker-compose.yml # Servicios
|
||||
├── docs/
|
||||
│ ├── ARQUITECTURA.md
|
||||
│ └── ESPECIFICACION_SERVIDOR.md
|
||||
├── .env # Variables entorno
|
||||
└── README.md
|
||||
```
|
||||
58
01_ARQUITECTURA/entidades/flg.md
Normal file
58
01_ARQUITECTURA/entidades/flg.md
Normal file
@@ -0,0 +1,58 @@
|
||||
# FLG - Flags
|
||||
|
||||
**Tipo:** Marcos Jurídicos
|
||||
**Estado:** Planificado
|
||||
|
||||
---
|
||||
|
||||
## Descripción
|
||||
|
||||
Los FLG representan **marcos jurídicos**, normativas y países. Determinan las reglas aplicables a cada operación.
|
||||
|
||||
---
|
||||
|
||||
## Uso
|
||||
|
||||
| Contexto | Ejemplo |
|
||||
|----------|---------|
|
||||
| País | España, México, Argentina |
|
||||
| Normativa | RGPD, SOX, ISO 27001 |
|
||||
| Jurisdicción | UE, LATAM, USA |
|
||||
|
||||
---
|
||||
|
||||
## Grupos HST Relacionados
|
||||
|
||||
Actualmente existe un grupo `flg` en HST con 65 tags de países, pero no como entidad independiente con schema propio.
|
||||
|
||||
---
|
||||
|
||||
## Schema Propuesto
|
||||
|
||||
```sql
|
||||
CREATE TABLE flags (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
h_flag VARCHAR(64) UNIQUE NOT NULL,
|
||||
tipo VARCHAR(50) NOT NULL,
|
||||
codigo VARCHAR(10),
|
||||
nombre VARCHAR(255) NOT NULL,
|
||||
normativas JSONB,
|
||||
metadata JSONB,
|
||||
activo BOOLEAN DEFAULT true,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Aplicación en Bloques
|
||||
|
||||
Cada bloque puede tener un FLG asociado:
|
||||
|
||||
```json
|
||||
{
|
||||
"h_bloque": "abc123...",
|
||||
"h_flag": "esp...",
|
||||
"implicacion": "RGPD aplica, retención 5 años"
|
||||
}
|
||||
```
|
||||
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 |
|
||||
84
01_ARQUITECTURA/entidades/itm.md
Normal file
84
01_ARQUITECTURA/entidades/itm.md
Normal file
@@ -0,0 +1,84 @@
|
||||
# ITM - Items
|
||||
|
||||
**Tipo:** Entidad de Plano Ideal
|
||||
**Estado:** Planificado
|
||||
|
||||
---
|
||||
|
||||
## Descripción
|
||||
|
||||
Los ITM representan el **plano ideal** (T0). Son la "partitura" que guía las acciones. Definiciones perfectas de lo que debería existir o lograrse.
|
||||
|
||||
---
|
||||
|
||||
## Concepto
|
||||
|
||||
| Aspecto | Descripción |
|
||||
|---------|-------------|
|
||||
| **Naturaleza** | Ideal, abstracta |
|
||||
| **Temporalidad** | T-N → T-1 → T0 |
|
||||
| **Energía** | No consume (es definición) |
|
||||
| **Mutabilidad** | Versionable |
|
||||
|
||||
---
|
||||
|
||||
## Tipos de Items
|
||||
|
||||
| Tipo | Descripción |
|
||||
|------|-------------|
|
||||
| **accion_ideal** | Acción que debería ejecutarse |
|
||||
| **objetivo** | Meta a alcanzar |
|
||||
| **requerimiento** | Requisito a cumplir |
|
||||
|
||||
---
|
||||
|
||||
## Schema Propuesto
|
||||
|
||||
```sql
|
||||
CREATE TABLE items (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
h_item VARCHAR(64) UNIQUE NOT NULL,
|
||||
h_instancia VARCHAR(64) NOT NULL,
|
||||
secuencia BIGINT NOT NULL,
|
||||
hash_previo VARCHAR(64),
|
||||
hash_contenido VARCHAR(64),
|
||||
tipo_item VARCHAR(50) NOT NULL,
|
||||
titulo VARCHAR(255) NOT NULL,
|
||||
descripcion TEXT,
|
||||
criterios_aceptacion JSONB,
|
||||
metadata JSONB,
|
||||
proyecto_tag VARCHAR(64),
|
||||
etiquetas JSONB,
|
||||
estado VARCHAR(20) DEFAULT 'draft',
|
||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
||||
created_by VARCHAR(64),
|
||||
UNIQUE (h_instancia, secuencia)
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Fórmula Hash
|
||||
|
||||
```
|
||||
h_item = SHA-256(h_instancia:secuencia:tipo:contenido)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Relación con Otros Planos
|
||||
|
||||
```
|
||||
ITM (ideal)
|
||||
│
|
||||
├──► h_maestro (HST tags)
|
||||
├──► h_player (PLY responsable)
|
||||
├──► h_loc (LOC ubicación)
|
||||
└──► h_flag (FLG normativa)
|
||||
│
|
||||
▼ materializa
|
||||
MST (milestone)
|
||||
│
|
||||
▼ genera
|
||||
BCK (bloque)
|
||||
```
|
||||
67
01_ARQUITECTURA/entidades/loc.md
Normal file
67
01_ARQUITECTURA/entidades/loc.md
Normal file
@@ -0,0 +1,67 @@
|
||||
# LOC - Locations
|
||||
|
||||
**Tipo:** Ubicaciones Geográficas
|
||||
**Estado:** Planificado
|
||||
|
||||
---
|
||||
|
||||
## Descripción
|
||||
|
||||
Los LOC representan **ubicaciones geográficas** con precisión variable.
|
||||
|
||||
---
|
||||
|
||||
## Tipos
|
||||
|
||||
| Tipo | Descripción |
|
||||
|------|-------------|
|
||||
| **punto** | Coordenadas exactas |
|
||||
| **area** | Zona delimitada |
|
||||
| **ruta** | Trayecto entre puntos |
|
||||
|
||||
---
|
||||
|
||||
## Schema Propuesto
|
||||
|
||||
```sql
|
||||
CREATE TABLE locations (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
h_loc VARCHAR(64) UNIQUE NOT NULL,
|
||||
nombre VARCHAR(255),
|
||||
lat DECIMAL(10, 8),
|
||||
lon DECIMAL(11, 8),
|
||||
precision_metros INTEGER,
|
||||
tipo VARCHAR(50),
|
||||
metadata JSONB,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Fórmula Hash
|
||||
|
||||
```
|
||||
h_loc = SHA-256(lat:lon:precision)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Uso en el Sistema
|
||||
|
||||
Cada bloque puede tener una ubicación asociada:
|
||||
|
||||
```json
|
||||
{
|
||||
"h_bloque": "abc123...",
|
||||
"h_loc": "geo456...",
|
||||
"lat": 41.6488,
|
||||
"lon": -0.8891,
|
||||
"precision_metros": 10
|
||||
}
|
||||
```
|
||||
|
||||
Esto permite:
|
||||
- Geolocalización de evidencias
|
||||
- Verificación de ubicación
|
||||
- Análisis espacial de operaciones
|
||||
64
01_ARQUITECTURA/entidades/ply.md
Normal file
64
01_ARQUITECTURA/entidades/ply.md
Normal file
@@ -0,0 +1,64 @@
|
||||
# PLY - Players
|
||||
|
||||
**Tipo:** Entidad de Identidad
|
||||
**Estado:** Planificado
|
||||
|
||||
---
|
||||
|
||||
## Descripción
|
||||
|
||||
Los PLY representan la **identidad de actores** en el sistema: personas, empresas, agentes.
|
||||
|
||||
---
|
||||
|
||||
## Tipos
|
||||
|
||||
| Tipo | Descripción |
|
||||
|------|-------------|
|
||||
| **persona** | Usuario individual |
|
||||
| **empresa** | Organización |
|
||||
| **agente** | Sistema automatizado |
|
||||
|
||||
---
|
||||
|
||||
## Schema Propuesto
|
||||
|
||||
```sql
|
||||
CREATE TABLE players (
|
||||
id BIGSERIAL PRIMARY KEY,
|
||||
h_player VARCHAR(64) UNIQUE NOT NULL,
|
||||
tipo VARCHAR(50) NOT NULL,
|
||||
nombre VARCHAR(255) NOT NULL,
|
||||
email VARCHAR(255),
|
||||
metadata JSONB,
|
||||
activo BOOLEAN DEFAULT true,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Fórmula Hash
|
||||
|
||||
```
|
||||
h_player = SHA-256(tipo:identificador_unico)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Uso en el Sistema
|
||||
|
||||
Cada acción registrada incluye referencia al player:
|
||||
|
||||
```json
|
||||
{
|
||||
"h_bloque": "abc123...",
|
||||
"h_player": "def456...",
|
||||
"accion": "completó tarea X"
|
||||
}
|
||||
```
|
||||
|
||||
Esto permite:
|
||||
- Trazabilidad de quién hizo qué
|
||||
- Portfolio verificable por persona
|
||||
- Auditoría sin ambigüedad
|
||||
Reference in New Issue
Block a user