Architecture
Architecture — Overview
Objective
A unified, self-hosted, subscription-free, AI-native operating system for Feedback Studios: a team CRM at the core, a client portal, with native automation and conversations and AI agents — all on our own VPS.
Components
| Component | Status | Function |
|---|---|---|
| Vidot VPS | Ready and hardened | Host of the entire platform |
| Coolify + Forgejo | Live | Orchestration, deploy on push, git |
| apps/cms (Payload + PostgreSQL) | Live | API, auth, engine, content; schema via migrations |
| apps/crm (Shadcn UI Kit) | Live, Phase 1 | Team CRM: companies, contacts, deals, tasks, 360 + timeline, search |
| apps/docs (Syntax) | Live | This documentation site |
| apps/web | In progress | Public website |
| Native conversations (omnichannel inbox) | Phase 2 | Replaces Chatwoot |
| Native automation engine | Phase 3 | Triggers to actions (replaces n8n) |
| AI agents (Claude) | Phase 4 | SDR, booking, support, ask-your-CRM |
| apps/portal | Phase 5 | Client portal |
Superseded: earlier drafts connected n8n (automation) and Chatwoot (chat) via API. Decision ADR 0006: both are dropped in favour of native automation and conversations, for full control of the workflow engine and the identity graph (the product moat).
Principles
- Self-hosted always · 2. No subscriptions · 3. Open-source preferred ·
- A single stack (TS/Next) · 5. Manual-efficient first, then automation, then AI ·
- By phases, without breaking what works.
See detailed decisions in the decisions folder, and the product blueprint and roadmap under docs/pm (published as Product in this site).