Amán Rules Engine

Piattaforma full-stack per authoring e valutazione regole: UI React + Next.js con conversione da linguaggio naturale ad AST tramite AI e valutatore ad alte prestazioni in Go.

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

Panoramica

Rules engine text-to-AST: l utente scrive l intento, clicca Generate, un LLM esterno (Gemini) restituisce AST, la UI mostra JSON + editor interattivo e il motore valuta con output di trace.

Architettura

UI Next.js / React -> API LLM (Gemini) per NL-to-AST -> render AST + dati di test UI -> valutatore Go (+ trace) -> output risultati. Persistenza in Postgres JSONB, valutazione in memoria per richiesta.

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

Decisioni tecniche chiave

Go per prestazioni e tipizzazione forte

PostgreSQL JSONB per modelli regola flessibili

chi per routing minimale e middleware estendibile

Gemini per evitare hosting di un modello proprietario

Sfide

Serializzazione JSON di pgx JSONB []byte nelle risposte

Type safety con payload regole dinamici

Flessibilità operatori per eq/gte/string/collection

Risoluzione campi annidati con parser dot notation

Compromessi

Parser creato a ogni richiesta (overhead allocazioni MVP)

Regex compilate ad ogni valutazione invece che in cache

Nessuna cache regole lato DB per ora (Redis possibile)

Valutatore single-node vs distribuito (scelto per release iniziale)

Nessuna auth API regole al momento; prima MVP, poi JWT

Risorse

Repository GitHub → Demo live →