commit 1cf076ba6d5281c9fb9168e097e948824c3a911c
Author: Luca Sacchi Ricciardi <luca@lucasacchi.net>
Date:   Thu Apr 2 15:07:05 2026 +0200

    added prd.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e69de29
diff --git a/prd.md b/prd.md
new file mode 100644
index 0000000..9f8853c
--- /dev/null
+++ b/prd.md
@@ -0,0 +1,43 @@
+# Product Requirements Document (PRD) - MVP
+## Progetto: LogWhisperer AI (aka Sacchi's Server Sentinel)
+**Status:** MVP (Lancio in 4 giorni - Focus su "Fail fast, fail cheap")
+
+### 1. Executive Summary & UVP
+**Vision:** Trasformare log di server e database incomprensibili in alert azionabili e in "plain language" per non-addetti ai lavori.
+**Unique Value Proposition (UVP):** "Il DevOps tascabile che traduce i crash del tuo server e ti dice l'esatto comando per risolverli in sicurezza, senza farti perdere ore su StackOverflow."
+
+### 2. Target & Problema (Customer Discovery / Market Fit)
+* **Buyer Persona (Early Adopters):** Piccole Web Agency, sviluppatori freelance frontend/fullstack e startup early-stage.
+* **Problema (Pain):** Gestiscono VPS o piccoli cluster (es. AWS, DigitalOcean) ma non hanno budget o volume per un DevOps/Sistemista senior interno. Quando c'è un downtime, c'è il panico. Ore perse a decifrare log = siti down = clienti persi = danni economici e d'immagine.
+
+### 3. Core Features (Scope dell'MVP)
+*Regola d'oro: Nessuna feature inutile. Sviluppiamo solo ciò che serve per validare l'ipotesi di mercato.*
+* **Feature 1: Log Ingestion (Edge to Cloud).** Uno script bash super leggero fornito al cliente da installare sul proprio server. Lo script fa un `tail -f` sui log critici (es. syslog, nginx, postgresql) e spara il payload via POST request a un Webhook quando rileva stringhe di errore (es. "FATAL", "ERROR", "OOM").
+* **Feature 2: AI Processing Pipeline.** Workflow su n8n che riceve il payload dal Webhook, formatta il testo e fa una chiamata API a un LLM. Il *System Prompt* deve integrare il "Metodo Sacchi" (Safety first, little often, double check) per garantire risposte sicure e conservative.
+* **Feature 3: Alerting Umano.** L'LLM restituisce un JSON strutturato che n8n formatta e invia come notifica su Telegram o Slack del cliente. La notifica deve contenere:
+  - Sintesi del problema in italiano semplice (es. "PostgreSQL è crashato per mancanza di spazio disco").
+  - Severità (Low, Medium, Critical).
+  - Lo snippet di codice/comando esatto da lanciare per la mitigazione immediata.
+
+### 4. Stack Tecnologico (Approccio Micro-SaaS)
+* **Core Logic & API Gateway:** n8n (self-hosted o cloud).
+* **Database & Auth:** Supabase / PostgreSQL (per gestire gli user_id, mappare i webhook_url univoci per cliente, e tracciare il piano di abbonamento).
+* **AI Engine:** API OpenAI (GPT-4o-mini per velocità/costo) o Anthropic (Claude 3.5 Sonnet per coding task).
+* **Frontend MVP & Pagamenti:** Landing page in HTML/CSS o builder No-Code integrata con Stripe Payment Links.
+
+### 5. Business Model & Pricing
+* SaaS B2B a ricorrenza mensile (Tiered Pricing).
+* **Tier 1 (Hobby/Solo):** 19€/mese (Max 1 server collegato, max X alert/mese).
+* **Tier 2 (Pro):** 49€/mese (Fino a 5 server collegati).
+* **Go-to-Market Offer:** 14-day Free Trial (Cardless) per abbassare al minimo l'attrito in fase di "Activation".
+
+### 6. Funnel di Crescita (Modello AARRR)
+* **Acquisition (ToFu):** Content marketing tecnico/dimostrativo su YouTube e LinkedIn ("Ho automatizzato il troubleshooting del mio server Linux con l'AI. Ecco i risultati"). Call To Action verso la Landing Page.
+* **Activation:** L'utente atterra sulla Landing Page, inserisce la mail, riceve il suo Webhook URL e lo script bash. L'*Aha Moment* scatta quando riceve il primo alert tradotto su Telegram dopo aver simulato un errore.
+* **Retention:** Valore passivo e continuo (il bot monitora silenziosamente 24/7). Zero lavoro per l'utente finché non c'è un problema.
+* **Revenue:** Trigger automatico via email allo scadere del giorno 14 per inserire la carta di credito su Stripe.
+* **Referral:** TBD in fase post-lancio (es. affiliazioni B2B o link "Powered by" nei report).
+
+### 7. Metriche di Successo Iniziali (OMTM)
+* **Activation Rate:** % di iscritti alla Trial che installano effettivamente lo script e triggherano almeno 1 alert (se non lo installano, la Trial è inutile).
+* **Trial-to-Paid Conversion Rate:** % di utenti che inseriscono la carta al termine dei 14 giorni.x