Skip to content

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”
  1. 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.
  2. 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.
  3. 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.