# Bug Ledger

> Registro dei bug complessi risolti con sintomo, causa, soluzione e prevenzione.

## Formato

```markdown
## YYYY-MM-DD: [Titolo Bug]
**Sintomo:** [Descrizione sintomo]
**Causa:** [Root cause]
**Soluzione:** [Fix applicato]
**Prevenzione:** [Come evitare in futuro]
```

---

## Esempio Template

## 2026-04-05: Race condition in webhook dispatch

**Sintomo:** Webhook duplicati inviati sotto carico elevato

**Causa:** Manca meccanismo di lock nel dispatcher, richieste concorrenti causano doppia delivery

**Soluzione:** 
- Aggiunto `asyncio.Lock()` nel dispatcher
- Sequentializza invio webhook per lo stesso evento

**Prevenzione:** 
- Test di carico obbligatori per componenti async
- Code review focus su race condition
- Documentare comportamento thread-safe nei docstring

---

*Aggiungere nuovi bug in ordine cronologico decrescente (più recente in cima)*