Ciclo de Vida da Limpeza & Telemetria GPS

Ciclo de Vida da Limpeza & Telemetria em Campo

O módulo de Operações de Campo (Field Operations) gerencia a execução em tempo real das limpezas residenciais pela equipe, capturando pontos de check-in/out geolocalizados e acompanhando a realização dos checklists.

---

🔄 1. Diagrama de Estado da Limpeza

stateDiagram-v2
    [*] --> REQUESTED: Solicitação de Orçamento
    REQUESTED --> PENDING: Validação de Disponibilidade
    PENDING --> CONFIRMED: Funcionária Alocada
    
    state CONFIRMED {
        [*] --> READY: Aguardando data/hora
        READY --> IN_TRANSIT: Deslocamento para imóvel
    }
    
    CONFIRMED --> IN_PROGRESS: Check-in por Telemetria GPS (raio de 200m)
    IN_PROGRESS --> COMPLETED: Check-out por Telemetria GPS + Checklist
    
    COMPLETED --> INVOICED: Emissão da Fatura Fiscal (Billing)
    INVOICED --> PAID: Quitação do Pagamento
    
    CONFIRMED --> CANCELLED: Cancelamento (Politica de Cancelamento)
    PENDING --> CANCELLED: Cancelamento sem taxa

---

📍 2. Telemetria GPS & Validação Geográfica

Para evitar fraude de horários ou check-ins fora do local do serviço, a classe ServiceGeoAction.tsx executa a validação por coordenadas:

sequenceDiagram
    autonumber
    actor Staff as Funcionária (App)
    participant UI as Componente ServiceGeoAction
    participant Geo as GPS do Dispositivo (HTML5/Capacitor)
    participant API as Edge API (/api/atomic/requests)
    participant D1 as Cloudflare D1 DB

    Staff->>UI: Clica em "Iniciar Limpeza" (Check-in)
    UI->>Geo: Solicita coordenadas atuais (lat, lng)
    Geo-->>UI: Retorna lat, lng e precisão
    UI->>UI: Calcula distância Haversine em relação ao imóvel
    alt Distância <= 200 metros
        UI->>API: POST /api/atomic/requests/:id (telemetry_json, status: IN_PROGRESS)
        API->>D1: UPDATE service_requests
        D1-->>API: OK
        API-->>UI: Check-in confirmado!
    else Distância > 200 metros
        UI-->>Staff: Alerta: "Você deve estar no imóvel para iniciar a limpeza"
    end

---

📋 3. Checklists Operacionais & Registros de Foto

• Checklists Personalizados: Cada tipo de serviço (ex: Deep Cleaning, Regular Cleaning, End of Tenancy) possui uma lista de tarefas.
• Relatório de Inspeção: A funcionária marca os itens concluídos e pode enviar fotos diretamente para o armazenamento do Cloudflare R2 via /api/upload.