This wiki keeps the current deep technical docs and adds a clearer top layer for handover, onboarding, operations, testing, security, and product guidance.
| Section | Purpose |
|---|---|
| Start Here | Handover, orientation, critical rules, and first-week checklist. |
| Product Guide | User-facing feature guide for inbox, messaging, channels, CRM, broadcasts, calls, and Reply Copilot. |
| Architecture | System shape, transports, queues, realtime, storage, tenancy, connector behavior, and sync designs. |
| Developer Guide | Local setup, backend, frontend, connector, migrations, tests, conventions, and feature workflow. |
| API and Integrations | Public REST API, webhooks, tokens, Toppie, payroll bridge, and UtopiaSpace SSO. |
| Deployment and Release | DigitalOcean, Vercel, workflow gates, release checklist, split-head handling, rollback, shipped log. |
| Operations | Runbooks, troubleshooting, production behaviors, stuck sends, tag drift, queue backlog, routing issues, pgweb. |
| Security | Secrets, HMAC, authentication, RBAC, encryption, webhook signatures, and open security items. |
| Roadmap and Maintenance | Master plan, known gaps, branch cleanup, backups, and future architecture notes. |