Amán Rules Engine

Plataforma full-stack para autoría y evaluación de reglas: UI React + Next.js con conversiones de lenguaje natural a AST usando IA, y evaluador de alto rendimiento en Go.

Next.js React TypeScript Go PostgreSQL pgx chi sqlc Gemini (LLM)

Resumen

Engine de reglas texto-a-AST donde el usuario escribe intención, pulsa Generar, un LLM externo (Gemini) devuelve AST, la UI renderiza JSON + editor interactivo y el motor evalúa con salida de trazas.

Arquitectura

UI Next.js / React -> API de LLM (Gemini) para NL-to-AST -> render AST + datos de prueba en UI -> evaluador de reglas en Go (+ trazas) -> salida de resultados. Persistencia en Postgres JSONB y evaluación en memoria por request.

Next.js UI Gemini LLM API AST Generator Go Evaluator PostgreSQL JSONB

Decisiones técnicas clave

Go por rendimiento y tipado fuerte

PostgreSQL JSONB para modelos de reglas flexibles

chi para routing mínimo y middleware extensible

Gemini para evitar alojar un modelo propio y aprovechar capacidades modernas

Desafíos

Serialización JSON de pgx JSONB []byte en respuestas

Seguridad de tipos con payloads de reglas dinámicas

Flexibilidad de operadores para eq/gte/string/colecciones

Resolución de campos anidados con parser de notación por puntos

Compromisos

El parser se crea por request (costo de asignación en MVP)

Regex compiladas en cada evaluación en lugar de caché

Sin caché de reglas a nivel DB todavía (posible Redis después)

Evaluador en un solo nodo vs distribución (elegido para versión inicial)

Sin auth en API de reglas aún; primero MVP, JWT después

Recursos

Repositorio en GitHub → Demo en vivo →