EIOS · Richard Pineda
← Back to home
rpineda1712@gmail.comLive EIOS
Built by AI Solutions Architect Claude Code Python FastAPI PostgreSQL React
The architecture map

EIOS · Conversational BI

EIOS: ask your business data in plain words and get numbers that were calculated, not guessed.

A language model invents numbers with total confidence. EIOS won't let it.

Conversational BI on SAP Business One · built with EDK, deployed to AWS under ACE · every piece below is a real component · click any piece for the details

Click or tap any piece to see what it does, in plain words. The pulses show how the work moves.

WHAT HAPPENS TO A QUESTION · STEPS 4 AND 5 CALCULATE, STEP 6 ONLY NARRATES The question step 1
Anyone in the company asks, in Spanish or English.
 PLAIN WORDS Permission step 2
License, role and company policy are checked. Any doubt means no, and it is logged.
 FAIL-CLOSED Understand step 3
One AI call sorts the topic against a catalog. If it fails, it falls back to general Q&A.
 ONE AI CALL Calculate step 4
The numbers are computed with SQL on the data warehouse. No AI involved.
 SQL ON THE DW Compose step 5
Cards, charts and tables are built by fixed rules from the computed data.
 DETERMINISTIC Narrate step 6
The AI only writes the explanation, from numbers already computed.
 AI NARRATES Verify step 7
Each figure in a recommendation must exist in the computed set, or it is rejected.
 FIGURE CHECK HOW IT IS BUILT The core never depends on the outside api
HTTP edge and live streaming
 core
domain rules and ports
 extensions
SAP B1, SAP HANA, CSV, 2 AI providers, 9 capability packs
 8 IMPORT CONTRACTS, CHECKED BY TESTS
Second-provider test: two analytics connectors and two AI providers swap with no change to the core.
 From SAP to the answer SAP Business One Service Layer or HANA ETL jobs batch loads PostgreSQL DW fact tables, per-tenant security
All data in this repo is synthetic.
 Intelligence ladder Descriptive what happened Diagnostic why it happened Predictive what comes next Prescriptive what to do about it
24 capabilities: 23 built, 1 designed.
 WHO MAY ASK, AND WHAT IS KEPT License by capability
Each capability must be licensed. The first no cuts the chain, and an error counts as no.
 Access and isolation
Two-step login, opaque session cookie, and row-level security per tenant. Secrets never enter the image.
 Audit trail
Append-only log of 14 fields, with before and after values redacted.
 Spanish and English
Keys are canonical and the texts are localized, so adding a language does not touch the logic.
 HOW IT SHIPS Push to main
triggers the pipeline
 CI
tests, image build, smoke test
 Image to ECR
tagged with the commit, no stored keys
 Runs on AWS
infrastructure comes from AWS-EIOS
 Frontend
to S3 and CloudFront
 Tests 4,713
backend test functions in 656 files
 1,143
frontend tests in 206 files
 computed rejected limit component
QUÉ PASA CON UNA PREGUNTA · LOS PASOS 4 Y 5 CALCULAN, EL PASO 6 SOLO NARRA La pregunta paso 1
Cualquiera en la empresa pregunta, en español o en inglés.
 PALABRAS SENCILLAS Permiso paso 2
Se revisan licencia, rol y política de la empresa. Ante la duda, no, y queda registrado.
 CIERRA ANTE LA DUDA Entender paso 3
Una llamada a la IA clasifica el tema contra un catálogo. Si falla, pasa a preguntas generales.
 UNA LLAMADA A LA IA Calcular paso 4
Las cifras se calculan con SQL sobre el almacén de datos. Sin IA.
 SQL SOBRE EL ALMACÉN Componer paso 5
Tarjetas, gráficos y tablas se arman con reglas fijas a partir de los datos calculados.
 DETERMINISTA Narrar paso 6
La IA solo escribe la explicación, a partir de cifras ya calculadas.
 LA IA NARRA Verificar paso 7
Cada cifra de una recomendación debe existir en lo calculado, o se rechaza.
 CONTROL DE CIFRAS CÓMO ESTÁ CONSTRUIDO El núcleo nunca depende de lo de afuera api
borde HTTP y envío en vivo
 core
reglas del dominio y puertos
 extensions
SAP B1, SAP HANA, CSV, 2 proveedores de IA, 9 paquetes
 8 CONTRATOS DE IMPORTACIÓN, VERIFICADOS POR PRUEBAS
Prueba del segundo proveedor: dos conectores de analítica y dos proveedores de IA se cambian sin tocar el núcleo.
 De SAP a la respuesta SAP Business One Service Layer o HANA Trabajos ETL cargas por lotes Almacén PostgreSQL tablas de hechos, seguridad por cliente
Todos los datos de este repo son sintéticos.
 Escalera de inteligencia Descriptiva qué pasó Diagnóstica por qué pasó Predictiva qué viene Prescriptiva qué hacer al respecto
24 capacidades: 23 construidas, 1 diseñada.
 QUIÉN PUEDE PREGUNTAR Y QUÉ SE GUARDA Licencia por capacidad
Cada capacidad debe tener licencia. El primer no corta la cadena, y un error cuenta como no.
 Acceso y aislamiento
Ingreso en dos pasos, cookie de sesión opaca y seguridad por fila para cada cliente. Los secretos nunca entran en la imagen.
 Bitácora de auditoría
Registro de solo agregar, de 14 campos, con valores antes y después ocultados.
 Español e inglés
Las claves son canónicas y los textos están localizados, así que agregar un idioma no toca la lógica.
 CÓMO LLEGA A PRODUCCIÓN Subida a main
dispara el pipeline
 CI
pruebas, imagen y prueba de humo
 Imagen a ECR
etiquetada con el commit, sin llaves guardadas
 Corre en AWS
la infraestructura viene de AWS-EIOS
 Frontend
a S3 y CloudFront
 Pruebas 4.713
funciones de prueba del backend en 656 archivos
 1.143
pruebas del frontend en 206 archivos
 calculado rechazado límite componente
Live demo

Try EIOS live

The live environment runs on AWS and is switched on only for demos and interviews. Outside those windows the screen may load but not answer. If it does not respond, write to me and I will start it. Seeded demo data only.

Open EIOS live