Introdução e Visão Geral da Plataforma
Introdução & Visão Geral da Plataforma Prime Crown
Section titled “Introdução & Visão Geral da Plataforma Prime Crown”O Prime Crown é uma plataforma SaaS full-stack para a gestão completa de serviços de limpeza residencial de alto padrão no Reino Unido.
Estado actual. SPA React 19 + Pages Functions (Hono) + D1. WhatsApp: Meta Cloud API direto do app. Chatwoot atende Instagram e Facebook. IA de texto no Workers AI, com modelo configurável por recurso. Deploy: npm run deploy:web. Relógio: Londres. Mapa entre agentes: agents.md.
🏛️ 1. Visão Geral da Arquitetura do Sistema
Section titled “🏛️ 1. Visão Geral da Arquitetura do Sistema”graph TD
subgraph Frontend ["Frontend SPA (Vite / React 19 / Zustand)"]
ClientWeb["Portal do Cliente (PublicQuote)"]
AdminDashboard["Painel Administrativo & Operações"]
FieldApp["App de Campo da Funcionária (PWA)"]
end
subgraph EdgeBackend ["Edge Serverless (Cloudflare Pages Functions / Hono)"]
API["REST API Serverless (/api/*)"]
DO["Durable Objects (Realtime WebSockets)"]
Cron["Cloudflare Cron Triggers"]
end
subgraph StorageAI ["Persistência & Serviços"]
D1[("Cloudflare D1 (SQLite DB)")]
R2["Cloudflare R2 (Fotos & Mídias)"]
AI["Cloudflare Workers AI via /api/ai"]
WA["Meta Cloud API"]
end
ClientWeb --> API
AdminDashboard --> API
FieldApp --> API
API <--> D1
API <--> R2
API <--> AI
API <--> WA
DO <--> AdminDashboard
💎 2. Princípios Norteadores de Engenharia
Section titled “💎 2. Princípios Norteadores de Engenharia”- Zero Lock de Interface (Re-render Cascade Eliminated): Migração do React Context monolítico para Zustand Stores com seletores granulares, garantindo re-render apenas dos elementos alterados.
- Mutação Otimista com Fallback Seguro: A interface pode refletir alterações antes da resposta do servidor. O servidor confirma a gravação atômica e a interface trata recusas.
- Serviços na borda: Pages Functions, D1 e R2. A IA de texto usa Workers AI. O WhatsApp usa Meta Cloud API, direto do app. Chatwoot atende Instagram e Facebook.