@ingcrea/aumic-puf 3.2.0 → 3.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/MANIFEST.es.md +68 -134
- package/MANIFEST.md +85 -43
- package/README.es.md +205 -203
- package/README.md +208 -204
- package/dist/cli/index.js +1 -1
- package/package.json +1 -1
package/MANIFEST.es.md
CHANGED
|
@@ -1,172 +1,106 @@
|
|
|
1
|
-
# 📜 MANIFIESTO ARQUITECTÓNICO: ESTÁNDAR AUM-IC 7
|
|
1
|
+
# 📜 MANIFIESTO ARQUITECTÓNICO: ESTÁNDAR AUM-IC 7 (EDICIÓN 2026)
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
<p align="center">
|
|
4
|
+
<img src="https://img.shields.io/badge/version-7.0.0-crimson?style=flat-square" alt="Versión 7.0.0">
|
|
5
|
+
<img src="https://img.shields.io/badge/naturaleza-Estandar%20de%20Ingenieria%20Pura-38bdf8?style=flat-square" alt="Naturaleza">
|
|
6
|
+
<img src="https://img.shields.io/badge/suite-PUF--23%20Aseguramiento-gold?style=flat-square" alt="PUF-23">
|
|
7
|
+
</p>
|
|
4
8
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
---
|
|
9
|
+
> 🌐 **Navegación:** 🇲🇽 [Leer en Español](./MANIFEST.es.md) | 🇺🇸 [Read in English](./MANIFEST.md) | 📖 [README (ES)](./README.es.md) | 📖 [README (EN)](./README.md) | 🌌 [Estándar AUM-IC 7](https://github.com/ingcrea/aum-ic)
|
|
8
10
|
|
|
11
|
+
Este documento rige el **Paradigma de Universos Multidimensionales de Ingeniería Creativa (Estándar AUM-IC 7)** y su correspondencia operativa con la matriz de 23 compuertas del **Protocolo Universal contra Fallos (PUF-23)**.
|
|
9
12
|
|
|
10
|
-
|
|
13
|
+
No es una convención arbitraria de directorios ni una sugerencia cosmética: es un marco riguroso de arquitectura, física fractal e ingeniería de software concebido para satisfacer de forma nativa los estándares internacionales de calidad de producto (**ISO/IEC 25010**), seguridad de la información (**ISO 27001**), testabilidad (**ISO 29119**) y accesibilidad web (**ISO 40500 / WCAG 2.2**).
|
|
11
14
|
|
|
15
|
+
---
|
|
12
16
|
|
|
13
|
-
## 🌌 El Porqué Fundamental: Entropía vs.
|
|
17
|
+
## 🌌 El Porqué Fundamental: Entropía vs. Precisión Matemática
|
|
14
18
|
|
|
15
|
-
**
|
|
19
|
+
**El desarrollo de software sin rigor es entropía descontrolada.** Es dispersión caótica: dependencias circulares, parches superficiales, acoplamiento destructivo, pérdidas de memoria y sistemas que colapsan ante condiciones imprevistas de concurrencia.
|
|
16
20
|
|
|
17
|
-
El
|
|
21
|
+
El universo físico, aunque parezca caótico, opera bajo un equilibrio matemático implacable. Desde las interacciones cuánticas elementales hasta la mecánica de cuerpos celestes masivos, nada queda al azar.
|
|
18
22
|
|
|
19
|
-
**El Paradigma AUM-IC
|
|
23
|
+
**El Paradigma AUM-IC somete el código a estas mismas leyes universales.** Es un modelo mental absoluto, **100% agnóstico al lenguaje** (Rust, TypeScript, Python, Astro, PHP, Java, C#, Swift, Shell), que divide el desarrollo en **Materia Observable** (estructura fractal del código), **Fuerzas Invisibles** (flujo de datos y resiliencia SRE) y **Leyes de Correspondencia** (escalabilidad por masa crítica).
|
|
20
24
|
|
|
21
25
|
---
|
|
22
26
|
|
|
23
27
|
## PARTE I: LA MATERIA OBSERVABLE (Estructura Fractal)
|
|
24
28
|
|
|
25
|
-
El Principio
|
|
26
|
-
|
|
27
|
-
Para detener la entropía, los directorios utilizan obligatoriamente prefijos numéricos:
|
|
29
|
+
El Principio de Correspondencia establece: *"Como es arriba, es abajo"*. Los componentes del software se organizan en simetría fractal estricta tanto en Frontend (interfaces de usuario), como en Backend (controladores y microservicios) y Persistencia (modelos de datos):
|
|
28
30
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
31
|
+
```text
|
|
32
|
+
src/
|
|
33
|
+
├── 1-atoms/ # Elementos puros e indivisibles (Botones, inputs, helpers matemáticos puros)
|
|
34
|
+
├── 2-molecules/ # Agrupaciones simples (Campos de formulario con label/error, middlewares)
|
|
35
|
+
├── 3-cells/ # Contenedores funcionales (Tarjetas de producto, entidades ORM, servicios unitarios)
|
|
36
|
+
├── 4-organisms/ # Módulos autónomos de negocio (Formulario de checkout, casos de uso, orquestadores)
|
|
37
|
+
├── 5-planets/ # Vistas completas o controladores API (Páginas de dashboard, endpoints REST/gRPC)
|
|
38
|
+
└── 6-layouts/ # Malla espacial y contenedores maestros (Plantillas estructurales, server app modules)
|
|
39
|
+
```
|
|
32
40
|
|
|
33
|
-
|
|
34
|
-
* **Concepto:** La unión de dos o más átomos (Campos de formulario en UI / Middlewares y Validadores en Backend).
|
|
35
|
-
* **Regla:** Tienen propósito específico pero carecen de lógica de negocio profunda.
|
|
41
|
+
* **Regla de Gravedad Cero:** Los átomos (`1-atoms/`) no pueden depender de capas superiores ni importar estado mutable o conexiones a base de datos. La densidad y gravedad se reservan para los organismos y planetas.
|
|
36
42
|
|
|
37
|
-
|
|
38
|
-
* **Concepto:** Contenedores funcionales interactivos (Formularios completos en UI / Entidades ORM o Servicios unitarios en Backend).
|
|
39
|
-
* **Regla:** Manejan eventos de usuario pero delegan el procesamiento masivo a capas superiores.
|
|
43
|
+
---
|
|
40
44
|
|
|
41
|
-
|
|
42
|
-
* **Concepto:** Bloques complejos y autónomos (Secciones dinámicas en UI / Casos de Uso y Orquestadores en Backend).
|
|
43
|
-
* **Regla:** Agrupan células. Pueden ser inyectados en diferentes planetas y funcionar de manera independiente.
|
|
45
|
+
## PARTE II: LAS 7 FUERZAS CÓSMICAS (Núcleo SRE y Seguridad)
|
|
44
46
|
|
|
45
|
-
|
|
46
|
-
* **Concepto:** Macro-secciones semánticas (Headers/Footers en UI / Endpoints y Controladores API en Backend).
|
|
47
|
-
* **Regla:** Son el "hogar" de los organismos. Estructuran y enrutan la información.
|
|
47
|
+
Todo sistema en producción debe operar bajo 7 leyes dinámicas que rigen el flujo de datos:
|
|
48
48
|
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
49
|
+
1. **Materia Oscura (Estado Global):** La gravedad invisible. La información global de la aplicación (Zustand, Redux, Daemons de memoria) unifica a los organismos sin acoplarlos de forma directa (*Prop Drilling* prohibido).
|
|
50
|
+
2. **Horizonte de Eventos (Seguridad Perimetral):** Frontera impenetrable. Aplica Content Security Policy (CSP), Rate Limiting estricto, challenge anti-bots y validación criptográfica de firmas JWT. Todo payload sin firma válida es repelido en el middleware.
|
|
51
|
+
3. **Campo Magnético (ORM y Sanitización):** Protege el núcleo del sistema contra radiación cósmica (inyecciones SQL y ataques XSS). Queda prohibido el SQL en texto plano sin parametrizar. La materia no se destruye arbitrariamente: se exige el **Borrado Lógico (Soft Deletes)** y el control estricto de esquemas mediante migraciones declarativas.
|
|
52
|
+
4. **El Colisionador de Hadrones (Ciclo Cerrado de Calidad PUF-23):** El caos no entra a producción. Antes de un release, el código debe superar la matriz de 23 compuertas de aseguramiento (**G0 a G22**), auditando desde la codificación de bytes hasta contratos de API y compatibilidad de licencias.
|
|
53
|
+
5. **Agujeros de Gusano (Caché y Arquitectura Offline-First):** Supera la latencia de la red. Despliega bases de datos locales incrustadas (SQLite, Realm) en clientes Desktop/Mobile o clústeres Redis en la nube, garantizando que el sistema opere y facture aun en condiciones de desconexión.
|
|
54
|
+
6. **La Malla Cósmica (Resiliencia Distribuida):** Implementación obligatoria de **Circuit Breakers** para aislar servicios externos caídos y bucles exponenciales de reconexión (**Exponential Backoff**) para revivir enlaces a bases de datos de forma autónoma.
|
|
55
|
+
7. **Radiación Cósmica de Fondo (Observabilidad Forense y RUM):** Toda interacción deja una huella digital determinista. Telemetría de usuario real (RUM), captura de excepciones de runtime globales, monitoreo de 404s y despacho inmediato de alertas al centro de comando.
|
|
52
56
|
|
|
53
57
|
---
|
|
54
58
|
|
|
55
|
-
## PARTE
|
|
56
|
-
|
|
57
|
-
Un universo estático está muerto. Estas leyes dictan cómo interactúa la materia.
|
|
59
|
+
## PARTE III: LEY DE CORRESPONDENCIA (Escalabilidad por Masa Crítica)
|
|
58
60
|
|
|
59
|
-
|
|
60
|
-
* **El Concepto:** Son los datos globales de la aplicación en memoria (Redux, Zustand, Daemons).
|
|
61
|
-
* **Uso Práctico:** En lugar de pasar un dato bajando por 10 archivos distintos (*Prop Drilling*), guardas ese dato en la "Materia Oscura". Cualquier archivo lo absorbe directamente. Es la **Fuente Única de Verdad**.
|
|
62
|
-
* **Estándar ISO:** Mantenibilidad y Modularidad.
|
|
61
|
+
Un asteroide obedece las mismas leyes fundamentales que una galaxia; sin embargo, las fuerzas activas se encienden en proporción a su **Masa Crítica**:
|
|
63
62
|
|
|
64
|
-
###
|
|
65
|
-
* **
|
|
66
|
-
* **
|
|
67
|
-
* **
|
|
68
|
-
|
|
69
|
-
### ⚡ 3. Velocidad de la Luz y Agujeros de Gusano (Latencia y Caché)
|
|
70
|
-
* **El Concepto:** Peticiones de red, tiempos de espera y memoria a corto plazo.
|
|
71
|
-
* **Uso Práctico:** Superamos el límite de la velocidad de la luz mediante **UI Optimista** (mostrar resultados al instante mientras el dato viaja). Además, utilizamos **Agujeros de Gusano (Redis, Caché de Navegador, CDNs)** para doblar el espacio-tiempo, entregando información frecuente instantáneamente desde la memoria sin tener que hacer el viaje completo hasta la Base de Datos.
|
|
72
|
-
* **Estándar ISO:** Eficiencia de Rendimiento y Escalabilidad.
|
|
63
|
+
### 🪨 Nivel 1: El Asteroide (Sistemas de Propósito Único)
|
|
64
|
+
* **Ejemplos:** Landing pages, herramientas CLI, scripts de procesamiento, utilidades de una sola pantalla.
|
|
65
|
+
* **Materia Oscura (Estado Global):** **APAGADA.** No requiere almacenes pesados; el estado reside localmente.
|
|
66
|
+
* **Campo Magnético Perimetral:** **MÁXIMO.** Todo input exterior es letal. En web se aplican filtros contra tráfico malicioso; en mobile/desktop se aplican validadores tipados estrictos (Zod, TypeBox, serde).
|
|
67
|
+
* **La Biósfera (Accesibilidad y SEO):** **MÁXIMA.** Marcado semántico riguroso y consumo nativo de APIs de accesibilidad del sistema operativo.
|
|
73
68
|
|
|
74
|
-
###
|
|
75
|
-
* **
|
|
76
|
-
* **
|
|
77
|
-
* **
|
|
69
|
+
### 🌍 Nivel 2: El Planeta (Sistemas Transaccionales)
|
|
70
|
+
* **Ejemplos:** Plataformas de comercio electrónico, puntos de venta (POS), aplicaciones móviles transaccionales.
|
|
71
|
+
* **Agujeros de Gusano (Offline-First):** **ENCENDIDO.** Bases de datos SQLite locales mantienen la operatividad continua si la conexión a internet colapsa.
|
|
72
|
+
* **Firmas Espectrales (Seguridad de Sesión):** **ENCENDIDO.** Almacenamiento seguro en Credential Manager de Windows, Keychain de macOS o cookies HttpOnly con banderas `Secure` y `SameSite`. Prohibido el almacenamiento en texto plano.
|
|
78
73
|
|
|
79
|
-
###
|
|
80
|
-
* **
|
|
81
|
-
* **
|
|
82
|
-
* **
|
|
74
|
+
### 🌌 Nivel 3: La Galaxia (Ecosistemas Masivos y Distribuidos)
|
|
75
|
+
* **Ejemplos:** Sistemas ERP en la nube, plataformas Fintech / Core Bancario, suites industriales de escritorio.
|
|
76
|
+
* **La Malla Cósmica (IPC y Microservicios):** **MÁXIMA POTENCIA.** Comunicación asíncrona tipada y desacoplamiento de subprocesos. Si un microservicio o worker falla, el resto de la galaxia permanece intacto.
|
|
77
|
+
* **Telemetría y Observabilidad:** **MÁXIMA POTENCIA.** Auditoría continua de logs, monitoreo de tiempos de respuesta, trazas distribuidas y mitigación proactiva de incidentes.
|
|
83
78
|
|
|
84
79
|
---
|
|
85
80
|
|
|
86
|
-
##
|
|
81
|
+
## MATRIZ DE CORRESPONDENCIA: AUM-IC 7 vs. PUF-23
|
|
87
82
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
83
|
+
| Fuerza Cósmica AUM-IC | Compuertas PUF-23 que la Certifican | Objetivo Operativo |
|
|
84
|
+
| :--- | :--- | :--- |
|
|
85
|
+
| **Higiene Fundamental** | **`G0`**, **`G8`**, **`G22`** | Codificación UTF-8 pura, saltos LF, erradicación de mojibake y balanceo universal de delimitadores. |
|
|
86
|
+
| **Colisionador de Hadrones** | **`G2`**, **`G3`**, **`G5`**, **`G6`** | Ciclo rojo/verde de tests, snapshots SHA-256 de reversión y rigor estático absoluto. |
|
|
87
|
+
| **Campo Magnético** | **`G4`**, **`G19`**, **`G21`** | Refactor limpio, cero inyecciones SQL, erradicación de secretos y compliance estricto WordPress/WooCommerce. |
|
|
88
|
+
| **Horizonte de Eventos** | **`G9`**, **`G17`**, **`G20`** | Permisos POSIX restrictivos, consistencia de licencias y aislamiento de entornos (cero localhost en producción). |
|
|
89
|
+
| **Gravedad Cero y Estructura** | **`G1`**, **`G11`**, **`G18`** | Desacoplamiento de hilos UI, cero robo de foco (`CREATE_NO_WINDOW`) y coexistencia limpia de motores CSS. |
|
|
90
|
+
| **Malla Cósmica y Rutas** | **`G12`**, **`G13`**, **`G14`** | Cero enlaces 404, erradicación de botones zombies y validación de contratos API cliente/servidor. |
|
|
91
|
+
| **Radiación de Fondo** | **`G7`**, **`G10`**, **`G15`**, **`G16`** | Registro ADR en `BITACORA.md`, purga de cachés corruptas, pruebas E2E y Core Web Vitals. |
|
|
91
92
|
|
|
92
93
|
---
|
|
93
94
|
|
|
94
|
-
##
|
|
95
|
-
|
|
96
|
-
Para que un proyecto sea considerado formalmente AUM-IC, debe cumplir con los 4 pilares de supervivencia cósmica. Estos garantizan que la plataforma cumpla de forma automatizada y nativa con los estándares más estrictos del mundo corporativo (**ISO 25010, ISO 27001, ISO 27701, ISO 40500, ISO 29119 y SOC 2**).
|
|
97
|
-
|
|
98
|
-
### 🛡️ 1. Horizonte de Sucesos, Firmas Espectrales y Campos Magnéticos (Seguridad Total)
|
|
99
|
-
* **Las Normas:** ISO/IEC 27001 (Seguridad) e ISO/IEC 27701 (Privacidad de la Información).
|
|
100
|
-
* **El Horizonte y La Singularidad:** Las contraseñas y secretos viven en el Backend (Horizonte). La "Privacy by Design" comprime y cifra identidades para que nadie pueda ver datos en claro (Singularidad).
|
|
101
|
-
* **Firmas Espectrales (Auth y JWT):** Cada petición debe portar una "Firma Espectral" validada criptográficamente (JWT, Sesiones con Cookies `HttpOnly`). Si un viajero presenta una firma alterada, el Middleware rechaza la conexión instantáneamente.
|
|
102
|
-
* **Campos Magnéticos (ORMs y Sanitización):** Así como el campo magnético de la Tierra desvía la radiación solar mortal, el uso estricto de **ORMs (Object-Relational Mapping)** y validadores (ej. Zod) actúa como un escudo magnético. Atrapa, filtra y desvía caracteres maliciosos e Inyecciones SQL o XSS antes de que toquen el núcleo de la base de datos. Está estrictamente prohibido apagar el campo magnético ejecutando "Raw SQL" con inputs de usuario.
|
|
103
|
-
|
|
104
|
-
### 💥 2. El Colisionador de Hadrones (Testing y Calidad)
|
|
105
|
-
* **La Norma:** ISO/IEC/IEEE 29119 (Pruebas de Software).
|
|
106
|
-
* **Uso Práctico:** Todo Átomo y Organismo debe sobrevivir a colisiones a alta velocidad en ambientes controlados (Unit Testing, E2E, TDD). Si el código se rompe bajo estrés simulado en el pipeline automatizado (CI/CD), el Universo rechaza el despliegue. El caos no entra a Producción.
|
|
107
|
-
|
|
108
|
-
### 📡 3. Radiación de Fondo Cósmica (Observabilidad y Auditoría)
|
|
109
|
-
* **La Norma:** SOC 2 Tipo II (Integridad de Procesamiento y Disponibilidad).
|
|
110
|
-
* **Uso Práctico:** El Big Bang dejó un rastro que nos cuenta la historia del universo. Del mismo modo, todo error, acción del usuario o caída del servidor deja un **Rastro Radiactivo inmutable** (Telemetría, Sentry, Datadog, Audit Logs). Es imposible silenciar fallos; todo debe ser rastreable forensemente. Esto incluye la observabilidad del cliente (**RUM - Real User Monitoring**), capturando globalmente excepciones del navegador, recursos rotos (404) y *Dead Clicks* (botones inactivos) enviando el rastro instantáneamente al centro de mando.
|
|
111
|
-
|
|
112
|
-
### 🌍 4. La Biósfera y el Espectro Invisible (Accesibilidad y SEO)
|
|
113
|
-
* **La Norma:** ISO/IEC 40500 (Pautas de Accesibilidad WCAG) y Directrices de Motores de Búsqueda (SEO).
|
|
114
|
-
* **Uso Práctico:** La **Biósfera** exige que el ecosistema visual soporte toda forma de vida humana (validación matemática de contraste de colores, navegación por teclado). Sin embargo, el **Espectro Invisible** (Infrarrojo/Ultravioleta) es como las máquinas ven tu aplicación. Motores de búsqueda (Googlebots) y Tecnologías de Asistencia (Screen Readers) consumen tu código a través de etiquetas Semánticas, *ARIA-labels* y metadatos. Si tu planeta no emite en el espectro invisible, no existe en la web.
|
|
115
|
-
|
|
116
|
-
## PARTE V: EL MOTOR DE EJECUCIÓN (Protocolo de Creación y Telemetría)
|
|
117
|
-
|
|
118
|
-
Para garantizar que el universo no colapse al expandirse (desarrollo de nuevas *features*) o mutar (refactorización), todo arquitecto AUM-IC debe regirse por el siguiente flujo de operaciones inquebrantable.
|
|
95
|
+
## GLOSARIO TÁCTICO: EL PORQUÉ DE LAS REGLAS
|
|
119
96
|
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
### Fase 2: Observabilidad y Respuesta Inmediata (Telemetría de Supernova)
|
|
128
|
-
6. **Caja Negra de Logs Atómicos:** Se debe programar un sistema interno de trazabilidad. Toda interacción crítica, desde un fallo silencioso en un Átomo hasta un *Fatal Error* en una Galaxia, genera un Log estructurado. Se establecen *breakpoints* y *checkpoints* internos en la ejecución para permitir análisis forense forense y gestión de fallos.
|
|
129
|
-
7. **Alarma de Supernova (Intercepción y Alerta en Tiempo Real):** El sistema de logs no es pasivo; es proactivo. Al interceptar un fallo (Warn, Error, Fatal), el paradigma exige emitir un pulso a la Velocidad de la Luz al Centro de Mando de Desarrollo. A través de NTFY, Webhooks (Discord/Telegram), SMS o bots de WhatsApp, el equipo de ingeniería es notificado en el milisegundo exacto del fallo, garantizando soporte técnico preventivo antes de que el usuario final lo reporte.
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
## PARTE VI: LA LEY DE CORRESPONDENCIA (Escalabilidad y Plataformas Agnósticas)
|
|
134
|
-
|
|
135
|
-
El argumento de *"Este paradigma es demasiada sobreingeniería"* nace de la incomprensión de las leyes del universo. **Como es arriba, es abajo.** El estándar AUM-IC 7 obedece a la **Ley de Correspondencia del Kybalión**: un asteroide obedece la misma física que una galaxia, y una App Móvil obedece la misma arquitectura que un ERP de escritorio o una web en la nube. Las fuerzas solo se encienden en proporción a su Masa Crítica.
|
|
136
|
-
|
|
137
|
-
Para mantener la velocidad de desarrollo sin sacrificar las certificaciones ISO, el arquitecto debe clasificar su proyecto:
|
|
138
|
-
|
|
139
|
-
### 🪨 Nivel 1: El Asteroide (Sistemas de Propósito Único)
|
|
140
|
-
* **Ejemplos:** Landing Pages, Scripts CLI, Apps Móviles unidireccionales (Calculadora, Lector QR), Utilidades Desktop pequeñas.
|
|
141
|
-
* **Materia Observable:** Solo carpetas `1-atoms` a `4-organisms`.
|
|
142
|
-
* **Materia Oscura (Estado Global):** **APAGADA.** No necesitas Redux, Vuex ni Singletons pesados. El estado vive localmente (Energía Cinética).
|
|
143
|
-
* **Campo Magnético Perimetral:** **ENCENDIDO.** Todo input externo es un rayo cósmico mortal. En Web, usas filtros de desafío invisible anti-bots. En Móvil/Desktop, usas validadores biométricos (FaceID) o sanitización estricta (Zod/Regex) para evitar *Buffer Overflows* o ejecución de macros maliciosos.
|
|
144
|
-
* **La Biósfera (Accesibilidad):** **MÁXIMA.** En web es SEO semántico. En Móvil/Desktop, obligas el uso de APIs nativas (*VoiceOver, TalkBack*) para que la tecnología de asistencia pueda "leer" tu interfaz.
|
|
145
|
-
|
|
146
|
-
### 🌍 Nivel 2: El Planeta (Sistemas Transaccionales y Puntos de Venta)
|
|
147
|
-
* **Ejemplos:** E-Commerce, Puntos de Venta locales (Sistemas de Punto de Venta (POS) locales), Apps Móviles transaccionales.
|
|
148
|
-
* **Agujeros de Gusano (Caché y Offline-First):** **ENCENDIDO.** En la nube usas Redis. En POS Desktop o Móvil, enciendes bases de datos locales incrustadas (SQLite, Realm, CoreData). Si el internet se cae, el planeta sigue girando y facturando gracias al Agujero de Gusano.
|
|
149
|
-
* **Firmas Espectrales (Seguridad de Sesión):** **ENCENDIDO.** Implementas JWT para web, o el **Keychain / Windows Credential Manager** para proteger contraseñas localmente en Desktop/Móvil. Jamás se guarda texto plano en disco.
|
|
150
|
-
|
|
151
|
-
### 🌌 Nivel 3: La Galaxia (Ecosistemas Masivos y Distribuidos)
|
|
152
|
-
* **Ejemplos:** Sistemas ERP distribuidos en la nube, Core Bancario, Suites de Escritorio pesadas (Suites de escritorio de alto rendimiento).
|
|
153
|
-
* **Malla Cósmica (Microservicios / IPC):** **ENCENDIDA.** En la nube, las galaxias se comunican por APIs REST/gRPC. En Desktop, se comunican mediante hilos aislados (IPC - Inter-Process Communication). Si un hilo colapsa, el programa no se cierra. La arquitectura implementa **Circuit Breakers (Disyuntores)** para cortar comunicación con APIs externas caídas y **Bucles de Auto-Sanación (Exponential Reconnects)** para revivir conexiones a bases de datos sin intervención humana.
|
|
154
|
-
* **Materia Oscura y Telemetría:** **MÁXIMA POTENCIA.** El estado global dicta todo. El sistema de Logs (Radiación de Fondo) reporta cada *Fatal Error* de inmediato vía Sentry, Datadog o Webhooks (NTFY/Discord) al centro de mando.
|
|
97
|
+
* **¿Por qué prohibir las consultas Raw SQL sin parametrizar?**
|
|
98
|
+
Escribir consultas concatenando texto del usuario es apagar el Campo Magnético. Permite que cualquier inyección SQL altere la estructura de la base de datos, destruyendo la integridad relacional de la información.
|
|
99
|
+
* **¿Por qué capturar Checkpoints inmutables con SHA-256 (G3)?**
|
|
100
|
+
Toda modificación de código sin respaldo verificado introduce riesgo de entropía irreversible. Un checkpoint criptográfico asegura que cualquier intento fallido de reparación pueda colapsarse y revertirse al estado exacto previo al fallo.
|
|
101
|
+
* **¿Por qué destruir listeners y desacoplar temporizadores (G1 y G11)?**
|
|
102
|
+
Un proceso en segundo plano, worker o websocket que no se destruye explícitamente se convierte en un objeto errante que consume memoria RAM de forma indefinida (Memory Leak), provocando bloqueos en el sistema operativo y degradando la ergonomía del usuario.
|
|
155
103
|
|
|
156
104
|
---
|
|
157
105
|
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
Para que AUM-IC 7 no sea visto como un capricho estético, todo arquitecto debe saber defender la física de sus decisiones en *cualquier* lenguaje (C#, Python, JS, Swift):
|
|
161
|
-
|
|
162
|
-
* **¿Por qué y cuándo encender el Campo Magnético (ORMs o Query Builders)?**
|
|
163
|
-
* *Cuándo:* Siempre que el software (Web, POS o App) interactúe con una base de datos o sistema de archivos.
|
|
164
|
-
* *Por qué:* Escribir consultas "Raw SQL" (SQL crudo) combinadas con variables del usuario es apagar el campo magnético de tu planeta. Los rayos cósmicos (Inyecciones SQL) freirán tu núcleo, ya sea en un clúster en la nube o en la base local de SQLite de la caja registradora. El ORM actúa como una magnetósfera que purifica los comandos maliciosos antes de que toquen el disco. Además, la materia nunca se destruye: se exige el **Borrado Lógico (Soft Deletes)** y el control estricto de esquemas mediante Archivos de Migración.
|
|
165
|
-
|
|
166
|
-
* **¿Por qué y cuándo hacer un Commit (Punto de Control en el Multiverso)?**
|
|
167
|
-
* *Cuándo:* Jamás al final del día por costumbre. Se hace **cada vez que un átomo o ruta alcanza la estabilidad matemática (Test en verde)**.
|
|
168
|
-
* *Por qué:* El desarrollo es una lucha contra la entropía (el caos). Si en la siguiente hora tu código colapsa, el *commit* te permite colapsar esa línea temporal fallida y regresar instantáneamente al último punto donde el universo era estable.
|
|
169
|
-
|
|
170
|
-
* **¿Por qué destruir los Listeners (Órbitas Cerradas)?**
|
|
171
|
-
* *Cuándo:* Cuando una ventana modal, un componente o una sub-rutina se cierra o destruye.
|
|
172
|
-
* *Por qué:* Un Webhook, un proceso *Background Worker* en C#, o un WebSocket que no se destruye explícitamente se convierte en un "Planeta Errante". Seguirá orbitando invisible en la memoria RAM (Memory Leak) hasta destruir la capacidad del dispositivo, forzando al usuario a reiniciar su computadora o teléfono.
|
|
106
|
+
> 🏛️ Propiedad Intelectual de **Ingeniería Creativa (IngCrea)**. Estándar libre publicado bajo licenciamiento dual CC BY-SA 4.0 / MIT.
|
package/MANIFEST.md
CHANGED
|
@@ -1,64 +1,106 @@
|
|
|
1
|
-
|
|
2
|
-
# 🌌 AUM-IC 7 Standard (2026 Edition)
|
|
3
|
-
**Multidimensional Universe Architecture - Engineering Standard**
|
|
1
|
+
# 📜 ARCHITECTURAL MANIFESTO: AUM-IC 7 STANDARD (2026 EDITION)
|
|
4
2
|
|
|
5
3
|
<p align="center">
|
|
6
4
|
<img src="https://img.shields.io/badge/version-7.0.0-crimson?style=flat-square" alt="Version 7.0.0">
|
|
7
|
-
<img src="https://img.shields.io/badge/nature-
|
|
5
|
+
<img src="https://img.shields.io/badge/nature-Pure%20Engineering%20Standard-38bdf8?style=flat-square" alt="Nature">
|
|
6
|
+
<img src="https://img.shields.io/badge/suite-PUF--23%20Assurance-gold?style=flat-square" alt="PUF-23">
|
|
8
7
|
</p>
|
|
9
8
|
|
|
10
9
|
> 🌐 **Navigation:** 🇺🇸 [Read in English](./MANIFEST.md) | 🇲🇽 [Leer en Español](./MANIFEST.es.md) | 📖 [README (EN)](./README.md) | 📖 [README (ES)](./README.es.md) | 🌌 [AUM-IC 7 Standard](https://github.com/ingcrea/aum-ic)
|
|
11
10
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
11
|
+
This document governs the **Multidimensional Universe Architecture Paradigm (AUM-IC 7 Standard)** and its operational correspondence with the 23-gate matrix of the **Universal Failure Prevention Protocol (PUF-23)**.
|
|
12
|
+
|
|
13
|
+
It is neither an arbitrary folder recommendation nor a cosmetic convention: it is a deterministic framework of architecture, fractal symmetry, and software physics engineered to inherently satisfy international product quality (**ISO/IEC 25010**), information security (**ISO 27001**), testability (**ISO 29119**), and web accessibility standards (**ISO 40500 / WCAG 2.2**).
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 🌌 The Fundamental Philosophy: Entropy vs. Mathematical Precision
|
|
18
|
+
|
|
19
|
+
**Human software development without discipline is uncontrolled entropy.** It degrades into chaotic sprawl: circular imports, shallow monkey-patches, toxic coupling, memory leaks, and services collapsing under unanticipated concurrency spikes.
|
|
20
|
+
|
|
21
|
+
The physical universe, while seemingly chaotic, operates under immutable mathematical laws. From elementary quantum interactions to massive planetary mechanics, nothing is left to chance.
|
|
22
|
+
|
|
23
|
+
**The AUM-IC Paradigm binds software to these same universal laws.** It serves as an absolute mental model, **100% language-agnostic** (Rust, TypeScript, Python, Astro, PHP, Java, C#, Swift, Shell), categorizing systems into **Observable Matter** (fractal codebase structure), **Invisible Forces** (data flow and SRE resilience), and **Laws of Correspondence** (critical mass scalability).
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## PART I: OBSERVABLE MATTER (Fractal Code Structure)
|
|
28
|
+
|
|
29
|
+
The Hermetic Principle of Correspondence dictates: *"As above, so below"*. Software components are arranged in strict fractal symmetry across the UI, API Controllers, and Persistence layers:
|
|
30
|
+
|
|
31
|
+
```text
|
|
32
|
+
src/
|
|
33
|
+
├── 1-atoms/ # Irreducible elements (Buttons, pure math helpers, primitives)
|
|
34
|
+
├── 2-molecules/ # Simple composite groups (Form fields with label/error, middlewares)
|
|
35
|
+
├── 3-cells/ # Functional interactive containers (Cards, ORM entities, unitary services)
|
|
36
|
+
├── 4-organisms/ # Autonomous business modules (Checkout flows, domain use-cases, orchestrators)
|
|
37
|
+
├── 5-planets/ # Full application views or API controllers (Dashboard screens, REST/gRPC handlers)
|
|
38
|
+
└── 6-layouts/ # Structural gravitational grid (Master templates, server bootstrap modules)
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
* **Zero-Gravity Rule:** Atoms (`1-atoms/`) must remain entirely stateless and cannot import higher-level modules, state managers, or database connections. Gravitational mass and logic density are reserved strictly for organisms and planets.
|
|
34
42
|
|
|
35
43
|
---
|
|
36
44
|
|
|
37
|
-
## PART
|
|
38
|
-
|
|
45
|
+
## PART II: THE 7 COSMIC FORCES (SRE & Security Core)
|
|
46
|
+
|
|
47
|
+
Every production system must enforce 7 dynamic laws governing data flow and runtime resilience:
|
|
48
|
+
|
|
49
|
+
1. **Dark Matter (Global State):** The invisible gravitational bond. Global application state (Zustand, Redux, background memory daemons) connects organisms without toxic coupling (*Prop Drilling is strictly forbidden*).
|
|
50
|
+
2. **Event Horizon (Perimeter Security):** The impenetrable boundary. Enforces strict Content Security Policy (CSP), rate limiting, bot challenges, and cryptographic JWT verification. Any payload lacking a valid spectral signature is rejected at the middleware gateway.
|
|
51
|
+
3. **Magnetic Field (ORM & Sanitization):** Shields the system core against cosmic radiation (SQL Injections and XSS attacks). Raw unparameterized SQL strings are banned. Matter cannot be arbitrarily destroyed: **Soft Deletes** and declarative schema migrations are mandatory.
|
|
52
|
+
4. **The Hadron Collider (PUF-23 Closed-Loop Assurance):** Chaos does not enter production. Prior to any release, code must clear the 23-gate matrix (**G0 to G22**), auditing everything from raw byte hygiene to API contracts and licensing compliance.
|
|
53
|
+
5. **Wormholes (Cache & Offline-First Architecture):** Defeats network latency. Employs embedded local databases (SQLite, Realm) in desktop/mobile apps or distributed Redis clusters in cloud backends, guaranteeing uninterrupted operation and transactional capability during network dropouts.
|
|
54
|
+
6. **The Cosmic Web (Distributed Resilience):** Implements **Circuit Breakers** to isolate failing upstream dependencies and **Exponential Backoff Reconnect Loops** to revive degraded database connections autonomously.
|
|
55
|
+
7. **Cosmic Microwave Background (Forensic Observability & RUM):** Every user action leaves a forensic signature. Real User Monitoring (RUM), global runtime exception traps, 404 tracking, and immediate alerting dispatch to the incident response center.
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## PART III: LAW OF CORRESPONDENCE (Critical Mass Scalability)
|
|
60
|
+
|
|
61
|
+
An asteroid obeys the exact same gravitational laws as a galaxy; however, architectural forces ignite proportionally to the system's **Critical Mass**:
|
|
39
62
|
|
|
40
63
|
### 🪨 Level 1: The Asteroid (Single-Purpose Systems)
|
|
41
|
-
* **Examples:** Landing
|
|
42
|
-
* **Dark Matter (State):** **OFF.**
|
|
43
|
-
* **Perimeter Magnetic Field:** **MAXIMUM.**
|
|
44
|
-
* **The Biosphere (Accessibility
|
|
64
|
+
* **Examples:** Landing pages, CLI utilities, single-screen mobile apps.
|
|
65
|
+
* **Dark Matter (Global State):** **OFF.** No heavy stores needed; state lives locally.
|
|
66
|
+
* **Perimeter Magnetic Field:** **MAXIMUM.** External input is lethal. Applies strict schema validation (Zod, TypeBox, serde) and bot challenges.
|
|
67
|
+
* **The Biosphere (Accessibility & SEO):** **MAXIMUM.** Semantic HTML structure and native OS accessibility APIs (VoiceOver/TalkBack).
|
|
45
68
|
|
|
46
69
|
### 🌍 Level 2: The Planet (Transactional Systems)
|
|
47
|
-
* **Examples:** E-Commerce,
|
|
48
|
-
* **Wormholes (
|
|
49
|
-
* **Spectral Signatures (Auth):** **ON.** Secrets saved in OS Keychains or secure HttpOnly cookies.
|
|
70
|
+
* **Examples:** E-Commerce platforms, Point of Sale (POS) applications, transactional mobile apps.
|
|
71
|
+
* **Wormholes (Offline-First):** **ON.** Local SQLite databases keep the business running during internet outages.
|
|
72
|
+
* **Spectral Signatures (Auth):** **ON.** Secrets saved in OS Keychains, Windows Credential Manager, or secure HttpOnly cookies. Plaintext credential storage is banned.
|
|
50
73
|
|
|
51
74
|
### 🌌 Level 3: The Galaxy (Massive Ecosystems)
|
|
52
|
-
* **Examples:** Cloud
|
|
53
|
-
* **The Cosmic Web (Microservices
|
|
54
|
-
* **Telemetry &
|
|
75
|
+
* **Examples:** Cloud ERP systems, Core Banking, high-performance desktop suites.
|
|
76
|
+
* **The Cosmic Web (IPC & Microservices):** **MAXIMUM POWER.** Typed asynchronous messaging and decoupled execution threads.
|
|
77
|
+
* **Forensic Telemetry & Observability:** **MAXIMUM POWER.** Real-time log aggregation, distributed tracing, and automated failure isolation.
|
|
55
78
|
|
|
56
79
|
---
|
|
57
80
|
|
|
58
|
-
##
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
81
|
+
## MAPPING MATRIX: AUM-IC 7 vs. PUF-23
|
|
82
|
+
|
|
83
|
+
| Cosmic Force (AUM-IC) | Certifying PUF-23 Gates | Operational Objective |
|
|
84
|
+
| :--- | :--- | :--- |
|
|
85
|
+
| **Fundamental Hygiene** | **`G0`**, **`G8`**, **`G22`** | Pure UTF-8 encoding, LF line endings, mojibake eradication, and universal delimiter balance. |
|
|
86
|
+
| **Hadron Collider** | **`G2`**, **`G3`**, **`G5`**, **`G6`** | Red/Green test cycle, SHA-256 rollback snapshots, and strict multi-language static analysis. |
|
|
87
|
+
| **Magnetic Field** | **`G4`**, **`G19`**, **`G21`** | Pure logic refactor, zero SQL injection, secret purge, and WordPress/WooCommerce compliance. |
|
|
88
|
+
| **Event Horizon** | **`G9`**, **`G17`**, **`G20`** | POSIX permissions, license integrity, and environment isolation (zero localhost in production). |
|
|
89
|
+
| **Zero Gravity & Layout** | **`G1`**, **`G11`**, **`G18`** | UI thread decoupling, zero-focus stealing (`CREATE_NO_WINDOW`), and clean styling engine consistency. |
|
|
90
|
+
| **Cosmic Web & Routing** | **`G12`**, **`G13`**, **`G14`** | Dead link eradication (no 404s), zombie UI action removal, and HTTP client/server contract checks. |
|
|
91
|
+
| **Background Radiation** | **`G7`**, **`G10`**, **`G15`**, **`G16`** | ADR logging in `BITACORA.md`, stale cache flushes, E2E validation, and Core Web Vitals audit. |
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## TACTICAL GLOSSARY: THE "WHY" BEHIND THE RULES
|
|
96
|
+
|
|
97
|
+
* **Why ban raw string-concatenated SQL queries?**
|
|
98
|
+
Concatenating unchecked input into SQL statements disables your Magnetic Field, allowing trivial SQL injections to alter and compromise the integrity of relational data.
|
|
99
|
+
* **Why capture immutable SHA-256 checkpoints (G3)?**
|
|
100
|
+
Modifying code without verified checkpoints introduces irreversible entropy. An atomic cryptographic snapshot guarantees that any failed remediation step can be immediately collapsed and restored.
|
|
101
|
+
* **Why terminate listeners and decouple UI timers (G1 and G11)?**
|
|
102
|
+
Background daemons or WebSockets left running without lifecycle bounds become rogue objects leaking memory RAM indefinitely, causing system freezing and ruining desktop ergonomics.
|
|
62
103
|
|
|
63
104
|
---
|
|
64
|
-
|
|
105
|
+
|
|
106
|
+
> 🏛️ Intellectual Property of **Ingeniería Creativa (IngCrea)**. Standard released under dual CC BY-SA 4.0 / MIT licensing.
|