Seazone · BackOffice Franquias · Central da UTI × API uti_leitura
Análise refeita em 20/10/2026 depois de ler o Processo UTI de Franquias v1.0 (Isabella) e a API de leitura da própria Central (uti_leitura). A ferramenta já implementa muito mais do que o doc deixa transparecer — a v1 do check-list tinha 7 gaps, metade já estava feita. Aqui vão os 10 que sobraram (v2.0 trouxe 7 validados contra a API; v2.1-v2.3 somaram os gaps 00/0A/0B da Ray após leitura manual) + seção 05 nova com 23 indicações de melhoria pra ganho de qualidade e escalabilidade (automação · agentes · extensão).
Antes de abrir qualquer gap, o que a Central já faz. Oito itens que a v1 do check-list levantou como pendência e a bate-pronta confirmou prontos.
metas_base dos casos em execução traz snapshot completo (airbnb, graves, carteira, criticos, abertas_30d, urgentes_7d, manut_por_imovel, rede_manut_por_imovel).
casos?p_escopo=franquia&fase=execucao → 4 casos, todos com metas_base preenchidaconsultoria_hub ativa com estados sugerida, agendada|data, realizada|visita|N, cancelada.
integracoes → 60+ registros nos últimos 15 diasstop_crescimento / existente registrada nos casos em execução.
caso 9 (CMC-001-GRJ · Sônia): stop_crescimento = existente em 16/10captacao / nao_se_aplica para franquias que não são únicas da região.
caso 9: captacao = nao_se_aplica em 16/10Sete gaps que a bate-pronta confirmou pendentes. Marque cada item conforme resolver — o progresso salva no navegador.
#uti-franquias marcando Vivianny + especialista do plano principal + cria task + cron diário no thread. Ao mover pra Aguardando aprovação, dispara mensagem com 4 botões de ação pras aprovadoras decidirem direto do Slackconsultoria_hub / sugerida| sem data desde 06/10 — 14 dias parados. Caso 9 (Sônia · em execução) não tem nenhuma integração consultoria_hub apesar do plano Manutenção prever conferências D7 e D21POST → hub/visitas no primeiro passo que depende de consultor, com franchise_id, plano, passo, prazo, tag UTIprotocolos.franquia.etapas.comunicacao: call_alinhamento_feita com data, responsavel, consultor_participou, resumovivianny.aguilera@seazone.com.br e isabella.bino@seazone.com.br. Rayanne e David não recebem nenhum alerta de Pré-UTI/UTIcco parametrizável; defaults do v1.0: vivianny@, isabella@, rayanne.oliveira@, david.soares@POST /api/v1/uti/whitelist com franchise_id, motivo, aprovador, validade#uti-franquias: "rodada OK · N cards processados" ou "FALHA · stack trace" todo dia após rodada principalrksgmplciyyslegcadvw.supabase.co e serve 4 casos reais em execução (CMC, BLU, FLN×2). UI ainda roda no domínio -stgcentral-uti.seazone.propertiesDocumentos e sistemas que o dev precisa ao lado.
Processo UTI de Franquias v1.0 · 19/10/2026 — autoria Isabella Bino, dona das etapas Vivianny Aguilera, dona das regras Carolina Espindola
Central da UTI (staging): https://central-uti-stg.seazone.properties/
API de leitura: GET https://rksgmplciyyslegcadvw.supabase.co/rest/v1/rpc/uti_leitura?p_recurso=<recurso> · headers apikey + x-api-key · recursos: indice, resumo, casos, eventos, integracoes, planos, pedidos, imoveis_hoje, qualidade, diagnostico_franquias, dados_diarios, protocolos, regras, historico_airbnb
Hub Consultoria Regional: https://consultoriaregional.seazone.dev/consultoria/planejamento
Stop de Crescimento: https://stopdecrescimento.seazone.properties/
ScorePulse: https://scorepulse.seazone.com.br
Canal: #uti-franquias
Casos franquia: 48 total — 5 em Sinal · 14 em Pré-UTI · 1 em Decisão · 4 em Execução · 1 em Observação · 1 Alta · 1 Distrato · 21 Fora
Casos imóvel: 435 total — 167 em Fila · 79 em Tratamento · 189 Fora
Casos Conta 2: 388 total — 121 Elegíveis · 96 em Iminência · 171 Fora
CMC-001-GRJ · "Sônia" · entrou em Execução em 17/10 · metas_base preenchida (airbnb 4,68 · 3 graves · carteira 57 · 6 críticos · 7 abertas 30+) · integrações captacao=nao_se_aplica · email_entrada=enviado · stop_crescimento=existente · sem integração consultoria_hub apesar do plano Manutenção prever D7 e D21. Validar gaps 01, 02 e 03 por este caso primeiro.
Achados complementares aos 7 gaps da seção 02. Sem critério de aceite — cada item tem botão ✦ Enviar ao Claude pra virar desenho técnico (Ferramenta), rascunho de retro (Processo) ou análise conjunta (Alinhamento).
Regra: "no máximo 5 em Comunicado + Plano + Resultado; aprovada sem vaga fica aguardando e entra sozinha quando abre vaga". API não expõe campo específico de fila — pode estar fundido com aguardando_vaga dos casos. Confirmar visualização.
Meta D30 do plano Manutenção. Baseline da Central já traz manut_por_imovel e rede_manut_por_imovel, mas Vinicius precisa dessa comparação nativa no próprio Sapron pra conferir no D21 e D30 sem abrir a Central.
A API já funciona e é consumível. Falta documentação formal: campos de cada recurso, parâmetros, exemplos, SLA. Hoje a thread do handover tem as chaves — formalizar como API v1.
Para automatizar o fechamento de passos vindo de sistemas externos (Suporte CS fecha chamado → fecha passo "anuncio corrigido" na Central). Hoje precisa clique humano. Precisa de POST /api/v1/uti/casos/{id}/passos/{n}/concluir com assinatura por sistema de origem.
Regra: "Mover direto é exceção (⋯) e pede justificativa". API não expõe nenhum campo motivo_movimento nos eventos. Confirmar se existe no backend ou é só UI.
UTI automáticas em Sapron e Suporte CS FranquiasProcesso cita tag uti nos cards de Manutenção e nos chamados de Anúncios. Integração sapron_manutencao aparece como confirmada/concluida, mas não valida se a tag está sendo aplicada. Precisa combinar com Vini e Larissa qual sistema cria/sincroniza a tag.
Entrada: integração stop_crescimento / existente confirmada no caso 9. Saída: nenhum caso em Alta ainda — não dá pra validar se o fluxo de retirada está pronto. Vivianny e dev do Stop precisam alinhar o handshake antes do primeiro caso chegar na Alta.
Decisões humanas pendentes no v1.0. Dev recebe só como contexto.
Ponto 2 da seção 9: "Confirmar a regra de divisão (por exemplo: gestor regional quando há visita na semana, Vivianny nas demais)". Sem regra, risco de dupla responsabilidade ou nenhuma.
Ponto 1 da seção 9: treinar cada área em meia hora OU publicar na KB. Decisão pendente — afeta velocidade de rollout e qual conteúdo oficial usar (ver gap 04 sobre divergências).
Ponto 3 da seção 9: "Confirmar com a Carol se a integração está prevista". A integração já existe parcial (gap 01), mas o dispatch automático dos passos ainda não. Decisão: investir no fluxo completo ou manter paliativo.
Processo cita "stop total por qualidade" como único exemplo que vai direto pra Aguardando aprovação. Outros casos graves? (jurídico, fraude, multa pesada). Lista fechada evita decisão caso a caso.
Vivianny antecipa visita até Camila terminar o treinamento. Até quando é "até lá"? API já aponta Camila como dona de 4 protocolos — divergência com o doc.
Por quê 5? Qual a base empírica? Hoje tem 14 em Pré-UTI + 1 em Decisão + 4 em Execução = 19 ativas, 5 é o teto da UTI oficial. Validar com Vivianny e Carol.
Seção 4: "não existe aceite do franqueado: o plano começa com ou sem a call". Risco: franquia contestar que não foi avisada / não concordou com as metas. Rito claro pra defender a Seazone.
Hoje Rodrigo Ruas está na lista (por quê? até quando? quem decide tirar?). Dependência direta do gap 05.
Plano Ocorrências: "Gravíssima nova: call com o franqueado em 24h". Se Vivianny está indisponível, backup é o gestor regional? Isabella? Risco de descumprir SLA interno.
Processo cita "Diretoria" em vários "Se atrasar": Carol (Diretora Franquias)? Iara (Diretoria Operações)? API aponta "Diretoria / COO" no passo Decisão. Nomes fechados por tipo de escalada evitam que "escalonado pra Diretoria" vire ninguém.
Melhorias de qualidade e escalabilidade levantadas rodando o processo UTI de Franquias v1.0 contra a API uti_leitura em 20/10. Três lentes complementares — automação (processo manual → cron/trigger), agentes (IA aplicada em análise/decisão/resumo) e extensão (overlay nos sistemas-irmãos pra levar o contexto da UTI aonde o time já trabalha). Cada item tem botão ✦ Enviar ao Claude pra virar desenho técnico pro David.
Rotinas que hoje dependem de alguém lembrar. Automação libera a Isabella pra tratar casos atípicos.
Franquias aprovadas sem vaga (max 5 em Comunicado+Plano+Resultado) ficam estacionadas. Automatizar fila por: reincidência (topo) → prédio GOps/Spot → reserva nos próximos 14 dias → tempo em crítico → nota mais baixa (mesma régua da UTI de Imóveis). Entra automático quando vaga abre.
Hoje Isabella cobra. Cron por caso: 24h antes do marco posta no thread do alerta "Amanhã é D14 do caso X — Victória precisa conferir ocorrências e Vivianny faz check-in". Isabella só revisa.
Suporte CS fecha chamado de anúncio → Central fecha passo "anúncio corrigido". Sapron conclui manutenção com tag UTI → Central fecha entrega D3. Hoje depende de clique humano em cada ponta.
Quando franquia entra em Comunicado, aplicar automaticamente: tag uti em todo card do Sapron da franquia, tag uti em chamados do Suporte, prioridade na UTI de Imóveis pros críticos. Consistente com A1 e A2 do backlog.
Quando caso vai pra Distrato (etapa 8), job coleta toda a trilha (eventos, planos, passos marcados, e-mails trocados, respostas da franquia, decisões de escalada) e gera PDF controlado. Serve de evidência jurídica. Consequência direta do gap 0B.
Hoje 30d de Acompanhamento silenciosos; se Score cair volta pra aprovação. Cron: no D15 e D25 pós-alta, se métrica se aproxima da régua (ex.: carteira crítica subiu 50% desde alta mas ainda não bateu 20%), posta alerta antecipado pro Vivianny.
Processo diz Integração/Stand by fica fora. Se franquia muda de status (sai de Integração no cadastro), entra automaticamente no diagnóstico diário sem deploy ou intervenção. Hoje depende da franquia aparecer no próximo diagnóstico naturalmente.
Onde o volume (48 casos franquia · 435 imóveis · 388 Conta 2) + a necessidade de qualidade justificam LLM. Cada agente roda sozinho e devolve rascunho pra humano aprovar.
Franqueado responde ao e-mail de Pré-UTI/UTI (destinatário Vivianny). Agente classifica em 4 buckets: vai executar · precisa ajuda operacional · vai contestar meta · outro — encaminha pro dono do plano correto com rascunho de resposta pré-formatado.
Toda sexta antes do check-in, agente lê eventos da semana (passos marcados, ✎ contatos, mudanças de métrica, respostas da franquia) e gera resumo: "Caso X · semana D7-D14 · 3 entregas feitas / 2 pendentes · franquia respondeu em 24h · risco: Y". Vivianny / especialista chegam no check-in com contexto.
Quando o dossiê é gerado (AT5), agente escreve a narrativa executiva (3-5 parágrafos): histórico da franquia, o que a Seazone ofereceu, o que a franquia executou/não executou, por que o distrato é justificado. Pra Carol levar à decisão sem ler 30 páginas.
Franquia contesta meta (ex.: "não dá pra zerar manutenções em 30d porque fornecedor X atrasou"). Agente puxa contexto (base da rede, outros casos similares, fornecedores) e devolve rascunho: "contestação procede / parcial / não procede · justificativa + evidência".
Automatiza o gap 04. Toda semana, agente lê o doc oficial (Isabella) + API uti_leitura/regras e aponta divergências novas no #uti-franquias. Mantém o doc sempre atualizado sem Rayanne precisar auditar.
Hoje Derek sugere plano por regra. Agente lê contexto adicional (últimas ocorrências descritivas, histórico de 1:1 no Pipedrive, transcrição de calls recentes, mensagens no WhatsApp Business) e sugere plano com justificativa + grau de confiança. Carol/Vivianny validam no botão do G00.
Mensal, agente roda sobre todos os casos encerrados e aponta padrões: "80% das franquias em plano Manutenção não respondem no D3", "cadência 7 dias insuficiente pra plano Prédio", "Victória registra mais ✎ contato que Vinicius". Input estruturado pra retro.
Levar o contexto da UTI aonde o time já trabalha (Sapron, Hub Consultoria, Suporte, Gmail, Stays) via extensão de navegador — padrão que a Ray já valida na Plataforma Governança Franquias. Reduz "preciso abrir mais um sistema" pra zero.
Vinicius abre card de manutenção de franquia em UTI → badge "🔴 UTI · plano Manutenção · D+7 · próxima entrega: urgentes zeradas". Atalho pra abrir ficha da Central sem sair do Sapron.
Consultor abre agenda → visitas que são passo UTI ganham badge "UTI" + prioridade visual + link pro card. Lado do consumidor do gap 01.
Franquia aberta no ScorePulse → badge "📊 UTI · Pré-UTI D+4 · Score caiu 12 pts no mês". Mostra ligação direta entre o movimento do Score e o caso na UTI.
Larissa abre chamado de anúncio → se franquia está em UTI, badge "UTI · plano Anúncios · D+4 · fechar até D7". Conclusão do chamado dispara fechamento do passo UTI (consistente com AT3).
E-mail de franquia em UTI chega → badge "🔴 UTI D+6 · entrega D7 vence amanhã · plano: Ocorrências" na lista de inbox. Prioriza triagem sem precisar abrir o e-mail.
Franquia em UTI aberta no Stays → badge contextual com situação atual + próximo passo + link pro card da Central.
Card novo pra franquia em UTI → badge + priorização automática na coluna + sincronia bidirecional de status com o passo UTI do Sapron.
Comunicados pros franqueados em UTI ganham tag "UTI" + obrigação de leitura marcada. Franquia sabe que a mensagem é parte do plano, não comunicado comum.
Task vinculada a UTI → badge no card do board, link pro thread do Slack do G00, link pro card da Central, prazo sincronizado com a data-limite do passo.
v2.4 · 20/10/2026 · Ray (BackOffice Franquias) · análise refeita após bate-pronta contra API uti_leitura + ajustes manuais da Ray (gaps 00/0A/0B pedidos ao David). v2.4 soma a seção 05 de melhorias (7 automação · 7 agentes · 9 extensão) pra ganho de qualidade e escalabilidade. Entregue pro David Soares (coord. Admin/Financeiro Franquias).