Introdução e Visão Geral da Plataforma

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.

🏛️ 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 de IA"]
        D1[("Cloudflare D1 (SQLite DB)")]
        R2["Cloudflare R2 (Fotos & Mídias)"]
        AI["Cloudflare Workers AI (Llama 3.2 1B) & Gemini 2.0 Flash"]
        EvoAPI["Evolution API (WhatsApp)"]
    end

    ClientWeb --> API
    AdminDashboard --> API
    FieldApp --> API

    API <--> D1
    API <--> R2
    API <--> AI
    API <--> EvoAPI
    DO <--> AdminDashboard

💎 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 reflete ações do usuário em 0 milissegundos, realizando sincronizações atômicas assíncronas com o Cloudflare D1.
Gratuidade & Alta Performance com Edge Serverless: Processamento na borda global do Cloudflare (Pages Functions, D1 SQLite e Workers AI), reduzindo custos de infraestrutura a quase zero.