# Critères d’introduction d’un service `browser-automation-api`

## Position par défaut

La plateforme **n’intègre pas** Chromium / Playwright / équivalent dans les services tant que les besoins ci-dessous ne sont **pas** satisfaits par le navigateur système ou un onglet web du shell (Lapce, front).

## Ouvrir le service si **au moins une** condition est vraie

1. **Capture de rendu** : génération d’images ou PDF de pages **internes** sans interaction utilisateur (rapports, preuves d’état).
2. **E2E pilotés par agents** : scénarios web reproductibles avec **timeouts** et **allowlist** de domaines.
3. **Scraping contrôlé** : extraction de contenu depuis URLs **pré-approuvées** uniquement (liste configurée par env).
4. **Tests visuels** sur infra d’intégration où le poste développeur **n’a pas** de GUI.

## Contraintes de conception

- Processus **séparé** : `services/browser-automation-api/` dédié, pas de dépendance lourde ajoutée aux API existantes (Local Office, repos-devtools, etc.).
- **File d’attente** et **plafond** de jobs simultanés ; **timeouts** stricts.
- Réseau : **allowlist** ; pas de navigation arbitraire vers Internet.
- Auth : Bearer service-to-service ; journalisation des URLs demandées.

## Hors scope

- Remplacer le navigateur de l’utilisateur pour l’UI AnythingLLM ou ONLYOFFICE au quotidien.
- Automatisation non auditée sans policy.

## Document lié

- [platform-target.md](../platform-target.md) — rappel navigateur optionnel