# ADR 0001 — Socle helpdesk : Zammad self-hosted

- **Statut** : Accepté
- **Date** : 2026-06-26

## Contexte

Les demandes de devis arrivent sur plusieurs adresses email distinctes, sans
centralisation ni workflow. Le brief (`docs/brief.md`) demande de centraliser la
réception, router les demandes, et assister la rédaction des réponses via Claude 4.5
(brouillon + révision humaine avant envoi).

## Décision

- **Socle = Zammad** (helpdesk open source, AGPLv3, multi-boîtes, gestion de tickets,
  triggers/règles de routage natifs, webhooks sortants).
- **Hébergement = self-hosted Docker** via le compose vendoré dans `infra/zammad/`
  (upstream `zammad/zammad-docker-compose`). On garde le contrôle des mailboxes et des
  données clients.
- Périmètre immédiat : **POC** sur un **domaine de test dédié**, pour valider routage +
  traitement sans impacter la production.

## Conséquences

- On hérite des dépendances Zammad : PostgreSQL, Redis, Elasticsearch, Memcached, Nginx
  (voir `infra/zammad/docker-compose.yml`).
- Le seul point d'architecture **non tranché** est le mécanisme d'intégration de Claude
  dans le workflow → tranché depuis dans l'**ADR 0002** (`0002-hook-claude.md`).
- Mises à jour de l'upstream à suivre via les releases `zammad-docker-compose`.

## Alternatives écartées (pour cette phase)

- Cloud managé (Zammad Cloud / autre SaaS) : moins de contrôle des données, coût récurrent.
- Helpdesk custom : effort de build non justifié pour un POC.