Files

Luca Sacchi Ricciardi 88cfe9af50 docs: update all documentation for Sprint 1 completion

- Update README.md with badges, project status, and improved structure
- Update CHANGELOG.md with Project Review Sprint 1 and version 0.1.1
- Update PRD status to reflect Sprint 1 completion
- Update ingestion script spec status to Completed with review link
- Update Sprint 1 verification report with Project Review reference
- Add comprehensive Sprint 1 Project Review document

Refs: Project Review conducted by agent staff (Product Manager, Tech Lead, Security Auditor)

2026-04-02 17:25:29 +02:00

4.2 KiB

Raw Blame History

Product Requirements Document (PRD) - MVP

Progetto: LogWhisperer AI (aka Sacchi's Server Sentinel)

Status: 🟢 MVP Active Development - Sprint 1 Completed
Last Updated: 2026-04-02
Version: 0.1.0

Sprint Progress:

✅ Sprint 1: Log Ingestion Script (Completed)
🔄 Sprint 2: AI Processing Pipeline (Planning)
⏳ Sprint 3: Alerting & Onboarding
⏳ Sprint 4: Landing Page & Payments

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

4.2 KiB Raw Blame History