Architecture
System architecture, technology stack, project structure, and design decisions
Architecture Overview
Complete system architecture — headless Chrome, Express backend, React frontend, PostgreSQL, Docker slices
v2 Architecture — Baileys
v2 replaced Chrome/whatsapp-web.js with Baileys (direct WebSocket). No browser, no DOM, no Puppeteer.
V3 Architecture — Single-Process Multi-User
V3 replaces Docker-per-user containers with a single Node.js process managing all Baileys sockets in-process
Baileys 7.0.0-rc.9 Required Patches
4 patches required to fix broken pairing in Baileys RC9 — Platform.MACOS, passive:false, lidDbMigrated removal, noise.finishInit
QR Code Login (v1 — ARCHIVED)
DEPRECATED — v1 only. Replaced by pairing codes in v2 (Baileys). See v2-baileys.md.
Baileys Security Audit
Full source code audit of Baileys v7.0.0-rc.9 — network destinations, phone number handling, credential storage, dependency chain