Skip to content

Arquitetura de Alto Nível

Estado actual — formulários em telas pequenas. Janelas usam cabeçalho e rodapé compactos no telefone, corpo rolável sem reserva inferior duplicada e o viewport do teclado; ao desfocar um campo durante um toque, a geometria permanece até soltar o dedo para não deslocar o botão antes do clique. Durante escrita protegida, X, fundo, Escape e controles aguardam o resultado. Lead e cadastro de cliente preservam dados e mostram erro junto à ação; lead exige nome e repete a tentativa com o mesmo ID. O menu Novo de People compartilha navegação por teclado; contatos offline usam a mesma pilha e restauração de foco. Shift+Tab permanece no diálogo e ignora controles ocultos/inert. A atribuição de conversas aguarda confirmação e mantém falhas visíveis; salvar mensagens nas notas de acesso usa a versão original do cadastro.

Estado actual — celular, tablet e computador. O espaço disponível define a disposição; toque, caneta, mouse e teclado mantêm seus comandos sem classificar o aparelho por nome. Controles compartilhados e itens de menu preservam alvo de 44 px em qualquer aparelho com toque, inclusive com mouse conectado; campos mantêm 16 px para evitar zoom. Ações de conversas, mensagens, álbuns, pessoas e células da agenda têm entrada visível, com clique direito e gestos preservados. Menus compartilham foco, Escape, setas e busca por letras; cabem no viewport visual, rolam por dentro e acompanham teclado e rotação. Janelas de todas as larguras seguem o teclado, compactam cabeçalho/rodapé e mantêm o campo editado visível; perfis em apresentação de página deixam o sidebar acessível ao teclado. Multitoque, cancelamento e desmontagem não concluem pressionamento longo ou resposta por deslize. A matriz de navegador cobre as telas principais em retrato/paisagem, formulários e menus em Android, iPhone, tablets Android/iPad, Firefox desktop e computador com toque.

Estado actual — carga inicial. A navegação do app autenticado carrega sob demanda e começa a aquecer assim que existe usuário, em paralelo à hidratação do boot. O serviço global de confirmação carrega a janela compartilhada somente quando há uma confirmação para mostrar. Login, páginas públicas e Chat independente não baixam essa navegação na carga inicial; a espera usa a mesma tela de preparação.

Estado actual — configuração pública do perfil. O vínculo Google reutiliza a consulta pública de configuração já compartilhada com o login, sem refazer o boot operacional para obter somente o identificador público.

Estado actual — prioridade e acessibilidade. A gestão vê pendências acionáveis antes do resumo do dia, sem cartões vazios para completar uma linha. Na Home da equipe, a visita atual/próxima vem antes dos avisos secundários. People mostra o nome completo com quebra de palavras longas. A busca de pessoas abre resultados além dos primeiros 12 em blocos e com altura limitada; limpar a pessoa devolve o foco à busca. A comparação de nomes é reutilizada durante a consulta. O shell oferece Ir para o conteúdo para teclado; abas inativas e textos secundários dos cartões usam contraste legível. Escape fecha primeiro o menu aberto e devolve o foco ao botão, preservando a janela de origem. Recebimento manual recusa frações de centavo; o lote bloqueia cliques repetidos antes de renderizar, preservando IDs nas tentativas de recuperação.

Estado actual — experiência por perfil. Lead abre em My quotes, acompanha pedidos abertos/anteriores e fala com o escritório; Bills só aparece se houver documentos. Cliente sem visitas recebe uma única orientação para pedir orçamento e mantém acesso ao histórico, mesmo sem visitas na janela de boot. O shell reserva o espaço inferior das Homes e acomoda prompts persistentes num slot acima do conteúdo, sem cobrir abas; avisos críticos mantêm prioridade. Billing e Banking deixam busca visível e recolhem filtros secundários no telefone, indicando o período. Formulário, foto e gravação do perfil próprio resolvem o mesmo registro de equipe, incluindo ADMIN. Fiscal, manutenção manual e configurações globais protegidas pela API são administrativas; o gerente mantém catálogo, orçamento online, cancelamentos, banner e operação financeira. Links públicos recusados/expirados diferem de falha de rede.

Estado actual — perfis em People. Abrir cliente, lead ou integrante da equipe ocupa toda a área de conteúdo ao lado do sidebar no desktop, acompanhando sua largura ao recolher ou expandir. O nome começa no topo, com ações logo após o nome, agrupadas à esquerda no desktop e abaixo no telefone: entram quantas couberem na largura e o resto fica em More, como a barra de seções. Os ícones usam botões com cantos arredondados no padrão do sidebar e do X; no desktop, ficam na mesma altura do X, que usa o componente de fechar das demais janelas. A ação Profile abre o cadastro de clientes e equipe (ou os dados do lead); a antiga aba Profile é Keys: uma chave não tem código nem etiqueta, só a descrição e quem a tem; no cliente, as chaves dele e todo o histórico, com o cabeçalho só no cadastro; na equipe, as chaves que estão com a pessoa e o histórico de posse que a nomeia; nos dois, Mover passa a chave para outra pessoa e as outras opções abrem um menu flutuante; leads mostram estado vazio. Há uma única camada de padding (16 px no telefone). Fechar devolve à lista; no telefone o perfil continua em tela cheia. A seção Aparelhos, no perfil próprio e no de cada pessoa, é visível somente ao ADMIN; a API de consulta também recusa os demais papéis, inclusive a consulta dos próprios aparelhos. O registro automático dos aparelhos permanece ativo para todos. A seção lista os aparelhos desta sessão (navegador, sistema, versão, último acesso em Londres, app instalado, notificações e permissões de localização e câmera quando o navegador as informa), sem coordenadas.

Estado actual — PWA mobile. No Android o Chrome grava no app instalado a barra de gestos do PWA (theme_color) e a splash (background_color), então o theme_color dos manifestos é branco e o background_color azul (splash azul); o azul da barra de status vem só do <meta name="theme-color">. No modo edge-to-edge a área inferior exposta do documento também é branca, e o azul do fundo fica limitado ao inset superior real. Safari/iPhone e Chrome/Android usam os insets reais em abas e no app instalado: o shell preenche a altura disponível, o menu reserva espaço acima do logo e conteúdo/janelas respeitam os recuos laterais em paisagem. Campos mantêm 16 px também no telefone deitado. No Safari, o teclado acompanha visualViewport somente durante edição, sem confundir zoom ou barras do navegador; no Chrome que já redimensiona o layout não há segundo desconto. A instalação pré-carrega o código de contatos offline e suas dependências, sem carregar telas financeiras ou mapas no boot. Falhas de quota/leitura do Cache Storage não substituem um boot online por dados antigos nem impedem baixar assets; escritas de cache ficam no waitUntil. O diagnóstico de push consulta o registro existente sem esperar uma ativação indefinida.

Estado actual — transições. A navegação lateral e inferior antecipa o código da tela ao receber ponteiro, toque ou foco, respeitando economia de dados; o carregamento ocioso por papel continua como cobertura. O componente principal lê visitas sob demanda ao abrir um registro, sem assinar a lista inteira nem passá-la ao layout. Clientes e serviços são assinados pelo formulário global somente enquanto ele está aberto. Abrir e fechar janelas atualiza os consumidores da pilha, mas o componente principal recebe comandos estáveis e não renderiza por essa mudança de contexto.

Estado actual — relatórios e leituras. Relatórios consulta o período de métricas somente nas abas que usam esse período e calcula apenas a métrica visível (Estatísticas também usa avaliação média); o BI não recalcula fora de Estatísticas. Exportar continua usando o conteúdo da aba exibida. A linha do tempo mantém a consulta compartilhada e a frequência, associando visitas, pessoas e serviços por índices em memória, sem leituras adicionais. Cache continua separado por sessão, com invalidação compartilhada e proteção de versões nas gravações.

Estado actual — conectividade e lentidão. Offline vem do navegador ou do plugin nativo, nunca de um timeout ou erro isolado da API; o ping sem cache recupera indicadores offline desatualizados e é compartilhado entre chamadas concorrentes. Leituras, inclusive o boot, tentam a API mesmo quando o aparelho informa offline; resposta em cache não comprova conexão. O aviso de respostas demoradas exige três leituras bem-sucedidas de pelo menos 5 s entre as cinco últimas em 30 s; duas rápidas ou 30 s sem amostras limpam o aviso. Uploads, cancelamentos, erros e chamadas que atravessam segundo plano não contam. Problemas permanecem na faixa do shell, sem toasts duplicados; a barra exige 4 s contínuos offline em primeiro plano, reiniciados na retomada, e a recuperação só mostra toast se a barra chegou a ser exibida.

A leitura fiscal das faturas e dos saldos de correção resolve visitas pelos identificadores vinculados, usando a chave primária em vez de varrer o histórico para cada documento; preserva a coorte completa de uma fatura agrupada antes de repartir centavos. Erros encadeados preservam a mensagem sanitizada da causa do banco, inclusive quando os campos de Error não são enumeráveis.

As atualizações parciais consultam faturas e listas visíveis em paralelo, aguardando ambas antes de repetir uma falha; atualizações completas continuam terminando o boot antes de invalidar as consultas. Respostas HTTP da API incluem Server-Timing: api;dur=… para medir o processamento no servidor separadamente do transporte; upgrades WebSocket permanecem intactos.

A atualização entre aparelhos usa um relay de invalidações no Durable Object existente, separado dos canais de conversa por nome e host. A fonte continua sendo D1 pelas APIs com escopo de sessão; o socket transporta somente revisões por domínio. O novo sincronizador não adiciona polling de D1 por tela numa conexão saudável. Publicar essa mudança exige primeiro o Worker (deploy:backend) e depois o app (deploy:web).

O Prime Crown é uma plataforma SaaS full-stack para gestão de limpeza residencial de alto padrão. A interface React possui três runtimes suportados: navegador/PWA e aplicativos Android/iOS empacotados com Capacitor. Todos consomem o mesmo backend Cloudflare e compartilham componentes, stores, tipos e regras de negócio.

No fluxo nativo de notificações, somente os proxies críticos de Push Notifications e Preferences ficam no bundle inicial. Assim, Subscribe chama o bridge nativo sem depender de baixar chunks pela rede depois do toque; App.getInfo() é enriquecimento best-effort posterior e carrega @capacitor/app sob demanda, reutilizando a promise e liberando retry após falha. Os timeouts restantes cobrem chamadas nativas realmente travadas.

Se a autorização do Android já estiver concedida, mas não houver token local nem registro no backend, Subscribe não espera um novo diálogo do sistema: lê o token já emitido diretamente do cache/FCM e o persiste na conta autenticada. Timeout de rede ou backend não invalida automaticamente o token Firebase; somente unsubscribe/reset explícito faz essa operação destrutiva.

O Android também registra o plugin nativo NativePushToken, que consulta FirebaseMessaging.getToken() diretamente. Esse caminho é usado antes de aguardar o evento do Capacitor, porque o evento pode não disparar novamente quando o Firebase já possui um token. A inclusão do plugin exige uma nova versão do shell Android.

O mesmo plugin expõe diagnóstico sem revelar o token: autorização global via NotificationManagerCompat, importância dos canais de mensagens e alertas, e prontidão do Firebase. A permissão já concedida é lida diretamente no Android sem aguardar a ponte de push do Capacitor. PrimeCrownMessagingService.onNewToken() persiste o último token em armazenamento nativo e o plugin consulta memória/cache antes de Preferences e de Play Services; assim, um token já emitido não fica preso atrás de uma nova chamada getToken() lenta. O POST autenticado ao backend encerra o caminho crítico, enquanto Preferences e metadados são gravados depois. Login, resume, diagnóstico e Subscribe compartilham uma única reconciliação em voo; unsubscribe/reset limpam o cache nativo junto do token Firebase para nunca regravar um token invalidado. O Profile traduz cada camada em orientação específica. No login e em cada retorno ao app, uma inscrição desejada e autorizada executa reconciliação idempotente com o backend, inclusive quando o token local já existe. android:doctor bloqueia a release se plugin, registro no MainActivity, provider web ou chamadas Firebase/NotificationManager estiverem ausentes.

O POST primário registra ainda o limite inferior de build 10 quando a disponibilidade síncrona de NativePushToken comprova um shell moderno. O renderer avançado existe desde o build 5, portanto essa prova autoriza com segurança FCM data-only mesmo se App.getInfo() falhar. Sem esse campo, o servidor usa deliberadamente o payload legado; com ele, PrimeCrownMessagingService restaura Reply, Mark as read, MessagingStyle e agrupamento estável por conversa.

O botão Check native também executa a reconciliação e sempre mostra um toast conclusivo. Se um token já pertencer a outra conta autenticada anteriormente no mesmo aparelho, /api/native-push-tokens transfere sua propriedade para a sessão atual; manter o dono antigo causaria tanto o limbo de registro quanto entrega indevida de notificações após troca de conta.

O registro primário envia token, plataforma e dispositivo ao backend imediatamente. installId e appBuild são enriquecidos depois em uma segunda escrita best-effort, pois travamento de Preferences/App não pode impedir a criação do destino. O reparo acionado pelo Profile devolve o botão em no máximo 15 segundos; o watchdog mais amplo de Subscribe ainda reserva tempo para um diálogo real de permissão do sistema.

graph TD
    subgraph ClientLayer ["Client Layer"]
        UI["React 19 SPA (Vite)"]
        PWA["Browser / Installed PWA"]
        Android["Android (Capacitor 8)"]
        Platform["Platform Capability Layer"]
        Zustand["Zustand Stores (State)"]
        Query["TanStack Query (Cache)"]
        PWA --> UI
        Android --> UI
        UI --> Platform
        UI --> Zustand
        UI --> Query
    end

    subgraph EdgeLayer ["Edge Backend (Cloudflare Pages Functions)"]
        Hono["Hono Router & Zod Validation"]
        Auth["JWT & Role Authorization"]
        Hono --> Auth
    end

    subgraph StorageLayer ["Persistence & External Services"]
        D1[("Cloudflare D1 (SQLite)")]
        R2["Cloudflare R2 (Media/Audio)"]
        WA["Meta Cloud API"]
        AI["Cloudflare Workers AI"]
    end

    Query <-->|/api/boot & Atomic REST| Hono
    Hono <--> D1
    Hono <--> R2
    Hono <--> WA
    Hono <--> AI
  • npm run build e npm run build:web produzem o mesmo PWA em dist/; o deploy Cloudflare existente não depende do Android.
  • npm run pwa:doctor audita os manifestos principal/chat, ícones, atalhos tipados, service worker, isolamento do boot offline, cache/rotas Cloudflare, associações nativas, acessibilidade do viewport e VAPID. O atalho Live Map aponta para o ViewState compartilhado LIVE_TRACKER e continua sujeito ao mesmo RBAC das demais entradas externas.
  • npm run android:sync produz o build web e sincroniza dist/ com o projeto nativo em android/.
  • src/shared/platform/runtime.ts é a fonte central de detecção do runtime. Componentes não devem consultar diretamente window.Capacitor.
  • O diagnóstico de boot consulta essa mesma fonte e identifica explicitamente Android App, iOS App, PWA instalada e Browser/Desktop. Logs de suporte nunca classificam um shell Capacitor como navegador apenas porque sua WebView não publica display-mode: standalone.
  • Abaixo da faixa suportada (Chrome/WebView 108, Safari 17, Firefox 104) o app não degrada: sem polyfills, a primeira API nova derruba o render (WebView 90 caiu em Array.prototype.at). Um script ES5 inline no index.html identifica os engines conhecidos pelo piso de versão e usa CSS.supports('height', '100dvh') somente como fallback para engines desconhecidos; ele marca data-unsupported-runtime e mostra “Update needed” (no Android: atualizar Android System WebView e Chrome na Play Store). Com a marca, index.tsx não monta o React e registra CLIENT_UNSUPPORTED_RUNTIME_ERROR em System Errors. Como o script roda antes do bundle, cobre também engines que nem conseguem interpretá-lo. Teste: tests/unsupportedRuntime.test.ts.
  • O login Google usa providers por runtime: Google Identity Services/redirect no PWA e @capgo/capacitor-social-login no Android. O seletor nativo devolve um ID token com o OAuth Web Client ID como audience; o token entra no mesmo fluxo de sessão do backend, sem duplicar usuários ou regras de autorização. Somente o provider Google é compilado no aplicativo. A sessão autenticada é revalidada ao retomar o shell nativo, recuperar rede ou voltar a uma aba PWA/browser visível; sinais simultâneos são agrupados em uma única leitura, e retornos anônimos do provider continuam ignorados até a troca do token terminar. Login, redefinição de senha e o fallback do gate operacional seguem 100dvh e a safe area compartilhada, portanto teclado, orientação e barras móveis redimensionam também as superfícies anteriores à sessão. O provider de teclado restaura os insets na pausa além do evento Hide, pois Android/iOS podem ocultar a IME em background sem notificar a WebView; também ignora um Show atrasado enquanto o lifecycle ainda está pausado, para que o retorno não herde o espaçamento do compositor de outra tela.
  • O service worker é registrado na build publicada, inclusive quando ela é aberta pelos shells Capacitor. Android e iOS usam https://app.primecrowncleaning.co.uk como origem remota canônica para preservar as chamadas relativas /api, os cookies HttpOnly, OAuth e o RP ID do WebAuthn; o worker mantém o shell e o último boot disponível em perdas breves de sinal. O boot usa uma chave canônica única, apaga o snapshot em 401/403 e em toda troca de identidade (login, logout e impersonação), inclusive chaves antigas com query string. Essa limpeza avança uma geração no worker: uma leitura antiga que termine após a troca de identidade não consegue regravar nem usar o snapshot da conta anterior. A audiência de push também é revogada em memória antes da escrita Cache Storage e suas escritas persistentes são serializadas; portanto um put antigo não pode restaurar conteúdo privado depois de logout/troca de conta. Na mesma fronteira, o CloudClient aborta leituras, mutações e uploads autenticados ainda em voo, além de recusar replay ou publicação de geração anterior. A limpeza síncrona também restaura as stores de sistema — configurações, regras, área de serviço, logs e badge de erros — antes de outra conta renderizar. Um pushsubscriptionchange do PWA confirma que a audiência persistida ainda coincide com /api/auth/me antes de recriar o endpoint. A gravação inclui esse mesmo proprietário esperado e /api/push-subscriptions compara-o ao reference_id do cookie no instante do POST; divergência retorna 409, portanto uma rotação que atravessa login/logout não pode ligar o endpoint à conta seguinte. Ao abrir a sessão pública, o preload e o controller do login compartilham a única leitura tipada de /api/public/config, evitando duas chamadas simultâneas para descobrir o cliente Google. O dist/ sincronizado pelo Capacitor continua sendo artefato de build, não uma base de dados nativa independente.
  • Atualização no boot: só enquanto o splash cobre a tela (isAppReady falso, dentro de 20 s do carregamento) — em nenhuma outra hipótese que não seja a abertura inicial o app atualiza de forma automática. Ao mudar entre janelas ou em segundo plano, a atualização nunca recarrega automaticamente; a cada troca de página ou sessão e mudança de janela (foco ou retorno à aba), se houver uma nova versão, o app limpa adiamentos e exibe o toast perguntando se o usuário deseja atualizar, para nunca interromper trabalho em andamento. Com o splash ainda na tela, um worker à espera é aplicado por applyNewestWebUpdate (o mesmo do Perfil → About). O toast “Update now”, o boot e o Perfil reconsultam registration.update() antes de aplicar e aguardam a instalação mais nova, promovendo apenas o worker final em uma única atualização. Se a consulta ou a instalação não terminar, a versão antiga não é promovida: a ação permite nova tentativa sem recarregar. Um F5 busca a página na rede, então logo após um deploy a aba já roda a build nova enquanto o worker antigo ainda a controla; o worker novo instala em segundo plano e fica à espera. Esse worker não é atualização para a aba: quando o index.html do seu cache carrega o mesmo script de entrada que a página (sameBuildAdoption, adoptIfThisPageBuild), ele é ativado em silêncio — sem splash, toast nem segundo reload —, e a troca de controlador que ele causa (isAdoptedWorker) não recarrega nem oferece atualização. O boot e o inspect do useAppUpdate passam por essa mesma decisão.
  • As entradas públicas /quote, /pay, /statement, /proposal e /rate usam correspondência de segmento completo. O caminho-base e seus descendentes entram no fluxo público, mas prefixos coincidentes como /payroll permanecem no shell autenticado em web, PWA e WebViews.
  • Fatura, extrato, proposta de horário e avaliação públicas usam system-viewport-safe, cancelam fetches no teardown e bloqueiam POST duplicado antes do próximo render. A avaliação distingue 404 de indisponibilidade/rede, oferece retry real, arredonda stars da URL para 1–5, normaliza o feedback e usa CFInput, Button e IconBadge com alvos touch. Clipboard passa pelo provider nativo/web e só produz feedback depois da confirmação. Sem uma integração PISP credenciada, fatura e extrato mostram dados para Faster Payments manual em vez de simular um redirect Open Banking ou transmitir dados bancários a terceiros.
  • Conciliação bancária e QuickBooks adotam useModalLifecycle: a camada participa da pilha compartilhada de Back/History, recebe z-index coordenado, contém/restaura foco, trava scroll e limita Escape ao modal superior. Safe areas são preservadas; locks síncronos impedem ações concorrentes e o fechamento é recusado enquanto uma operação financeira está em andamento.
  • Pausa de férias e aviso de trânsito compartilham o mesmo lifecycle; férias e trânsito bloqueiam nova ação e fechamento enquanto processam. Pausa de férias usa UUID idempotente e um único UPDATE D1 para todas as visitas elegíveis, portanto retry nativo não duplica e falha SQL não deixa um intervalo parcialmente cancelado. Custódia de chaves usa inventário e trilha D1 reais, nunca exemplos em memória. As observações de acesso do endereço (access_notes) aparecem no detalhe da visita; o antigo «manual da residência» foi removido porque só mostrava dados inventados.
  • UUIDs operacionais do frontend usam createUuid: crypto.randomUUID quando disponível e RFC 4122 v4 sobre crypto.getRandomValues nas primeiras versões do iOS 15. O contrato cobre pedidos/recorrências, clientes/endereço, mensagens/toasts, incidentes, suprimentos, logs, telemetria, idempotência, push, mídia e CSV. O pwa:doctor percorre todo src de produção e impede que Math.random volte a gerar identidade operacional.
  • vite.config.ts substitui o token __BUILD_ID__ do worker por um hash de 12 caracteres calculado a partir do index.html emitido e do template do próprio worker. O arquivo publicado muda em todo release que altera o grafo da aplicação, portanto PWAs e WebViews descobrem builds web-only sem depender de incremento manual de versão; a ativação elimina o namespace anterior.
  • useAppUpdate detecta tanto o evento de instalação quanto um worker que já esteja em registration.waiting ao montar. Ao mudar entre janelas (focus ou primeiro plano), o hook limpa o estado de adiamento e o cooldown para reexibir o toast perguntando se o usuário quer atualizar, além de solicitar registration.update() imediato. Em hipótese nenhuma fora da abertura inicial o app atualiza ou recarrega sozinho. createControllerChangeHandler só recarrega automaticamente se a atualização foi explicitamente acionada nesta janela (isWebUpdating()) ou se ainda estiver no splash de boot; caso contrário, despacha sw-update-available para exibir o toast de confirmação.
  • createPreloadErrorHandler é a única autoridade de recuperação automática de lazy chunks e limita a ação a uma tentativa por sessão a cada 60 segundos. As rotas usam React.lazy sem fallback de reload próprio. Durante o splash inicial, a primeira falha atualiza/promove o worker e recarrega network-first; depois do boot, apenas anuncia a atualização pelo toast e propaga a falha ao ErrorBoundary, que reconhece um chunk sumido com o deploy (isStaleChunkError: as mensagens de Chrome, Safari e Firefox e o preload de CSS do Vite) e, no lugar da parte que falhou, mostra StaleVersionFallback (“A new version of the app is ready” + Update now, applyNewestWebUpdate) em vez da tela System interruption, sem CLIENT_EXCEPTION — ambos no bundle inicial, porque uma cópia lazy poderia faltar pelo mesmo motivo. O próprio toast (AppUpdateBanner, lazy) é buscado no ocioso junto com prefetchPages, para existir quando o deploy chegar; uma repetição propaga para o ErrorBoundary em vez de criar um loop de splash. Storage indisponível desativa a autorrecuperação por segurança.
  • Falhas anteriores ao mount de React usam renderEarlyBootFailure: DOM criado por APIs seguras, mensagem em textContent, sem innerHTML/handler inline, safe areas, role=alert e botão de 48 px com foco. O fallback continua operacional mesmo quando os estilos ou a árvore React não carregam.
  • Falhas posteriores ao mount chegam ao ErrorBoundary: a causa sanitizada vai para a telemetria administrativa e permanece visível/copiável no ErrorFallback, enquanto stack e árvore de componentes ficam restritas ao desenvolvimento. telemetrySanitizer remove query/hash de URLs e redige tokens, JWTs, senhas, cookies, authorization, API keys, credenciais e códigos também em mensagens, stacks e contexto recursivo; ciclos/profundidade e 8.000 caracteres limitam volume. A tela anuncia o erro, foca seu título, adapta ações a telefones e respeita safe areas/modo escuro sem vazar credenciais de reset, OAuth ou deep links.
  • A ingestão /api/atomic/system-logs repete o sanitizer e não confia em userId/timestamp do cliente: autor e horário vêm da sessão/Worker. Zod limita campos/payload, cada conta pode gravar 20 relatórios em 5 minutos e excesso retorna 429 + Retry-After; inserir antes de contar e remover somente o ID recém-inserido fecha a corrida entre requests. GET de admin/manager limita paginação a 1–500, rejeita filtros excessivos e substitui erros internos por mensagens públicas estáveis.
  • Exceções geradas no backend passam por logErrorToSystemLogs, que sanitiza nome, mensagem, stack, causa e objetos circulares antes do D1. Orçamento/chat público, verificação de WhatsApp e envio de fatura devolvem mensagens 500 estáveis, sem propagar mensagens do banco, objetos do Resend ou credenciais de WhatsApp/gateway; detalhes permanecem somente na telemetria sanitizada.
  • Escritas e leituras inesperadamente interrompidas nos CRUDs atômicos centrais passam por atomicServerError: o diagnóstico sanitizado é classificado em system_logs, e todas as plataformas recebem um único contrato de retry. Respostas funcionais 4xx permanecem no endpoint e não são convertidas em falha genérica.
  • Custódia física usa tabelas próprias (key_tags, key_custody_records) e /api/field/key-custody, fora do snapshot de boot para não distribuir dados de segurança a papéis sem necessidade. Apenas ADMIN/MANAGER acessam o endpoint. Cadastro e mudança de posse disparam auditoria por trigger no mesmo statement; estado e versão esperados tornam a transição concorrente condicional e retornam 409 em vez de sobrescrever outro aparelho.
  • Capacidades nativas futuras devem ser adicionadas atrás de providers com fallback web, preservando o PWA como implementação padrão. O stack compartilhado espelha no History cada camada transitória, inclusive drawer móvel, modais, lightbox e detalhes do chat: Back/gesto fecha somente o topo. O sidebar permanente do desktop fica fora do histórico. Uma operação com closeDisabled pode rejeitar o fechamento; nesse caso browser/PWA restauram a entrada consumida, igualando a retenção já aplicada por Android Back e impedindo navegação sob um modal bloqueado.
  • Navegações externas aguardáveis usam openExternalUrl; handlers que não podem aguardar usam launchExternalUrl, que contém e registra falhas do Browser/AppLauncher, aceita callback de feedback e reivindica a URL sincronamente para impedir intenções duplicadas por toque duplo. Sem callback próprio, uma falha produz feedback tátil e toast recuperável. Âncoras mantêm seu comportamento normal na web e são interceptadas somente no nativo. Fotos de evidência usam o lightbox compartilhado, evitando abrir URLs autenticadas em uma sessão externa sem cookies.
  • Exportações de relatório completo, gráficos, usuários, histórico, payslips, faturas e QuickBooks reivindicam um lock em ref antes do primeiro await; o estado React serve somente à apresentação. Assim dois toques no mesmo frame não geram dois PDFs/CSVs nem duas share sheets no PWA, desktop, Android ou iOS, e o lock sempre é liberado em finally.
  • Evidências do checklist mantêm o item ocupado durante todo o ciclo de captura/seletor e upload, inclusive resultados restaurados pelo Android após recriar a WebView. O epoch invalida respostas de outra tarefa/sessão; cancelamento ou revogação de edição permanece silencioso, enquanto falhas reais recebem spinner, toast recuperável e feedback tátil compartilhado. Se Preferences ou o arquivo da foto restaurada não puderem ser lidos, o provider contém a falha, remove o contexto opaco e devolve a superfície restaurada ao estado em que uma nova captura é possível.
  • Mensagens de voz preservam a prévia local até o upload e o envio/agendamento serem confirmados. Um lock síncrono impede dois envios no mesmo frame; falha ou timeout mantém a gravação pronta para retry, enquanto troca de conversa invalida o ticket e limpa somente o estado pertencente ao composer anterior.
  • Texto agendado também permanece no composer até confirmação autoritativa; falha mantém rascunho e menu prontos para retry. O conteúdo só é limpo se ainda for o mesmo snapshot enviado, evitando apagar uma edição mais nova. Agendamento e geração de rascunho por IA possuem locks síncronos e epochs por usuário/conversa.
  • Mídia moderna em R2 usa {clientId}/direct|team/{job?} e aplica o mesmo escopo de linhas de boot/requests no upload, leitura e exclusão. Clientes acessam somente a própria pasta; funcionários precisam enxergar o cliente e estar atribuídos às tarefas team; o par tarefa/cliente é validado inclusive para administradores. Chaves legadas continuam legíveis para conversas antigas, mas somente admin/manager pode criar ou apagá-las. Falhas de R2 recebem contrato estável, e o antigo /api/test-db não integra mais a superfície publicada.
  • NativeBridge integra pause/resume ao focusManager do TanStack Query, trata o botão voltar e converte App Links em intenções de navegação existentes (view, reqId e channelId). O foco do Query exige simultaneamente appStateChange.isActive e document.visibilityState === 'visible': uma retomada Capacitor que chega antes da WebView visível não antecipa refetches. Ao montar, ele reconcilia o estado autoritativo de App.getState() sem emitir uma retomada artificial; um evento de lifecycle mais novo sempre prevalece sobre uma leitura inicial atrasada, e o teardown invalida ambos. No app instalado, toque longo sem seleção não expõe menus de imagem/link da WebView; clique direito físico, modificadores, campos editáveis e texto já selecionado preservam o menu do sistema. Plugins exclusivos do Capacitor são carregados por import() somente após detectar Android/iOS ou iniciar a ação nativa, com uma exceção deliberada: Push Notifications e Preferences permanecem eager porque a recuperação crítica de inscrição precisa funcionar sem buscar outro chunk após um deploy ou perda de rede. Lifecycle, privacidade, status bar, haptics, login social, badge, atualização, teclado, rede, splash, configurações, câmera, localização, clipboard, navegador externo, filesystem e share sheet continuam sob demanda. appInfoProvider adia App.getInfo() até a aba About; o enriquecimento de push também reutiliza o mesmo módulo dinâmico somente depois que o destino já foi registrado. Providers de listeners preservam cleanup síncrono por contrato e descartam/removem registros que resolvam depois da desmontagem. Arquivos temporários compartilhados usam um subdiretório exclusivo por entrega, preservam o nome visível e são apagados do cache nativo em finally; exportações simultâneas com o mesmo nome não se sobrescrevem. Ele já fica ativo durante carregamento e login; uma intenção recebida antes da sessão/boot é preservada e retomada depois da autenticação, pela mesma validação RBAC usada para mensagens do service worker. Retomada nativa e recuperação da rede também reconciliam boot e canais de chat; PWA usa os eventos equivalentes do navegador, com limiares/deduplicação para não repetir chamadas. O socket de um chat é aberto depois do snapshot de histórico, e o snapshot preserva rascunhos locais ainda sem confirmação por externalId; assim uma mensagem criada durante a troca de canal, retorno do background ou rede lenta não desaparece antes do catch-up autoritativo.
  • Cada entrada interna do History API carrega pcView e pcDepth. Assim reload restaura a tela, Back reduz para a profundidade gravada e Forward a recupera — inclusive antes do botão Voltar do Android decidir entre navegar e encerrar o app. Na restauração de uma nova identidade, a tela persistida passa novamente por RBAC para não herdar um módulo administrativo da sessão anterior.
  • O teardown também cobre inicializações tardias do push no NativeBridge; falhas assíncronas de App lifecycle, teclado e rede são contidas e observáveis no console, sem rejeições globais nem listeners órfãos após troca de sessão/remount. Callbacks de push invalidam-se sincronamente antes da remoção assíncrona dos handles, portanto eventos já enfileirados não persistem token, exibem mensagem nem navegam após desmontagem/troca de sessão. O cache e transportes de chat usam a mesma fronteira para ID, função e entidade vinculada: uma revalidação que reduz a audiência não deixa histórico do escopo anterior visível até o próximo fetch. Callbacks de teclado já enfileirados verificam a atividade antes de alterar safe areas, portanto não conseguem reabrir o layout depois que o bridge restaurou o estado sem teclado. A recuperação de câmera também usa geração por callback: um cancelamento restaurado vence uma foto anterior ainda em leitura, que não é entregue a nenhum destino.
  • A recuperação de câmera também serializa a escrita/leitura/remoção do marcador único em Preferences. O resultado restaurado só remove o seu próprio marcador; se uma nova captura já o substituiu, a limpeza antiga falha fechada e a nova Activity ainda pode ser recuperada.
  • initializeNativePush registra seus quatro listeners como uma transação. Falha intermediária, leitura de permissão ou registro APNs/FCM executa rollback dos handles já criados; o teardown normal tenta remover todos com allSettled, evitando que um erro de plugin impeça os demais cleanups.
  • Atualização flexível Google Play também possui rollback: falha ao iniciar remove o listener recém-criado, e download concluído/cancelado/falhou converge por cleanup idempotente. A conclusão aceita somente o primeiro evento DOWNLOADED, impedindo chamadas concorrentes a completeFlexibleUpdate() quando o Play repete o estado. Erros de conclusão ou remoção não escapam como rejeição global; iOS mantém apenas a abertura da ficha oficial na App Store.
  • O Android declara https://app.primecrowncleaning.co.uk/* e primecrown://*. src/shared/platform/androidAppLinks.ts mantém os certificados da upload key e da app signing key do Google Play; a rota functions/.well-known/assetlinks.json.ts publica esse contrato mesmo quando o Pages ignora diretórios estáticos ocultos, e public/.well-known/assetlinks.json é o fallback do build. Assim, App Links permanecem verificados em builds locais assinados e nas instalações distribuídas pela loja.
  • Ícones legacy/adaptativos e splash screen usam a mesma coroa azul do manifesto PWA. O foreground adaptativo permanece dentro da safe zone do Android para suportar máscaras diferentes dos launchers.
  • Push compartilha notificationPermissionProvider entre onboarding e preferências, normalizando consulta, solicitação e observação no PWA, Android e iOS sem duplicar fluxos de UI. A Permissions API e o listener com cleanup ficam no provider; Android/iOS revalidam no resume. Leituras sobrepostas de saúde disparadas pelo provider global, Perfil, evento de token e retomada compartilham um singleFlight por modo habilitado/desabilitado; uma sessão impersonada nunca herda o voo da sessão normal. No Perfil, autorização/token/assinatura recebem tickets latest wins, e o diagnóstico Android é coalescido por usuário e confere o epoch antes de cada commit/finalização; logout não recebe estado tardio do plugin. A ação manual Check native possui ainda lock síncrono próprio e revalida owner/lifecycle depois de registro, refresh e diagnóstico, bloqueando toque duplo e toast de uma conta anterior. A lista de dispositivos usa um singleFlight keyed com passe final: uma rajada de mudanças não aborta/reabre cada request, mas a intenção mais recente roda uma vez depois da leitura atual para observar eventual token recém-registrado. O AbortSignal do lifecycle ainda interrompe imediatamente o transporte no logout/troca de conta. Ativar ou desativar invalida imediatamente checks em voo e publica o resultado autoritativo, impedindo que um refresh atrasado restaure “Subscribed”. Web Push/VAPID atende browser/PWA, FCM atende Android e APNs atende iOS; tokens nativos são registrados em native_push_tokens por /api/native-push-tokens. O ID estável da instalação é criado por uma única operação compartilhada mesmo quando callbacks de token chegam em paralelo, e os imports dos plugins Preferences/Push também são deduplicados; assim um aparelho não ganha duas identidades durante o mesmo boot. O POST de registro usa AbortSignal e é cancelado no teardown; enquanto estiver em voo, seu token permanece disponível somente ao cleanup de logout, que consegue removê-lo mesmo antes da persistência local. Antes do logout, o endpoint Web Push ou token nativo é removido da conta enquanto o cookie ainda é válido e a inscrição local é encerrada; cada etapa tem limite de três segundos para nunca bloquear a saída offline. O alvo capturado também segue no corpo de /api/auth/logout, que repete a exclusão no mesmo request que revoga a sessão e sempre a restringe ao reference_id do JWT, cobrindo timeout entre as duas chamadas sem remover outros aparelhos. O estado da autorização e a lista de dispositivos são relidos ao retornar das Configurações nativas. O marcador da identidade autorizada do Service Worker vive em cache estável, separado do cache versionado do bundle: uma atualização não faz o worker descartar pushes válidos enquanto o app está fechado, e logout ainda remove o marcador. Chat Android usa MessagingStyle com avatar de iniciais, Reply + Mark as read e shortcut de Conversations; iOS usa alerta APNs agrupado; a PWA aproxima o mesmo fluxo (stack, avatar SVG, ações). Recebimento em foreground alimenta os mesmos toasts/histórico e o toque converte data.url pela navegação nativa validada.
  • No Android, a limpeza de logout/troca de conta remove também os atalhos dinâmicos de Conversations associados às threads persistidas; nomes, avatares e deep links da conta anterior não ficam expostos pelo launcher.
  • A conversa visível só é espelhada em Capacitor Preferences quando isNativePlatform() confirma Android/iOS. Browser, PWA e desktop mantêm o valor apenas em memória e não executam nem solicitam a ponte nativa ao abrir o chat.
  • A paleta global e SearchIntelligenceService formam uma fronteira lazy do layout autenticado. O atalho Ctrl/Cmd+K publica imediatamente um status modal enquanto o chunk é solicitado e só então monta busca, índice e folha adaptativa; usuários que não abrem a pesquisa não pagam esse código no shell inicial.
  • Atalhos da tela e globais no Cmd/Ctrl+K (2026-10-08) — só as funções principais. A paleta abre com This page: poucos comandos da tela visível, registrados por usePageCommands (src/shared/hooks/usePageCommands.ts, uma store pequena com um dono por componente montado, que sai ao desmontar; no máximo cinco antes de digitar). A PageTabBar registra só as ações do More (Export, Reconcile…), nunca cada aba, e as pílulas de filtro não registram nada; o Dashboard registra Today e, quando há, Today · Late e Today · No team; o Full Schedule registra Today, semana anterior/seguinte e o mapa do dia. O comando chama o handler mais recente da própria tela. Depois vêm os globais (useGlobalCommands, src/components/globalCommands.ts): antes de digitar só New visit, New client, New lead (abrem o formulário da People pela personToCreate) e as telas Today, Full Schedule, Messages, People e Billing; digitando, aparecem também New staff member e qualquer tela do menu (NAV_STRUCTURE filtrada por canRoleAccessView, mais Settings, sem a tela atual), achadas pelo rótulo no idioma do usuário ou pelo nome da tela (“billing”, “chat”, “payroll”). Por último clientes, equipe e visitas (SearchIntelligenceService), só com algo digitado.
  • Ações rápidas por registro no Cmd/Ctrl+K (2026-11-03). A busca acha pessoas (clientes, leads ainda não convertidos, equipe), visitas pela referência (T26-0042, t26 0042, 26-42, 0042 — taskNumberFromCode e as letras/dígitos da referência, a partir de três caracteres com um dígito) e invoices emitidas pelo número (PC26-0001, pc260001, DEP26-; nunca um rascunho; só o escritório). Para ADMIN/MANAGER, Enter num registro não sai da busca: abre a lista do que dá para fazer com ele (recordActions, src/components/search/recordActions.ts); Esc ou Backspace vazio voltam aos resultados. Pessoa: Abrir cadastro, as ações do cabeçalho do perfil na mesma ordem (profileActions; nunca Deactivate/Delete; Call só com número; Message nunca no próprio cadastro; a regra de staff do administrador é staffActionAllowed, a mesma do perfil) e as seções (Visits, Invoices, Pay…). Visita: Abrir, Finish visit quando a janela da visita oferece (finishVisitOffered), Edit task enquanto visitEditScope permite, a conversa da visita, o cadastro do cliente e a invoice viva. Invoice: Abrir (o Billing abre a janela da invoice via invoiceToView), Copiar link de pagamento enquanto devida (copyInvoicePayLink, o mesmo texto do cadastro), as invoices do cliente e até três visitas dela. Cada ação leva à tela dona dela — a People recebe personToView com tab/action e o perfil roda o handler do próprio cabeçalho uma vez; a visita recebe requestToView.edit e abre com o Edit task por cima — nunca uma cópia. Cliente e equipe continuam abrindo o registro direto. Cada ação tem uma letra fixa com ⌥/Alt (ACTION_SHORTCUT em recordActions.ts, mostrada à direita da linha como ⌥F no Mac e Alt+F fora dele): O abrir, F Finish visit, E editar (Edit task ou o cadastro), M mensagem ou a conversa da visita, C ligar ou o cliente, I invoice(s), P link de pagamento ou Pay, V visitas (numa invoice, a primeira), e as raras depois (B book, Q quote, A advance, R reativar, L email, H holiday, N app link, W tornar cliente, G merge, S acesso, K keys, T history); nunca a mesma letra duas vezes numa lista. A letra roda a ação dentro do registro aberto ou direto no resultado destacado da busca (T26-0042 + ⌥F finaliza sem abrir as ações). A tecla é lida por code (no Mac ⌥F digita “ƒ”); uma letra sem ação segue para a digitação (a busca ignora acentos, então “Jose” acha “José”).
  • Registro aberto, recentes e a lista de atalhos (2026-11-03). Cada janela que mostra um registro ao escritório — a da visita (ServiceDetailsModal), o perfil (PersonProfile/StaffProfile) e a da invoice (InvoicePreviewModal) — se registra com useOpenRecord (src/components/search/openRecords.ts), dizendo qual registro é e quais ações ela mesma executa: Edit task e a conversa na visita; cada ação do cabeçalho e cada aba no perfil (profileRecordActions); Open, nada. O registro aberto é a janela do topo que tem o foco (currentOpenRecord): uma janela aberta por cima dela (Edit task, uma confirmação) toma o foco e as letras não chegam ao registro de baixo. Com isso: ⌘K aberto sobre um registro já mostra as ações dele (o MainLayout lê o registro antes de a busca pegar o foco; Esc volta à busca); ⌥/Alt + letra funciona dentro da janela sem abrir a busca (RecordShortcuts, lazy, só escritório e computador, nunca num campo de texto) pelo mesmo executor da busca (useRecordActionRunner), que usa o handler da janela quando ela tem um. Os últimos registros abertos (por janela ou escolhidos na busca, até 5 mostrados) aparecem antes de digitar, como Recent — só na memória da sessão, nunca gravados. O cliente ganhou duas ações logo depois de Abrir: Próxima visita (⌥X; a regra da aba Visits, isUpcoming) e Invoice em aberto (⌥P; a devida há mais tempo). ? fora de um campo, ou “Keyboard shortcuts” na busca, abre a lista de atalhos (ShortcutsSheet), lida da mesma tabela das ações (SHORTCUT_GUIDE).
  • Busca além da janela do boot (2026-11-03). O boot traz todos os clientes, leads e equipe ao escritório, mas só a janela operacional de visitas e invoices; o resto não entra na memória. Quando o texto digitado é um código (três caracteres ou mais com um dígito) e a memória não o responde exatamente, o Cmd+K pergunta a GET /api/search?q= (functions/api/search.ts, só ADMIN/MANAGER) depois de 250 ms sem digitar (useRemoteRecords, TanStack Query: a busca nova aborta a anterior, cada resposta vale um minuto). O servidor procura visitas pela referência — uma referência inteira é uma busca exata no índice único de task_number, uma sequência solta (0042) é a mesma busca em cada ano desde 2020 (taskNumbersFor) — e invoices emitidas pelo número em qualquer grafia (PC26-0001, PC-2025-7, pc260001; nunca rascunho), até oito de cada, em linhas curtas que a busca já lê. Elas se somam à lista da memória só dentro da busca (nunca nas stores) e passam pelo mesmo matcher e pelas mesmas ações (recordActions); enquanto as ações de um registro do servidor estão abertas, a palette guarda o que ele encontrou. Uma visita fora da memória abre pelo Dashboard, que a lê em /visits/:id/admin; uma invoice, pelo Billing, que a lê em /atomic/invoices?id=.
  • O gate completo de instalação/permissões é solicitado apenas para sessões EMPLOYEE/MANAGER, as únicas sujeitas ao fluxo operacional; um fallback bloqueante e anunciado impede exposição momentânea do app antes da verificação. As instruções detalhadas de GPS negado formam outra fronteira lazy e só são baixadas quando o modal realmente abre. Clientes e administradores não carregam esses módulos no shell comum.
  • Login, redefinição e troca obrigatória de senha são fronteiras lazy independentes do shell autenticado. Ao detectar uma sessão anônima, o chunk de Login e a configuração pública cacheável começam em paralelo; somente o chunk participa do bloqueio visual, enquanto Google reutiliza a resposta aquecida ao montar. Login/redefinição preservam um carregamento de página integral; a troca obrigatória só é solicitada quando mustChangePassword está ativo e usa fallback bloqueante, portanto nenhum conteúdo protegido fica momentaneamente utilizável. O aviso de atualização também só entra no bundle quando precisa ser exibido.
  • Recursos contínuos do shell são separados por função: rastreamento e recuperação de permissão GPS são carregados somente para EMPLOYEE; diagnóstico periódico do WhatsApp somente para ADMIN/MANAGER. O diagnóstico administrativo relê o estado ao voltar do background e descarta respostas tardias depois do logout/desmonte. Clientes não baixam nem inicializam nenhum dos dois fluxos.
  • NativeBridge é carregado somente quando o runtime confirma Capacitor Android/iOS; launch URL, App/Universal Links, Back, câmera restaurada, lifecycle, teclado, rede, privacy screen e push permanecem nessa fronteira. A política leve de menu contextual foi separada em InstalledContextMenuGuard, preservando o toque longo de PWA/WebView sem fazer browser, PWA ou desktop baixarem os serviços nativos.
  • O pull-to-refresh do shell é uma fronteira lazy ativada somente quando maxTouchPoints ou (pointer: coarse) confirma entrada touch. Desktop sem toque não baixa o controller, indicador, hápticos ou soft refresh e não registra listeners; PWA/Android/iOS e desktops híbridos mantêm o gesto. Chat continua dono de seus scroll roots e o hook compartilhado recusa listeners em runtimes sem touch. Um toque que começa numa faixa de abas ou na barra fixa de página ([data-page-bar], a PageTabBar) não arma o gesto, e o disco nasce logo abaixo dessa barra (ShellPullToRefresh mede onde ela termina), nunca por trás dela.
  • networkProvider multiplexa conectividade em todas as plataformas: Android/iOS compartilham um listener do plugin Capacitor e browser/PWA/desktop compartilham um único par online/offline, mesmo com layout, update checker e fila de chat ativos simultaneamente. Inscrições repetidas mantêm referência própria e a ponte é removida somente quando o último consumidor sai. Falha transitória anterior ao registro nativo recebe apenas duas novas tentativas compartilhadas (1 s/3 s); o último disposer cancela o timer, evitando polling de fundo. Falha isolada do snapshot inicial conserva o listener vivo, sem abrir outro handle. Se IndexedDB estiver indisponível, o composer preserva a bolha como failed recuperável — nunca a apresenta como fila durável nem a deixa presa em sending.
  • A sincronização do badge do ícone é uma fronteira lazy por capacidade: sempre ativa no Capacitor e, na web, somente quando setAppBadge/clearAppBadge existe. Desktop sem Badge API não baixa hook/provider nem agenda escritas inúteis; Android, iOS e PWAs compatíveis preservam fila serializada, coalescing do valor mais recente e limpeza autoritativa no logout/troca de conta.
  • Sem rede, nenhuma tela de erro do navegador: public/offline.html (autônoma, script ES5, inglês com pt-BR pelo idioma do aparelho) é o fallback do service worker para uma navegação sem shell em cache e o server.errorPath do Capacitor nos apps (vai no bundle nativo, então só chega com um release nativo). No Android ela também aparece num status HTTP de erro do frame principal. “Tentar de novo” e o evento online recarregam o endereço que falhou, ou voltam a / quando a página foi aberta como /offline.html.
  • O monitor de conectividade permanece no shell, mas o componente visual OfflineBanner é solicitado somente na transição para offline. Um fallback leve com role=status, live region e a mesma promessa honesta aparece imediatamente enquanto o chunk chega; sessões sempre online não baixam ícone/componente de indisponibilidade.
  • Preferências síncronas do shell usam uiPreferenceStorage: localStorage continua sendo a persistência de UI, mas leitura, escrita e remoção possuem fallback em memória. Safari privado, iframe sandboxed e WebViews com storage restrito não derrubam o primeiro render nem os toggles de háptico e notificações do chat; a escolha permanece funcional durante a sessão mesmo sem persistência disponível, e o serviço tátil lê o mesmo valor exibido pela tela.
  • O primeiro POST do token devolve a identidade no header X-Prime-Crown-Registration-Owner; o enriquecimento assíncrono de instalação/build reenvia esse valor como expectedUserId. A API retorna 409 antes de tocar o banco se o cookie já pertencer a outra conta, impedindo que metadata atrasada depois de logout/login reassocie silenciosamente o aparelho. O header evita ler o corpo no caminho crítico, e um registro explícito da nova sessão continua autorizado a mover o token.
  • Gravações e remoções do token em Preferences usam uma fila única. Cada save captura uma geração; rotação, recovery e logout invalidam tarefas antigas antes de tocar o bridge. Se uma gravação já começou, a remoção aguarda seu término e executa por último, portanto uma persistência best-effort nunca recria o token depois da limpeza.
  • A limpeza de logout suspende o registro nativo no próprio limite síncrono da autenticação, antes de qualquer leitura assíncrona de Preferences, e aborta tanto o POST primário quanto o enriquecimento tardio de token ainda em voo. unregisterNativePush também suspende os dois callbacks de registration (bridge global e listener temporário). Eventos FCM/APNs enfileirados depois da saída não repopulam memória nem POSTam; o token continua disponível exclusivamente para o request autenticado de cleanup. Uma chamada posterior a ensureNativePushRegistration ou recovery remove a suspensão para a nova sessão.
  • Resultados restaurados da câmera usam consumo único por contexto opaco. O primeiro observer correspondente reivindica o arquivo; observers duplicados não repetem upload, e a entrega em microtask verifica novamente se o destino segue montado antes de chamar chat/checklist/evidência.
  • O provider permite uma única Activity de câmera por vez em toda a WebView, evitando que toques/superfícies concorrentes sobrescrevam o contexto persistido. O checklist complementa isso com lock síncrono, aria-busy e ticket de owner; um retorno direto só faz upload se usuário e item ainda forem os mesmos.
  • Captura operacional de fotos passa por cameraProvider: PWA usa o input com câmera traseira, enquanto Android/iOS usam a API atual Camera.takePhoto com orientação corrigida, limite de 1920 px e arquivo temporário fora da galeria. Cancelar retorna null; falhas de captura continuam distintas. O fluxo não depende mais do Camera.getPhoto depreciado e permanece pronto para a próxima geração do plugin Capacitor.
  • Localização diferencia permissão recusada, precisão aproximada e serviços globais desligados. Os códigos nativos OS-PLUG-GLOC-0007/0017 recebem orientação própria; Android abre diretamente Location Settings, enquanto iOS mantém o caminho manual suportado por App Review. Retomar o app revalida permissão e precisão sem reinício.
  • O gate operacional usa esse mesmo provider para consultar e solicitar permissão; Android registra FCM, iOS registra APNs e o PWA mantém Notification.permission e a assinatura Web Push. No nativo, inclusive o primeiro POST do token carrega o reference_id da identidade React que o iniciou; o Worker rejeita se o cookie já representar outra conta. Assim abort local e validação no servidor cobrem a troca rápida de logout/login sem reatribuir o aparelho ao novo usuário.
  • A detecção de aplicativo instalado confia em display-mode, navigator.standalone, TWA ou Capacitor, nunca em parâmetros de URL. O beforeinstallprompt capturado antes do React é mantido por um provider tipado e descartado após instalação/consumo, impedindo que uma aba comum contorne o onboarding ou ressuscite um prompt já utilizado.
  • Sons de interface e o teste obrigatório do onboarding compartilham um único AudioContext. O motor aguarda a retomada autorizada pelo gesto e informa se o tom foi realmente agendado; a confirmação não é persistida quando Web Audio está bloqueado ou indisponível, e o teste não cria/fecha contextos extras no Safari/iOS ou nas WebViews.
  • Após uma recusa, o gate e o modal de rastreamento reutilizam nativeSettingsProvider para mostrar o caminho e abrir diretamente as configurações do aplicativo no Android; o PWA preserva as instruções de permissões do site e não carrega uma ação nativa.
  • As páginas públicas /privacy, /terms e /account-deletion são compartilhadas pelo PWA, Android e ficha da Play Store. Profile → About reúne informações técnicas da versão e, num bloco discreto chamado Legal, Privacy, Terms e a exclusão da conta. O pedido torna a conta inativa imediatamente, registra prazo de 30 dias e avisa administradores; o fluxo público continua acessível sem instalar ou autenticar no app.
  • public/store-assets/ mantém os recursos editoriais reutilizáveis da ficha Google Play. O banner 1024×500 segue a identidade dos ícones PWA/Android; public/store-assets/screenshots/ contém capturas do runtime real para telefone (1080×1920), tablet de 7 polegadas (1280×720) e tablet de 10 polegadas (1920×1080). Antes de publicar, revise as imagens para impedir exposição de dados pessoais ou operacionais.
  • src/shared/platform/cameraProvider.ts usa @capacitor/camera apenas no runtime nativo. Evidências, checklist e chat recebem um File comum e mantêm os inputs capture="environment" como fallback no PWA.
  • Consulta e solicitação da permissão de câmera usam o mesmo provider: Capacitor no Android/iOS e Permissions API + getUserMedia no navegador/PWA/desktop. O stream web de prova é encerrado assim que a permissão é confirmada; browsers sem consulta padronizada preservam estado unknown e continuam com o input nativo como fallback.
  • src/shared/platform/locationProvider.ts centraliza posição, permissão, observação e watch. Android usa @capacitor/geolocation com localização precisa e intervalos compatíveis com bateria; navegador/PWA preserva navigator.geolocation e observa a Permissions API quando disponível. Watches aceitam AbortSignal: desmontar bloqueia callbacks imediatamente e, se o ID nativo ainda estiver pendente, limpa-o assim que o plugin responder; cleanup é idempotente e falhas de remoção são contidas. useRealTimeTracker só lê a permissão e pede acesso; não abre watch. Um ponto automático só existe quando chega o aviso de check-in ou de check-out (useNoticeLocationCapture). useGeoPermission inicia observadores de câmera/localização em paralelo e usa commits latest wins: uma consulta lenta de mount/resume nunca sobrescreve leitura ou evento mais novo, e teardown invalida toda resposta pendente. O gate móvel agrupa câmera, localização e notificações em uma reconciliação singleFlight, e aplica outra à leitura de precisão GPS; focus, app-resume, visibilidade e evento FCM simultâneos reutilizam o trabalho já iniciado. O perfil aplica a mesma coalescência às permissões e converte falha de bridge em unknown, sem unhandledrejection. Gate móvel, perfil e rastreamento não consultam APIs web diretamente: nativo revalida no resume, PWA reage também à mudança de permissão e todos limpam seus listeners ao desmontar.
  • O canal de atualização da loja usa nativeUpdateReconciler: sinais concorrentes de mount/resume compartilham a leitura em andamento e colapsam a rajada em no máximo uma consulta final. Se uma repetição já estiver pedida, o resultado intermediário não chega à interface; uma falha intermediária também pode ser substituída pela tentativa final. Isso reduz bridge, rede e bateria sem permitir que uma resposta antiga da Play Store/App Store apague a disponibilidade mais nova, e resultados pendentes são invalidados ao desmontar. O service worker continua sendo um canal independente em todas as plataformas, inclusive dentro dos shells nativos.
  • O evento beforeinstallprompt é tratado como recurso de uso único tanto no convite opcional quanto no gate operacional dos funcionários. Uma trava síncrona impede dois toques antes do render; prompt() e userChoice são aguardados, aceite confirma com háptico, recusa encerra a oferta e falha troca para instruções manuais sem rejeição não tratada. Troca de usuário/tela invalida respostas tardias, e indisponibilidade de storage não impede dispensar o convite.
  • No gate operacional, solicitações de GPS, câmera, notificações e som possuem singleFlight independente, portanto toques simultâneos compartilham uma única chamada ao sistema sem bloquear permissões diferentes. O epoch acompanha o ID autenticado e impede que diálogo, posição, registro push ou teste de áudio iniciado por um funcionário altere o estado de outro após logout/impersonação. A troca de identidade reinicia a leitura autoritativa de GPS, câmera e notificações em checking antes de liberar etapas.
  • Captura de evidência mantém lock desde a abertura da câmera nativa até o fim do upload, com nome/busy acessível e remoção bloqueada durante a operação. O epoch inclui usuário, cliente, escopo, job e superfície; troca de serviço ou usuário descarta o retorno. Se o serviço ficar somente leitura, o upload é abortado e uma conclusão antiga não adiciona mídia. A confirmação também revalida o limite atual, enquanto falhas de câmera/rede aparecem na própria zona e cancelamento nativo permanece silencioso.
  • Checklist e chat aplicam a mesma fronteira de autorização ao retorno da câmera e do seletor. Perder edição/clock-in invalida a captura e aborta uploads de checklist; foto restaurada só entra se o item ainda for editável. No chat, um lock cobre câmera → entrega ao uploader, desabilita anexos/composer e descarta retorno se canal bloqueou ou já iniciou outro upload. Mudança de canal/usuário limpa o estado, falha de câmera gera toast e cancelamento não gera erro.
  • Aplicação de atualização usa um singleFlight compartilhado entre ação manual e auto-apply. O banner possui lock síncrono antes do próximo render, desabilita defer/dismiss durante a ação e vincula falha/loading à fonte web, Play ou App Store que iniciou o fluxo. No Android Flexible Update, a Promise permanece pendente durante download e instalação: cancelamento encerra sem falso erro, falha rejeita para oferecer nova tentativa e DOWNLOADED somente conclui após completeFlexibleUpdate(). Eventos repetidos não instalam duas vezes e o listener é removido mesmo quando o evento chega antes do handle assíncrono. Na atualização web, falha ao ler o registro ou enviar SKIP_WAITING em uma WebView restrita converge por reload imediato; o overlay não fica aguardando um evento que não pode chegar. No Safari e iOS/iPhone, o fluxo limpa o Cache Storage (preservando apenas a audiência de notificações) antes de promover e recarregar, impedindo que o WebKit reutilize shells em cache. Atualizações web aplicam automaticamente via splash de atualização (SystemScreen) quando o usuário não estiver em edição ativa (canSilentlyApplyWebUpdate), ou na costura de mudança de tela (handleNavigate), preservando a tela de destino em stagedUpdateView. A verificação de atualização aguarda o worker em instalação (registration.installing) transicionar para installed/waiting antes de concluir a disponibilidade, evitando falsos negativos. Boot, navegação e About usam applyNewestWebUpdate (update() + espera de até 3 s + 3 s, abaixo do failsafe de 8 s). O toast usa applyAdvertisedWebUpdate para não enfileirar outro waiting no tap. controllerchange cancela o reload de 2,5 s. O inspect do hook sincroniza swUpdate com registration.waiting (incluindo “não há”) e um evento novo invalida um inspect vazio ainda em voo.
  • Ações destrutivas do painel de manutenção usam um único proprietário por lifecycle. Logs, mídia em memória e reset travam antes de abrir a confirmação, desabilitam os controles pares, aguardam a operação efetiva sem setTimeout decorativo e descartam finalizações depois do teardown; o reset expõe o mesmo loading acessível das demais plataformas.
  • Histórico de push e lista de canais também são particionados pelo lifecycle da identidade. Logout, login de outra conta e impersonação limpam a projeção imediatamente e invalidam buscas anteriores; retomadas concorrentes usam latest wins. A lista, o push e as ações de uma funcionária conferem também a alocação atual da tarefa — channel_participants é apenas projeção de push/leitura — para que uma linha obsoleta nunca revele prévia, cliente, horário ou conteúdo de um JOB removido, nem permita pedir sua reabertura. No chat, até a remoção das proteções locais de “já lido” só ocorre no commit vencedor, impedindo uma resposta da conta anterior de alterar badges da próxima sessão.
  • O ServiceProvider (src/context/ServiceContext.tsx) não expõe valor de contexto: ele só aninha os providers e roda o coordenador de boot, que hidrata as stores por getState() e publica o status em appStatusStore. Componentes leem stores e query cache diretamente; não existem mais o agregado useServiceContext nem os wrappers useRequests/useEntities/useSystem/usePayroll. Hooks de operação selecionam só os campos que usam (useXStore(useShallow(...))); o SystemProvider guarda apenas o efeito de tema e o estado de instalação PWA (usePWAInstall); as ações de folha (usePayrollActions) rodam no usePayrollController, seu único consumidor.
  • O /api/boot segue o mesmo boundary no ServiceContext: cada mount, retry ou refresh de foco/rede propaga AbortSignal por DataService e CloudClient (inclusive durante backoff) e só hidrata stores/query cache se a identidade ainda for a proprietária. Sinais simultâneos de resume, visibilidade e rede da mesma conta compartilham uma única leitura por singleFlight; uma ação posterior, troca de conta ou retry continua podendo substituir/cancelar o trabalho correspondente. A lista de canais usa a mesma coalescência por usuário, inclusive entre carga inicial e retomada. Logout também impede que um 401 tardio do boot antigo acione reload na tela pública.
  • CloudClient aplica limites por padrão a toda a superfície compartilhada: GET e refresh de sessão encerram em 8 segundos, POST/PUT/PATCH/DELETE em 15 segundos e multipart em 60 segundos para acomodar mídia em rede móvel. Todos aceitam cancelamento e propagam o sinal por refresh e espera de retry. Somente leituras recebem repetição automática: uma mutação com falha ambígua de rede ou 5xx não é reenviada pelo cliente, pois o Worker pode já tê-la aceitado; operações recuperáveis usam a respectiva chave de idempotência. Corpos 4xx de escrita continuam disponíveis ao consumidor.
  • Mensagens em tempo real usam um epoch de sessão sincronizado durante o render. Fetch inicial/paginação, polling, catch-up, eventos WebSocket e flush offline verificam o ticket antes de publicar ou enviar o próximo item. Troca de conta fecha sockets, intervals, reconnects e timers de typing, limpa projeções; onclose só manipula a própria instância, portanto um socket antigo não remove nem ressuscita o novo.
  • Todo push emitido por sendPushToUser recebe recipientUserId no payload criptografado Web Push e nos dados FCM/APNs. Service worker e bridge preservam o carimbo; a UI rejeita recebimento, badge/read e navegação que não correspondam à sessão ativa. Effects de preferências/banner e timers de toast usam epoch, cobrindo eventos em trânsito durante logout ou impersonação.
  • Fotos nativas são capturadas pela câmera traseira, corrigidas quanto à orientação, limitadas a 1920 px/qualidade 85 e mantidas fora da galeria antes do upload R2. O Android solicita somente CAMERA, sem permissões de armazenamento externo.
  • Notas de voz usam Ogg/Opus mono 16 kHz (PTT WhatsApp) via src/shared/voiceRecorder.ts, com encode em Worker (fora da thread de áudio) para evitar picote; o Android declara RECORD_AUDIO para a captura iniciada pelo usuário no chat, sem gravação em background. O microfone permanece um recurso opcional na ficha de compatibilidade da Play Store.
  • src/shared/platform/fileDeliveryProvider.ts centraliza arquivos gerados e anexos remotos autenticados. Android/iOS gravam temporariamente no cache privado com @capacitor/filesystem e abrem o share sheet com @capacitor/share; PWA/navegador usa Web Share quando aceita arquivos e recorre ao download por Blob quando indisponível ou impedido. Downloads remotos têm teto de 12 segundos e aceitam AbortSignal; o lightbox e os cartões de documento/áudio incompatível do chat usam lock síncrono, loading acessível e cancelam o fetch ao fechar, trocar URL ou desmontar. O sinal atravessa também a conversão e escrita em cache nativa: se o dono fechar nesse intervalo, o arquivo é limpo e nenhum share sheet abre depois da saída. Falha real preserva o cartão e oferece feedback para retry; cancelamento fica silencioso. O resultado tipado informa shared, downloaded ou cancelled, e o serviço de PDF acrescenta failed; tanto o AbortError web quanto a rejeição Share canceled/cancelled do Capacitor convergem para cancelamento normal, sem rejeição não observada, download surpresa, háptico ou confirmação falsa. Erros reais continuam propagados após a limpeza do cache temporário. Acionadores bloqueiam repetição enquanto preparam o arquivo. O botão de gráfico permanece visível e mede 44 px no touch, mas continua discreto por hover onde existe mouse.
  • A People já não exporta nem importa equipe, clientes ou leads (nem seleção em massa). Os outros ficheiros gerados continuam no provider acima.
  • Rollbacks otimistas de clientes, equipe, adiantamentos, serviços, entidades fiscais, leads e adicionais são condicionais por identidade de objeto. Uma falha só restaura a linha se aquela tentativa ainda for sua proprietária; deletes recusados reinserem apenas o item ausente e nunca sobrescrevem uma recriação. Edições paralelas em outros registros permanecem intactas enquanto o cache autoritativo reconcilia o endpoint.
  • Ações contextuais permanecem visíveis por padrão em telas sem hover e só adotam revelação por group-hover dentro de @media (hover: hover). Isso cobre payroll, fotos, reviews, grupos faturáveis e cards de Settings sem perder a apresentação discreta do desktop. Todos recebem nome contextual e alvo touch adequado; indicadores ainda ocultos por hover são exclusivamente decorativos e aria-hidden. O gate AST também exige texto ou nome ARIA em cada uso de Button.
  • title permanece somente como tooltip desktop. Botões e links icon-only publicam aria-label contextual e usam alvo de 44 px nas superfícies touch; o inventário cobre chat/diretório, calendário, faturas, mapas, equipe, estoque, agenda e navegação. O doctor diferencia conteúdo textual de componentes de ícone na AST e rejeita qualquer controle que tente usar tooltip como único nome. Variantes group-hover/msg também entram no gate; somente decoração aria-hidden e setas desktop com scroll touch equivalente podem permanecer hover-only.
  • HapticsService usa @capacitor/haptics no Android para impactos e resultados semânticos; o PWA preserva navigator.vibrate e ambos respeitam a mesma preferência do usuário. O toque vibra quando o dedo sai do controle (pointerup), antes do clique rodar — antes vibrava num timer depois do handler, e um toque que abria uma tela só vibrava quando ela terminava de desenhar; um toque que virou rolagem (mais de 10 px) não vibra, e um light/selection do mesmo toque não vibra de novo. No app nativo o plugin carrega ao iniciar. enableTouchActiveStates põe um touchstart passivo no documento: sem ele o Safari do iPhone não desenha o :active (o active:scale-95 dos botões) fora da área com puxar-para-atualizar, e a barra de baixo, janelas e menus não reagiam ao dedo.
  • src/shared/platform/clipboardProvider.ts centraliza cópias de texto: @capacitor/clipboard é obrigatório nos shells Android/iOS; PWA e desktop tentam a Clipboard API e recorrem a uma seleção temporária, removida em finally, quando Safari/WebView não a disponibiliza. Esse fallback restaura foco e seleção anteriores sem scroll, preservando teclado e posição da tela. A interface só confirma sucesso após o provider resolver e mantém estado de retry nas falhas.
  • src/shared/platform/externalBrowserProvider.ts envia HTTPS externo ao @capacitor/browser no Android/iOS, entrega schemes de sistema como webcal:// ao @capacitor/app-launcher e, no PWA, abre com window.open(url, '_blank') e zera opener à mão. Não usa a feature noopener: com ela o window.open devolve null mesmo quando a aba abriu, e todo link virava “Link unavailable”; assim só uma aba realmente bloqueada lança erro. WhatsApp, Google Reviews, mapas e assinatura de calendário não substituem a aplicação dentro da WebView.
  • Links do Profile para assinatura direta de calendário e o retorno do orçamento público ao site institucional também passam por esse provider; isso evita navegação bloqueada pelo domínio restrito do iOS sem mudar o comportamento normal dos anchors no PWA.
  • O provider aceita somente HTTP(S) e os schemes de sistema webcal:, mailto:, tel:, sip: e sms:. Caminhos relativos de mídia são resolvidos contra a origem oficial antes de chegar ao browser nativo; javascript:, data: e schemes desconhecidos são rejeitados.
  • Ações de telefone/e-mail nos cartões de clientes e contatos do chat usam o mesmo contrato: Android/iOS entregam ao discador, softphone SIP ou cliente de e-mail pelo App Launcher, enquanto a PWA conserva tel:/sip:/mailto: como anchors do navegador.
  • Token push e identificador estável da instalação nativa são persistidos por @capacitor/preferences, não no localStorage da WebView. A primeira leitura migra valores de builds anteriores e remove a cópia legada; preferências visuais da PWA continuam separadas.
  • Contatos sem internet (2026-10-07). Para a equipe (todo papel menos CLIENT), OfflineContactsSnapshot (lazy, montado pelo App com o app pronto) guarda no IndexedDB prime-crown-offline-contacts uma lista só com nome, telefones, e-mail e endereços de clientes ativos, equipe ativa e leads abertos (buildOfflineContacts; nunca observações de acesso, dinheiro ou visitas), três segundos depois da última mudança nas stores; um registro por aparelho, com o dono e o idioma, apagado no logout (clearPrivateClientStorage). Sem rede o app não confirma a sessão e cai no login; aí, se houver lista, OfflineContacts mostra por cima do login o aviso “Sem conexão” e a lista só para leitura, no idioma salvo, com busca por nome, e-mail, endereço ou qualquer trecho do telefone (07… ou +44…), e o telefone abre a ligação. Com o app já aberto, People continua lendo da memória. As visitas de quem está logado vão no mesmo registro (buildOfflineVisits): as em que o seu relatedEntityId está na equipe, do começo de hoje (Londres) até três dias, sem as canceladas — horário, as horas dela (staffDurationHours), serviço, cliente e telefone, endereço com as observações de acesso daquele endereço (as dela, como no app), equipe e checklist; nada de valores. A tela offline abre com “Suas visitas hoje” e “Amanhã” (offlineVisitDays, pelo dia de Londres na hora de ler, então uma lista salva ontem à noite ainda serve) antes dos contatos; a busca esconde as visitas.
  • Mensagens criadas sem rede ficam em IndexedDB (prime-crown-offline/chat-messages), nunca em localStorage. Cada item traz o dono e o escopo de autorização completo (usuário, papel e entidade); registros legados sem esse escopo são descartados, pois não podem ser associados com segurança à sessão após uma atualização ou mudança de permissões. Cada escrita carrega um epoch do storage: logout invalida operações já em voo, que não podem repovoar o IndexedDB depois da limpeza. Cada mensagem é removida somente após confirmação individual do backend; uma queda durante o flush preserva os itens restantes para a próxima reconexão.
  • A reconexão consulta somente a partição que corresponde exatamente à autorização atual. Logout, revogação remota, impersonação, troca de papel e troca de entidade isolam ou limpam a store antes de qualquer envio; portanto outra conta — ou a mesma conta com acesso reduzido — não envia, lê nem encontra conteúdo pendente de uma autorização anterior.
  • Logout offline grava somente uma barreira booleana opaca antes de remover a identidade. Na inicialização seguinte, AuthContext processa essa barreira antes de consultar /api/auth/me, repete /api/auth/logout e continua desautenticado se a rede ainda não voltou. Login por senha, Google, Apple, biometria ou impersonação confirmado remove a barreira, evitando tanto restauração indevida do cookie HttpOnly antigo quanto bloqueio de uma nova sessão legítima.
  • O cache local de alertas operacionais também usa IndexedDB, particionado pelo ID do usuário. A hidratação assíncrona combina alertas recebidos durante o boot com o cache existente; chaves legadas notif_history_v1_* são migradas e removidas. O mesmo boundary de sessão apaga todas as partições e a dica de e-mail Google em sessionStorage; preferências estritamente visuais continuam no localStorage.
  • Preferências visuais associadas a entidades usam opaqueStorageMarker, com namespaces separados e sem armazenar IDs operacionais legíveis. Fixação de canais, preferências de notificação e dismiss do banner WhatsApp removem chaves legadas; canais fixados usam uma chave v3 particionada pelo marcador da conta, pois uma lista global não pode ser atribuída com segurança à próxima sessão. Dicas de passkey compartilham o algoritmo estável. notif_prefs_v2_<marker> preserva som, posição e categorias por conta sem escrever o ID real na chave. O marcador não protege segredos e seu uso fica restrito a estado de interface.
  • O fluxo de orçamento chama chat-initiate com issueGuestToken: false: cria/atualiza lead, canal operacional e lead_quote aberta, mas não cria cliente/atendimento nem gera um JWT de convidado que a tela de confirmação não consome. O padrão do endpoint permanece true para widgets de chat existentes. A confirmação administrativa da cotação é a única fronteira que materializa cliente e service_request.
  • chat-initiate usa uma allowlist CORS: domínios Prime Crown, previews HTTPS do projeto Pages, desenvolvimento local e origins Capacitor. Origens de navegador desconhecidas recebem 403 antes de tocar o banco; integrações servidor-a-servidor sem Origin permanecem compatíveis e as respostas variáveis usam Vary: Origin.
  • Os mesmos endpoints consomem um orçamento persistente em public_api_attempts antes do parsing e dos efeitos externos: 5 requisições/15 min para iniciar lead/chat e 30/10 min para verificar telefone. As chaves SHA-256 derivadas do IP não expõem o endereço em claro; janelas são isoladas por endpoint e um bloqueio retorna 429 com Retry-After para web, PWA e shells nativos tratarem igualmente.
  • src/shared/platform/networkProvider.ts usa @capacitor/network como fonte compartilhada no Android/iOS e eventos do navegador no PWA. No shell nativo, todos os consumidores dividem um único listener e uma única leitura inicial, mantidos enquanto houver assinantes; uma geração invalida inicializações tardias após teardown. Até o plugin responder, o sinal inicial do WebView evita anunciar rede artificialmente disponível. Fila offline do chat, sincronização, polling e refetches deixam de depender diretamente de navigator.onLine no WebView.
  • src/shared/platform/statusBarProvider.ts sincroniza ícones do sistema e --status-chrome. Android nativo API 36 e PWA standalone expõem a safe area superior contra o fundo do documento; o body usa o inset e background-clip: content-box, deixando visível o chrome azul sob os glifos. No PWA, <meta name="theme-color"> (azul) e <meta name="color-scheme" content="light"> preservam esse contrato mesmo com o sistema em modo escuro; o meta só pinta a barra de cima. A barra de navegação do sistema no PWA Android é pintada pelo Chrome com o theme_color gravado no WebAPK, e a splash com o background_color: os dois manifestos usam theme_color: #ffffff (barra branca como o BottomNav) e background_color: #2563eb (splash azul). Em 27/10 a splash ficou branca com background_color branco e a barra seguiu azul: a barra é o theme_color. O Chrome só aplica ao WebAPK na próxima atualização dele (verificação a cada ~30 dias) ou numa reinstalação — no celular, chrome://webapks mostra as cores que o app instalado usa e a data da última verificação. No modo edge-to-edge, o fundo do documento pode aparecer sob os gestos: html tem base branca e uma faixa azul limitada ao inset superior real, enquanto o BottomNav pinta seu próprio inset inferior branco. A folha de instalação do Chrome mostra description e screenshots do manifesto: capturas reais das 4 seções do menu do cliente (Home, Bills, Chat, Menu) em public/brand/screenshots/, com o endereço trocado por um fictício (narrow para celular, até 8 em carrossel; lado maior ≤ 2,3× o menor), nunca a splash. O worker e os cabeçalhos buscam o manifesto pela rede antes de recorrer ao cache offline, para que o Chrome não mantenha a cor de uma revisão anterior. Uma cor primária clara personalizada não pode tornar os ícones invisíveis: o PWA recai para o azul institucional. O shell iOS em ios/ reutiliza os providers Capacitor e respeita safe areas do sistema.
  • O estilo claro/escuro dos glifos nativos segue a luminância da cor efetivamente aplicada ao chrome. O modo do conteúdo é apenas fallback quando não há cor primária, evitando ícones claros sobre marcas claras em temas escuros.
  • Universal Links e credenciais compartilhadas do iOS usam App.entitlements e /.well-known/apple-app-site-association. A resposta é construída com APPLE_TEAM_ID no Cloudflare e associa o bundle uk.co.primecrowncleaning.app; o scheme privado primecrown:// permanece como fallback para deep links internos e aceita destinos no host (primecrown://chat) ou em ?view=.
  • Toda entrada de navegação externa passa pela matriz canRoleAccessView: URL inicial, clique de push/Web Push, Universal Link, custom scheme e o roteador defensivo convertem destinos sem permissão em Dashboard antes de aplicar seleções secundárias. Links HTTPS só são aceitos na origem canônica https://app.primecrowncleaning.co.uk (incluindo a porta padrão); hostname semelhante com porta alternativa não entra no shell nem em páginas públicas. As URLs internas criadas pelo service worker ou pelo PendingIntent Android também preservam recipientUserId como guarda de rejeição no cold-start: se a sessão restaurada for de outra pessoa, a rota e suas seleções são descartadas. O destino temporário de um reload por atualização PWA segue a mesma fronteira e é apagado no logout. Esse valor na URL nunca autoriza conteúdo; payload de push e backend/RBAC seguem sendo as autoridades. O backend continua responsável pelo isolamento real dos dados.
  • Revogação remota, bloqueio e logout invalidam tanto a revalidação em foreground quanto a restauração /auth/me em andamento. Essa fronteira cobre WebViews que resolvem um fetch após AbortController.abort(): o resultado antigo não tem mais dono e não volta a montar a identidade que acabou de ser removida.
  • Mutações de visita iniciadas pelo cliente capturam a sessão antes da requisição. Caso uma troca de conta ocorra enquanto o backend calcula cancelamento, remarcação, bônus e visitas derivadas, a resposta não escreve nem invalida o Query cache da conta que entrou depois; apenas o fluxo original recebe seu resultado para finalizar com segurança.
  • A deduplicação de push nativo é por instalação física: quando Android/iOS confirma um installId, a nova linha elimina tokens diferentes daquele mesmo aparelho inclusive de uma conta anterior. Isso fecha a combinação de logout offline e rotação FCM/APNs; aparelhos realmente distintos continuam independentes. O registro em voo também pertence ao dono da sessão: após a troca de conta, a nova tentativa não aguarda o POST cancelado da anterior.
  • Filas extensas do Dashboard usam renderização progressiva compartilhada: cards montam 24 grupos e a lista 50 linhas por etapa, sempre conservando o total e oferecendo expansão explícita em um controle touch de 44 px. Grupos de fatura, conta e recorrência nunca são divididos. O agrupamento prepara índices lineares para faturas, clientes, funcionários e recorrências, evitando buscas quadráticas sem alterar a prioridade da primeira fatura ativa. O mesmo React/CSS e os mesmos contratos de teclado, status acessível e háptico atendem desktop, PWA, Android e iOS.
  • O Pages usa seu fallback SPA nativo quando não existe 404.html na raiz; não há reescrita catch-all que possa entrar em ciclo com a canonicalização de /index.html. Rotas de instalação e metadados continuam explícitas. /slides usa a resolução natural do index.html do diretório, enquanto assets/404.html isola somente chunks inexistentes e devolve 404 real em vez do HTML da aplicação.
  • /slides é uma rota permanente de treinamento. Os scripts versionados capture-slide-*.mjs e capture-wizard-shots.mjs mantêm suas imagens a partir do app local em viewport móvel e perfil isolado do Chrome; são ferramentas de autoria e não entram no bundle de produção.
  • O seletor administrativo de simulação preserva o <select> nativo e a identidade corrente no boot, mas só monta as listas extensas de funcionários e clientes ao receber foco ou toque; blur as descarta. Assim, centenas de opções não ocupam permanentemente o DOM nem a árvore de acessibilidade do Dashboard, enquanto mouse, teclado, VoiceOver, TalkBack e picker do sistema continuam percorrendo a lista completa quando solicitada.
  • Cada seção operacional constrói um DashboardRelationshipIndex antes de renderizar cards ou linhas. Entidades fiscais e funcionários passam a ser resolvidos por mapa; equipes atribuídas são preparadas em ordem visual estável; séries recorrentes são agrupadas e ordenadas uma única vez para indexar posição/total. Cards deixam de assinar individualmente a store fiscal e de filtrar, buscar e ordenar coleções globais, mantendo exatamente os mesmos valores, avatares e indicadores em cards e lista nas quatro plataformas.
  • A auditoria financeira do Dashboard monta no máximo 12 claims por etapa. Cliente, entidade fiscal e visitas vinculadas são indexados em uma passagem, preservando a ordem global das visitas e o fallback fiscal anterior; cada card deixa de repetir três buscas completas e de assinar a store fiscal. Aprovar/rejeitar usa lock síncrono compartilhado entre os dois botões e libera loading em finally, inclusive quando o backend recusa a decisão; teardown impede estado tardio. A expansão continua explícita por botão touch/teclado e o total permanece anunciado.
  • DashboardIntelligenceService.classifyRequests distribui as visitas entre todas as filas operacionais e financeiras em uma única passagem, conservando ordem e sobreposições de negócio. A leitura de faturas também produz, num só percurso, o índice de visitas faturadas, aprovações e pendências do cliente. O setor liquidado reutiliza o resultado booleano de faturamento da própria visita, eliminando a busca quadrática anterior sem mudar a separação completa de PENDING entre alocação e confirmação.
  • useDashboardController é o único proprietário das queries, stores e ações operacionais consumidas pela página; Dashboard não cria um segundo conjunto de observers para os mesmos dados. useDashboardData prepara uma vez os mapas de clientes e serviços, usa-os na desnormalização e os reutiliza nos fallbacks de cards, sem voltar a varrer as coleções por consulta. Escopo de funcionário/cliente e ordenação cronológica permanecem cobertos por testes puros.
  • Os resumos por papel usam classificadores lineares compartilhados. No cliente, uma passagem encontra visita ativa, próxima visita, total futuro e último atendimento sem avaliação; outra distribui todos os setores operacionais, em vez de filtros e sorts independentes. No funcionário, uma passagem separa hoje, próximos sete dias, visita ativa e concluídos. Ambos assinam useNowMinute, relógio único que pausa em background, para atravessar limites de horário corretamente após foreground sem criar timers por card.
  • O mapa operacional prepara em uma passagem visitas ativas e o primeiro trabalho em andamento por funcionário, além do índice de clientes. Marcadores deixam de executar buscas cruzadas por pessoa, e presença online usa o mesmo relógio foreground. O primeiro conjunto válido recebe fitBounds uma vez — inclusive quando chega depois de um estado vazio — enquanto atualizações posteriores não deslocam o operador; Recenter continua explícito. Todo nome inserido nos fragments HTML do Leaflet é escapado antes de chegar ao DOM.
  • A disponibilidade semanal estabiliza as datas derivadas da semana e indexa pedidos, horas por funcionário e totais diários numa única passagem. A matriz deixa de varrer toda a agenda para cada célula, preservando ordem, atribuições múltiplas e exclusão de cancelamentos. Em telas estreitas, a coluna da equipe permanece fixa durante o scroll horizontal; a grade é uma região nomeada e cada dia anuncia funcionário, data, estado, tarefas e horas a VoiceOver/TalkBack.
  • A inteligência de carga e desempenho da equipe também agrega por atribuição em passagem única. Horas executadas/futuras, avaliações, receita, pontualidade, compliance e contagens funcionário-cliente deixam de refiltrar o histórico por profissional. Retenção conserva a regra de três atribuições com pelo menos uma visita concluída. A tabela de capacidade mantém o profissional fixo durante o scroll móvel, reduz padding em telas estreitas e diferencia ausência real de equipe ativa.
  • Crescimento e margem indexam serviços, clientes, entidades fiscais e funcionários antes de percorrer visitas concluídas. Candidatos acumulam avaliações e último serviço sem ordenar um histórico por cliente; margem acumula receita, custo, horas, VAT, equipe e presença de taxa negociada sem refiltrar pedidos. O resumo da tela separa setores filtrados em uma passagem e distingue busca sem correspondência de uma carteira realmente acima da meta.
  • Os radares de retenção agrupam pedidos por cliente em uma passagem. Reengajamento ordena cada histórico concluído uma vez para inferir frequência, última visita e risco; o score de churn separado saiu junto com o Quality Control; a lista de clientes em risco (Reports → Risk) usa o reengajamento. Ambos recebem o relógio foreground compartilhado, portanto dias inativos e severidade avançam ao retomar PWA ou shell nativo. A interface distingue ausência de histórico, carteira saudável e filtro sem resultados; pills publicam grupo/estado pressionado e mantêm scroll touch em viewports estreitos.
  • O Portfolio filtra clientes antes de indexar pedidos e calcula score, LTV, lifecycle e momentum uma vez por histórico agrupado. O controller usa o mesmo relógio foreground, então o limite de inatividade avança sem reload. Cada cartão recebe a métrica pronta e não assina a lista global de pedidos, evitando recomputação e renderização em cascata nas quatro superfícies.
  • Relatórios de prova social e ranking de equipe também usam agregação linear: avaliações, promotores, receita, pontualidade e frequência funcionário-cliente são acumulados uma vez. IDs repetidos na atribuição são normalizados por pedido, cancelamentos permanecem excluídos e a ordenação por contas retidas/avaliação conserva o contrato visual existente.
  • Capacidade e governança recebem o relógio foreground do hook de relatórios. O intervalo mensal é criado uma vez e horas são somadas em passagem única; leakage, avaliações e última visita são agregados simultaneamente por cliente, sem filtros/ordenações por cartão. Virada do mês e limites de 15/30 dias avançam ao retomar browser, PWA ou shell nativo.
  • O Business Intelligence usa um agregador puro para histórico de seis meses, distribuição de serviços e eficiência da equipe. Um índice resolve nomes de serviço e uma passagem por pedidos concluídos alimenta os três painéis; o controller não assina mais clientes sem uso e recebe o relógio foreground para mover a janela mensal sem reload.
  • A divisão fiscal indexa clientes e entidades e acumula pedidos/faturas em uma passagem por coleção. O contrato preserva VAT absorvido, reembolsos parciais, taxas de cancelamento, métodos oficiais no modo HMRC, sobretaxas SENT/PAID e consolidado; entidades desconhecidas não contaminam totais publicados.
  • A visão financeira do colaborador cria um snapshot indexado de holerites visíveis, IDs quitados, tarefas pendentes e tarefas por período. DRAFT permanece privado, somente PAID quita trabalho, custos manuais (inclusive zero) prevalecem e a ordem dos pedidos é preservada. O caixa em mãos usa mapas de cliente/entidade para aplicar VAT sem buscas por linha.
  • O editor de endereços mantém atualizações estruturais imutáveis. Remover o endereço padrão cria a lista remanescente e clona somente o primeiro endereço promovido; nenhum objeto recebido da store/props tem isDefault alterado antes do save. Índice inválido e tentativa de remover a última localização preservam a referência original e não publicam uma falsa mudança.
  • O resumo financeiro central aplica o escopo RBAC antes dos cálculos e sempre ordena uma cópia dos pedidos; abrir Finance nunca muta a ordem do cache TanStack compartilhado com agenda, dashboard ou operações. Salários, horas e receita por serviço são acumulados juntos, com lookup indexado do catálogo e sem alterar P&L/fiscal.
  • Avisos de reposição ordenam uma cópia da lista do cliente por urgência; a entidade compartilhada nunca é mutada para compor texto. Auditoria de IA e envio usam single-flight por cliente, fechando a janela de toque duplo sem impedir operações independentes ou retry após falha.
  • As seis linhas de tabela que funcionam como ação — agenda do dashboard, itens da fatura, pagamentos, serviços históricos, faturas históricas e auditoria — preservam a área inteira para toque, mas também publicam role=button, nome contextual, foco visível e ativação por Enter/Espaço. O seletor lateral da equipe completa a sétima superfície com role=option, aria-selected e nome que anuncia adicionar/remover. Pagamentos sem fatura deixam de anunciar clique; os expansíveis publicam aria-expanded. O doctor deriva esse inventário diretamente da AST TSX e rejeita qualquer elemento estático com onClick sem contrato equivalente.
  • Push nativo seleciona o transporte pela plataforma persistida em native_push_tokens: Android usa FCM e builds novos recebem data-only para o renderer PrimeCrownMessagingService; iOS envia o device token diretamente ao APNs e recebe alerta visível com som, badge e thread-id. O AppDelegate encaminha o token ao plugin Capacitor. Resultado e configuração são apurados por transporte, portanto um envio VAPID bem-sucedido não esconde FCM ausente em uma conta com PWA e Android.
  • O NativeBridge fornece um AbortSignal à inicialização FCM/APNs. Teardown interrompe canais, listeners, consulta de permissão, registro e saves de token; handles que resolvem depois do abort são removidos uma única vez. Back e resultado restaurado da câmera repetem o guard active dentro do callback, cobrindo o intervalo entre cleanup React e remoção assíncrona do listener Capacitor.
  • O provider de teclado trata Show/Hide como um par atômico: qualquer falha parcial remove imediatamente os handles que chegaram e restaura os safe areas, impedindo que a interface receba o deslocamento de abertura sem o evento de fechamento correspondente. Qualquer listener que resolva depois do teardown também é removido exatamente uma vez. A restauração dos safe areas continua síncrona, evitando que remontagens ou logout deixem o conteúdo deslocado. Toasts, ações de bottom sheets e o rodapé de disponibilidade leem as variáveis vivas do shell, portanto acompanham teclado, orientação e barras do sistema em Android/iOS sem mudar o espaçamento desktop. Sheets full-screen aplicam o inset superior ao cabeçalho completo — inclusive fechar e ações — enquanto sheets parciais evitam reserva duplicada. Se o header padrão estiver oculto, o contêiner reserva topo e barra de gestos para o conteúdo customizado; consumidores cujo rodapé já possui safe area, como o composer do chat, declaram essa propriedade para não duplicar o inset.
  • Watches de localização recebem o mesmo ownership explícito: um AbortSignal já cancelado impede a chamada ao plugin, cancelamento durante o registro limpa o ID tardio e falha de registro desanexa o listener de abort antes de propagar o erro.
  • Conectividade nativa mantém um único listener do plugin, mas contabiliza cada assinatura React separadamente — inclusive quando duas superfícies reutilizam a mesma função. Cada disposer é idempotente e o listener Capacitor só é removido quando o último owner sai.
  • Mudanças de tema pintam CSS/meta tags imediatamente, enquanto chamadas ao plugin da status bar são serializadas por geração. Intenções obsoletas aguardando import são descartadas, uma falha não envenena a fila e a última cor sempre determina o contraste final dos ícones nativos.
  • O badge do launcher usa uma fila latest-wins comum a Android, iOS e App Badge API: uma escrita já iniciada termina antes da próxima, contagens intermediárias ainda aguardando são descartadas e a limpeza de logout permanece a intenção final. Rajadas de push atualizam o número correto sem martelar o plugin com cada estado transitório.
  • Escritas no clipboard nativo são serializadas na ordem dos toques através do carregamento dinâmico e da bridge; uma cópia antiga não pode terminar depois e substituir o texto mais novo. Falha de uma operação não envenena a fila seguinte. Na web, a chamada permanece imediata para conservar a ativação transitória exigida pelo Clipboard API, com fallback de seleção que restaura foco e ranges.
  • Abertura das configurações do sistema usa um single-flight compartilhado por gates e modais: o lock é adquirido antes do carregamento do plugin, portanto toque duplo ou duas superfícies simultâneas produzem uma única intent Android/iOS. O retorno ao foreground reconcilia as permissões autoritativas, e sucesso, resposta negativa ou falha da bridge liberam uma nova tentativa.
  • O contraste da status bar nativa deriva da luminância relativa da cor realmente pintada, usando o ponto em que glyphs claros e escuros oferecem contraste equivalente. Assim todas as paletas configuráveis — inclusive Amber e Emerald, antes classificadas como escuras por um limite arbitrário — recebem o estilo de ícone mais legível; cor malformada permanece no fallback conservador.
  • O listener global de haptics observa controles na captura, mas agenda o tick genérico somente depois do dispatch do clique. Se o Button ou a ação emitir light, selection, success, warning ou error no mesmo gesto, esse feedback explícito cancela o tick pendente. Android/iOS recebem uma única chamada da bridge por gesto; PWA usa a mesma arbitragem sobre navigator.vibrate, e desktop sem suporte nem instala o listener.
  • A lista compartilhada de dispositivos representa tokens nativos como native:<plataforma>:<token>; a API ainda aceita o prefixo legado fcm: durante a transição. Assim, diagnóstico e remoção distinguem corretamente Android/FCM de iOS/APNs sem criar telas separadas.
  • A recuperação de permissões usa nativeSettingsProvider: Android abre detalhes/notificações do app pelas configurações Android; iOS usa somente as telas app-specific oficialmente suportadas pelo sistema.
  • O elemento raiz recebe data-platform="android" ou data-platform="ios" antes do primeiro render. CSS compartilhado permanece o padrão; workarounds de edge-to-edge, momentum scroll, seleção e interação que diferem por sistema usam esse atributo, evitando inferência por user agent.
  • privacyScreenProvider no Android fica sempre desligado (FLAG_SECURE bloqueava screenshots e o diálogo de Subscribe). No iOS aplica blur só em background para o app switcher; transições rápidas são serializadas e estados ainda enfileirados são coalescidos, garantindo que o último foreground/background vença mesmo quando a bridge demora. Captura pela câmera e upload de evidências continuam normais. PWA não carrega o plugin nativo.
  • O teste de push nativo dispara o POST sem timer em background e sem consultar livePushEndpoint/token pela ponte Capacitor; a comparação de endpoint é exclusiva do PWA. O cliente limita o teste a 15 segundos e os transports FCM, APNs e Web Push limitam cada chamada externa a 10 segundos, portanto o estado de loading sempre converge para sucesso ou erro acionável.
  • O canal de chat visível continua imediato em memória para web/PWA e é espelhado em @capacitor/preferences para o renderer nativo suprimir apenas a notificação da conversa realmente aberta. Essas escritas são serializadas e estados enfileirados obsoletos são coalescidos; sair ou trocar rapidamente de thread não pode ser sobrescrito por um set antigo e silenciar notificações futuras.
  • O Android desativa Auto Backup e exclui explicitamente todos os domínios de cloud/device transfer, evitando restaurar cookies WebView, tokens FCM e identificadores de instalação em outro aparelho. Dados de negócio continuam vindo do backend após uma nova autenticação.
  • O gate operacional revalida GPS, precisão, câmera e notificações ao retornar das Configurações usando o lifecycle nativo, sem depender da presença de navigator.geolocation dentro da WebView; PWA mantém focus e visibilitychange como sinais equivalentes. Cada domínio usa o mesmo coordenador latest wins do perfil: consultas antigas, checagem lenta de token e precisão fora de ordem não regressam uma etapa já resolvida; ação explícita publica seu resultado autoritativo e a saída do gate invalida operações pendentes. Os single-flights também pertencem à identidade: uma leitura nativa pendente da conta anterior não bloqueia a nova conta em checking.
  • A seção de dispositivos/diagnóstico push no Perfil particiona leituras por user.id. Nova leitura aborta a anterior; troca de conta ou teardown cancela lista, espera de cinco segundos e polling de ACK. Remoção, teste local e teste real possuem locks síncronos contra dois toques no mesmo frame e só alteram loading, dispositivos ou toasts enquanto o ticket da identidade continuar atual, evitando feedback tardio em outra tela ou sessão.
  • O viewport permite pinch-to-zoom em PWA e WebViews para acessibilidade. Login e formulários de contato recorrentes (orçamento, leads, perfil, clientes e equipe) publicam inputMode/autocomplete, abrindo teclado de e-mail/telefone e autofill do sistema. Todos os 48 campos numéricos são auditados: decimal para dinheiro/percentual/fração, numeric para contagem/tempo inteiro, com única exceção explícita do offset UTC assinado. As 16 buscas/filtros usam type="search", inputMode="search", enterKeyHint="search" e autofill desligado; o postcode preserva seu autocomplete de endereço. Os 17 campos temporais permanecem date, time ou datetime-local, abrindo os pickers do runtime, e todos expõem nome acessível. O doctor exige os contratos. Localização é declarada como capacidade de foreground: o iOS mantém as duas descrições exigidas internamente pelo plugin, mas o produto não solicita nem anuncia rastreamento em background.
  • O teclado Android usa @capacitor/keyboard, adjustResize e resizeOnFullScreen; o provider publica altura/visibilidade no elemento raiz para que telas em 100dvh e modais respeitem a área realmente disponível. keyboardWillHide e o próprio disposer usam a mesma restauração de --safe-bottom, --content-safe-bottom, --native-bottom-lift e altura, portanto desmontar o shell com o teclado aberto não deixa o próximo mount comprimido. No PWA, Chrome usa interactive-widget=resizes-content; Safari acompanha altura e deslocamento de visualViewport durante o teclado, restaura os insets ao fechar/retomar e mantém o viewport amplo do iPhone fora da edição.
  • Breakpoints JS usam useMediaQuery: um mediaQueryStore multiplexa uma única assinatura de matchMedia por consulta e notifica somente quando o resultado cruza o breakpoint. Não use window.resize para derivar mobile/desktop; ele renderiza a cada pixel durante rotação, split-screen, teclado e redimensionamento.
  • Coleções com apresentações distintas também usam esse sinal como fronteira de montagem. Clientes, funcionários e custódia de chaves renderizam cards no mobile ou tabela no desktop, nunca ambos escondendo metade por CSS; a busca de usuários também possui uma única instância ativa. Isso reduz DOM, memória e controles interativos duplicados sem bifurcar cálculo, dados ou ações.
  • A agenda aplica a fronteira aos painéis auxiliares: equipe aparece a partir de 1024 px e tarefas sem alocação a partir de 1280 px; em viewports menores esses componentes drag-and-drop não são montados. O grid usa 80dvh e mínimo móvel de 420 px, retornando ao contrato amplo de 80 vh/700 px no desktop.
  • Polling que aciona hardware ou rede em ciclos curtos deve usar startForegroundInterval; o scheduler remove o timer quando a página oculta ou o shell Capacitor pausa e executa uma leitura fresca ao retornar. foregroundLifecycle multiplexa uma única assinatura global desses três eventos para schedulers, Auth, boot, canais, updates, permissões, saúde do push e histórico de notificações, descartando transições consecutivas para o mesmo estado. Proximidade operacional, polling de páginas, fila do chat e saúde/conexão do WhatsApp usam esse contrato. Textos relativos, SLA, agenda e centro operacional usam o único useNowMinute, que também para em background; não crie relógios locais por componente.
  • A gravação de voz também assina foregroundLifecycle: ao entrar em background, encerra e libera o microfone preservando o take. Não adicione listeners globais de visibilidade/pause/resume diretamente em componentes; a ponte nativa é somente a produtora do sinal compartilhado.
  • O reconcile de canais e o fallback de polling de mensagens usam startForegroundInterval com runImmediately: false: preservam o primeiro intervalo, removem o timer em background e reconciliam imediatamente na retomada. Não mantenha um setInterval ativo apenas para abortar seu callback quando document.visibilityState estiver oculto.
  • A fila offline de mensagens pertence ao usuário autenticado e conserva createdAt como ordem de composição. Na retomada, a leitura IndexedDB ordena por esse timestamp antes do flush serial; UUID é somente chave de idempotência, nunca ordem de entrega.
  • Listeners de pointer/touch que não chamam preventDefault devem ser { passive: true }. O touchmove do pull-to-refresh é a única exceção global: permanece { passive: false } porque cancela o scroll somente após reconhecer o gesto vertical no topo.
  • Feedbacks temporários e ações UI atrasadas usam useReplaceableTimeout: a próxima agenda substitui a anterior e o unmount cancela o timer. Não crie setTimeout(() => setState(...)) solto em componentes.
  • Menus ancorados usam usePopoverMenu com role="menu" e itens menuitem*: setas circulam, Escape restaura o gatilho e pointer fora fecha preservando o foco do alvo tocado. No mobile, prefira AdaptiveBottomSheet quando a mesma escolha precisa de uma superfície de alcance do polegar.
  • Utilities overflow-y-auto, overflow-x-auto e overflow-auto contêm overscroll no eixo que possuem; no iOS todas recebem momentum nativo. Não aplique touch-action: pan-x a rails/tabelas: isso impediria a mesma região de participar da rolagem vertical da página.
  • foregroundLifecycle combina document.visibilityState com pause/resume do Capacitor. Ambos precisam indicar foreground; o estado nativo é relido ao receber o primeiro assinante e também por guards avulsos quando não há assinantes, para que um callback tardio não trabalhe em segundo plano. Consumidores não devem voltar a observar diretamente apenas um desses sinais.
  • Decisões funcionais por sistema operacional usam DeviceService (runtime nativo primeiro, detecção web depois). Não duplique regex de user agent em fluxos de calendário, passkey, compartilhamento ou abertura de apps.
  • Capacidades de entrada usam inputCapabilities; breakpoint responsivo deve ter uma fonte reativa compartilhada entre layout e controlador. No chat, ChatInbox fornece o mesmo md/768 px ao controlador e ao ClientChatView, invalida overlays móveis ao cruzar para desktop e monta somente a árvore correspondente ao breakpoint. Não deixe uma segunda conversa escondida por CSS: ela repetiria polling/WebSocket, leitura, composer e efeitos de roteamento WhatsApp.
  • Shells full-screen usam 100dvh; tokens visuais não devem reintroduzir min-h-screen/100vh, pois a viewport estática pode cobrir conteúdo com teclado ou chrome móvel.
  • Web app instalado no iPhone (tela inicial, navigator.standalone): o WebKit entrega uma viewport mais curta que a tela pela altura da barra de status (medido no aparelho: tela 874, innerHeight e 100dvh 812, 100lvh 874), e o shell e o BottomNav terminavam 62 px acima da borda. Nesse modo não há barra de navegador, então 100lvh é a tela inteira: index.html marca data-ios-standalone e index.css usa 100lvh no html e nos overlays de tela cheia (.fixed.inset-0). Um truque de reflow (esconder e mostrar #root) rodou e não mudou a medida — foi removido. Login e redefinição de senha ficam sobre um wrapper #F8FAFC (a cor da tela): o system-viewport-safe deixa o padding da área de gesto transparente, e um wrapper branco aparecia ali como uma faixa.
  • Reconexão deve ser assinada por networkProvider. Ele compartilha um único par online/offline na web e um único @capacitor/network no nativo; Auth, boot, canais, atualização e fila offline recebem o mesmo sinal. Não recrie eventos primecrown:network-* no NativeBridge nem adicione listeners diretos de online em consumidores.
  • A splash nativa permanece visível até o primeiro commit React e é ocultada por splashScreenProvider; um auto-hide Android de três segundos impede bloqueio permanente se a origem HTTPS falhar antes de executar o app. O PWA não participa desse lifecycle.
  • src/shared/platform/appBadgeProvider.ts mantém o contador de mensagens não lidas no ícone. Android usa @capawesome/capacitor-badge quando o launcher oferece suporte; navegador/PWA preserva a App Badge API existente.
  • Atualizações do badge passam por uma fila que preserva ordem, normalizam entradas inválidas e limpam o ícone ao desmontar a sessão autenticada. Isso impede corridas entre leitura/logout e evita que uma conta deixe seu contador visível para a próxima; o service worker usa a mesma normalização.
  • src/shared/platform/appUpdateProvider.ts consulta atualizações distribuídas pelo Google Play e pela App Store após confirmação no banner compartilhado. Android usa o fluxo imediato/flexível quando permitido; iOS abre a ficha da App Store. Os assets remotos continuam atualizando pelo service worker, com texto e ação próprios para cada origem e os mesmos estados de progresso, falha e nova tentativa. O adiamento é registrado por origem: escolher “Later” para conteúdo web não oculta uma atualização da loja, e a ação sempre corresponde à origem atualmente anunciada.
  • A classe .touch-target preserva controles compactos no desktop e aplica área mínima de 44×44 px somente em dispositivos com ponteiro coarse. Todo botão com largura/altura explícita menor que esse limite — incluindo busca no chat, gravação/reprodução de voz, agendamento, resposta, encaminhamento, reação, filtros de chat, seleção de equipe/frequência da cotação, navegação semanal, folha, faturamento, estoque, configurações, CTAs dos banners globais, logout do drawer, recuperação e navegação lateral — usa o contrato; ações rápidas e dismisses ficam alinhados às convenções de toque de Android/iOS sem criar uma segunda árvore de componentes. O teste percorre a AST de todos os arquivos TSX, reconhece dimensões h/w/min-h/min-w inclusive importantes e mantém assertions explícitas para os controles cuja geometria final depende da composição. As únicas exceções nomeadas são setas hover-only com rolagem touch equivalente e checkboxes da tabela explicitamente desktop; uma exceção nova precisa ser registrada e revisada pelo teste.
  • Seletores visuais nunca comunicam estado apenas por cor, borda ou check decorativo. Serviço/frequência do orçamento, equipe, data/hora/endereço, período, método de pagamento, tema, recursos de IA/WhatsApp, filtros e reconciliação publicam aria-pressed; abas reais usam tablist/tab + aria-selected. Painéis recolhíveis publicam aria-expanded. O mesmo DOM atende mouse, teclado, PWA, TalkBack e VoiceOver, e tests/selection_state_semantics.test.ts protege o inventário compartilhado.
  • Os dois controles segmentados de chat — categorias da Inbox e tipos do Directory — usam oito botões aria-pressed. Eles preservam 36 px no desktop e recebem o piso touch-target de 44 px em ponteiro coarse, evitando uma variante separada para Android/iOS sem depender apenas da cor para comunicar a opção ativa.
  • Tablists usam foco roving: somente a aba ativa recebe tabIndex=0; setas horizontais/verticais circulam, Home/End saltam para as extremidades e o foco acompanha a seleção. CFTabs e o dashboard específico do chat obedecem ao mesmo contrato. Cada aba publica aria-controls e cada painel montado usa tabpanel + aria-labelledby, portanto teclado e leitores de tela navegam pela mesma estrutura em desktop, PWA e WebViews.
  • Listboxes seguem o modelo correspondente ao foco. A paleta combobox mantém o foco no campo por aria-activedescendant; opções ficam fora do Tab, a busca reinicia o índice e setas mantêm o resultado ativo visível. A multisseleção de equipe usa foco roving entre options, setas/Home/End para percorrer e Enter/Espaço para alternar aria-selected. Assim listas grandes não criam uma parada de Tab por item em nenhuma plataforma.
  • Menus ancorados usam usePopoverMenu para abertura por Arrow Down/Up no gatilho, foco inicial na opção marcada, circulação por setas, Home/End, typeahead sem distinção de acentos/caixa, fechamento por Escape com retorno ao gatilho e fechamento por Tab sem interromper a ordem natural. Iniciais repetidas circulam entre correspondências; Espaço e atalhos modificados permanecem reservados ao controle/sistema. Settings, conversas no desktop e ferramentas do composer compartilham o contrato; o seletor de conversas mobile preserva o bottom sheet adaptativo.
  • Sidebar do desktop começa recolhido (2026-11-03). Ao abrir o app no computador o menu aparece só com ícones (MainLayout, useState(true), nada guardado); expandir vale até o app ser aberto de novo. Cada ícone se nomeia na hora ao receber o ponteiro ou o foco (useSidebarTooltip): a legenda escura ao lado do ícone, com a contagem quando há (“Messages · 3”), desenhada no body porque o menu corta o próprio overflow, e some ao sair, ao clicar, ao rolar ou ao expandir — no lugar do title do navegador, que esperava um segundo. Settings e Sign out se nomeiam assim sempre; o perfil, só recolhido. Recolhido, o ícone mantém a contagem num badge vermelho sobre ele (99+ acima disso), não só um ponto. No telefone nada muda.
  • Sidebar alterna semanticamente entre navegação complementar permanente no desktop e drawer modal no mobile. Fechada, a versão mobile usa inert + aria-hidden, portanto itens traduzidos para fora da tela não recebem Tab nem aparecem antes do conteúdo em VoiceOver/TalkBack. BottomNav mantém aria-expanded e o ciclo de foco Menu → primeiro item → Menu; acima de lg, MainLayout não o monta, evitando uma segunda assinatura de canais e um ResizeObserver invisível no desktop.
  • Ações icon-only que exibem title no desktop também expõem aria-label para VoiceOver/TalkBack; toggles publicam o estado com aria-expanded. O doctor audita os sete controles compartilhados desse grupo e outras 21 ações compactas de navegação, mapa, seleção, adição e fechamento, impedindo que um ícone visual ou tooltip de mouse volte a ser o único nome da ação.
  • Os 22 inputs brutos com placeholder — buscas e entradas rápidas — mantêm um nome persistente por aria-label; ações concluídas pelo teclado indicam done/send e o distrito postal ativa capitalização. Placeholder permanece exemplo visual, não o único contrato acessível.
  • Trocar de tela não espera a próxima: useViewNavigation muda a tela na hora (a aba e o cabeçalho acompanham o toque) e AppRoutes põe o lugar da página (PageSkeleton, aparece após ~80 ms) enquanto a página é desenhada numa transição — interrompível, o celular não trava — e a preenche quando pronta; telas que são a mesma página (People/Leads, Schedule, Operations) trocam sem o esboço, para não perder o estado. Antes a transição segurava a tela antiga até a nova estar desenhada, e o toque parecia ignorado. Uma janela carregada sob demanda abre como a própria janela (ModalLoader: folha de baixo no celular, cartão no computador, conteúdo esboçado), e nenhum aviso (PromptToast: instalar, notificações, atualização) aparece sobre uma janela aberta.
  • Instalar o app: um só guia (InstallGuide) no portão da equipe e no convite do cliente (“How to install” abre o mesmo guia, com as 4 telas do cliente em vitrine no topo, inclusive no Android sem o botão de instalar do Chrome e no computador). Uma ação por passo, em palavras simples, cada uma com o desenho da barra daquele navegador no estilo claro do app e o botão a tocar em azul pulsando; o último passo mostra o ícone real. Safari no iOS 26: ••• → Compartilhar → Adicionar à Tela de Início → Adicionar (antes do 26, o Compartilhar da barra de baixo; a versão vem do Version/ do Safari, porque o iOS 26 congelou o sistema no user agent em “18_6”); Chrome/Edge no iPhone: Compartilhar na barra de endereço; Chrome no Android: ⋮ → Instalar app; Samsung Internet: ≡ → Adicionar página a → Tela inicial; Firefox no Android: ⋮ → Adicionar à tela inicial; computador: ícone de instalar no fim da barra de endereço (Chrome/Edge) ou Arquivo → Adicionar ao Dock (Safari no Mac); navegador dentro de outro app: “Abrir no Chrome” (intent) no Android e “Copiar link” para o Safari no iPhone (iosBrowser). As imagens e a descrição do manifesto só aparecem no Chrome/Edge do Android (e no computador); o iPhone ignora. Notificação web no iPhone só existe no app da tela inicial.
  • A espera da verificação do aparelho (MobileRequirementGate) e das janelas de senha é a mesma tela de “Updating App” (CheckingSplash sobre SystemScreen: ícone girando, barra e uma palavra, “Checking…”), nunca uma página branca com uma frase.
  • Telas fixas de sistema — autenticação, redefinição, boot e falha de conexão — usam o contrato system-viewport-safe: notch/status bar e área de gesto ficam reservados em Android, iOS e PWA, e 100dvh permanece contido quando o teclado redimensiona a WebView. Limites de agenda, menus de conversa/configuração e modais de manual/QuickBooks também usam dvh, nunca uma altura vh congelada pelas barras do navegador. A abertura automática do WhatsApp no orçamento público passa pelo adaptador externo, saindo da WebView privilegiada no app e mantendo o link de fallback na web.
  • O monitor de conectividade pertence ao MainLayout, não a uma página: Dashboard, Agenda, Chat, Perfil e módulos administrativos compartilham o mesmo aviso persistente e os toasts de perda/restauração de rede em browser, PWA, Android e iOS. O aviso distingue capacidade real: atualizações ao vivo pausam e mensagens de chat entram na fila; outras mutações não são anunciadas como cacheadas porque ainda exigem rede.
  • O mesmo contrato vale para textos transitórios e ações: o toast offline promete fila somente para chat, a instalação PWA descreve acesso a dados recentes durante interrupções breves e pull-to-refresh não inicia uma sincronização fictícia sem rede. Ao reconectar, os listeners globais retomam refresh e drenagem das filas.
  • Os sete editores multilinha têm nome contextual persistente. No compositor do chat, enterKeyHint="enter" acompanha a regra por runtime: Return cria nova linha em teclado touch e Enter envia no desktop, sem interceptar composição IME.
  • Os nove select brutos mantêm o picker nativo de cada runtime e publicam aria-label contextual; os demais seletores seguem a associação automática id/label de CFSelect. O doctor protege a fronteira manual.
  • Os 11 inputs brutos restantes fora de labels envolventes — financeiros, assunto, slider e toggles — têm nome direto; o range anuncia valor + unidade. Checkboxes já envolvidos por label e uploads realmente ocultos preservam a semântica nativa, sem atributos redundantes.
  • Button concentra o contrato de processamento: loading desabilita nova ativação, publica aria-busy, mantém o nome original em um status assistivo e torna o spinner decorativo. Todos os consumidores recebem a correção sem UI paralela por plataforma.
  • Todo botão HTML declara type explicitamente; os componentes compartilhados usam button por padrão e aceitam submit somente no ponto de envio. O doctor percorre a AST de todos os TSX, impedindo que composição de formulários ou Return em teclado móvel reintroduza submissões acidentais.
  • Toda tabela de dados possui caption assistivo (ou nome ARIA explícito), e todo cabeçalho HTML tem conteúdo/nome próprio e declara scope="col" ou scope="row". Colunas visualmente vazias de ações, opções ou expansão usam aria-label. O gate AST cobre inclusive tabelas aninhadas e cabeçalhos extraídos em componentes, mantendo o nome da coleção e a associação entre célula e título para VoiceOver, TalkBack e leitores desktop.
  • Colunas ordenáveis publicam aria-sort no <th> e usam um botão nativo interno para a ação; o cabeçalho estrutural nunca recebe onClick. Assim mouse, toque, Enter e Espaço compartilham o mesmo fluxo, e o doctor impede a regressão para células clicáveis sem semântica de controle.
  • Links que abrem outro contexto usam noopener noreferrer e passam pelo provider externo no runtime nativo; tel:, sip:, mailto: e webcal: são encaminhados ao app do sistema. O gate AST protege novas janelas contra opener e impede que protocolos externos permaneçam presos à WebView privilegiada.
  • PageLoader e ModalLoader formam o contrato de carregamento de superfícies: anunciam um status ocupado e educado e ocultam movimento decorativo da árvore assistiva. PageLoader adota tela cheia (system-viewport-safe fixed inset-0 z-[9999]), harmonizado ao formato do Connecting Engine e telas de atualização, eliminando artefatos de caixa/quadrado flutuante. Fallbacks lazy de mapas/feeds seguem o mesmo padrão, e a Edição Rápida usa o loader modal bloqueante em vez de uma espera silenciosa.
  • Ações assíncronas inline que não usam os botões compartilhados publicam aria-busy, bloqueiam nova ativação e escondem ícones decorativos. O gate cobre série recorrente, configurações do chat, teste WhatsApp, análise de incidente/conflito e respostas rápidas.
  • Os controles compartilhados de seleção mantêm um contrato único: CFSelect associa/alerta erros; CFCheckbox usa um input checkbox nativo dentro do card visual; CFTabs usa tablist com roving tab stop e setas/Home/End; CFPillSelector publica estado pressed. Ícones permanecem decorativos sem alterar touch ou haptics.
  • Coleções específicas preservam o contexto do grupo: frequências permitidas usam fieldset/legend; modos de resposta do WhatsApp usam grupo nomeado e cartões com aria-pressed. O mesmo destaque visual continua servindo touch, mas a seleção passa a ser explícita em VoiceOver, TalkBack e teclado desktop.
  • ProgressBar separa semântica e pintura: conclusão/tempo usa progressbar; margem, capacidade, fidelidade e receita usam <meter> nativo assistivo; o preenchimento customizado é decorativo. O componente limita valores e exige nome/texto contextual. Barras empilhadas publicam um resumo único, e segmentos de gráficos com legenda completa são ocultados para não repetir valores em leitores de tela.
  • AdaptiveBottomSheet e o lightbox de chat compartilham o contrato modal: diálogo nomeado, scroll lock, foco inicial/confinado/restaurado e Escape limitado ao topo da pilha que atende também o back nativo. A abertura externa do lightbox bloqueia repetição e publica busy/texto de progresso.
  • O Sidebar assume o mesmo isolamento apenas como drawer móvel: foco entra no primeiro destino, Tab fica contido, Escape respeita a profundidade modal, body fica travado e o gatilho recebe foco ao fechar. No desktop continua landmark complementar sem comportamento modal.
  • ToastCard centraliza a prioridade dos avisos: prompts comuns usam status educado, negações e falhas críticas usam alerta assertivo. PromptToast bloqueia repetição, publica busy e mantém o nome original da ação; banners operacionais do WhatsApp e comunicados globais seguem a mesma severidade, com animações decorativas e dismiss nomeado.
  • PDFs, payslips, invoices, relatórios, gráficos, exports CSV e templates passam pelo provider. O payslip não espera um timer de render: seu documento já montado permanece presente e o disclosure fica bloqueado durante a captura; lock síncrono e epoch por slip.id impedem export duplicado e feedback tardio depois de troca/teardown. A fatura serializa PDF e WhatsApp na mesma trava, mantém o modal aberto enquanto o alvo é capturado, valida status HTTP + resultado da entrega e usa epoch por invoice.id para não concluir na fatura errada. Nenhuma permissão de armazenamento compartilhado é solicitada, e exportToBase64 continua separado para entregas server-side como WhatsApp.
  • O despacho de invoice não é mais uma atualização fire-and-forget com sucesso antecipado. Ele aguarda RequestsApiClient somente para os serviços incluídos e InvoicesApiClient para o documento, passa cada resposta por assertMutationOk e então publica stores, auditoria e notificações. A ação visual possui lock antes do render, bloqueia fechamento/exports, libera loading em finally e confere o epoch antes de háptico ou erro.
  • E-mail de invoice separa entrega externa de reconciliação interna. A resposta do endpoint é validada antes do dispatch; falha real mantém o editor aberto, enquanto entrega confirmada seguida de falha de status gera warning de sincronização sem sugerir reenvio. O composer trava antes do próximo render, mantém draft/inputs durante erro, impede fechamento em voo e invalida callbacks no teardown.

Uma pílula nunca quebra linha (Button com pill, StatusBadge: o texto trunca, os ícones ficam) e o tamanho não depende do texto: sozinha ela tem a largura de pílula única; duas ou mais dividem a linha em colunas iguais (PillGroup). Ícone vai em icon ou iconEnd, nunca dentro do texto. Nos detalhes da visita, o endereço da coluna do cliente copia para a área de transferência; o mapa fica na aba de detalhes.

Os widgets laterais da visita usam um só título (ícone + texto, sem caixa alta). O do cliente mostra a tarifa por hora dele no serviço da tarefa (hourlyRateFor: a própria, senão a do serviço). O de Billing mostra o valor por hora acordado (preço do serviço sem extras ÷ horas faturadas), as horas e a situação do VAT; carpet, por comissão, mostra o valor do serviço, e um cancelado não mostra valor por hora.

A linha do tempo da visita (VisitLifecycleStepper) mostra o número da tarefa, que sai do cabeçalho na aba Details, e cada etapa alcançada abre o lugar dela: Scheduled abre Edit task (só antes do início), In progress abre Evidence (sem ela, Admin → Execution), Finished abre Admin → Execution, Invoiced e Paid abrem Admin → Payment.

O Edit task tem um alcance por etapa (visitEditScope). Antes do início muda tudo. Com a visita iniciada, muda equipe, horas, preço, notas e checklist; data, repetição e endereço são recusados pelo servidor e corrigidos em Admin → Execution, com motivo e prévia. Fechada (finalizada ou cancelada), não abre por nenhum caminho: Issues e Cash check levam ao Admin da visita. A correção de início agendado mantém a duração e os horários reais, é recusada se a visita estiver em um payslip ou no futuro, e faturas emitidas continuam com a data antiga. Cliente e equipe não são avisados dessas correções.

erDiagram
    auth_accounts ||--o{ auth_providers : "possui"
    auth_accounts ||--o{ refresh_tokens : "gera"
    clients ||--o{ service_requests : "solicita"
    clients ||--o{ invoices : "recebe"
    employees ||--o{ service_requests : "executa"
    service_requests ||--o{ invoices : "gera"
    leads ||--o{ chat_channels : "inicia"
    chat_channels ||--o{ chat_messages : "contém"

Toda a operação é em Londres; o admin trabalha do Brasil e clientes marcam de qualquer lugar. Todo horário que uma pessoa lê ou digita é o de Londres, qualquer que seja o fuso do navegador — ou do Worker, que roda em UTC.

  • src/shared/time/london.ts define a regra: londonDate, londonWallClock, londonDateKey, londonTimeKey, LONDON_TIME_ZONE. LondonDate (subclasse de TZDate) tem getters/setters de Londres e serializa como instante …Z.
  • O date-fns só é importado de @shared/time/dateFns, que prende cada função de calendário a Londres. O servidor usa os mesmos módulos por caminho relativo.
  • tests/londonTimeGuard.test.ts recusa import direto do date-fns, toLocale*/Intl.DateTimeFormat sem timeZone, datas montadas no fuso do navegador e o dia UTC como chave.
  • A suíte roda em America/Sao_Paulo (vitest.config.ts); fixtures de teste são horários de Londres.
  • Corrigido junto: campos de data/hora (reserva, remarcação, edição rápida, folga, férias, extensão de série), “hoje” nas telas e filtros, disponibilidade do orçamento público (dia e manhã/tarde em Londres), horário provisório do lead (09:00 de Londres), janela de envio e horário comercial do WhatsApp (o offset configurável deixou de ser lido e saiu da tela), briefing diário, datas no e-mail/recibo/aviso de chegada, data das faturas no QuickBooks e limites da pausa de férias.

Simplificação (2026-09): saíram a sincronização do banco inteiro (/api/sync, useSync, forceSync), que ninguém chamava mais — só o gravador de configurações ficou, em functions/api/atomic/syncSettings.ts —, o simulador de WhatsApp de Settings, o botão de estratégia de crescimento por IA nos Leads, a segunda chamada de IA que escrevia “raciocínio” sobre a rota otimizada e números fixos exibidos como métricas (Marketing “Brand Trust 98%”/“Elite”, Leads “Market reach 85%”, economia de rota de 15%).

People (2026-09-30). Equipe, clientes e leads numa página só (src/pages/People.tsx, view USER_MANAGEMENT, URL /users; a view LEADS abre a mesma página já em Leads). Abas All · Team · Clients · Leads com contagem; os filtros de cada tipo são os de antes (papel e inativos; sem código postal; New · Quoted · Lost); All mostra a equipe ativa, os clientes e os leads abertos. A lista (peopleIndex.ts, PeopleList.tsx) tem uma linha por pessoa — Pessoa · Contato · Agora · Esperando por nós — com quem espera por nós primeiro (pendingFor do cliente, orçamento aberto do lead, staffPending da equipe) e cabeçalhos que ordenam por nome ou por pendência; lead convertido ou juntado não vira linha própria. A busca acha nome, alias (staffNameMatches), e-mail, código postal e telefone em qualquer formato (normalizePhoneIdentifier). Tocar num cliente ou lead abre a PersonProfile (a ficha do painel do Chatwoot) ocupando a área de conteúdo ao lado do sidebar (AdaptiveBottomSheet desktopPresentation="page"), com Message abrindo o chat direto. Um funcionário abre a mesma ficha com o miolo da equipe (StaffProfile). A ficha tem uma forma só (2026-10-07, profileLayout.ts): a linha de ações é Message · Call · a ação principal · More para todo mundo — principal: cliente Book, lead Quote, equipe Advance; pessoa inativa, Activate. Call fica no lugar, apagado, sem número; Message some onde não há chat (a própria ficha, a conversa do painel). More traz Email (se houver), Edit, App link, Make client, Merge, Access, e por último, em vermelho e separados, Deactivate/Delete. As secções seguem a mesma ordem — Overview · o trabalho (Visits; Quotes do lead) · o dinheiro (Invoices; Pay da equipe) · Profile · History — e o resto vive dentro delas: planos do cliente em Visits, chaves e duplicados em Profile; disponibilidade (escala e ausências; editar abre o EmployeeModal) e acesso (app, bloqueio, Google, calendário; “Manage access” abre o StaffAccessControlSheet) da equipe em Profile, que abre com o contato (telefone, e-mail, casa). Quotes do cliente só aparece quando há algum. A Overview da equipe mostra o que espera por nós (staffPending: visita dos últimos 7 dias ainda agendada, sem check-in, depois da tolerância do quadro; sem dados bancários; holerite em rascunho; o item abre a visita, o formulário ou a aba Pay), visitas na semana, holerite em aberto, estado e próximas visitas. A faixa da ficha é a do Operations: as três primeiras secções e o resto em More. As ações vêm da página (staffActions = as do useUserManagementController), nunca de uma cópia; a coluna “Esperando por nós” da lista usa o mesmo staffPending. Outras telas abrem a ficha pela viewStore (personToView, consumido pela People): o resultado de cliente ou funcionário da busca global (SearchIntelligenceService.onViewPerson) e cada nome do card “clientes quietos” do Dashboard. A lista não tem botões de ação. Ninguém da equipe nem cliente é apagado (2026-09-30): a ficha desativa e reativa (o mesmo botão). Cliente desativado (clients.is_active, 0178) guarda todo o histórico, sai da lista (Clients e All; “Show inactive” o mostra, com “Inactive” na linha e na ficha), não aparece para marcar visita, não entra no app (accountSessionDenialReason), não recebe mensagem automática (checkAutomation; STOP e o link de login passam) e o plano dele não cresce (planSeriesExtension). Desativar é recusado enquanto houver visita aberta daqui em diante (visitsBlockingDeactivation, src/shared/clientDeactivation.ts; a ficha avisa e /atomic/clients responde 409 CLIENT_HAS_OPEN_VISITS): o escritório cancela as visitas ou encerra o plano antes. O DELETE /atomic/clients saiu. Só o lead é apagado: pelo Delete da ficha (lead, conversa, orçamentos e a conta de acesso dele — deleteLeadCompletely) ou sozinho, na faxina semanal, depois de 30 dias sem atividade. “+ New”: Client, Staff member, Lead (NewLeadModal). Para administradores, a barra inclui o Google Contacts (GoogleContactsModal, /api/integrations/google-contacts/), que sincroniza automaticamente em tempo real clientes, equipe e leads com a conta Google corporativa ([email protected]) sem duplicidades.

Horas da semana na aba Visits (2026-11-06). A aba Visits da ficha (cliente e equipe) abre com o cartão This week (WeekHoursCard.tsx, conta em weekHours.ts; o mesmo cartão está nas Visits da funcionária): uma barra com as horas já feitas sobre as horas marcadas na semana de Londres (segunda a domingo), “x h done of y h booked” e “z h to go”. Entram as visitas da semana que não foram canceladas; feitas = DONE ou COMPLETION_REVIEW. Na equipe contam as horas da própria pessoa (staffDurationHours); no cliente, as horas cobradas (estimatedEffort).

Menu da gestão (2026-09): um item por tarefa. Daily Desk tem Messages, Full Schedule, Operations e Service History. Sales tem Quotes. Finance tem Billing Center e Staff Payroll. Team tem People e Insights tem Reports. As telas que viraram abas mantêm suas rotas, e notificações e deep links continuam funcionando:

  • Supplies virou aba do Operations; Staff Availability virou o quadro da semana do Full Schedule (2026-09-27).
  • O Financials do gestor virou Reports → Revenue.
  • Quality Control abre Reports → Staff, e Marketing abre Reports → Trust. A lista de clientes em risco foi para Reports → Risk.
  • O Accounting Hub, que nenhum menu alcançava, abre Billing → Cash check. Conferência de caixa, alertas de integridade e QuickBooks agora estão no Billing.

Quality Control, Marketing e o motor de fidelidade foram removidos. Service History fica, porque o Billing não lista faturas pagas.

Configuração sem leitor não existe (2026-09): saíram configurações que nenhum código lia:

  • a aba “AI Engine” de Settings;
  • no painel do chat, os interruptores “Auto-Quote Bot” e “Review Sentiments”;
  • na aba de WhatsApp, a caixa “Hub trainer only” (modos de cancelamento e remarcação e palavras de incidente, usados só pelo simulador removido).

Supplies não pede mais “auditoria de risco” à IA: o aviso de reposição é a própria lista enviada ao cliente. O card “Active accounts” do Reports agora conta os clientes com visita concluída em 6 meses. E os rótulos “Neural…” viraram nomes simples.

Na revisão de Settings saíram também, pelo mesmo motivo:

  • “Admin Fixed Fee / Task”, que nenhuma folha ou fatura cobra;
  • o chat “direto cliente–equipe” e o “horizonte de retenção de dados”, porque nada modera nem apaga com base neles;
  • o fuso UTC do horário comercial;
  • sobras de tipo sem nenhum uso.

Mudanças grátis por ano: “Free late changes per year” (Settings → Profit & Liquidity, padrão 2) é um limite anual calculado, não um saldo salvo. Quando a política cobraria uma taxa, as primeiras mudanças do cliente nos últimos 12 meses saem grátis, até esse número. A mudança perdoada fica marcada na visita (financials.allowanceUse), e é essa marca que a contagem lê. Mudanças antecipadas e a janela de arrependimento não contam. Um cancelamento recusado ou desfeito devolve a mudança. Os campos “support email” e “website” de Identity foram removidos.

Padrões de configuração num lugar só: src/constants/settingsDefaults.ts, lido pelo store e pela carga inicial. As duas cópias já divergiam: o nome da empresa era “CleanFlow” numa e “PRIME CROWN” na outra. A reconquista de cliente fica só em Reports → Risk. A auditoria financeira não levanta mais LTV_STAGNATION nem gera rascunho por IA. O card de continuidade do conflito mostra quantas visitas concluídas cada funcionária fez para o cliente, em vez de um parágrafo de IA.

Sem nível nem pontos de fidelidade no app: nada concedia pontos, e o nível era um rótulo manual. Os dois saíram do cadastro, das listas, dos filtros, da importação e exportação e das telas do cliente. As colunas continuam no banco, e o servidor só lê loyalty_tier = 'LEAD' como marcador legado na ligação de contatos do WhatsApp. “VIP Account” continua. Os rótulos de jargão (“Mission”, “Protocol”, “Signal”, “Fleet”, “nominal”) viraram linguagem simples.

Deploy do app (2026-09): push em main não publica. O app vai ao ar só por npm run deploy:web, que faz upload direto do build local para o Cloudflare Pages. npm run ship faz o push e o deploy em sequência. O script recusa publicar se:

  • houver alteração não commitada;
  • o commit não estiver no GitHub;
  • houver deploy:backend pendente;
  • algum valor do .env.local aparecer no build.

No fim, ele confere se o domínio está servindo o build novo. O build pela integração com o Git parou em 13/09 com “unable to submit build job” e deve ficar pausado no painel.