Task: Browser Connector V2 - Implementation

Date: 03-02-2026 Status: EN COURS

Objectif

Implementation complete du Browser Connector V2 selon le plan valide.

Travail Realise

Backend (/stock_8to/33800-stack/projects/browser-connector/)

Structure creee:

browser-connector/
├── src/
│   ├── core/
│   │   ├── BrowserManager.ts      # Gestion multi-user des contexts Playwright
│   │   ├── SessionStore.ts        # Persistence sessions Redis
│   │   ├── CredentialStore.ts     # Credentials depuis Supabase
│   │   └── RegionStore.ts         # Zones nommees dans Redis
│   ├── middleware/
│   │   └── auth.ts                # Validation JWT/API keys
│   ├── services/
│   │   ├── capture.ts             # Screenshots, PDF, HTML
│   │   ├── regions.ts             # Gestion zones nommees
│   │   ├── browse.ts              # Actions generiques (navigate, click, type, etc.)
│   │   ├── ai.ts                  # Integration AI Orchestrator (YOLO, OCR, Ollama)
│   │   ├── site-templates.ts      # CRUD des site templates
│   │   └── captcha-assist.ts      # Assistance CAPTCHA (V1 screenshots)
│   ├── engine/
│   │   └── TemplateExecutor.ts    # Execution des actions de templates
│   ├── types/
│   │   └── index.ts               # Definitions TypeScript
│   └── index.ts                   # API Elysia complete
├── package.json
├── tsconfig.json
├── Dockerfile
├── docker-compose.yml
├── conf.prod.gouroubleu.yml       # Smart-deploy config
├── .gitlab-ci.yml
├── schema.sql                     # Tables Supabase
└── README.md

Features implementees:

• Multi-user isolation (BrowserManager avec Map<userId, context>)
• Sessions Redis avec cles browser:session:{userId}:{service}
• Credentials depuis Supabase (browser_credentials)
• Site templates generiques (browser_site_templates)
• Screenshots, PDF, HTML export
• Zones nommees (regions) avec thumbnails
• Actions generiques (navigate, click, type, extract, scroll, wait)
• Integration AI (YOLO, OCR, find-element, analyze)
• CAPTCHA Assist V1 (screenshots rafraichis apres chaque action)
• Endpoints legacy backward-compatible (/scrape, /screenshot, /pdf)
• Templates builtin (LinkedIn, Gmail, Generic)

Endpoints API (80+):

• Health & Status
• Config (viewport, presets)
• Capture (screenshot, pdf, html, zone, region)
• Regions (define, list, delete, diff, wait-change)
• Browse (navigate, click, type, scroll, wait, extract)
• AI (detect, ocr, find-element, analyze)
• Site Templates (CRUD)
• Credentials (CRUD)
• Execute (template action, manual steps, login)
• CAPTCHA Assist (start, click, drag, type, refresh, check, end)

Frontend (/stock_8to/33800-stack/projects/connectors-front/src/components/browser/)

Composants crees:

• ZoneSelector.tsx - Selection interactive de zone sur screenshot (draw rectangle)
• RegionManager.tsx - Liste et gestion des zones nommees
• ScreenshotViewer.tsx - Affichage screenshot avec toolbar et zone selector
• CaptchaAssist.tsx - Interface d'assistance CAPTCHA

API lib mise a jour:

• browserFetch() - Proxy vers browser-connector
• getBrowserStatus() - Status instance
• getBrowserTemplates() - Liste templates
• executeBrowserAction() - Execute action template
• browserScreenshot() - Prendre screenshot

Base de donnees

Tables a creer (schema.sql):

• connectors.browser_credentials - Credentials cryptes par user/site
• connectors.browser_site_templates - Templates d'automation
• connectors.browser_sessions - Metadata sessions (optionnel)
• connectors.browser_audit - Logs d'audit (optionnel)

Prochaines etapes

1. Deployer schema SQL sur Supabase PROD
2. Builder et push l'image Docker
3. Deployer via smart-deploy ou CI/CD
4. Tester les endpoints de base
5. Integrer dans connectors-front (routes /browser/*)
6. Documentation utilisateur

Notes

• Le projet est complet mais non deploye
• CAPTCHA Assist V1 utilise des screenshots statiques (pas de streaming temps reel)
• Les templates builtin (LinkedIn, Gmail) sont des exemples, a adapter selon les sites reels
• L'integration AI depend de ai-orchestrator fonctionnel