Nicolas Cantu
088eab84b7
- Add ia_dev submodule (projects/smart_ide on forge 4nk) - Document APIs, orchestrator, gateway, local-office, rollout - Add systemd/scripts layout; relocate setup scripts - Remove obsolete nginx/enso-only docs from this repo scope
29 lines
1.5 KiB
Markdown
29 lines
1.5 KiB
Markdown
# 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
|