Add HST schemas index with 13 document types

2026-01-01 19:52:43 +00:00
parent 5dd2110b74
commit e2c308eb6f
1 changed files with 192 additions and 0 deletions
--- a/03_MODELO_DATOS/hst-schemas-index.md
+++ b/03_MODELO_DATOS/hst-schemas-index.md
@@ -0,0 +1,192 @@
+# Índice de Schemas HST
+
+**Versión:** 1.0  
+**Actualizado:** 2026-01-01
+
+---
+
+## Resumen
+
+El sistema HST (HashTag Semántico) define 13 schemas de documentos comerciales siguiendo una arquitectura de 6 capas (L1-L6). Los schemas están almacenados en R2 y registrados en la base de datos HST.
+
+---
+
+## Documentos Comerciales
+
+### Flujo de Ventas
+
+| Tag | Nombre ES | Nombre EN | Campos | Descripción |
+|-----|-----------|-----------|--------|-------------|
+| `bgt` | Presupuesto | Budget/Estimate | 120 | Cálculo económico sin compromiso |
+| `gtc` | Condiciones Generales | General Terms | 90 | Términos legales reutilizables |
+| `off` | Oferta | Offer | 180 | Propuesta vinculante (bgt + gtc) |
+| `ord` | Pedido | Order | 200 | Instrucción de compra |
+| `dpa` | Aviso de Despacho | Despatch Advice | 180 | Notificación de envío |
+| `dnt` | Albarán | Delivery Note | 160 | Documento de entrega |
+| `inv` | Factura | Invoice | 250 | Documento fiscal |
+| `cct` | Contrato | Contract | 280 | Acuerdo legal vinculante |
+
+### Flujo de Compras (Perspectiva)
+
+| Tag | Nombre ES | Base | Descripción |
+|-----|-----------|------|-------------|
+| `qtt` | Cotización | off | Oferta recibida de proveedor |
+| `sod` | Pedido Proveedor | ord | Pedido emitido a proveedor |
+| `siv` | Factura Proveedor | inv | Factura recibida de proveedor |
+
+### Gestión
+
+| Tag | Nombre ES | Nombre EN | Campos | Descripción |
+|-----|-----------|-----------|--------|-------------|
+| `evt` | Evento | Event | 80 | Registro de actividad |
+| `tsk` | Tarea | Task | 70 | Unidad de trabajo |
+
+---
+
+## Flujo Documental
+
+```
+VENTAS:
+bgt ──────────────────────────────────────────────────┐
+ │                                                    │
+ └──▶ off (+gtc) ──▶ ord ──▶ dpa ──▶ dnt ──▶ inv     │
+            │                                         │
+            └──▶ cct ────────────────────────────────┘
+
+COMPRAS:
+      qtt ──▶ sod ──▶ (dpa) ──▶ (dnt) ──▶ siv
+```
+
+---
+
+## Arquitectura de 6 Capas
+
+| Capa | Nombre | Descripción |
+|------|--------|-------------|
+| **L1** | Core | Datos principales: header, partes, líneas, totales |
+| **L2** | Tax/Legal | Información fiscal y legal |
+| **L3** | Execution | Firmas, estados, seguimiento |
+| **L4** | Regional | Requisitos por país (Peppol, CFDI, etc.) |
+| **L5** | Links | Referencias a otros documentos |
+| **L6** | Extended | Metadata, workflow, integraciones |
+
+---
+
+## Estándares Soportados
+
+- **UBL 2.1** - Universal Business Language
+- **Peppol BIS 3.0** - Pan-European Public Procurement Online
+- **EN16931** - Norma europea de facturación electrónica
+- **Factur-X / ZUGFeRD** - Factura híbrida PDF/XML
+- **CFDI 4.0** - Comprobante Fiscal Digital (México)
+- **FacturaE 3.2** - Factura electrónica (España)
+- **INCOTERMS 2020** - Términos de comercio internacional
+- **eIDAS** - Reglamento europeo de firma electrónica
+
+---
+
+## Ubicaciones
+
+### Schemas Completos (R2)
+
+```
+s3://architect/system/skynet v8/03_MODELO_DATOS/sistema hst/
+├── HST_Budget_Standard_v1.0.md
+├── HST_Delivery_Note_Standard_v1.0.md
+├── HST_Despatch_Advice_Standard_v1.0.md
+├── HST_Event_Standard_v1.0.md
+├── HST_General_Terms_Standard_v1.0.md
+├── HST_Global_Contract_Standard_v1.0.md
+├── HST_Global_Invoice_Standard_v1.0.md
+├── HST_Offer_Standard_v1.0.md
+├── HST_Order_Standard_v1.0.md
+├── HST_Quotation_Standard_v1.0.md
+├── HST_Supplier_Invoice_Standard_v1.0.md
+├── HST_Supplier_Order_Standard_v1.0.md
+└── HST_Task_Standard_v1.0.md
+```
+
+### Base de Datos (HST Server)
+
+- **Servidor:** 72.62.2.84
+- **Base de datos:** lumalia
+- **Tabla:** hst
+- **Campo:** descripcion_modelo (JSONB)
+
+---
+
+## Consultas Útiles
+
+### Listar schemas disponibles
+
+```sql
+SELECT ref, nombre_es, 
+       descripcion_modelo->>'name_en' as name_en,
+       descripcion_modelo->>'total_fields' as campos
+FROM hst 
+WHERE descripcion_modelo IS NOT NULL 
+ORDER BY ref;
+```
+
+### Ver flujo documental de un tipo
+
+```sql
+SELECT ref,
+       descripcion_modelo->'document_flow'->>'input' as entrada,
+       descripcion_modelo->'document_flow'->>'output' as salida
+FROM hst 
+WHERE ref = 'ord';
+```
+
+### Listar capas de un schema
+
+```sql
+SELECT ref,
+       jsonb_object_keys(descripcion_modelo->'layers') as capa
+FROM hst 
+WHERE ref = 'inv';
+```
+
+---
+
+## Tipos de Documento
+
+### Tipos de Factura (inv/siv)
+| Código | UNTDID 1001 | Descripción |
+|--------|-------------|-------------|
+| 380 | Commercial Invoice | Factura comercial |
+| 381 | Credit Note | Nota de crédito |
+| 383 | Debit Note | Nota de débito |
+| 384 | Corrective Invoice | Factura rectificativa |
+| 389 | Self-billed Invoice | Autofactura |
+| 751 | Invoice Information | Factura informativa |
+
+### Tipos de Pedido (ord/sod)
+| Código | Descripción |
+|--------|-------------|
+| STD | Pedido estándar |
+| BLK | Pedido abierto/marco |
+| REL | Liberación de pedido abierto |
+| SPT | Pedido puntual |
+| RPT | Pedido repetitivo |
+| RUS | Pedido urgente |
+| SVC | Pedido de servicios |
+
+### Tipos de Contrato (cct)
+| Código | Descripción |
+|--------|-------------|
+| FRM | Contrato marco |
+| SVC | Servicios |
+| NDX | Anexo/Adenda |
+| LIC | Licencia |
+| EMP | Empleo |
+| LEA | Arrendamiento |
+| PUR | Compraventa |
+
+---
+
+## Changelog
+
+| Fecha | Versión | Cambios |
+|-------|---------|---------|
+| 2026-01-01 | 1.0 | Versión inicial con 13 schemas |