Trasparenza tecnica

Stack Tecnologico

Costruiamo con strumenti open-source, principi event-driven e architetture multi-agent. Niente vendor lock-in proprietario: ogni componente è sostituibile e documentato.

Principi Architetturali

Event-Driven

I sistemi reagiscono a eventi (webhook, queue, timer) invece di polling. Scalabilità nativa e disaccoppiamento tra componenti.

Multi-Agent AI

LLM specializzati orchestrati da un coordinatore centrale. Ogni agente ha un dominio ristretto e un tool set definito.

RPA + LLM Hybrid

RPA per flussi deterministici strutturati (XML SEPA, ERP), LLM per parsing semantico e decisioni contestuali. Complementari, non sostitutivi.

Stack per Layer

Backend & API

  • Python 3.11+ — linguaggio principale per AI, automazioni e data processing
  • FastAPI — API REST async per servizi interni e webhook (Orchestrator, SEPA Manager backend, ClinicFlow)
  • Node.js 20+ — runtime per servizi real-time e bot WhatsApp (SideMindBot, SideMind Hub, Flowlitycs)
  • Flask — micro-framework per applicazioni web interne lightweight
  • Baileys — libreria Node.js per WhatsApp Web API (SideMindBot)
$ python --version
Python 3.11.9
$ node --version
v20.11.1
$ fastapi --version
0.111.0

AI & LLM Infrastructure

  • Anthropic Claude (Sonnet/Opus) — orchestrazione decisionale, parsing contratti, generazione testo strutturato
  • Ollama — runtime LLM locale (qwen3:14b, qwen2.5-coder:7b) per task senza invio dati esterni
  • ChromaDB — vector database per retrieval semantico (RAG, knowledge base prodotti)
  • Dify — orchestrazione workflow AI visuale per integrazioni enterprise (ClinicFlow 2)
  • Playwright / Puppeteer — browser automation per RPA web-based
# Ollama local models
qwen3:14b    9.3GB  main
qwen2.5-coder:7b  4.7GB  fast
# ChromaDB collection
decisions   1.2k docs
knowledge   3.8k docs

Database & Storage

  • Supabase (PostgreSQL) — database principale per dati strutturati e real-time subscriptions
  • SQLite — database embedded per servizi autonomi leggeri (Flowlitycs, Hub)
  • PostgreSQL RDS — database managed AWS per SEPA Manager (isolation produzione)
  • AWS S3 — object storage per file XML SEPA, log CloudFront, asset statici
# Supabase
PostgreSQL 15 + pgvector
Row Level Security
# AWS
S3 + CloudFront + Lambda
RDS PostgreSQL (SEPA)

Cloud & Infrastruttura

  • AWS Lambda — funzioni serverless per automazioni event-triggered (IndexNow, email, webhook)
  • AWS CloudFront — CDN + Edge Functions per redirect 301 e header sicurezza
  • EC2 (eu-west-1) — server applicativi per servizi stateful (bot WhatsApp, Orchestrator)
  • Azure — servizi cloud secondari per integrazioni enterprise cliente-specifiche
  • Eleventy (11ty) — static site generator per siti con requisiti SEO/GEO elevati
# Region principale
eu-west-1 (Irlanda)
# Stack IaC
AWS CLI + shell scripts
CloudFront Functions JS
# OS
Ubuntu Server 22.04 LTS

Repository Open Source

Parte del codice sviluppato da Synaptica è rilasciato pubblicamente su GitHub. Strumenti, utilità e componenti riusabili dalla community.

Vedi tutti i repository → GitHub @SynapticaSolution

Perché Queste Scelte

Python per AI, Node per real-time

Python ha l'ecosistema AI/ML più maturo (LangChain, ChromaDB, Pandas). Node.js gestisce meglio le connessioni WebSocket persistenti richieste dai bot WhatsApp.

Supabase su MongoDB

PostgreSQL garantisce transazionalità ACID per pagamenti SEPA e dati sanitari. Row Level Security di Supabase riduce il codice di autorizzazione. pgvector evita un database vettoriale separato.

Ollama per privacy-first

Per dati aziendali sensibili (bilanci, dati pazienti) usiamo modelli locali via Ollama. Nessun dato lascia l'infrastruttura del cliente. Claude API per task che richiedono capacità superiori.

RPA + LLM, non LLM solo

La generazione XML SEPA ISO 20022 richiede precisione assoluta: RPA deterministico. Il parsing di email di conferma richiede comprensione semantica: LLM. I due approcci si completano.

Static site per GEO

Eleventy genera HTML puro senza JavaScript obbligatorio. I crawler AI (GPTBot, ClaudeBot, PerplexityBot) leggono meglio contenuto statico. Lighthouse 100/100 su tutti i parametri.

EU-first infrastruttura

Hosting primario in eu-west-1 (Irlanda) per conformità GDPR. Nessun dato personale trasferito fuori UE senza accordo DPA esplicito. CloudFront con restrizioni geografiche configurabili.

Vuoi sapere come applichiamo questo stack al tuo progetto?

Discovery call gratuita di 30 minuti. Analizziamo il tuo caso e proponiamo l'architettura più adatta.

Parliamone
Scrivici su WhatsApp