commit b5391342803a24023d4e23ac70dcc022b18a1120
Author: Luca Sacchi Ricciardi <luca@lucasacchi.net>
Date:   Tue Apr 7 11:27:03 2026 +0200

    first commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7338765
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+# mockupAWS - Backend Profiler & Cost Estimator
+
+## Obiettivo del Progetto
+`mockupAWS` è un ambiente di simulazione locale (homelab) progettato per replicare i layer di ingestion ed elaborazione cloud del progetto LogWhispererAI. 
+
+Lo scopo principale non è analizzare i log, ma **profilare il traffico e calcolare i driver di costo** dei servizi AWS (SQS, Lambda, Bedrock/LLM) prima del deploy in produzione. Inviando log tramite Logstash a questo mockup, è possibile ottenere una stima precisa della fatturazione basata su traffico simulato o reale.
+
+## Architettura e Metriche Misurate
+Il mockup espone endpoint che simulano il comportamento dei servizi AWS, raccogliendo metriche essenziali:
+
+* **Simulazione Ingestion (Amazon SQS / API Gateway):**
+  * Misurazione delle richieste HTTP al secondo (RPS).
+  * Calcolo della dimensione media dei payload (monitorando i blocchi di fatturazione da 64KB).
+  * *Principio applicato: Safety First* - Validazione dell'integrità del payload in ingresso e verifica dell'avvenuta sanitizzazione dei dati (assenza di PII/Secreti).
+
+* **Simulazione Compute (AWS Lambda):**
+  * Profilazione dell'efficacia del batching e della deduplicazione.
+  * *Principio applicato: Little Often* - Test del processamento a piccoli batch per simulare la lettura ottimizzata dalle code.
+
+* **Simulazione LLM (Amazon Bedrock):**
+  * Conteggio esatto dei token in ingresso (Input Tokens) tramite tokenizer (es. `tiktoken`).
+  * *Principio applicato: Double Check* - Validazione finale del prompt generato prima del calcolo dei costi simulati.
+
+## Requisiti
+* Docker / Docker Compose
+* Node.js (v20+) o Python (3.11+) [A seconda dello stack scelto per lo script]
+* Logstash (configurato per puntare agli endpoint esposti da questo mockup)
+
+## Flusso di Sviluppo (Spec-Driven & TDD)
+Questo repository adotta un approccio rigoroso allo sviluppo:
+
+1. **Spec-Driven**: Nessuna implementazione senza prima aver definito le specifiche di input/output.
+2. **Test-Driven Development (TDD)**: I test per il calcolo delle metriche e la validazione dei payload (es. conteggio token, validazione limiti SQS) devono essere scritti *prima* della logica di routing.
+3. **Gestione del Codice**: 
+   * Flusso Git basato su **Conventional Commits** (`feat:`, `fix:`, `chore:`, `test:`).
+   * Commit atomici e mirati.
+   * Compilazione del file `CHANGELOG.md` aderente allo standard **Common Changelog**.
+4. **Pull Requests**: Le PR devono includere l'esito dei test e la descrizione chiara del driver di costo AWS che si sta andando a simulare o correggere.
+
+## Come avviare la simulazione
+*(Da completare una volta definito lo stack esatto e i comandi di avvio, es. `docker-compose up --build`)*