Skip to content

Módulo 3 - Motor de Agendamento & Recorrência (scheduling)

Módulo 3: Motor de Agendamento & Recorrência (scheduling)

Section titled “Módulo 3: Motor de Agendamento & Recorrência (scheduling)”

Estado actual — confirmação nas janelas. Alocação, cancelamento e prévia de movimento aguardam aceite do servidor; recusa mantém escolhas e mostra erro junto à ação. Cancelamento mantém a visita de origem aberta. A revisão de alocação da série verifica recusas de cada gravação; janelas de duplicação, redistribuição e reagendamento impedem fechamento durante envio.

Estado actual — toque no tablet. Nos quadros Dia, Semana e semana da pessoa, tocar com dedo ou caneta numa visita abre o menu de ações (equivalente ao clique direito), sem selecionar para mover. O arraste fica no mouse; no toque a remarcação é explícita em Editar tarefa. Deslizar permite rolar o quadro.

Estado actual — horas e VAT. O recálculo de preço ao salvar a equipe respeita a base fiscal gravada na visita. A próxima visita com a mesma equipe preserva a duração de trabalho, as horas cobradas, as horas individuais e essa base fiscal; cobrar 3h e pagar 2h permanece separado.

Estado actual — revisão e unificação de sequências. Issues recebe do servidor, na mesma consulta do estado das séries, um card por cliente com fragmentos unificáveis, duas séries no mesmo dia de Londres, visitas futuras fora de sua programação ou cancelada no meio da série; várias séries ativas em seus próprios dias (dois slots de um plano, ou dois planos) são um estado válido e não geram card; o card, a aba e o menu compartilham o mesmo contador. A organização preserva a equipe das visitas movidas e deixa sobreposição de horários e folgas para a gestão da agenda. A revisão é o fluxo único Organizar séries (/recurring-series/organize; ver Ciclo de Vida da Limpeza). Três ou mais visitas abertas futuras fora de qualquer série, com o mesmo serviço, endereço, horário e ritmo próprio (detectVisitRhythm), são detectadas em Issues, nunca agrupadas automaticamente; visita que já está numa série, ou de série encerrada, nunca é sugerida. Uma visita cancelada pode ser reativada pelo cabeçalho (Reativar visita, revertCancellation), como pendente se estiver sem equipe ou agendada se já tiver equipe; o servidor recusa com fatura, depósito, folha ou correção ligados (evaluateClosedVisitMutation). Séries encerradas com visita real, sem série em andamento na mesma programação, aparecem no plano do cliente com Retomar série (/recurring-series/resume): reabre e preenche na hora; dias cancelados continuam ocupados. Cancelar uma série preenche na hora as outras séries ativas do cliente. Quando o card diz “Extends automatically”, o servidor diz o que impede a marcação (/recurring-series/stalls: cliente inativo, última visita sem data, dias ocupados, fatura vencida há mais de 30 dias ou outra visita no horário, com a visita que ocupa o horário; se ela é de outra série compatível, o cartão abre a prévia de união). O resultado de Reativar aparece ao lado do botão, nunca em toast. Cada série oferece Cancelar série a ADMIN/MANAGER: prévia no servidor, taxa e pagamento da equipe de £0 explícitos e uma confirmação atômica encerram a repetição e marcam CANCELLED nas visitas não iniciadas de hoje em diante, preservando datas, equipe, conversas, valores originais e auditoria. Passado e visitas iniciadas permanecem; faturas, depósitos, pagamentos, folha ou correções financeiras bloqueiam a operação até o cancelamento individual pelo fluxo existente. Retry reaproveita o resultado confirmado, e uma alteração após a prévia exige nova revisão. A lista e o Overview mostram somente séries ativas confirmadas pelo estado canônico. ADMIN e MANAGER unificam pela prévia compatível; recurring_series_reviews é só histórico (lido, nunca mais gravado). Quinzenais em semanas alternadas permanecem permitidas. Criação, duplicação, confirmação de orçamento com data e recorrência adicionada a uma avulsa reaproveitam uma continuação compatível única; várias candidatas ou um dia já ocupado na sequência recusam a nova série e encaminham a Issues. Compatibilidade exige cliente, serviço, endereço, periodicidade, horário de Londres e fase do calendário; a unificação preserva tarefas, datas, equipe, valores e auditoria. A prévia de união abre pela decisão: qual série fica e quantas visitas entram. Remarcações individuais preservam seu slot; séries de quatro semanas só são compatíveis quando mantêm a mesma fase de 28 dias. Editar o horário desta e das próximas aplica a hora escolhida; mudar só o dia preserva os horários em Londres. O card Plan do Overview em People reconhece o ritmo quinzenal gravado nas visitas (BIWEEKLY) e mostra Quinzenal, em vez de “No plan”.

Estado actual — remoção de série encerrada. Ao lado de Retomar série, ADMIN/MANAGER podem confirmar a remoção permanente. A operação apaga as visitas futuras canceladas elegíveis, registra a exclusão e retira a opção de retomada. Visitas passadas, iniciadas, com conversas ou com vínculos financeiros são preservadas. O resultado informa quantas visitas futuras foram excluídas e quantas permaneceram.

Estado actual — ficha da série. Em Revisar séries recorrentes, ADMIN/MANAGER veem as pausas para férias vigentes e futuras do cliente e podem configurar ou editar um período pelo formulário de pausa. No telefone a pausa abre na janela compartilhada: o nome do cliente fica numa linha própria, com no máximo duas linhas. Remover pausa desfaz todo o período e restaura as visitas elegíveis na mesma transação, mantendo o registro da operação para auditoria e retries. A edição pausa novas visitas elegíveis e restaura as que saem do intervalo com base na auditoria, em uma transação. Visitas passadas, iniciadas, com vínculo financeiro ou com valores alterados após a pausa exigem revisão individual. No detalhe da visita cancelada por férias, o cabeçalho mostra a badge Férias do cliente e as datas completas da pausa vinculada. A tarefa e os cartões de planos do cliente (inclusive no Issues) abrem a mesma ficha com padrão de Londres, próxima visita, primeira visita agendada e histórico consultado por série, com alternância entre próximas e passadas, marcando divergências e exceções aprovadas. Issues mostra o dia da semana nas visitas fora do padrão. Issues apresenta primeiro a decisão pendente e distingue adotar a programação já marcada, remarcar com prévia e manter as exceções.

Estado actual — mudança de periodicidade. O resumo do plano usa a periodicidade da visita vigente mais recente, preservando o ritmo das visitas históricas. Alterar o ritmo no Editar tarefa reconstrói as próximas visitas ainda intocadas a partir da tarefa editada; check-in vazio ou JSON null não significa visita iniciada. Visitas com execução, conversa ou vínculo financeiro permanecem avulsas. Salvar novamente uma alteração parcialmente aplicada recupera as próximas visitas no ritmo aprovado, sem sobrescrever uma mudança posterior com âncora mais nova.

Estado actual — escopo em série (2026-11-09). Numa visita de série, o Editar tarefa sempre pergunta “só esta / esta e as próximas”, e o segundo leva às visitas seguintes da série em aberto e de dia não passado tudo o que a tela muda: data e hora, serviço, tarifa, preço combinado, horas, equipe, empresa, forma de pagamento, conta, quem recebe (futureCollectorPatches) e, desde 2026-11-09, endereço (antes do início), nota para a equipe e checklist, com todos os itens desmarcados (futureDetailPatches). Extras do cliente seguem a própria pergunta de repetição; extras de pagamento da equipe ficam na visita.

Estado actual — People sem assinaturas da equipe. A seção Team Calendar Subscriptions foi removida de People; sair ou entrar na aba Team não consulta mais o estado dos calendários de funcionários. O componente, o hook e o endpoint exclusivo /api/calendar/ics/employees foram removidos junto com seus textos e testes próprios.

Estado actual — Home do cliente. Coming up mostra inicialmente as três próximas visitas da lista; Recently finished mostra as três mais recentes. Cada seção com mais de três visitas expande e recolhe de forma independente, mantendo a contagem total e a ordem cronológica. A visita em destaque continua separada, sem repetição na lista.

Estado actual — telas do gerente (04/11). No Dashboard do escritório (OfficeSummary), a visão do dia fica agrupada no topo (Today com as pílulas por estado e a lista nominal Needs you now para visitas atrasadas/sem equipe de hoje + Next 7 days, seguidos imediatamente pela TodayTimeline com atalho para a Agenda); Needs attention mantém apenas áreas acionáveis entre módulos sem repetição (sem os tiles redundantes Team today e Plans, e com Quality restrito a avaliações <= 3★, deixando problemas de mensagem exclusivamente em Issues e Messages); Messages traz as contagens e maior espera diretamente nos cabeçalhos de Waiting for a reply e Crew talking with clients (sem caixas KPI duplicadas no topo, deduplicando Since your last visit contra Waiting e exibindo AppAdoptionCard apenas quando há mensagens não confirmadas no app ou quota do WhatsApp >= 80%); Billing mantém os quatro estágios, barra e legenda de aging (ocultando faixas zeradas e abrindo Awaiting payment ao clicar), cobranças pendentes com a equipe (awaitingCrew) e faturas não entregues (notDelivered). Na navegação do Schedule, Today fica sempre visível entre as setas de semana anterior/próxima, inclusive na semana atual; um toque retorna à data de hoje. Operations lista as visitas como linhas da Home (OpsVisitList: dia, cliente, hora · serviço · equipe, total e estado; Assign no lugar quando não há equipe), sem textos de ajuda; “Needs a team” só aparece quando existe. Issues mostra um selo só, sem repetir o estado. No computador os cartões de Issues têm no mínimo 320 px (a grade põe quantas colunas couberem), e nada flutua sobre o conteúdo: abrir a visita fica na linha do nome, a caixa de estado leva rótulo e selo em cima, o fato inteiro abaixo (até duas linhas) e “What can be done” como última linha quando há ações. No celular, o Dia da agenda abre nas visitas, com a linha do tempo recolhida e a busca atrás de um ícone. A janela da visita leva no “…” Duplicate visit e, quando a equipe está atrasada (isLateArrival), Tell the client. Abas em caixa normal.

Estado actual — identificação e disponibilidade. Um cliente/serviço ausente conserva o ID solicitado e aparece como indisponível, sem assumir o nome ou os dados de outro cadastro. Planejador e relatório de capacidade compartilham a leitura dos turnos e afastamentos de cada integrante ativo.

Estado actual — coordenação. Cliente/lead cria um orçamento em /atomic/client-quotes; /atomic/requests não cria visitas diretamente para esses papéis. Reagendamento, cancelamento e decisões de revisão usam planos públicos e fluxos em src/application, preservando Londres, série, taxa, compensação e rollback por versão. Recusas parciais não anunciam sucesso integral. Alocação mantém disponibilidade cumulativa e versões/instantes; uma recusa preserva alterações posteriores na mesma visita. O resgate só fecha sua prévia quando a alocação retorna aceite explícito; recusa permite retry; Worker de conflitos e IA de resgate ficam nos adaptadores, com coordenação cancelável por sessão fora da UI. Recorrência reutiliza os cálculos existentes e contratos financeiros explícitos.

Estado actual — detalhe da visita do escritório. O endereço da tarefa omite o rótulo Main quando o cliente só tem um endereço cadastrado. Valor cobrado ao cliente e custo da equipe dividem a largura igualmente (50% cada), inclusive no celular, com a mesma estrutura interna: valor em cima e recebimento/equipe abaixo do separador; o lucro fica em uma linha própria no resumo financeiro. O indicador de periodicidade abre uma janela sobre a tarefa com as próximas visitas já agendadas da mesma série, em ordem de data, com horário e equipe; visitas passadas, concluídas e canceladas ficam de fora. Cada visita da lista abre seus detalhes sobre a janela, sem fechar a origem. A janela identifica se as repetições automáticas estão ativas ou encerradas pelo estado canônico da série (estado indisponível enquanto não confirmado) e mostra a quantidade, serviço e periodicidade das outras séries do mesmo cliente presentes nas visitas carregadas, sem duplicar a série por visita. Fechar retorna à tarefa original. Oferecer um novo horário usa o botão compacto e arredondado das demais ações. Em visitas confirmadas, o menu “…” oferece Enviar confirmação ao cliente: abre a prévia existente com serviço, data, horário e equipe atuais antes do envio. Checklist, resumo do orçamento, avaliação e o quando e onde usam o cabeçalho de seção do Home. O preço e o lucro continuam os do escritório; a janela de chegada do cliente, as notas de acesso, oferecer um horário e cancelar ficam nesse bloco. No dia e nessa visita (escritório e equipe), cada chave do cliente mostra a descrição e quem a tem, em destaque quando ninguém da equipe a tem; o cliente não vê.

Estado actual — Visits da funcionária. O cabeçalho da tarefa e o calendário da equipe (no app e na assinatura) identificam o cliente pelo nome de exibição, como “Laura - Casa”; sem ele, usam o nome do cadastro. A tela Visits (CrewScheduleView) segue o padrão do Home: o nome da página, a semana para escolher o dia, e as visitas desse dia como linhas do Home — a casa, o horário dela, o serviço e a fase (no local, confirmada, onde o pagamento está, ou concluída). Cada linha abre a janela da visita, onde se começa e termina. O cliente não tem esta tela.

Horas da semana nas Visits da funcionária (2026-11-06). Logo abaixo do título fica o mesmo cartão da aba Visits da ficha (WeekHoursCard, conta weekHours): as horas da própria pessoa já feitas sobre as marcadas na semana escolhida na faixa de dias (This week / Last week / Next week), só das visitas dela, canceladas fora.

Estado actual — abertura de visitas. O detalhe carrega Chat, Evidências e Admin apenas ao abrir a respectiva aba; a espera fica dentro do conteúdo, mantendo cabeçalho, abas e fechar disponíveis. Os alertas de gestão só são calculados em Detalhes para ADMIN/MANAGER. O registro de janelas só assina os dados operacionais enquanto alguma janela está aberta, preservando as janelas de origem quando uma segunda é sobreposta.

Estado actual — custo do quadro. A semana indexa a lista operacional uma vez por dia de Londres, preservando visitas antigas ainda em andamento no dia de hoje. Os quadros base são reutilizados ao trocar filtros/busca; no modo Dia, essas mudanças e a escolha de outro dia da mesma semana não reconstroem a semana inteira. Sem afastamentos cadastrados, o cálculo de disponibilidade não converte intervalos de licença vazios.

Estado actual — choque na sequência. Na criação, no Duplicar e no Editar tarefa, cada visita seguinte cujo horário bate com alguém da equipe pode ficar com essa pessoa ou sem ninguém (seriesCrewKeep, o dia de Londres). Sem essa escolha, e na criação automática do dia, a visita nasce sem ninguém.

Estado actual — semana individual. Na Semana do Full Schedule, clicar no nome abre a agenda semanal do funcionário (PersonWeekSheet), como um calendário: colunas são os sete dias, linhas são as horas, com o cabeçalho, os cartões e as cores da Semana; visitas sobrepostas ficam lado a lado (placeDayVisits), fora do turno fica sombreado, folga/férias com o tom da Semana. Arrastar um cartão para cima/baixo muda o horário (encaixe de 30 min) e para outra coluna muda o dia — sempre pela mesma prévia e confirmação da Semana (planMove); tarefas encerradas não se movem. Clique numa meia hora vazia cria visita ali; o cabeçalho do dia abre o menu da pessoa (a ficha continua nele). Abrir uma tarefa preserva a semana ao fechar.

Estado actual — exibição de horas. Durações nos resumos, agenda, invoices/PDFs e folha aparecem como horas e minutos (2h 15min), sem arredondamento para décimos. Editar tarefa e Team selection recebem duração no formato h:mm (2:15); preços, horas individuais e cálculos permanecem em horas numéricas.

Estado actual — valor acordado. Criar, Editar tarefa e Concluir visita (FinishVisitModal) adotam o mesmo seletor unificado de precificação: alternância entre cálculo por hora e valor fixo combinado (taskEdit.pricingFixed), com exibição de campo dedicado para o valor acordado e cartão unificado de cobrança do cliente com badge de status do VAT (isento, incluído ou acrescido) e demonstrativo de VAT correspondente. O valor manual fica gravado e é preservado ao editar horas e finalizar; alternar para por hora retoma o cálculo por tarifa. Extras e VAT são adicionados separadamente; horas e custo da equipe continuam calculados normalmente. Visitas já faturadas/pagas mantêm o bloqueio e usam a correção financeira existente.

Estado actual — recuperação ao finalizar. Quando a tarefa é aceita mas o recebimento não pode ser confirmado, a janela permanece aberta, conserva os dados e informa que só o pagamento precisa de conferência em Revisar pagamento do cliente. O formulário e a repetição da finalização ficam bloqueados; fechar não exige descartar dados já salvos. A mensagem não afirma ausência de recebimento quando uma resposta pode ter sido perdida. Falhas da finalização conservam os campos e oferecem uma tentativa explícita.

Estado actual — Full Schedule, dia. As setas andam uma semana e mantêm o dia da semana; o dia muda na faixa. As pílulas contam e filtram só o dia seleccionado. No team é a primeira linha; as outras pessoas da semana ficam na linha do tempo mesmo sem visita, para receber a tarefa. Clique direito abre o menu da semana; arrastar ou prender o chip com o botão esquerdo muda a funcionária e o horário nesse dia (perto da linha da hora fica a hora cheia; no meio das duas linhas, a meia hora seguinte); enquanto move, só aparece o cartão tracejado no encaixe, com o resumo da mudança (hora e pessoa), e o bloco de origem some; a prévia confirma o horário em que largou. Esc cancela o movimento feito com o mouse (arrastar ou pegar e clicar, no dia e na semana) e tira o foco da visita (releasePointerFocus) — antes ficava o anel azul de foco até o próximo clique; um movimento pelo teclado mantém o foco. Clique direito numa visita (no toque, a folha da visita) tem Duplicate visit: o escritório escolhe dia e hora (Londres) e o servidor (/api/atomic/visits/duplicate, copiedVisitRecord — o mesmo copiar da série) cria a nova visita com serviço, endereço, horas, preço, empresa, pagamento, checklist zerado e a equipe se estiver livre (senão fica sem equipe, PENDING); de uma visita cancelada a cópia leva o valor com que ela foi marcada (originalPrice/originalVatAmount/originalCost, o mesmo que desfazer o cancelamento devolve), nunca a taxa de cancelamento nem o zero, e o lucro vem de jobProfit; o repasse de carpete não vem junto (o que está gravado é o pagamento do cancelamento), e a folha mostra esse valor; uma visita recorrente reaproveita uma continuação compatível única ou começa uma série nova no novo dia, no mesmo ritmo (dias ou quinzenas alternadas diferentes continuam séries separadas); se o cliente já tem visita nesse horário, a folha avisa e cria assim mesmo — as duas ficam em Issues como “Double-booked” (CLIENT_OVERLAP) até o gestor mover ou cancelar uma; recusa só cliente desativado; canais e confirmação seguem como num agendamento (depósito só pelo painel Deposit). Clique direito no nome da pessoa abre o dia dela, Split route, limpar o dia e editar a pessoa. Criar no vago (2026-10-05): com o mouse, um clique esquerdo num trecho vazio da linha de uma funcionária (não na linha No team, não numa visita, sem visita presa) pergunta “New visit for {nome} on {dia} at {hora}?” com a meia hora clicada (timelineSlotKey: o intervalo de 30 min em que o clique caiu — 10:40 é 10:30); confirmado, abre a New visit (ManagerVisitSheet) já nesse dia e hora e com ela em quem vai (initialStart/initialCrewIds). O clique é lido na janela; no toque, tocar segue abrindo. Só no Dia: na semana o clique na célula não cria (2026-10-06). Quotes no Full Schedule (2026-10-13): acima das pílulas, uma faixa (ScheduleQuotesBanner) conta as quotes abertas que pedem a semana na tela e as sem semana — sem semana pedida ou com a semana já passada (scheduleQuotes: a segunda-feira da preferred_week, domingo lido como a semana seguinte, como no painel; uma semana passada não tem quotes próprias). Tocar abre a lista (nome, serviço, horas, período); Encaixar liga o modo encaixe: a faixa vira a barra da quote (com Ir para a semana pedida, Abrir o pedido e Cancelar), cada pessoa no Dia ganha o período pedido sombreado (manhã 08–13, tarde 13–18, preferredPeriodMinutes; flexível sem sombra), clicar ou tocar num vago abre o QuoteConfirmationPanel já com dia, hora e essa pessoa (sem a pergunta de New visit), e na semana tocar na célula de uma pessoa abre aquele Dia. Fechar o painel sem confirmar mantém o encaixe; confirmar ou recusar encerra, e uma quote fechada noutro lugar sai do encaixe. Não há mais envio da agenda do dia por WhatsApp: cada funcionária vê o dia no app. Tela cheia no computador (2026-10-13): a partir de 1024px o Full Schedule do escritório é uma área de trabalho como o Chat (MainLayout: SCHEDULE, LIVE_TRACKER e STAFF_AVAILABILITY para manager/admin): sem margens nem largura máxima, controles num topo compacto (abas Semana/Dia; período, setas e Today; busca; botões Quotes, Visitas e mapa; pílulas numa linha abaixo; a faixa da semana só no Dia) e o quadro ocupa o resto da altura com uma só rolagem — horas e cabeçalho dos dias fixos no topo, nomes fixos à esquerda (WeekPlanner/TodayTimeline fill; no Dia as faixas sobem de 40 para 56 px). À direita, um painel lateral (OfficeSchedule): Visitas (o DayVisitList de sempre, numa coluna — cruzamentos, estados, ações e sugestão de equipe) abre sozinho no Dia em telas ≥1536px; Quotes (a lista do banner) abre pelo botão. No modo encaixe a barra da quote fica acima do quadro. Celular e tablet mantêm a página de antes (banner, lista sob a linha do tempo); o card Today do Dashboard usa a mesma linha do tempo sem fill.

Estado actual — usabilidade. A descrição do cancelamento é opcional, inclusive ao isentar a taxa; o escritório continua escolhendo quem pediu o cancelamento e se cobra ou isenta a taxa. As tarefas do escritório não têm mais barra de ações acima das abas (removida em 13/10: repetia a aba Admin): editar fica no lápis do cabeçalho e em Admin → Equipe e preço, corrigir valores, recebimento e histórico nas áreas do Admin, cancelar na aba Detalhes, e Finish visit em Admin → Execução quando a visita pode ser concluída (em andamento, ou agendada já no horário). O resumo distingue cobrança do cliente e custo calculado da equipe (não comprova salário pago); a tarifa do editor identifica explicitamente o cliente. Editar e Concluir preservam os dados em rejeição e pedem descarte ao fechar com alterações; durante o envio o fechamento fica bloqueado e os valores exibidos (total do cliente, saldo e valor pago) permanecem estáveis e congelados até o fechamento, prevenindo zeramentos visuais ou alertas de erro espúrios enquanto as gravações atômicas/pagamento são processados. A conclusão mostra horas, total e efeito sobre invoices/recebimento junto ao botão, que identifica quando registra dinheiro. Campos decimais aceitam centavos e os controles principais permanecem acessíveis no rodapé e por teclado/celular.

Estado actual — horas individuais. Team selection, Editar tarefa e Concluir visita (FinishVisitModal) permitem definir horas não negativas por pessoa (inclusive reduzindo até 0h / 0min para manter a colaboradora escalada no registro histórico da tarefa sem gerar custo de mão de obra nem repasse em folha), mesmo quando a soma supera o total acordado ou o preço do cliente está bloqueado. Reabrir preserva essas horas; entradas sem valor usam a divisão igual. O pagamento da equipe usa as horas individuais; no Editar tarefa, a opção existente decide cobrar o excedente ou absorvê-lo quando o preço pode mudar.

Estado actual — permissão de equipe. ADMIN e MANAGER podem adicionar outros managers à tarefa tanto no Team selection quanto no Editar tarefa. Administradores continuam fora da equipe; carpete exige a especialidade correspondente.

Estado actual — equipe do plano. “Esta e as próximas” no Editar tarefa e “Apply to cleaning plan” no Team selection gravam esta equipe nas visitas seguintes ainda abertas. O status é calculado por ocorrência: alocar equipe pode agendar uma visita pendente, mas o início de uma visita não é propagado às demais. O mapa de alocações da série (SeriesAllocationsMapModal) abre quando uma visita futura ficaria em conflito, ou quando a mudança cancela visitas; sem conflito ele não abre e a alteração é gravada. Quando abre, inicializa as visitas futuras com a nova equipe proposta, substituindo a equipe anterior. Horas a mais, deslocamento e descanso não seguram a semana: só uma sobreposição, uma folga ou uma conta suspensa deixa aquela visita com a equipe anterior. A equipe fica escrita na tabela que a lista lê antes da resposta sair — o refetch que vinha a seguir ainda via a equipe antiga e desfazia o plano.

Estado actual — trânsito. Trânsito entre visitas é AvailabilityService.estimateTravelMinutes sobre taskLocation (coordenadas do snapshot persistido, não só addressLat em memória). 30/35 minutos são o piso quando falta endereço, não um buffer fixo em todos os pares. Trecho curto é a pé (estimateTravel, modo WALK/TRANSIT): até 1,5 km em linha reta estima também a caminhada (5 km/h, ruas 1,2× a linha reta, mínimo 2 min) e fica com a mais rápida — antes todo par pagava os 15 min fixos do transporte, até duas casas no mesmo CEP; a penalidade de distrito vale só para o transporte. Vale para agendamento, conflitos, ranking e para o percurso do dia, que escreve “a pé”. Num trecho de transporte o percurso oferece “Ver ônibus”: abre o Google Maps em modo transporte público entre os dois endereços em texto (rua e CEP — o Google acha a casa, mais preciso que o centro do CEP das nossas coordenadas; sem texto, as coordenadas) (transitDirectionsUrl, handleExternalAnchorClick — no app nativo sai do WebView), com linha, ponto e horário ao vivo; nada é consultado nem guardado aqui.

Estado actual — quadro. Na linha do tempo, o deslocamento fica na mesma linha das visitas, tracejado (laneTravel: os mesmos trechos da lista do mapa, posicionados no relógio — de casa termina no início da primeira visita; entre visitas começa no fim da anterior e dura a estimativa), com ícone a pé/ônibus e os minutos, em vermelho e por cima da visita seguinte só quando a chegada passa a janela de 45 minutos de uma visita que segue outra (arrivesAfterWindow, a mesma regra do Issues); dentro da janela o traço fica no intervalo, sem vermelho (sobrepor é o aviso quando passa; numa faixa separada, como foi por um dia, ficava longe das visitas) — o nome e o horário ficam à esquerda e passam para a direita quando um trecho ou outra visita cobre o começo do bloco (labelsOnTheRight, largura mínima incluída), para não ficarem debaixo do que está por cima; o texto completo fica no título (legLabelKey, compartilhado com a lista). Duas visitas da mesma pessoa cujos horários se cruzam (o fim de uma depois do início da outra, incluindo quem ainda está no local) ficam com o mesmo tracejado vermelho, como algo a resolver (overlappingVisitIds); uma cancelada não entra, porque não impede outra tarefa. A pílula Sobreposições, no topo do dia, abre essas visitas agrupadas por pessoa.

Estado actual — visita no ecrã. No detalhe do escritório (ADMIN/MANAGER), Recebimento do cliente abre a fatura da visita quando há uma não anulada — a que ainda se pode liquidar, senão a da visita ou o depósito — na mesma janela em que se regista o pagamento; a equipe não vê o botão. A barra superior, imediatamente antes de Editar, mostra somente a referência curta T-<número>, sequencial e única em toda a plataforma, selecionável para copiar, sem expor o ID técnico na interface nem em tooltip. O servidor numera também as tarefas existentes; editar, remarcar ou apagar não recicla o número. A referência acompanha o painel expandido do chat, os resumos de edição/escala/cancelamento, a conciliação e a folha, além das linhas vinculadas à tarefa nas faturas, no PDF e na página de pagamento. O cliente cancela, remarca e acrescenta um pedido da visita só em /api/scheduling/client-change (a linha nova junta-se às que já estão; a visita ainda não começou; um pedido de novo horário ainda se cancela). Semana em que a equipe não pode: visita PENDING vaga, não omitida. O widget da visita no Dashboard e em Operations (DashboardCard) tem o chat imediatamente à esquerda da seta que abre a tarefa. Uma visita recorrente, no card e no detalhe, mostra o símbolo e o tipo (semanal, quinzenal), sem a posição na série. O detalhe da visita (e o preflight de entrada) mostra o mesmo bloco acima da checklist. O card da visita (DashboardCard e o card da cleaner na agenda) mostra o quoteSummary no bloco data/morada, até duas linhas — o que a equipe lê no local, sem abrir o detalhe.

Estado actual — cancelamento. Cancelamento (2026-09-29): Settings → Cancellation tem um cartão fixo por tipo (ligar/desligar, janela, penalidade; a migração 0172 grava os valores iniciais quando o tipo ainda não existe). A janela do escritório pede o motivo — os nossos não cobram, o pedido do cliente aplica a regra — e, havendo taxa, o gerente escolhe cobrar ou isentar (com nota). Não existe mais franquia anual de mudanças grátis (“Free late changes per year”, removida em 2026-09-29): só as regras de cancelamento decidem a taxa. Remarcar usa os mesmos cartões. Janela que cobraria recusa a mudança do cliente (rescheduleCharges): cancela-se e, se o cliente ainda quiser, marca-se outra visita. Janela sem taxa move a mesma visita. O Edit task e o planner do Full Schedule (arrasto, folha de toque; desde 2026-10-05, inclusive visitas de hoje) são só do escritório (manager/admin) e movem mesmo dentro da janela, grátis, sem taxa (o servidor só recusa RESCHEDULE_CLOSED a quem não é manager/admin); todo “Reschedule”/“Change time” do escritório abre o Edit task. Salvar o Edit task aloca a equipe mostrada também quando a visita tem funcionário mas ainda está PENDING sem alocação (as importadas da planilha) — allocatesOnSave; antes era preciso abrir Team selection depois de mudar a data. Pagar a equipe pelo horário vazio é um valor digitado nesse cancelamento (0 por omissão, dividido entre quem estava escalado); a folha e o resultado só contam esse valor, nunca as horas previstas. A visita cancelada com equipe permanece no horário, na agenda e no Day; não ocupa as horas nem impede outra tarefa. O valor se grava abrindo esse evento.

Ausências da equipe. Para funcionário já cadastrado, adicionar ou remover uma ausência grava diretamente o perfil e aguarda o aceite do servidor; falha mantém o formulário aberto e os dados digitados. O perfil mostra as datas e horários inicial/final em Londres. Na criação de funcionário, as ausências integram o primeiro salvamento do perfil. Escolher uma data preenche o início/fim com o turno cadastrado daquele dia, em Londres, mantendo os horários editáveis; folga sem turno usa dia inteiro e turno noturno preenche o fim no dia seguinte. Registrar ausência não desescala tarefas automaticamente antes do aceite: a equipe das visitas existentes é revista pelo fluxo de planejamento.

Horário da equipe. A linha do tempo do dia marca cada tarefa que ultrapassa o fim do turno de uma pessoa escalada, com nome e horário de término no aviso; tarefas em andamento consideram também o tempo decorrido. Turnos que atravessam meia-noite respeitam o dia seguinte; canceladas e dias sem turno não recebem este indicador de término. O padrão de um funcionário novo (formulário e importação CSV) é segunda a sexta, 08:00–19:00; sábado e domingo ficam de folga e são ligados um a um (src/constants/staffSchedule.ts). Sem turno no dia, a alocação trata como folga (conflito leve).

O módulo Scheduling é o motor de agendamentos do Prime Crown. Ele cuida do ciclo de vida das solicitações de serviço, garante a não sobreposição de horários e projeta agendamentos futuros recorrentes.


A. AvailabilityService (Janelas de Horários Livres)

Section titled “A. AvailabilityService (Janelas de Horários Livres)”
  • Função: Identifica horários disponíveis para agendamento em um determinado dia.
  • Buffer de Trânsito: estimateTravelMinutes (≈25 km/h urbano + overhead de estacionamento; penalidade entre distritos de código postal). Sem as duas coordenadas, usa o buffer conservador (35 min) ou o piso de 30 min — não acrescenta 30 min cegos antes e depois de cada visita.

B. ConflictService (Prevenção de Sobreposição)

Section titled “B. ConflictService (Prevenção de Sobreposição)”
  • Função: Audita qualquer nova solicitação ou reagendamento.
  • Validações:
    • Garante que a funcionária alocada não tenha dois serviços no mesmo horário.
    • Verifica se o cliente possui mais de um agendamento no mesmo endereço simultaneamente.

C. RecurrenceService (Motor de Recorrência)

Section titled “C. RecurrenceService (Motor de Recorrência)”
  • Função: Projeta os próximos atendimentos com base na frequência contratada:
    • Weekly: Agenda a cada 7 dias no mesmo dia da semana.
    • Bi-weekly: Agenda a cada 14 dias.
    • Every 4 weeks: Agenda a cada 28 dias, no mesmo dia da semana e horário de Londres.
  • Semana em que a equipe não pode (2026-09-11): a visita é criada sem ninguém (PENDING, aparece como visita vaga no painel de conflitos) em vez de ser descartada. Só a data em que o cliente já tem visita é pulada. generateOccurrences devolve conflicts (puladas) e unassigned (criadas sem equipe); a criação da reserva avisa “Weeks to allocate”. Antes a extensão de série e a retomada perdiam essas semanas em silêncio. Só choque real esvazia a semana (sobreposição, folga, conta suspensa): folga de deslocamento, descanso e horas semanais são isSoftConflict — aviso, a equipe fica, porque o gestor já aceitou isso na visita-base. Vale para createChildOccurrence e para o cron recurrence-auto-extend (sem os 30 min de margem). Antes, a Juliana saindo de uma visita às 15:00 e entrando na da Eliza às 15:00 deixou as 8 semanas estendidas sem ninguém.
  • Planos recorrentes (sem aba própria desde 2026-09-25): a aba Recurring do Operations saiu. Onde se edita um plano: a aba Plans da ficha do cliente (ClientModal, só cliente salvo) e o painel do Chatwoot mostram ClientPlans (src/components/recurring/ClientPlans.tsx, useClientPlans(clientIds)): um RecurringSeriesCard por plano, com Editar plano recorrente (abre o Editar tarefa na próxima visita aberta — ou, plano que precisa de data, na última — já em “Esta e as próximas visitas”) e a mensagem com a agenda ao cliente; o painel traz também a pausa de férias (a ficha já tem a sua). Problemas de plano ficam no Issues: a última visita PENDING num dia passado (antigo “Precisa de data”) já é uma visita que ficou aberta (filterGhostedTasks); plano parado sem visita futura é “Sem próxima visita”; plano sem equipe aparece em Needs a team (Overview) e no conflito No team. As ações de uma visita recorrente em Issues (ficou aberta ou No team) incluem Edit the visit (o Editar tarefa; o alcance escolhe só a visita ou o plano). A view RECURRING_HUB e a busca de planos por pessoa (searchPlansByPeople) foram removidas.
  • Extensão Automática de Séries (Cron): não há extensão manual; o sistema executa a rotina /api/cron/recurrence-auto-extend todo dia via dispatch-scheduled (regra em “Séries no servidor”, abaixo). Séries ativas com menos de 60 dias de cobertura recebem novas visitas projetadas. Visitas com conflito de agenda da equipe habitual são criadas desatribuídas (assignedEmployeeIds = [], status PENDING), sendo direcionadas automaticamente para o quadro de Issues (OpsCommander > Issues) para realocação manual pelos gestores, enquanto planos de clientes com dívidas vencidas há mais de 30 dias são pausados por segurança.
  • Abrir tarefa por toast ou notificação fica na tela atual: handleViewRequestFromFeed (App.tsx) só vai ao Dashboard se a tela atual não abre tarefas (TASK_OPENING_VIEWS: Dashboard, Schedule, Operations, o Day de hoje e a aba Issues); o Operations lê requestToView e abre a tarefa na aba Overview — no Full Schedule fica no Full Schedule (é onde o push de atraso chega). Antes, tocar no toast “Team Updated” (que no celular fica sobre o botão Save da tarefa) levava ao Dashboard.
  • Visão geral do Operations: Needs team (PENDING sem equipe), Awaiting confirmation (PENDING com equipe, só quando há itens; a mesma divisão do dashboard, awaitingConfirmation) e Scheduled. Uma quote confirmada com a equipe escolhida nasce PENDING com equipe e aparece na segunda até alguém confirmá-la no Team selection; antes não aparecia em nenhuma das listas.
  • Janelas com resumo em duas etapas (2026-09-28): o padrão do Change billing — a primeira tela só escolhe, Continue abre na mesma janela um resumo com as opções que ampliam o alcance, e o resumo é a confirmação (as caixas useConfirmation que vinham depois saíram). Team selection (AllocationModal): equipe e horas; o resumo mostra dia, equipe com horas e o status em que a tarefa fica, e traz Apply to cleaning plan. Cancelar (CancellationModal) é uma tela só desde 2026-10-21: o dia, o motivo (o escritório escolhe Client asked / nosso lado primeiro, e a taxa aparece depois disso), a taxa (dispensa, piso do depósito), Cancel the rest of the cleaning plan e um botão; o cliente lê que o escritório confirma. Editar tarefa (QuickEditTaskModal): só vai ao resumo quando há “Apply to future visits” a oferecer ou dia passado — o resumo lista o que muda na visita e traz a opção com a prévia das próximas; edição simples salva direto.
  • Uma janela edita qualquer visita (2026-09-28; modernizada em 2026-10-16): o Editar tarefa (QuickEditTaskModal) organiza a edição em 4 abas segmentadas (Agendamento, Equipe, Faturamento e Notas), mantendo os campos montados para acessibilidade e preservação de estado: dia, hora, duração com presets rápidos (+1 Semana, Amanhã, Horários padrão), equipe e horas individuais de cada um com resolução rápida de conflitos (1 clique para remover choque), repetição, tarifa, empresa, pagamento e notas. Um banner de recorrência oferece acesso direto ao Mapa da Série (SeriesAllocationsMapModal) para conferir e editar alocações das visitas futuras da série. Na confirmação, o rodapé exibe um resumo ao vivo das alterações pendentes. Numa visita de plano (ou quando tarifa/empresa/pagamento mudam) o resumo pergunta o alcance: Só esta visita ou Esta e as próximas visitas (em avulsa, “Também as próximas visitas de {cliente}”), com a prévia. Todo “reschedule” do escritório (Issues, Full Schedule, painel do Chatwoot) abre essa janela via TaskActionRegistry; a antiga janela de remarcar (RescheduleAndLocationModal, com taxa de remarcação) e a EditRecurringPlanModal foram apagadas — o escritório não cobra taxa ao mover. O cliente continua pedindo semana e período (ClientRescheduleSheet). O Team selection segue separado, como a ação rápida de escalar. Nova visita do escritório em etapas (2026-09-29; modernizada em 2026-10-16): a ManagerVisitSheet foi reconstruída em formato modal padronizado com stepper guiado interativo no topo (1 Cliente, 2 Endereço, 3 Serviço, 4 Agendamento & Detalhes). A janela já abre no tamanho amplo no desktop (initialMinHeight: 620px e container interno de no mínimo 500px), sem começar pequena ou encolhida nem sofrer saltos visuais conforme o gestor manipula os campos ou avança de etapa. O passo 1 exibe leads além dos clientes: a lista inicial pré-carrega os contatos recentes (clientes e leads ativos) e a pesquisa filtra instantaneamente ambos, diferenciados por tags e crachás visuais claros (“Cliente” e “Lead”). Ao selecionar um lead, seu endereço é pré-carregado no passo 2; ao concluir a reserva, o lead é convertido em cliente no banco de dados (leads.status = 'CONVERTED'), seus endereços são movidos para o cliente e as conversas de chat/canais são unificadas. Badges contextuais no topo permitem revisar e alternar entre passos já concluídos com 1 clique sem perder o progresso. A escolha de preço foi unificada no modelo exclusivo (ou Por hora ou Valor fixo combinado, nunca os dois simultâneos). Ao configurar uma repetição recorrente, o gestor pode tocar em “Ver mapa e alocações da série” para pré-visualizar ou ajustar as futuras alocações e equipe de cada visita no SeriesAllocationsMapModal. A janela conta com proteção contra descarte acidental de alterações (useUnsavedTaskChanges) no rodapé ao cancelar. Fluxo natural (2026-10-05): a ordem passou a 1 Cliente → 2 Endereço → 3 Serviço → 4 Dia, equipe e preço. O endereço novo ou corrigido usa a busca por postcode do cadastro (UKAddressAutocomplete: acha rua e cidade pelo postcode, pede o número). No passo 4 (QuoteConfirmationPanel, também no fecho de quote) vêm primeiro Dia e hora; as sugestões logo abaixo, como alternativa; depois horas e preço por hora (o preço final aparece no cartão de cada empresa, com o VAT; só sem empresa ele fica ao lado); na visita nova o painel não tem cartão próprio — fica direto no cartão do passo 4, e os campos não têm caixa; Repeats, que só aparece com um dia escolhido — o detalhe dia a dia da série (QuoteSeriesInsight) abre recolhido (o cabeçalho mostra a cobertura; falhas e datas melhores ficam à vista); só então quem vai (o ranking e a cobertura da série leem dia, horas e repetição); por fim resumo, empresa e pagamento; a mensagem de confirmação do WhatsApp também abre recolhida (o título abre; o selo da janela de 24 h fica à vista). Na visita nova a data abre vazia (o escritório costuma saber o dia); no fecho de quote ela ainda abre na opção 1, que respeita a preferência do cliente. Dia e quem vai juntos (2026-10-13): quem vai subiu para logo abaixo do dia e hora (o escritório costuma chegar do Full Schedule com os dois decididos; o ranking continua lendo horas e repetição, que ficam abaixo); as sugestões de horário e o Smart Rebalance ficam num bloco dobrável (“Suggested times”), aberto quando o painel abre sem dia e dobrado quando abre num dia escolhido (initialStart). A hora digitada é lida como relógio de Londres (parseLondonWallClock), a mesma que a confirmação grava — antes a leitura de equipe e o rebalance usavam o fuso do navegador (do Brasil, 11:00 virava 15:00 de Londres). Serviço (2026-09-29): o Editar tarefa também troca o tipo de serviço; o preço sai da tarifa do novo (a do cliente para ele, senão a padrão) e a tarifa digitada para o antigo é limpa. Carpete só troca com carpete e serviço por hora com serviço por hora (comissão não é horas × tarifa). Visita faturada ou paga não troca. Num plano, “Esta e as próximas” leva as visitas abertas seguintes não faturadas ao novo serviço, com o preço dele (futureServicePatches), e o servidor enche o resto a partir da última.
  • Edit task recusado mostra o porquê (2026-09-30): a recusa do servidor aparece no rodapé da janela (updateRequest(..., { onRefused })), não só num toast que ficava atrás dela. Mover uma visita para o horário de outra do mesmo plano — cancelada inclusive — responde 409 SERIES_SLOT_TAKEN com a data (seriesSlotClash em /atomic/requests) em vez de um 500 do índice idx_service_requests_series_slot. Uma visita cancelada abre só para leitura, com a dica de reverter o cancelamento.
  • Aviso ao cliente desmarcado (2026-09-29): no Editar tarefa, “Notify client on WhatsApp” só aparece quando a data ou a hora mudam e vem desmarcado: o escritório marca quando quer avisar. Voltar à data e hora originais desfaz a marcação, e a próxima mudança pergunta de novo.
  • Um dia só: Full Schedule → Day (2026-10-08). O Live Board do Operations saiu: era o mesmo dia (buildDayBoard, TodayTimeline) numa segunda tela. O Day do Full Schedule é onde o escritório planeja e acompanha o dia: arrastar/mover, clicar no vazio para criar, e o menu da visita com o que o estado pede (ver Field operations). Os links do antigo Live Board (LIVE_TRACKER: botão Tracker no celular, cards do Dashboard, push de atraso lateArrivalUrl) abrem o Full Schedule no Day de hoje (Schedule openOnDay); com reqId, no dia da visita, com ela aberta. Embaixo da linha do tempo, os cards das visitas (DayVisitList + TodayVisitRow): primeiro as sobreposições da mesma pessoa, depois uma seção por estado, só as que têm visita, cada card com as ações do estado (actionsFor) e, sem equipe, a sugestão do ranking. No Day, além das pílulas de planejamento, Overlaps, Late (num dia passado, Left open), On site, Coming up, Finished e Cancelled filtram a linha do tempo e os cards (visitMatchesFilter com o estado do quadro e dayOverlapIds; só no Day, e pílula sem visita não aparece). O botão de mapa no canto da linha do tempo abre o dia em página cheia (ScheduleDayMap → DayMapSheet; hoje, a posição da equipe relida a cada minuto). Cada dia é buildDayBoard(requests, dia, agora) (src/components/operational/todayBoard.ts): toda visita não cancelada do dia; hoje também leva as IN_PROGRESS de dias anteriores (check-out esquecido). Estados: Late (hoje: agendada com equipe, 15 min após o início sem check-in; num dia passado Left open: tudo que não foi concluído), On site, Coming up, No team, Finished. A linha do tempo (TodayTimeline) tem uma faixa por pessoa (visita com duas pessoas aparece nas duas; sem equipe primeiro), de 07–19h no mínimo; o traço vermelho (agora) só aparece hoje; sobreposições da mesma pessoa viram sub-linhas. A agenda não se move em tempo real: cada visita fica no horário agendado — início + jobDurationMinutes —, mesmo no local ou concluída; check-in e check-out são só registro interno (horas feitas, “passou do previsto”), nunca esticam nem deslocam o bloco, e uma visita que passa do previsto não vira sobreposição. A rota de uma pessoa (laneRoute, na ordem agendada) abre na janela do dia (PersonDaySheet + DayMapCard). Ao lado de cada nome na linha do tempo, as horas do dia (laneHours: feitas = tempo do check-in ao check-out, ou até agora no local; previstas = soma das durações). O percurso começa em casa (homeAddress com coordenadas; sem isso a lista avisa) e mostra entre as paradas o deslocamento estimado (AvailabilityService.estimateTravelMinutes, o mesmo do agendamento), em vermelho quando não cabe no intervalo e a visita seguinte ainda não começou. A posição de cada visita vem da cópia na visita e, sem coordenadas ali, do endereço do cliente (visitPoint) — as coordenadas saem do CEP (ver Cron → Coordenadas de endereço).
  • O deslocamento também no lado da funcionária (2026-09-24): personDayRoute (visitPlace.ts) é o percurso do dia lido pela própria pessoa — buildDayBoard + laneRoute + routeLegs, sem canceladas, cada visita com o trecho até ela (de casa na primeira). O Home (Dashboard) da funcionária é o que ela faz hoje (2026-09-24, EmployeeDashboardView), cada bloco só quando tem conteúdo: a visita da vez (NextVisitCard: a que está em andamento → Clock Out; senão a próxima de hoje, atrasada incluída → Clock In; senão a próxima agendada, sem botão de ponto), com endereço, como entrar (accessNotes do endereço, resolveTaskAddress), o trecho até lá, Chat e Details; mensagens não lidas (soma de unreadCount, abre o Chat); “Your route today” (MyDayRoute): casa, cada visita em ordem com o trecho antes dela, as notas de acesso e o total de deslocamento — quando não resta nada hoje, a rota de amanhã; o título (com “View” à direita, como um botão) abre o Visits naquele dia; as paradas não são clicáveis (hoje, ou amanhã na rota de amanhã; scheduleDayToView no viewStore, lido uma vez pelo useScheduleController), não uma tarefa; as chaves (ver Field operations); horas da semana (laneHours somado de segunda a domingo: feitas de previstas); e o último holerite. Sem visita hoje nem próxima, “Free today”. Os KPIs e as listas de visitas saíram: repetiam o Schedule. O Schedule dela mostra o trecho no topo de cada cartão do dia escolhido. O trecho é um componente só (TravelLeg: a pé/ônibus, minutos, vermelho quando não cabe, “See buses”), o mesmo da rota do escritório; nas telas da funcionária (fromHere) o “See buses” vai sem origem — o Google Maps parte de onde o celular está, não do endereço anterior; no escritório segue de parada a parada. A barra superior do Schedule da funcionária é uma semana de segunda a domingo (WeekStrip sobre weekDayKeys), da anterior à próxima — três semanas de visão (weekOffset, WEEKS_AROUND = 1, setas desativadas nos limites); as setas movem a semana inteira mantendo o dia da semana (sem botão “Today”: ficava por cima das datas), ponto no dia com visita; o cliente segue com a faixa de 30 dias (DateScroller). O Calendar sync (CalendarSyncPanel) está oculto no Schedule da funcionária e do cliente (2026-09-24, SHOW_CALENDAR_SYNC = false em ClientScheduleView): o app é a agenda completa; volta depois no Home, opcional, como lembrete de sincronizar. O componente e o feed ICS continuam. A funcionária já recebe no boot a própria casa e os endereços dos clientes das suas visitas — nada novo no servidor.
  • Busca por cliente ou funcionária (Dashboard e Operations): um campo acima das listas do Dashboard do admin e da aba Overview do Operations filtra as visitas pelo nome ou apelido do cliente e da equipe escalada (visitPeopleMatcher, src/shared/visitPeopleSearch.ts; campo VisitPeopleSearchField). Cada palavra precisa bater com o cliente ou alguém da equipe: “smith ana” mostra as visitas dos Smith feitas pela Ana. No Dashboard as aprovações de pagamento filtram só pelo cliente. Enquanto se digita, as sugestões de clientes e funcionárias aparecem em janela flutuante suspensa sem empurrar a lista ou elementos abaixo (visitSearchPeople, funcionária por staffName, até 12 por grupo; fecha ao clicar fora ou com Esc); tocar num nome troca a busca por ele. A aba Overview não tem mais KPIs (Issues, Unstaffed, Coverage, Team): as contagens já estão nos cabeçalhos das listas e no badge da aba Issues. O Operations abre direto nas abas (sem o título “Service Operations”; fica um h1 só para leitor de tela). Cada aba abre direto nos seus controles (TabToolbar, sem título visível — a faixa de abas já diz o nome; fica um h2 para leitor de tela): pílulas e busca no Overview e no Issues, a semana e as setas no Availability; Key Custody e Supplies abrem no conteúdo. A faixa (PageTabBar, src/components/shared/) mostra Overview, Issues e Recurring; Key Custody, Availability e Supplies ficam em More e entram na faixa enquanto abertas. Ela fica presa no topo da rolagem, logo abaixo da barra de alertas, opaca e de borda a borda (cancela o page-top-safe e as margens laterais), e é o primeiro filho da página: um h1 antes dela, dentro do space-y, a empurrava para baixo. O StabilityWidget saiu (auditava só 100 visitas, com texto fixo e caixa “100% OK” repetindo o all clear); problemas ficam na aba Issues. As listas do Overview têm cabeçalho de uma linha (OverviewListHeader: ponto, título, contagem, legenda), e o “Staff load” do dia saiu (as horas por pessoa estão no Full Schedule). Pílula zerada não aparece (StateFilterPills, para todas as telas): só All e a pílula escolhida ficam mesmo com 0. O Overview segue o padrão de pílulas (OverviewToolbar): uma linha com pílulas StateFilterPills (All, Needs a team, Awaiting confirmation, Confirmed visits — contagens seguem a busca e contam os cards: uma série conta uma vez, pela visita atual, não por cada visita à frente) e a busca; uma pílula mostra só a sua lista, com estado vazio quando não há nada. Issues → Hours don’t add up (2026-10-05) (hoursMismatches, operationsIssues.ts): visita aberta de hoje em diante, com equipe e cobrada por hora (carpete não), cujo calendário não ocupa horas ÷ equipe (ou a maior das horas de cada pessoa). Horas da equipe além do combinado (2026-10-08): no Edit task e no Finish visit as horas de cada pessoa podem passar das combinadas. No Edit task as horas cobradas viram o total da equipe e o cliente paga a diferença (billedHoursFor), a menos que o escritório desligue “Charge the client” — aí o cliente paga o combinado; menos horas nunca baixam o valor. No Finish visit as horas confirmadas são as cobradas, inclusive abaixo do combinado, e desmarcar a cobrança das horas a mais mantém o combinado. O combinado fica em financials.agreedHours enquanto as cobradas passam dele, e o aviso “+x h over the x h estimate · charged to the client / paid by us” (hoursOverAgreed) aparece no editor, nos Details (VisitSummary) e nos cards do Day; preço travado mantém o combinado como teto (somar menos é permitido: cobradas 10 h, pagas 8 h, as 2 h ficam com a empresa — as horas por pessoa agora valem também para uma pessoa só, no Edit task e no Team selection; mudar as horas cobradas volta à divisão igual). Fix the length grava a duração certa (divisão igual); horas por pessoa erradas abrem o Edit task. Uma pessoa com 0 h é treinamento (2026-10-05): está na visita sem dividir as horas e não recebe por ela (o Edit task e o Team selection descem até 0; a folha paga 0, calculateEmployeeEarnings); a outra leva as horas cobradas e o calendário ocupa a maior delas. O pagamento fixo do treinamento é feito na folha. Nasceu da T-206: o Edit task gravava realDuration = horas cobradas ao salvar sem mudar preço nem equipe — corrigido, ele grava horas ÷ equipe mostrada. Issues → conflitos (ConflictService, no Web Worker de conflitos): Double-booked, Not enough travel time (TRAVEL_GAP: duas visitas da mesma pessoa no mesmo dia de Londres sem sobreposição, mas com intervalo menor que o deslocamento de estimateTravelMinutes — o mesmo do agendamento; só enquanto a segunda está por vir e sem check-in; ações Reschedule, Reschedule the other, Choose team), Long wait, Not started, Usual cleaner free, No team. Visita sem equipe que é a última não cancelada do plano (planTailIds em buildDashboardRelationshipIndex) avisa no card, para staff: “Last visit of its plan: new ones copy no team” — o cron copia a equipe dela.
  • Equipe nos cards de tarefa pelo nome: o card do Dashboard/Operations e a linha do Service History mostram a equipe em chips coloridos (AssignedStaffChips), não só a inicial: a pílula inteira num tom só (fundo, borda e nome); o tom vem da cor da funcionária ou do nome, e dentro do mesmo card ninguém repete tom. O chip usa o apelido, senão o primeiro nome; duas pessoas com o mesmo nome na tarefa viram nome e sobrenome (staffChipLabels). Até 3 chips, o resto vira “+N” com os nomes no title.
  • Barra de abas nas páginas do escritório (2026-09-26): Billing (Pool, Drafts, Awaiting; Voided, Cash check e Integrity em More, com Reconcile como ação do More; o modal do QuickBooks saiu em 2026-09-29), Leads, Payroll, Reports (Stats, Revenue, Margin; o resto em More; Export num botão pequeno abaixo), Team e Notifications (só gestão; limpeza e cliente mantêm o cabeçalho) abrem na PageTabBar, sem o PageHeader grande. No More, cada aba mostra o seu contador e o botão ganha um ponto vermelho quando uma aba escondida tem contador. Settings também: os quatro grupos (Business, Operations, Messaging, Admin) são as abas da barra e as seções do grupo aparecem numa linha de pílulas logo abaixo, com “Unsaved changes” ao lado; o menu kebab (SettingsMenuKebab) saiu. Full Schedule: Week e Day são as abas; a linha abaixo traz o período, a pílula Today (só fora da semana atual, em Week e em Day; volta para hoje — antes Week mostrava “W41” mesmo na semana atual), e as setas (o envio da agenda do dia por WhatsApp saiu em 2026-10-05: cada funcionária vê o dia no próprio app). Quotes: cada grupo (Cleaning, Carpet, Declined, Booked — só os que têm orçamentos) é uma aba com a contagem; os dois primeiros à vista, o resto em More. Dashboard do escritório (OfficeSummary + useOfficeSummary, desenho de 2026-09-27; sem barra de abas desde 2026-10-01 — é uma página só, abre direto no conteúdo): no topo, Hoje — a data de Londres, “x de y visitas concluídas”, uma barra segmentada e as contagens por estado do dia (Finished, On site, Late, Coming up, No team → o Day de hoje); abaixo, no desktop em duas colunas: à esquerda a linha do tempo do dia (a mesma TodayTimeline do Day; a visita abre o detalhe, o nome leva ao Day de hoje) e Próximos 7 dias (pela regra do dia, weekAhead; desde 2026-10-06 a altura da barra são as horas de trabalho do dia — as horas cobradas de cada visita, estimatedEffort, senão a duração —, e dentro dela a parte com equipe (azul) e sem equipe (âmbar), cada uma com o número de visitas quando cabe; o total de horas fica em cima); à direita Needs attention — uma linha por área — e Faturamento (recentTakings: trabalho realizado sem VAT e líquido de reembolsos, splitVatNetOfRefunds, dos últimos 7 dias contra os 7 anteriores, dentro dos 14 dias que o boot guarda). No celular, Needs attention vem logo depois de Hoje. As áreas de Needs attention são: Operações (precisam de equipe, aguardam confirmação → Overview), Issues, Quotes (abertos, o mais antigo), Leads (novos), A faturar (£ do Pool), Awaiting payment (£ em aberto, atrasadas, pagamentos para aprovar), Cash check e Mensagens (conversas não lidas) — cada um abre a tela e a aba que conta (billingTabToView no viewStore para as abas da Billing). Cada número vem da regra da própria tela (overviewLists e countVisitCards compartilhados com o Overview, useOperationsIssues, historyInvoiceStatus); área sem nada some; sem nada, “Tudo em dia”. As listas do Dashboard saíram (AdminDashboardView, AdminMissionSectors): o que só existia lá mudou de casa — Review virou um tipo de Issues (needsReview: revisão de cancelamento, pedido em revisão, concluída numa fatura rascunho; a de dia passado continua em “ficaram abertas”) e a aprovação dos pagamentos que o cliente diz ter feito foi para o topo de Billing → Awaiting (PaymentClaimsSection). Limpeza, cliente e lead mantêm a saudação. Adaptativa (2026-10-01, em todas as páginas que a usam): a PageTabBar mede as abas numa cópia invisível e mostra quantas couberem na largura (primárias e depois secundárias, na ordem); o que seria cortado vai para More, que só aparece quando há o que guardar ou ações da página. A aba aberta fica sempre à vista no seu lugar. Recalcula ao redimensionar, ao mudar um rótulo ou contador e quando a fonte carrega (fitTabs).
  • Billing, filtros (2026-09-26): uma linha (BillingToolbar): a busca exata de cliente ou staff (visitPeopleMatcher no controller; filtra as visitas do Pool e as faturas das abas, e os nomes sugeridos vêm do que a aba mostra) e, só no Pool, o período — as abas de fatura nunca foram filtradas por ele. Saíram o select de cliente, o selo “auto filter” e o agrupamento de faturas por cliente que nada lia (useInvoiceGrouping).
  • Filtros no mesmo padrão (2026-09-26): Leads — no Pipeline, pílulas New/Quoted/Lost e a busca por nome ou telefone; a taxa de conversão virou uma nota na linha e os três KPIs saíram (novos = pílula, conversões = aba Archive); Merge foi para o More. Team — pílulas por papel (Admin, Manager, Staff; contam o que a busca e “inativos” deixam) mais o toggle de inativos no Staff, All/Missing postcode no Clients, uma busca só para todas as larguras e Export/Import/Add pequenos na linha. Notifications — o select de categoria virou pílulas com contagem (seguem o toggle Unread) e Mark all ficou na linha; as buscas de Activity e Errors ficaram compactas. Payroll — Generate e Close period numa linha fina à direita.
  • Service History segue o Operations (2026-09-26): abre na mesma PageTabBar (Jobs, Invoices, Payments; Audit em More), sem o título grande. Os filtros viraram uma linha (HistoryToolbar): pílulas StateFilterPills da aba (Jobs por estado, Invoices por estado, Payments por forma de pagamento, Audit por sinal), a busca exata de cliente ou staff (VisitPeopleSearchField + visitPeopleMatcher; faturas e pagamentos casam só o cliente) e, embaixo, o período e o Export. Uma pílula sem nada no período não aparece, salvo a escolhida; as contagens seguem período e busca (useHistoryData → counts). Saíram os selects de cliente, staff, estado e forma, a busca livre por serviço/notas e o cartão de contagem (o All da pílula já diz). Os três números da aba ficam numa faixa fina (dl de três colunas, sem ícones) no lugar dos cartões KPI grandes; a nota média sem nenhuma avaliação no período mostra “—”, não um 5.0 inventado. As quatro abas são uma lista só (RecordList, src/components/history/): no desktop, linhas compactas com colunas ordenáveis (data, cliente e o que é, equipe/forma/sinais, estado, valor); no celular, cada registro em duas linhas (cliente e valor; data, serviço e estado) e a equipe ou os sinais embaixo, sem tabela larga rolando de lado. O Audit perdeu as pílulas próprias (a barra já filtra por sinal); no Jobs o cabeçalho tinha uma coluna a mais (“N records”) e o Profit ficava fora do lugar. Um pagamento de fatura abre a fatura por baixo da linha. Fatura atrasada é uma regra só (historyInvoiceStatus, useHistoryData.ts): devida (SENT, PENDING_REVIEW ou OVERDUE — rascunho nunca, como no aging do Billing) e com vencimento passado, ou já gravada OVERDUE. A pílula Late, o número Late da faixa e o selo da linha contam as mesmas faturas; antes a pílula lia só o status gravado e a faixa contava rascunhos. “Awaiting payment” também deixou de somar rascunhos. Contam só faturas cobradas (2026-09-29): rascunho e anulada (DRAFT, VOID) ficam fora do All, da lista do All e do Billed da faixa — aparecem só na própria pílula; em Payments entram só pagamentos COMPLETED de faturas não anuladas (a regra de /api/billing/received). Mesmos números dos outros módulos (2026-09-29): a faixa de Jobs é o P&L dos Reports sobre as visitas listadas (ProfitLogic.calculateNetPL: só trabalho realizado, sem VAT, menos reembolsos; no All soma as taxas de fatura como os Reports) — antes somava o preço gravado de tudo, agendadas e VAT absorvido incluídos. Payments não lista mais recarga de wallet (gastá-la numa fatura já é um pagamento WALLET_CREDIT; contava duas vezes). O GET por período de faturas devolve as emitidas no período e as com pagamento datado nele (pagamento de setembro numa fatura de agosto sumia), e só preenche itens/pagamentos pelas tabelas quando as colunas do documento estão vazias (regra do enrichInvoice do boot) — antes mostrava pagamento pendente como COMPLETED e escondia os gravados depois do último save. Os Reports leem o período em dias de Londres (parseDate), como o Service History. Rótulos da faixa, colunas, estados vazios e detalhes do Audit passam por t() (pt-BR).
  • O cliente vê a equipe da visita: a lista de funcionárias do cliente não tem a equipe (escopo por papel), então card e detalhe montam a equipe com visitCrew a partir de assignedEmployeeNames (apelido primeiro), que o servidor manda para todos os papéis — no /api/boot e também no GET /atomic/requests, que antes não mandava e apagava os nomes no primeiro refetch. Antes o cliente via “equipe a definir” numa visita já confirmada.
  • Card de tarefa sem abreviar: o tipo de serviço fica abaixo do status, com o mesmo tamanho do StatusBadge, e o nome do cliente ocupa a largura toda (até 2 linhas). A grade dos cards (ServiceGroupRenderer, StackedCardGroup) usa colunas de no mínimo 22rem (auto-fill), em vez de um número fixo de colunas por breakpoint que espremia os cards ao lado da barra lateral; abaixo disso, um card por linha.
  • Mover uma visita de um plano não quebra o plano (recurrence.slot): mover só uma visita (o cliente mensal que troca de dia, a semana de folga) mantém a âncora e guarda o dia do ritmo de onde ela saiu (withSeriesSlot, functions/api/common/seriesSlot.ts, no save do escritório e no aceite de proposta). A extensão diária trata esse dia como ocupado e nunca o recria: antes, antecipar a última visita deixava o dia antigo livre e o plano ganhava uma segunda visita na mesma semana ou mês. Mover a série inteira, mudar o ritmo ou recomeçar re-ancora e descarta os slots. Um slot que não é dia da série não tira a visita do dia em que ela está marcada.
  • Periodicidade no editor de plano: EditRecurringPlanModal tem How often (Weekly / Fortnightly / Every 4 weeks, as mesmas da edição de tarefa; o orçamento continua sem recorrência de quatro semanas). Every 4 weeks (MONTHLY) repete a cada 28 dias no mesmo dia da semana e horário de Londres; um plano parado sugere o próximo encaixe no seu próprio ritmo. Se a última visita de uma série de quatro semanas estiver fora do padrão e sem um slot válido de remarcação, o preenchimento aguarda a revisão no Issues. Trocar salva só a próxima visita com o ritmo novo, a data, a hora e a equipe; o servidor (applySeriesOnSave) troca as visitas seguintes não tocadas por outras no ritmo novo a partir dela, e as com conversa, fatura ou depósito ficam avulsas. Sem troca, o editor move todas as visitas abertas como antes. Só o escritório muda o ritmo: cliente não grava a visita. O pedido dele (/api/scheduling/client-change) remarca (semana + período), cancela — também depois de pedir outro horário — ou acrescenta uma linha ao pedido da visita, antes de ela começar.
  • Card de plano (RecurringSeriesCard, 2026-09-25): sem seleção, sem “Extend” nem “Extend until” — cada plano diz o seu estado (groupRequests): Coberto, Estende sozinho (a execução diária marca o resto) ou Precisa de data (última visita PENDING num dia passado). O bloco da data com a pílula abre Editar plano recorrente (o Editar tarefa) em Precisa de data e Coberto; Estende sozinho não abre — a próxima visita ainda cai dentro dos 60 dias e a execução diária marca o resto. (EditRecurringPlanModal): o dia escolhido é a próxima visita, as visitas abertas seguintes seguem o mesmo ritmo (recurrence.anchorStart) e o servidor completa os 60 dias. Qualquer ecrã abre a pré-janela com openClientMessage (ClientMessageHost), incluindo fatura, extrato, sinal, recibo, avaliação, horário proposto, atraso e a mensagem do orçamento: recebe o texto e, se houver, o template; a janela de 24 h aberta manda o texto para o chat e abre essa conversa; fechada, se houver template o botão manda o template aprovado daquele tipo (taxa fixa da Meta); sem template só dá para copiar o texto ou abrir o WhatsApp no telemóvel — a enviar pelo WhatsApp Business da empresa. Busca de pessoas (Dashboard, Operações): digitar casa cliente ou staff; tocar num nome vira um chip “Cliente · nome” / “Equipe · nome” e filtra exatamente essa pessoa naquele papel (PeopleFilter.pick em visitPeopleMatcher) — a cliente Ana não traz as visitas da funcionária Ana. O badge da aba e o contador do painel do Chatwoot contam só os que precisam de data. O cartão de série parada não tem mais “Resume from today” (a execução diária a retoma a partir de hoje); ficam “View last visit” e “End series”.
  • Carpet é decidido por isCarpetService/isCarpetJob (id ou nome): fila de orçamentos, filtro do gestor, badge da sidebar, escolha de equipe (useAllocationController, TeamSuggestionSummary) e Settings. Um segundo serviço de carpet exige especialista como o primeiro; o filtro interno do StaffMatchingService por id continua como subconjunto seguro.
  • Várias visitas de uma vez usam RequestsApiClient.saveAll: estender, retomar, a reserva recorrente e a série de orçamento gravam 6 por vez e ressincronizam a lista uma única vez no fim; com save por visita, cada gravação invalidava e rebaixava a lista inteira de requests.
  • Estender e retomar série salvam no servidor: useOpsCommanderController e o antigo controller de Recurring gravavam só no store, e as visitas sumiam no próximo refresh. Agora cada uma passa por RequestsApiClient.save, e o toast diz quantas falharam e quantas precisam de equipe.
  • O cliente cancela ou remarca a própria visita por POST /api/scheduling/client-change (RequestsApiClient.clientChange). O caminho antigo gravava em /atomic/requests, que recusa updates de CLIENT: a visita voltava ao lugar, aparecia erro e o crédito de fidelidade nunca era gasto.
  • O servidor calcula a taxa pela política gravada e deixa a mudança para o gerente: CANCELLATION_REVIEW ou PENDING_REVIEW. No cancelamento, a série acompanha quando pedido.
  • Remarcação do cliente = semana + período, nunca horário (como na cotação): ClientRescheduleSheet oferece “o quanto antes” e 4 semanas (rescheduleWeekKeys: a semana atual só de segunda a quinta) e manhã/tarde/flexível. A visita vai para PENDING_REVIEW sem mudar a data, com preferred_week (segunda de Londres, NULL = o quanto antes) e preferred_period (migração 0152). Vale só para a visita pedida; mudar a série inteira é conversa com o escritório. Card e detalhe mostram o pedido (“Next week · Morning”) no lugar do horário antigo (useRescheduleLabels).
  • Quem escolhe a hora é o gerente: o ScheduleAuthorisationBanner mostra o pedido e um seletor de data/hora que começa na segunda da semana pedida (ou amanhã) no início do período (suggestedSlot). Confirmar grava o horário, limpa o pedido e volta para SCHEDULED (com equipe) ou PENDING (sem equipe); “Keep current time” rejeita e também limpa.
  • Recusar um cancelamento devolve o preço (restorePrice). Recusar uma remarcação mantém a data atual da visita.
  • Enquanto o escritório não confirma, o cliente vê a visita no Home em “We’re on it” com a pílula New time (remarcação) ou Cancelling (cancelamento) — a mesma pílula no cabeçalho da visita (StagePill, pelo status). Com o cancelamento em revisão a janela diz “Cancellation requested” e não oferece mais Reschedule, Cancel nem novo pedido (o servidor recusa os três). Os pedidos do cliente aparecem como lista (ponto, ou ✓ quando a equipe fez), nunca como caixa de marcar.
  • Remarcar pelo gerente (ProposeTimeToClient, no grupo de botões do detalhe da visita, ao lado de Cancelar — que some enquanto o formulário do novo horário está aberto e volta ao enviar, mover ou cancelar; o detalhe não tem botão de WhatsApp — conversa com o cliente é pelo Chat): escolhe data e hora de Londres e envia a proposta ao cliente (link /proposal) ou clica “Change now, don’t ask the client”, que move só esta visita na hora por rescheduleRequest (sem taxa, sem consultar o cliente). Visita em PENDING_REVIEW não oferece o movimento direto: ela se resolve pelo ScheduleAuthorisationBanner.
  • Datas retroativas pelo gestor (2026-09-26). O adm/manager pode criar e editar tarefas com datas retroativas; ao salvar, uma confirmação modal pergunta se deseja realmente prosseguir. Clientes continuam proibidos de agendar no passado (422 PAST_VISIT_DATE).
  • Edit Task (lápis) e “Apply to future visits” (2026-09-24, atualizado 2026-10-16, QuickEditTaskModal + src/features/scheduling/services/applyToFuture.ts + seriesImpact.ts + SeriesAllocationsMapModal.tsx). Abre em modal flutuante amplo no desktop (desktopPresentation="modal", size="lg"). A opção Repeats (frequência de repetição) é a primeira opção na aba Agendamento, pois define a cadência da série. Logo abaixo do seletor de repetição, um banner unificado descreve o impacto da série: quando não há alteração de ritmo, mostra o resumo da série atual com o botão “Ver mapa da série”; ao alterar a repetição (ex.: semanal para quinzenal ou avulso) ou deslocar a data/hora inicial, o banner unificado consolida o impacto em um só lugar, listando as visitas que serão canceladas e as visitas que serão movidas (de → para). Ao clicar em “Ver mapa da série”, o modal SeriesAllocationsMapModal reflete as novas visitas e disponibiliza uma seção dedicada para gerenciar as visitas fora do ritmo, permitindo ao operador manter visitas específicas (ou todas) como visitas avulsas (frequency: 'NONE') sem cancelá-las. As visitas mantidas são desvinculadas da série para que o servidor (seriesOnSave) as preserve no calendário. A aba Notas reúne a nota para a equipe (quote_summary) e o Checklist do serviço, permitindo adicionar, renomear e excluir tarefas diretamente da edição. Desmarcada, a edição muda só esta visita. Marcada: (1) numa série, nova data/hora desloca as visitas abertas seguintes da série pelo mesmo intervalo (seriesShiftPatches) — o padrão muda, e o cron recurrence-auto-extend, que copia a última visita, continua nele; é a mesma regra do “Update entire plan” do Reschedule; (2) um £/h novo vira a taxa do cliente para o serviço (customRates, gravada antes) e reprecifica as visitas abertas de hoje em diante desse cliente e serviço, avulsas ou de série (futureRatePatches: tiram o £/h próprio e leem o do cliente); faturadas (qualquer fatura não anulada), pagas, em revisão de taxa (originalPrice) e carpete ficam como estão; (3) numa série, horas novas vão para as visitas abertas seguintes, cada uma reprecificada no seu £/h (ou sobre o serviço/£/h novos da mesma edição) — futureHoursPatches; antes a visita ia para 3 h/£60 e as seguintes ficavam em 11 h/£220. O servidor também move o fim gravado (end_date_time, followingEnd) quando a visita muda de hora ou de horas sem mandar o fim — antes uma visita de 3 h guardava fim de 11 h, lido pelo calendário, pelo preenchimento da série e pelo Duplicar. A caixa aparece numa série ou quando o £/h muda. A visita editada é gravada uma vez; as outras vão num lote (atomicBatchUpdate). Corrigir endereço: cada cartão do TaskAddressPicker tem editar; mantém o id do endereço, salva o cliente e, com o servidor aceitando, reescreve a cópia (addressSnapshot) das visitas abertas nesse endereço (addressSnapshotPatches). O UKAddressAutocomplete, ao abrir um endereço existente, não soma a rua encontrada à linha que já a tem (antes cada edição gravava “1 Raeburn Avenue Raeburn Avenue”). A janela (em pt-BR pelo t(), chaves taskEdit.*/addressPicker.*) mostra antes de salvar: o término (início + duração de relógio), conflitos da equipe (taskEditChecks.ts → crewClashes: outra visita da mesma pessoa no mesmo horário, ou deslocamento — estimateTravelMinutes — maior que o intervalo até a visita anterior/seguinte; aviso, não bloqueio), o preço de → para quando horas ou £/h mudam (visita faturada: “o preço continua”), e com “Apply to future” marcado a prévia das visitas que mudam (data/hora e preço de → para). A duração aceita digitar (quartos de hora, até 24 h); apagar o £/h com a caixa marcada tira a taxa do cliente para o serviço e volta as próximas visitas à taxa padrão; a nota para a equipe (quote_summary) e o checklist editam-se aqui. Só depois do aceite do servidor a janela diz “Tarefa atualizada” e fecha (syncAtomic devolve Promise<boolean>, updateRequest também); recusada, fica aberta com o que foi digitado. No cabeçalho do detalhe o tipo do serviço é uma pílula do tamanho da de status (TagBadge), logo após ela no desktop e na linha de baixo no celular.
  • Séries no servidor, uma regra só (2026-09-25). planSeriesExtension (functions/api/cron/recurrence-auto-extend.ts) é a única regra: todo grupo semanal/quinzenal é uma série, a menos que recurring_series diga TERMINATED (nada precisa registrá-la). O ritmo conta de recurrence.anchorStart — gravado quando a série começa, muda de ritmo ou é movida inteira (Editar tarefa com “aplicar às próximas”, Reschedule da série); remarcar uma visita só não o altera, e as próximas continuam no dia e hora do plano. Série antiga sem âncora conta da última visita. Cria depois da última visita não cancelada até 60 dias (seriesHorizon), nunca dia passado, nem dentro da próxima hora, nem dia que a série já tem (cancelada inclusive — cancelar uma semana não a traz de volta), nem por cima de outra visita do cliente; equipe da visita-base onde livre, senão sem equipe (Issues); fatura vencida há 30 dias pausa. Última visita PENDING num dia passado (a âncora da importação) = série em pausa até ganhar data real. Quando roda: todo dia (maybeAutoExtendRecurring, antes semanal) e em toda gravação do escritório de uma visita com repetição (applySeriesOnSave em /atomic/requests, com trava por série em system_logs). Ao gravar: repetir numa avulsa começa a série (âncora nesta visita) e preenche; semanal ↔ quinzenal remove as visitas seguintes não tocadas (sem chat, fatura, check-in ou sinal), solta da série as tocadas (viram avulsas) e preenche no ritmo novo a partir desta; avulso encerra (TERMINATED) e remove as não tocadas. Fecho da quote e nova visita do gestor já criam a visita com a série (bookQuotedVisit, carpete reconhecido também pelo nome e nunca repete); a equipe escolhida grava-se na mesma ida e a série enche com ela. Sem geradores no app: useQuoteSeriesCreation e o addRequest antigo saíram; o Editar tarefa só grava a repetição.
  • Empresa que fatura no Editar tarefa (2026-09-24). Seletor das empresas (ordem de Settings, com “Cobra VAT de 20%”/“Sem VAT”). Trocar mantém o price (líquido) e refaz VAT e total pela empresa nova (withFiscalVat; VAT absorvido segue splitVat); preço de → para aparece. Travado quando a visita está numa fatura não anulada, paga ou com sinal emitido (fiscalLocked). Com “Aplicar às próximas visitas”: grava clients.fiscal_entity_id (junto com a taxa, num só saveClient) e passa as visitas abertas de hoje em diante do cliente, de qualquer serviço e não travadas, para a empresa, com o VAT dela sobre o preço já reprecificado (futureFiscalPatches com base). As novas visitas já leem a empresa do cliente (agenda useBookingOperations, reserva do cliente clientBooking) e a série estendida copia a última visita.
  • Aba Detalhes da visita (2026-09-24, atualizado 2026-10-16). Para o gestor e a funcionária, no topo, agrupado em duas colunas abaixo dos detalhes: (1) cobrança do cliente junto com recibo do cliente (charged to the client com situação do VAT e status de pagamento / botão de abrir fatura vinculada) e (2) custo da equipe junto com equipe alocada (crew cost para o escritório e nomes da equipe atribuída). A alteração de equipe é feita via Editar tarefa (QuickEditTaskModal), sem botão de lápis direto no cartão da equipe. O checklist do serviço, quando vazio, é ocultado dos detalhes da visita para manter a tela limpa (e pode ser gerenciado pelo Editar tarefa, na aba Notas). O cartão “Equipe” do fim só aparece para o cliente (nem as sugestões ao gestor: quem escolher é a tela Team selection); a avaliação de uma visita concluída fica num cartão próprio. Os alertas (JobIntelligenceService devolve code + vars; IntelligenceSummary escreve em frase simples via visit.alert.*, título “Vale conferir”) — o selo piscando “Intelligence Alert” do cabeçalho saiu. Horas de trabalho em relógio (formatHourMinutes: “2h30 de trabalho”, não “2.5 labor-hrs”); a janela de chegada em texto normal. Sem nota de acesso no endereço, o gestor vê o aviso e escreve a nota no formulário de endereço do Editar tarefa (TaskAddressPicker, campo “Como entrar”). O botão do gestor chama-se “Propor novo horário ao cliente” (ProposeTimeToClient: link para o cliente aceitar, ou mudar já sem taxa); o lápis é “Editar tarefa”. O checklist vazio não mostra “0/0” e fica oculto. Sem botão Salvar: o requestsStore guarda as visitas cuja última gravação o servidor recusou ou não recebeu (unsavedRequestIds, markRequestSaved), e só nelas SaveTaskChanges mostra o aviso com “Tentar de novo” (reenvia a visita inteira).

  • Serviço de Disponibilidade: src/features/scheduling/services/AvailabilityService.ts
  • Serviço de Conflitos: src/features/scheduling/services/ConflictService.ts
  • Serviço de Recorrência: src/features/scheduling/services/RecurrenceService.ts
  • Gravação atómica: src/features/scheduling/services/SchedulingAtomicService.ts
  • Onde a visita acontece: src/features/scheduling/services/taskLocation.ts
  • Página da Agenda: src/pages/Schedule.tsx

Só o escritório pausa (o servidor recusa outro papel): Holiday pause no More da ficha do cliente (PersonProfile, ação HOLIDAY, só cliente ativo). O cliente não tem mais Schedule (2026-10-21) — as visitas dele estão todas no Home; ?view=SCHEDULE o leva ao Home, e no computador o Home tem o botão New visit no cabeçalho (sem barra inferior, sem o +). O histórico completo é a última linha do Home, Past visits (ClientPastVisits): abre os últimos 12 meses pelo GET de período (máx. 366 dias) e Show earlier busca o ano anterior; cada visita abre a sua janela, com Report.

HolidaySuspensionModal envia uma intenção UUID retomável para POST /api/scheduling/holiday-suspension. O backend cancela todo o intervalo elegível em um único statement D1, preserva preço/VAT originais para auditoria e devolve exatamente o mesmo resultado em retries. Navegador, PWA, Android e iOS compartilham o contrato e só confirmam depois da resposta autoritativa. A mutação encerra em 15 segundos; fechar/desmontar ou trocar o cliente aborta o transporte e uma resposta que perdeu ownership não altera store, cache, toast ou modal. Datas e fechamento ficam bloqueados durante a aplicação. O modal segue o design system claro, usa campos e botões canônicos, respeita safe areas e reorganiza datas, métricas e ações para telas estreitas.

CalendarSyncPanel (oculto por ora, ver acima) oferece a mesma assinatura ICS em todas as superfícies: webcal:// abre Apple Calendar no iOS/macOS e a URL HTTPS abre Google Calendar no Android ou navegador; outras agendas podem copiar o feed. O painel permanece renderizado durante a consulta e em falhas iniciais para que Retry nunca dependa de já existir uma resposta bem-sucedida.

useIcsCalendarSync mantém apenas uma consulta ativa por painel. Um refresh aborta a anterior, e o cleanup aborta a rede ao sair da Agenda; somente a execução mais recente pode atualizar dados, erro e loading.

useRouteOptimization aplica o mesmo contrato às duas chamadas de IA. Reexecutar ou fechar o insight cancela a operação; o resultado só é aceito quando contém cada atendimento do dia exatamente uma vez, sem IDs desconhecidos, e distâncias/tempos finitos não negativos. Saída inválida usa a ordem cronológica segura.

O portal público /proposal lê a proposta com teto de 12 segundos e envia aceite/recusa com teto de 15 segundos. Navegação cancela ambas as operações, um lock síncrono impede decisões duplicadas e falha de conexão oferece Try again sem afirmar que o link expirou. A mesma superfície e o mesmo ciclo de vida são usados em browser, PWA e WebViews Android/iOS.

Na agenda desktop, trabalhos não alocados permanecem arrastáveis, mas cada cartão também é um botão nativo dentro de uma lista semântica. Assim, Enter/Espaço, foco visível, TalkBack e VoiceOver usam o comportamento padrão sem anunciar um listbox que exigiria navegação por setas.

Os painéis drag-and-drop laterais não ficam apenas escondidos por CSS: equipe é montada a partir de 1024 px e tarefas sem alocação a partir de 1280 px, usando o useMediaQuery compartilhado. Telefones, tablets estreitos, split-screen e orientação horizontal mantêm somente o grid, sem árvores interativas invisíveis. A altura acompanha 80dvh em todos os breakpoints, com mínimo reduzido no mobile e 700 px no desktop para a operação ampla.

Nos cartões de agenda do cliente, a faixa temporal usa o ProgressBar compartilhado: atendimentos futuros anunciam “Not started”, os ativos expõem a percentagem decorrida e os concluídos anunciam “Completed”. O preenchimento colorido permanece decorativo e idêntico no touch/desktop.

Segue o padrão de pílulas do Overview. Uma fonte só (useOperationsIssues): a aba, o badge da aba e o badge do menu lateral contam o mesmo — os cards, não as visitas (visitas que ficaram abertas + conflitos, os de uma série num card só + planos retidos por dívida + planos sem próxima visita; antes cada choque da série contava e o badge passava do All); antes o menu contava três tipos e a aba cinco. O topo é uma linha (IssuesToolbar, pílulas de StateFilterPills, as mesmas do Overview): Todos / Ficaram abertas (rosa) / Conflitos (âmbar) / Retidos por dívida (âmbar) / Sem próxima visita (azul, a execução diária cuida), contagens seguindo a busca exata de cliente ou staff (visitPeopleMatcher sobre as visitas de cada problema). Uma grade só, paginada de 24 em 24; cada card (IssueCard, o layout do RecurringSeriesCard) tem a caixa de estado que abre o que dá para fazer (IssueActionSheet, uma folha para todos os tipos) e o botão de abrir a visita no canto. A folha lista só o que resolve aquele problema: nunca “abrir a visita” (o ícone do card já faz isso) — exceto Relatado nas mensagens, cujo canto abre a visita e a folha traz Abrir conversa (a DIRECT ou a JOB onde o problema foi relatado) ao lado de Marcar como resolvido —, e nunca trocar a equipe de uma visita cujo horário já passou (teamFor) — ela se conclui (Finish visit registra quem foi), se move ou se cancela. Sem sobreposição de equipe, um conflito de pessoa ausente ou sem equipe não oferece Edit task. Conflitos da mesma série ficam num card com “mais N neste plano”. Os conflitos não piscam vazios (2026-09-30): o resultado do Web Worker (conflictsState.ts) fica na tela enquanto o próximo é calculado — refetch ao voltar à janela, save ou virada do minuto — e sair da tela só pausa o cálculo (pause); só outra conta ou sessão zera a lista. As visitas de um conflito chegam do worker com datas em texto: quem as lê usa new Date(...). Tudo em t() (issues.*), inclusive os toasts de “fechar o intervalo”.

  • Planos retidos por dívida (seriesHeldForDebt, operationsIssues.ts) seguem a regra do servidor: todo grupo com ritmo válido que recurring_series não encerrou — antes só listava grupos com linha ACTIVE, e a maioria das séries não tem linha. Um plano retido não aparece de novo em “Sem próxima visita”. O valor passa por roundPence.
  • Sem próxima visita só é calculado depois que recurring_series responde; falha mostra alerta com retry e não vira lista vazia. End series (useEndSeries) trava antes do próximo render, valida a sessão antes de gravar no cache e só atualiza depois do success do endpoint.
  • Série antiga continua visível: o boot traz a última visita de cada série em curso, de qualquer idade (series_visit_heads, ver Governança), então uma série parada ou retida há mais de 14 dias continua em Issues e no Recurring. Os cards de plano não mostram mais “N visitas”: o app só conhece as visitas da janela e o número saía errado.
  • Visitas concluídas não faturadas viram uma linha verde com link para Faturamento, pela regra do pool de Billing (BillingPoolService.getBillableRequests + crewCollectedVisits): dinheiro e pago à equipe nunca são faturados, e cancelada com taxa entra. Não conta no badge — é a fila do faturamento.
  • Conflitos vêm só do Worker (useSchedulingConflicts); useConflictController guarda só as correções (resgate, fechar intervalo, colocar a sugestão) — antes recalculava todos os conflitos na thread principal sem ninguém ler. ConflictService não sugere mais “Low utilization” (o botão era “fechar o intervalo”, que não resolvia aquilo); “Sem equipe” deixa de fora visita esperando sinal (fora da escala) e de dia passado (já está em “Ficaram abertas”); “Faxineira de sempre livre” leva a pessoa em recommendedStaffId. Um horário duplo é um conflito por par de visitas, com todas as pessoas marcadas nas duas (staffIds) — antes vinha um por pessoa com o mesmo id, contado em dobro. Duas visitas abertas do mesmo cliente com horários cruzados são CLIENT_OVERLAP (um por par; o cartão usa o rótulo “Double-booked” e mostra a hora da outra; correções: editar esta, remarcar a outra, cancelar esta), podado assim que uma muda de hora, de cliente ou é cancelada/concluída. O conflito não carrega mais title/description em inglês: a tela escreve pelo tipo.
  • Resolução imediata de conflitos e double booking (2026-10-04): ao salvar a edição, remarcação ou alteração de equipe de uma visita em conflito (ex.: double booking / STAFF_OVERLAP, UNASSIGNED), o conflictsState.ts poda de forma síncrona e imediata (pruneResolvedConflicts) o conflito resolvido na mesma chamada update(input) sem aguardar o retorno assíncrono do Web Worker. Assim, a outra tarefa envolvida no choque de horário sai imediatamente da lista de conflitos e o card desaparece no mesmo instante no useSchedulingConflicts e na aba Issues, sem itens órfãos. Na edição rápida (QuickEditTaskModal), a alteração de duração atualiza estimatedEffort e realDuration simultaneamente, alinhando a regra de jobDurationHours (que prioriza realDuration) e evitando durações defasadas.
  • Atualização viva entre modais e páginas (2026-10-04): o ServiceDetailsModal e as ações do TaskActionRegistry (edição rápida, alocação, cancelamento e revisão) derivam a visita ativa diretamente do store global (requests.find(r => r.id === props.request.id) || props.request), sincronizando cliente, serviço e equipe (visitCrew). Qualquer edição concluída atualiza instantaneamente as informações em tela e modais sobrepostos em qualquer página (Full Schedule, Issues, Overview, Dashboard, PersonProfile) sem depender de recarga manual.
  • Lembrete de dívida no card retido é o extrato (ClientMessageButtons, tipo STATEMENT): segue Settings → mensagens ao cliente e, no WhatsApp com a janela fechada, manda o template aprovado — antes era texto livre.
  • Achar substituta (useConflictRescue, RescuePlanModal) em t() (rescue.*). Não anuncia mais “Rescue applied”: confirmAllocation não lança erro quando o servidor recusa, e o aviso saía mesmo assim; quem anuncia é o próprio confirmAllocation, depois do aceite.

Nota do match de equipe, de 0 a 100 (2026-09-24)

Section titled “Nota do match de equipe, de 0 a 100 (2026-09-24)”

calculateStaffScore (StaffScoringService.ts) dá 0–100: média ponderada de fatores de 0 a 1 — fidelidade (parte das visitas concluídas deste cliente feitas pela pessoa; a principal vale 1), deslocamento (até o overhead fixo vale 1, uma hora além vale 0), qualidade (1★ = 0, 5★ = 1), dia livre (8 h marcadas no dia = 0) e semana equilibrada (horas da semana, contadas de novo acima da média da equipe, sobre o teto semanal). Os controles de Settings → Staff Matching são o peso relativo de cada fator, não pontos somados. Fator que não distingue ninguém fica de fora (cliente sem histórico; deslocamento sem ponto de partida ou endereço conhecido). Conflito direto = 0; aviso leve (trajeto apertado, descanso, horas da semana, folga, fora do turno) tira softConflictPenalty % (0–100); falta de especialidade pedida pelo serviço corta pela metade; carpete sem a especialidade = 0. conflictPenalty saiu (não tinha mais leitor). Antes era uma soma sem teto (+15 por visita, +100 continuidade, +200 principal, +500 carpete) e passava de 100.

No modal de alocação de equipes (AllocationModal), quando uma visita está desatribuída (selectedEmployeeIds.length === 0), o sistema sugere com 1 clique a melhor profissional disponível classificada pelo StaffMatchingService (respeitando disponibilidade de horário, buffer de viagem e especialidade em carpet), permitindo confirmação imediata.

OfficeSchedule (src/components/schedule/planner/, carregado só para admin/gestor; a funcionária vê as suas em CrewScheduleView; o cliente não tem Schedule). Substituiu a grade vertical, as barras laterais (vagas e equipe), o Fast Dispatch, o Staff Insight e a aba Operations → Availability (a view STAFF_AVAILABILITY abre o Full Schedule).

  • Semana (WeekPlanner, desktop): quadro pessoa × dia de Londres (buildWeekPlan, weekPlan.ts). Cada dia é lido pela regra do dia (buildDayBoard), então o estado e a cor do chip são os do Day; visita ainda no local de um dia anterior fica no dia em que começou. Primeira linha No team (só quando há visita sem equipe na semana, com “Suggest teams” → BatchAllocationModal com as vagas da semana); depois as limpadoras ativas por staffName, um gestor só na semana em que tem visita, e alguém removido que ainda tem visita (nenhuma visita some). A célula mostra horas marcadas / horas do turno (weeklySchedule), folga (listrada), férias (timeOffs, rosa) e fica vermelha quando passa do turno ou tem visita em folga/férias. Cabeçalho do dia: visitas e quantas sem equipe; tocar abre o Dia. Uma pessoa desativada só aparece na semana em que tem visita não cancelada (2026-10-06: a cancelada não segura mais a linha). Nome da pessoa abre o EmployeeModal; o topo da célula abre o dia da pessoa (PersonDaySheet, em página cheia ao lado do sidebar — desktopPresentation="page", tela inteira no celular: a rota do dia em DayMapCard fill — mapa com a linha desde a casa e a lista numerada com os trajetos (abaixo do layout largo — celular — só o mapa, em toda a altura: as paradas numeradas já dizem a ordem e tocar abre a visita); ao lado, as visitas sem equipe do dia (unstaffed: âmbar e sem número no mapa, fora da linha; na lista, o tempo desde a parada mais próxima da pessoa, casa incluída) para decidir quem as leva. Split route e Clear today’s schedule ficam só no PlannerPersonMenu, que abre o dia já na ação; o cabeçalho é só o seletor de pessoa (as pessoas do planner na ordem dele, com as horas do dia) e logo depois a WeekStrip da semana, ocupando o resto da largura (abaixo do nome, no celular): conta as visitas daquela pessoa em cada dia (countOf) e muda o dia mantendo a pessoa; a janela e o mapa continuam montados. Sem linha de turno, data ou total — o calendário e a lista já dizem; tocar numa parada abre a visita por cima do dia — fechá-la volta ao dia —, clique direito abre o PlannerContextMenu, que fica acima da janela aberta).
  • Pílulas e busca: All, Needs a team, Awaiting confirmation, In review (contagens depois da busca) e a busca de pessoas (visitPeopleMatcher). Na semana, filtram a semana inteira e escondem as linhas sem visita mostrada; as horas da célula continuam as do dia inteiro. No dia, as contagens e o filtro são só desse dia (dayFilterCounts, dayBoardForOffice).
  • Mover e interações: arrastar um chip (@dnd-kit/core, só neste chunk; mouse, toque com espera de 250 ms e teclado) ou clicar com botão esquerdo para prender o chip ao cursor com mãozinha (cursor-grabbing) e clicar na célula de destino (segundo clique ou Esc cancela) move a visita mudando o dia, a pessoa ou ambos, mantendo o horário de Londres. Duplo clique abre os detalhes da visita. Clique com botão direito abre menu de contexto flutuante (PlannerContextMenu: ver detalhes, editar agendamento, trocar equipe, abrir conversa, cancelar visita) interceptando o menu nativo do sistema operacional. planMove monta a mudança (a pessoa da linha de origem sai, a da linha de destino entra, o resto da equipe fica; soltar na linha No team tira a pessoa) e roda AvailabilityService.check para quem trabalha no novo horário ou entra — o mesmo aviso do modal de equipe. A prévia (MovePreviewSheet) mostra de → para, os avisos (sobreposição/férias em vermelho, “Move anyway”), dia já passado em Londres e, num plano recorrente, pergunta se aplica só àquela visita (o servidor guarda o slot, withSeriesSlot) ou à série inteira (applyToSeries, reancora data/hora e replica a equipe para as próximas abertas). Gestor só recebe visita por admin (MANAGER_BY_ADMIN). Só PENDING/SCHEDULED se movem. A gravação (useApplyMove) usa os caminhos de sempre: o dia ou o horário por rescheduleRequest, depois a equipe por confirmAllocation com a logística recalculada (ProfitLogic.calculateLogistics); se o servidor recusa o dia, a equipe não é gravada.
  • Adicionar tarefa na semana (2026-10-06): só pelo botão direito (o clique no espaço vazio da célula foi tirado no mesmo dia: só o nome e as horas do dia criam). Add task abre a New visit (ManagerVisitSheet) com a pessoa e o horário de newVisitStart (weekPlan.ts): depois da última visita não cancelada da pessoa no dia, senão o início do turno, senão 09:00, no quarto de hora e nunca no passado de Londres (dia passado: o início do turno). Clique direito no nome (semana) abre o PlannerPersonMenu com Add task (hoje, ou o primeiro dia da semana mostrada), Open profile (o registro da pessoa em People, setPersonToView + USER_MANAGEMENT) e Edit staff member; clique direito nas horas do dia (topo da célula) abre o mesmo menu daquele dia: Open day, Add task, Split route, Open profile, Edit, Clear the day. No Dia, o menu do nome ganhou Add task e Open profile.
  • Horas de cada pessoa numa visita dividida ou corrigida (2026-10-06): por padrão a equipe divide as horas igualmente (é a duração da visita); quando o escritório deu horas diferentes a cada um ou corrigiu as horas (financials.staffWorkHours), cada pessoa aparece com as próprias horas (inclusive em visitas individuais) — a barra no Dia (buildDayBoard faz uma cópia da visita por linha, staffVisit: end e plannedMinutes), a duração do chip, as horas da célula na semana e o “x of y” da linha (laneHours). Regra única: staffDurationHours (jobDuration.ts); 0 h (treinamento) e carpete mantêm a duração da visita. Em correções financeiras (/visits/:id/financial), real_duration também é alinhado para manter a duração da visita fiel à correção.
  • Toque (celular, tablet, pointer: coarse): tocar num chip abre PlannerVisitSheet — sugestão de quem vai (o ranking de quem vai, StaffMatchingService), abrir, trocar equipe, trocar horário e mover para outro dia da semana (mesma prévia). Com mouse, o chip seleciona para mover ou duplo clique abre a visita.
  • Celular: WeekStrip + PlannerDayList (um dia, um cartão por pessoa com visita, No team primeiro, depois “Free:” com quem está livre).
  • Dia: as setas andam a semana (o dia da semana fica; o dia muda na WeekStrip). TodayTimeline com No team primeiro e as outras pessoas da semana, mesmo sem visita nesse dia. Arrastar o bloco, ou clicar com o botão esquerdo e depois a linha, muda a funcionária e/ou o horário — soltar na mesma pessoa só muda a hora. Arrastando, o início anda a distância arrastada (draggedTimeKey; continua na hora marcada enquanto não sai da faixa dela); clicando, o início vai para onde clicou (timelineTimeKey); nos dois, perto da linha da hora fica a hora cheia e entre as linhas a meia hora seguinte. A ponta esquerda do bloco é o que marca a hora (o cartão do “pegar e clicar” começa no cursor). Ao arrastar nada segue o cursor; assim que há encaixe, o bloco de origem some (e o cartão “Click a cell” do pegar e clicar também) e a linha de destino mostra só o cartão tracejado da visita no encaixe, por cima do resto: cliente, horário novo e o resumo do que muda (hora antiga → nova, pessoa antiga → nova, ou “No change”), com uma linha tracejada na ponta esquerda (LandingProjection, mesma leitura que a gravação usa). O cartão pode ser mais largo que o encaixe para o resumo caber; no fim do dia cresce para a esquerda a partir do fim do encaixe. A prévia (MovePreviewSheet) confirma o horário em que largou; a semana continua no horário de origem. Visita de equipe (mais de uma pessoa) leva um ícone de duas pessoas, no bloco do dia e no chip da semana (Users, título “Team of N”). Movê-la para outra pessoa — no dia ou na semana — pergunta na prévia se os outros ficam (Keep the others) ou se a visita vai inteira para quem recebe (Only : os outros saem); o botão de mover espera a resposta (MovePlan.teamChoice, PlannerMove.wholeVisit). Não pergunta quando a mesma pessoa só muda a hora, nem quando passar para o único outro membro dá a mesma equipe. Clique direito numa visita abre o PlannerContextMenu; no nome da pessoa abre o PlannerPersonMenu (clique esquerdo no nome não faz nada; no toque, onde não há botão direito, o toque abre o mesmo menu): Open day (PersonDaySheet), Split route e Clear today’s schedule (só com visita ainda não começada nesse dia, openCellVisits; abrem o dia já nessa ação) e Edit staff member (EmployeeModal). Toque curto abre a visita.
  • A lista de assinaturas de calendários da equipe foi removida de People. A ordem de rota por IA (routeOptimization) saiu com o Staff Insight, seu único leitor.

🔁 Gravações em lote contam as recusas

Section titled “🔁 Gravações em lote contam as recusas”

countRefusedSaves (src/shared/api/refusedSaves.ts) conta quantas visitas de um lote o servidor não guardou: séries a partir de cotação, extensão e retomada de série. O CloudClient devolve um 4xx como resposta, não como erro, e por isso uma visita recusada, por conflito de horário por exemplo, chega como sucesso com error no corpo. A criação de série a partir de cotação contava só erros de rede e anunciava como criadas semanas que o servidor tinha recusado.

O resgate de conflitos passa para a IA a duração prevista de cada visita (jobDurationHours). A duração real só existe depois de a visita ser feita, então todas as visitas futuras apareciam com duração zero.

Editar plano recorrente (EditRecurringPlanModal)

Section titled “Editar plano recorrente (EditRecurringPlanModal)”

No card (RecurringSeriesCard), o bloco da data com a pílula abre o editor em Precisa de data e Coberto. O dia e a hora são os da próxima visita; gravar move as visitas abertas para esse ritmo, da mais recente para a mais antiga (RequestsApiClient.saveAll, uma de cada vez), e o servidor completa o horizonte. A equipe e as horas por pessoa continuam neste ecrã.

Alocação Multiprofissional e Divisão Personalizada de Horas (staffWorkHours)

Section titled “Alocação Multiprofissional e Divisão Personalizada de Horas (staffWorkHours)”

A alocação de múltiplos profissionais é liberada para qualquer tipo de serviço e duração, sem limitação mínima de horas. Além da divisão padrão igualitária, o gestor pode definir a carga horária exata que cada colaboradora cumprirá na tarefa (staffWorkHours). O motor de lucratividade (ProfitLogic) e o motor de fechamento de folha (PayrollSettlementLogic) respeitam essas horas individuais no cálculo de pagamento (wageForService(emp, serviceTypeId) * hours — a taxa do serviço, ou hourlyWage), margens e holerites.

As horas individuais podem ultrapassar o total acordado: fitStaffHours preserva os valores digitados e usa a divisão igual apenas para entradas ausentes. O escritório pode digitar centésimos ou ajustar com os botões; trocar a equipe volta à divisão igual. Na linha de cada pessoa selecionada o Team selection mostra o Payout positivo que ela recebe. A janela não mostra custo, lucro nem margem da visita (essa análise fica em Reports). Quem já tem outra visita no mesmo horário (overlap) aparece em âmbar e pode ser escalado: o conflito vai para Operations → Issues (STAFF_OVERLAP); só licença e conta suspensa bloqueiam. A caixa pesquisa pelo nome ou apelido; o chip tira essa pessoa, e Clear team deixa a visita sem ninguém. Copiar a equipe para o plano grava cada visita seguinte uma versão à frente — duas à frente o servidor recusa e a visita não muda.

Toda tela do app mostra a funcionária pelo alias quando ele existe (staffName, src/shared/displayName.ts; o /api/boot já manda assignedEmployeeNames com COALESCE(alias, name)), e a busca encontra pelo nome ou pelo alias (staffNameMatches). O nome completo fica só onde ele é legal: payslip, export CSV e o formulário de cadastro.

Privacidade de Valores e Segregação de Remunerações na Equipe

Section titled “Privacidade de Valores e Segregação de Remunerações na Equipe”

Os colaboradores alocados em uma tarefa têm acesso estritamente aos seus próprios ganhos individuais (payouts.myPay). Quando há múltiplos profissionais na mesma tarefa:

  • As colaboradoras não visualizam os ganhos, horas ou valores recebidos pelas colegas de equipe (o valor de terceiros é omitido na interface e zerado em useTeamStats / buildTeamWithEarnings).
  • As colaboradoras não têm acesso ao valor cobrado do cliente (financials.price, impostos ou status de faturamento no DashboardCard e detalhes de visita).
  • Administradores e gerentes mantêm visão completa de faturamento do cliente e detalhamento de repasse de cada profissional.
  • Clientes têm visão do valor do seu serviço e não visualizam custos internos ou repasses à equipe.
  • Apresentação hierárquica e sequenciada de valores (2026-11-01): nos resumos e detalhamentos da visita (VisitSummary, FinancialSummaryView, ClientVisitOverview), os valores financeiros seguem uma sequência visual e lógica estrita:
    • Cobrado do cliente (Charged to the client): título do card, valor bruto total em destaque (£100.80), linha de discriminação de VAT posicionada imediatamente abaixo do total (Incl. £16.80 VAT ou + £16.80 VAT / No VAT) e, quando houver acréscimos contratados (extrasInPrice), bloco divisor discriminando o valor do serviço principal (Service £74.00) e os itens extras padronizados com sinal de adição e dois-pontos (+ Travel: £10.00). Clientes e funcionárias encarregadas da cobrança visualizam essa composição para transparência sobre o valor cobrado.
    • Custo da equipe (Crew cost): exclusivo para administração e gerência, exibe o título, valor total calculado (£50.00), texto explicativo de apoio (Calculated for this visit. Payroll confirms what has been paid.) e, havendo extras de funcionários (staffExtras), bloco divisor com a mão de obra líquida (Labour £40.00) e os itens adicionais com identificação da profissional (+ Travel (Nome): £10.00). A equipe de campo nunca tem acesso a este card nem a margens/lucro da empresa.
  • Dashboard reorganizado (2026-09-28): ordem de ação — Hoje; Needs attention como bloco unificado logo abaixo (uma peça por área ativa: Operações, Issues, Orçamentos com a conversão do mês “X de Y fechados”, Leads, Planos com séries que precisam de data, Chaves com a equipe/há mais de um dia/perdidas → Operations › Chaves, Suprimentos em falta e urgentes → Operations › Supplies, Cota de IA a partir de 80% ou com chamada recusada → Settings › Bot, Equipe hoje com funcionárias atrasadas → Live Tracker, Qualidade com avaliações baixas ou problemas relatados → Reputation Hub, e Clientes que sumiram com clientes em risco de cancelamento → User Management; caso a quantidade ativa seja ímpar, um card resumo “Tudo em ordem” com as áreas limpas é anexado para manter sempre simetria e número par de colunas/linhas sem widgets soltos). Em seguida Mensagens; a linha do tempo (TodayTimeline) ocupando todo o espaço em largura total sem widgets ao lado, seguida da visão semanal; por último a Cobrança, que some quando não há nada a faturar, em aberto, com a equipe, recebido ou agendado. Regras em src/components/dashboard/officeExtras.ts e useOfficeSummary. A Operations abre na aba pedida (opsTabToView). O card de mensagens relê a cada 3 min e na hora quando uma conversa se move (antes, a cada minuto).
  • Dashboard acionável (2026-10-08): o cartão Hoje junta o dia e o Next 7 days (lado a lado a partir de lg, um embaixo do outro no celular). Needs attention ocupa a largura toda e abre com Needs you now — até três visitas pelo nome: quem não fez check-in, depois as sem equipe, pelo horário; cada uma abre a visita — e só mostra “tudo em dia” quando não há nem área nem visita pendente. Mensagens também ocupa a largura toda e traz dentro a seção Clients on the app (aparece mesmo com a caixa quieta, enquanto houver clientes para contar). Depois a linha do tempo e a Cobrança. Cada estado do Hoje abre o Day de hoje já na pílula correspondente (Unstaffed → No team; scheduleDayToView + scheduleFilterToView, lido uma vez pelo OfficeSchedule). No Next 7 days, a coluna de um dia abre o Day daquele dia, e o pedaço âmbar abre direto em No team. Uma linha marca as horas que a equipe trabalha no dia (teamHoursAvailable, weekPlan.ts: turnos das funcionárias ativas menos folgas e ausências, a mesma leitura do planner); um dia acima dela fica vermelho, e o cabeçalho mostra a semana em horas marcadas sobre horas da equipe. Clientes que sumiram abre a lista com nome e última visita; um toque abre a ficha (personToView), e o que passar dos oito listados fica em People.
  • Edição de tarefas e modelo de precificação exclusivo (2026-10-16): na aba de faturamento (BILLING) do QuickEditTaskModal, o operador escolhe de forma mutuamente exclusiva entre cobrança Por hora (Horas × Tarifa) e Valor fixo combinado (Agreed fixed price, sem o sufixo redundante de total final). Selecionando por hora, apenas o campo de tarifa horária negociada é exibido; selecionando valor fixo, apenas o campo de valor final acordado é exibido. O cartão de prévia “Cobrado do cliente” (Charged to the client) é posicionado imediatamente abaixo do campo de tarifa ou de valor fixo, exibindo o total final, o badge de status fiscal internacionalizado (VAT incluso (X%), +X% VAT ou Isento de VAT / VAT exempt) e, para valor fixo em empresa com VAT, o desmembramento de líquido e imposto. Quando um valor fixo é digitado, ele representa o total final pago pelo cliente: em empresas registradas em VAT, o imposto é calculado como absorvido/embutido (taxBasis.absorbed = true), sem acréscimo de VAT sobre o valor combinado. A opção de repetição (repeats) foi movida para o topo da aba SCHEDULING com reanálise de impacto da série (seriesImpact.ts), e na visualização da visita o resumo agrupa em duas colunas a cobrança ao cliente e os custos/equipe escalada (com remoção do botão de edição avulsa da equipe). Ao cancelar a edição com alterações não salvas, o banner de confirmação (“You have unsaved changes. Keep editing or discard them?”) é renderizado diretamente sobreposto/em substituição aos botões originais Cancel/Continue no rodapé do modal, oferecendo as ações claras de continuar editando ou descartar as alterações.
  • Isolamento de séries recorrentes e prévia estável (2026-10-19): na edição rápida (QuickEditTaskModal), a opção de aplicar alterações nas próximas visitas (applyToFuture) para visitas recorrentes restringe a propagação (futureRatePatches, futureFiscalPatches, futurePaymentMethodPatches) estritamente à série correspondente (recurrence.groupId), sem vazar para outras séries do mesmo cliente (ex.: séries em dias da semana distintos) e sem sobrescrever as tarifas globais do perfil do cliente (client.customRates). A lista de prévia de tarefas (previewRows) é congelada durante o salvamento (isSaving) para evitar que recálculos temporários exibam valores zerados ou oscilações visuais enquanto o lote assíncrono é persistido.

Gerente no dia a dia (2026-10-27). A janela da visita no escritório mostra no cabeçalho cliente · dia · hora · serviço e o status, com a ação do momento (“Finish visit” no dia ou depois, senão “Edit task”) e um “Mais” com check-in, editar, equipe, conversa e cancelar — as mesmas ações do botão direito na agenda. Os avisos (“Worth checking”) são linhas de um cartão só, e o valor devido de visitas anteriores um aviso leve. “Finish visit” diz acima do botão o que ainda falta (equipe, horários, preço, relato ou pagamento). Na agenda da semana, quem não tem escala cadastrada não mostra “Off” em todos os dias, e quem não tem visitas mostra “Sem visitas”; os dias vazios dos próximos 7 dias aparecem com “—”. No celular, a aba de baixo se chama Agenda, como no menu.

  • Mapa de alocação da série grava a visita atual (2026-11-09): ao salvar, SeriesAllocationsMapModal relê cada visita do store em vez da cópia de quando o mapa abriu. Antes, um Edit task que salvava preço fixo com “this and the next” abria o mapa com as visitas de antes do salvamento, e a gravação da equipe devolvia o preço antigo (T26-0695: £50 fixo virou £50,01 de novo quatro segundos depois).

Preço combinado £0 (2026-11-10). Criar uma visita (New visit → Book now, e o fecho de quote no QuoteConfirmationPanel) aceita £0 no preço combinado: zero é um preço (visita gratuita), o campo vazio continua recusado. O servidor aceita price ≥ 0 em /atomic/visits/book e /atomic/leadQuotes/:id/confirm (negativo é 400), e manualServicePrice 0 em /atomic/requests; Editar tarefa e Finish visit (ManualVisitPrice) também aceitam 0, para que uma visita a £0 continue editável e possa ser concluída. A correção de preço da visita (planVisitFinancialEdit, Admin → Equipe e preço) também aceita £0: o cliente não paga e a equipe continua recebendo o que foi digitado (custo e lucro negativo seguem). O £0 é gravado como preço fixo (manualServicePrice: 0, sem tarifa por hora), para que nenhum recálculo de equipe ou duração leia o zero como falta de preço e volte à tarifa. A correção de uma visita realizada (/visits/:id/financial) já aceitava preço ≥ 0.