ARCHITECTURE_CANONICAL-da2acf93

# ::::bastion::universalis::orp::kukulkan:::: — arquitectura canónica

::::terra::sls:::: 🌐♾  
Fecha de registro en repo: 2026-06-09  
Estado: **canónico / joya de la corona / culminación de sistemas del bienestar**  
Repositorio: `terrauniversalis/bastion-grp`  
Ruta: `architecture/orp-kukulkan/ARCHITECTURE_CANONICAL.md`

## 1. Decisión

`::::bastion::universalis::orp::kukulkan::::` queda registrado como **la capa superior de sentido** de `::::sistemas::del::bienestar::::`.

No debe tratarse como:

- un módulo suelto;
- un ERP ciudadano;
- un dashboard más;
- una simple extensión de Frappe/ERPNext;
- una capa administrativa secundaria.

Debe tratarse como:

- **ORP**: Operating System for Regenerative Potential;
- sistema operativo de potencial regenerativo;
- culminación social, económica, formativa, comunitaria y de bienestar;
- capa superior que convierte Bastion GRP en jardinero institucional del ecosistema.

## 2. Relación con Bastion GRP y citoyen

```text
::::bastion::universalis::grp::::
        ↓
::::bastion::universalis::citoyen::::
        ↓
::::bastion::universalis::orp::kukulkan::::
```

| Capa | Nombre canónico | Función |
|---|---|---|
| Gobierno / gestión soberana | `::::bastion::universalis::grp::::` | Núcleo de gestión, coordinación, identidad, autorización, trazabilidad y operación institucional. |
| Brazo ciudadano | `::::bastion::universalis::citoyen::::` | Capa ciudadana para identidad, oficios, bienestar, formación, señales, trámites, participación y relación viva con GRP. |
| Culminación sistémica | `::::bastion::universalis::orp::kukulkan::::` | Sistema operativo para potencial regenerativo; organiza células de potencial, enjambres, jardinería, salus, aprendizaje y acción comunitaria. |

## 3. Corrección ontológica obligatoria

`::::bastion::universalis::citoyen::::` **no es ERP ciudadano**.

Puede usar capacidades ERP como sustrato técnico interno:

- Frappe;
- ERPNext;
- DocTypes;
- proyectos;
- inventario;
- fiscalidad;
- formación;
- workflows.

Pero su identidad conceptual es ciudadana, comunitaria, formativa, de bienestar y de participación.

`::::bastion::universalis::orp::kukulkan::::` lleva esa capa ciudadana al nivel superior: potencial regenerativo.

## 4. De ERP a ORP

| Paradigma | Lectura |
|---|---|
| ERP | Planifica recursos empresariales. |
| GRP | Gestiona recursos gubernamentales/institucionales. |
| ORP | Activa, conecta y regenera potencial humano, comunitario y territorial. |

El ORP no mira al ciudadano como recurso. Lo reconoce como **célula de potencial**.

## 5. Componentes canónicos

| Componente | Descripción |
|---|---|
| `::::celula::de::potencial::::` | Gemelo digital aspiracional del ciudadano; registra lo que es y lo que puede llegar a ser. |
| `::::motor::de::potencial::::` | Recomienda rutas de evolución personal, formación, oficio y colaboración. |
| `::::enjambres::de::valor::::` | Equipos efímeros formados por señales complementarias de ciudadanos, oficios y necesidades. |
| `::::protocolo::de::jardineria::::` | Bastion GRP nutre ecosistemas con incentivos, formación, compras públicas, apoyos o reglas correctivas. |
| `::::salus::ecosistemico::::` | Lectura agregada de bienestar territorial/comunitario, sin reducir todo a dinero. |
| `::::mayan::codex::::` | Lenguaje pedagógico y operativo para que el sistema sea entendible y modificable. |
| `::::nuntium::universalis::::` | Eventos, avisos, comunicaciones, alertas y trazabilidad. |
| `::::fabrica::systemarum::::` | Provisionamiento de células, oficios, workspaces, dashboards y plantillas. |

## 6. Arquitectura viva

```text
Ciudadano
  ↓
Célula de Potencial
  ↓
Señal de Potencial
  ↓
Motor de Enjambres
  ↓
Enjambre de Valor
  ↓
Proyecto / acción comunitaria
  ↓
Salus individual + salus comunitario
  ↓
Bastion GRP como jardinero institucional
```

## 7. Sustrato técnico

El sustrato técnico puede incluir:

```text
Frappe / ERPNext
sdb_universalis
PotentialCell
FrappeCellBridge
MayanRuntime
MayanTranspiler
MayanParser
Nuntium
Fabrica Systemarum
Bastion Gateway / unicornd
Azure PostgreSQL
```

La regla es clara:

> La tecnología es sustrato. La identidad del sistema es ORP.

## 8. Endpoints y kernel ORP

La arquitectura original incluye:

- kernel de células de potencial;
- motor de enjambres;
- protocolo de jardinería;
- integración Frappe;
- endpoints para despertar célula, declarar aspiraciones, añadir habilidades, completar cursos, emitir señales, proyectar futuro y consultar estado;
- despliegue ORP sobre `sdb_universalis`.

Esta pieza debe quedar como línea de implementación para Codex, separada del runtime `unicornd :8800` pero integrable con él.

## 9. Relación con `unicornd`

`unicornd :8800` es el gateway operativo público.

`orp::kukulkan` es la capa superior de sentido y lógica regenerativa.

```text
SharePoint / Dashboard
        ↓
unicornd :8800
        ↓
Bastion GRP
        ↓
citoyen
        ↓
ORP Kukulkan
```

No compiten. Se complementan.

## 10. Fuentes documentales internas

Fuentes base usadas para este registro:

- `Arquitectura final orp-bastion-universalis-kukulkan.md`
- `bastion_universalis_orp_kukulkan_annotated_20260608.md`
- `sistemas_del_bienestar_patch_citoyen_kukulkan_20260608.md`
- `README_integracion_codex.md`

## 11. Estado de implementación

```text
estado_arquitectonico: canonico
estado_documental: registrado_en_repo
estado_codigo: pendiente_de_implementacion_codex
estado_integracion: pendiente_de_unificar_con_sistemas_del_bienestar
prioridad: maxima
```

## 12. Próxima acción

Codex debe tomar este documento junto con los anexos fuente y producir:

1. carpeta de implementación ORP;
2. kernel mínimo;
3. endpoints Frappe / API;
4. integración con `unicornd`;
5. dashboard / visualización de salus y enjambres;
6. pruebas de primera célula de potencial;
7. documentación de despliegue.

## 13. Frase canónica

`::::bastion::universalis::orp::kukulkan::::` es la joya de la corona de `::::sistemas::del::bienestar::::`: el sistema operativo para potencial regenerativo que transforma al ciudadano de registro administrativo a célula viva de potencial, y al GRP de torre de control a jardinero institucional del ecosistema.

::::terra::sls:::: 🌐♾