---

El problema que nadie ha resuelto (hasta ahora)

Las organizaciones empresariales viven atrapadas en una paradoja tecnologica:

• Tienen sistemas SOAP/XML de los 90s que no pueden apagar porque procesan millones de transacciones al dia.
• Necesitan aplicaciones moviles y web modernas que esperan APIs rapidas, ligeras y seguras.
• Cada protocolo existente (REST, GraphQL, gRPC) resuelve una parte del problema, pero ninguno habla con el pasado Y el futuro al mismo tiempo.

NexaQL resuelve esto de raiz. Es el primer protocolo binario disenado para ser simultaneamente:

Compatible con el Pasado (traduce a SOAP/XML nativo) +
Optimo en el Presente (binario, comprimido, cifrado) +
Listo para el Futuro (Edge Computing, V8 Isolates, Serverless)

---

Benchmark en Vivo (100,000 registros reales)

NexaQL transporta los mismos datos en menos de 1 MB lo que XML/REST envian en mas de 10 MB. Es 10x mas compacto y 5x mas rapido. Medido en vivo, no en teoria.

---

Capacidades

NexaQL es el UNICO protocolo que cumple con todos los requisitos modernos.

---

Arquitectura

[Browser / Mobile Client]
        |
        | WebSocket Binary Frames / HTTP POST (octet-stream)
        |
  [NexaQL Gateway (Python FastAPI)]    [Edge Worker (Node.js V8 / Cloudflare)]
   Schema Registry                      Simulador V8 Isolate
        |                                        |
        +------------ Traduce NexaQL -> SOAP/XML ---------> [Legacy Database]

Estructura del Frame Binario

Offset  Longitud  Campo
0       2 bytes   Magic Bytes "NX" (0x4E 0x58)
2       2 bytes   Version (uint16 BE)
4       1 byte    Schema ID (multiplexing)
5       1 byte    Flags: 0x01=Zlib | 0x02=AES-GCM | 0x04=Error
6       4 bytes   Payload Length (uint32 BE)
10      4 bytes   CRC32 Checksum
14      N bytes   Payload (MsgPack + Zlib + AES-GCM)

---

Las 11 Fases del Protocolo

---

Estructura del Repositorio

nexaql/
 |-- nexaql/                  # Gateway (Python / FastAPI)
 |   |-- server/
 |   |   |-- main.py          # Endpoints HTTP + WebSocket
 |   |   |-- registry.py      # Schema Registry
 |   |-- protocol/
 |   |   |-- encoder.py       # MsgPack + Zlib + AES-GCM
 |   |   |-- decoder.py       # Deserializacion + hidratacion
 |   |   |-- frame.py         # Frame binario con CRC32
 |   |   |-- security.py      # AES-256-GCM
 |   |-- legacy/
 |       |-- xml_adapter.py   # Adaptador bidireccional SOAP/XML
 |
 |-- frontend/                # SDK + UI (TypeScript / React)
 |   |-- src/
 |       |-- nexaql-client/
 |       |   |-- client.ts    # Cliente principal
 |       |   |-- encoder.ts   # Encoder isomorfico
 |       |   |-- decoder.ts   # Decoder isomorfico
 |       |   |-- frame.ts     # Frame encoder/decoder + CRC32
 |       |-- App.tsx          # Dashboard de demostracion
 |
 |-- edge/                    # Edge Worker (Node.js V8)
 |   |-- worker.ts            # Simulador Cloudflare Worker
 |
 |-- NEXAQL_PROTOCOL_SPEC.md  # Especificacion formal (estilo RFC)
 |-- README.md

---

Como ejecutarlo localmente

Requisitos

• Python 3.11+
• Node.js v22+

1. Backend Gateway

# Crear entorno virtual
python -m venv venv
.\venv\Scripts\activate  # Windows
source venv/bin/activate  # Linux/Mac

# Instalar dependencias
pip install fastapi uvicorn msgpack cryptography pydantic

# Iniciar el Gateway
uvicorn nexaql.server.main:app --reload
# -> http://localhost:8000

2. Edge Worker (nueva terminal)

node --experimental-strip-types edge/worker.ts
# -> http://localhost:8001

3. Frontend React (nueva terminal)

cd frontend
npm install
npm run dev
# -> http://localhost:5173

4. Probar el protocolo

Abre http://localhost:5173 y ejecuta en orden:

1. Fetch NexaQL (Native) - Compara velocidad vs XML/JSON
2. Stream NexaQL (Batch) - Streaming de 100k registros en chunks
3. Filtro Binario - Activa el checkbox y mira como el servidor filtra en el backend
4. Crash BD - Simula un colapso y observa el Error Frame elegante
5. Emitir Transaccion - Escribe en NexaQL, el Edge lo traduce a SOAP/XML
6. Benchmark Oficial - Mide los numeros reales en tu maquina

---

Documentacion

• NEXAQL_PROTOCOL_SPEC.md - Especificacion formal completa (estilo RFC IETF)

---

Roadmap

• SDK de TypeScript publicado en npm (nexaql-client)
• Gateway en Docker (imagen oficial)
• Soporte de TLS nativo en el Gateway
• Wasm binary target para browsers antiguos
• CLI: nexaql generate-schema desde JSON/Protobuf
• Integracion con Cloudflare Workers real

---

Filosofia

"El pasado no es un problema a eliminar. Es la base sobre la cual el futuro se construye.
NexaQL no reemplaza lo que funciona. Lo conecta con lo que viene."

Este protocolo nacio de una conviccion simple: la brecha entre sistemas Legacy y arquitecturas modernas no se cierra con migraciones costosas, sino con un lenguaje comun que todos puedan hablar. NexaQL es ese lenguaje.

---

Licencia

MIT License - Ver LICENSE

---