Área do cliente para manutenção de coluna de esgoto em SP: WordPress

Como transformar a gestão caótica de chamados de esgoto em um processo digital rastreável, onde síndicos abrem ocorrências pelo celular, técnicos recebem rotas otimizadas e relatórios técnicos saem assinados antes da equipe sair do prédio?

A resposta está em uma área do cliente WordPress projetada para a realidade operacional de manutenção de colunas prediais na Grande São Paulo: geolocalização nativa, integração com apps de campo, geração automática de laudos em PDF e conformidade com LGPD para dados condominiais sensíveis.

Arquitetura de dados para ordens de serviço complexas

O coração do sistema é um Custom Post Type ordem_servico com taxonomias hierárquicas: zona_sp (Centro, Zona Norte, Sul, Leste, Oeste, Grande SP), tipo_coluna (pluvial, esgoto, mista), urgencia (emergência, urgente, programada, preventiva). Cada ordem carrega meta fields ACF: endereco_completo, coordenadas_gps, condominio_id, sindico_contato, fotos_antes (gallery), fotos_depois, laudo_pdf, assinatura_tecnico, checklist_conformidade (repeater), tempo_resposta_minutos, sla_cumprido (boolean).

Relacionamentos são resolvidos via posts-to-posts: uma ordem_servico pertence a um condominio (CPT pai), que por sua vez vincula a unidades (CPT filho) para rateio de custos. Isso permite relatórios agregados por torre, bloco ou condomínio inteiro — essencial para gestoras que administram dezenas de empreendimentos.

Integração REST bidirecional com aplicativo de campo

A equipe técnica usa app mobile (React Native ou Flutter) que consome endpoints customizados registrados via rest_api_init. Exemplos práticos:

// Endpoint para técnico aceitar ordem e iniciar deslocamento
register_rest_route('manutencao/v1', '/ordem/(?P<id>\d+)/aceitar', [
  'methods' => 'POST',
  'callback' => 'manutencao_aceitar_ordem',
  'permission_callback' => 'manutencao_verificar_tecnico_autenticado',
  'args' => [
    'id' => ['validate_callback' => 'is_numeric'],
    'lat' => ['required' => true, 'type' => 'numeric'],
    'lng' => ['required' => true, 'type' => 'numeric'],
    'timestamp_chegada' => ['required' => true, 'type' => 'string'],
  ],
]);

O callback atualiza post_meta com geolocalização de aceite, muda status para em_deslocamento, dispara webhook para notificação ao síndico e cria log imutável em tabela custom wp_manutencao_auditoria. O mesmo padrão serve para iniciar_servico, concluir_servico, reabrir_ordem — cada transição de estado é um endpoint versionado, auditável e testável isoladamente.

Geração automática de laudos técnicos em PDF

Ao transicionar status para concluida, o hook transition_post_status aciona job assíncrono via Action Scheduler:

add_action('transition_post_status', 'manutencao_gerar_laudo_pdf', 10, 3);
function manutencao_gerar_laudo_pdf($new, $old, $post) {
  if ($new !== 'concluida' || $post->post_type !== 'ordem_servico') return;
  as_enqueue_async_action('manutencao_gerar_pdf', ['ordem_id' => $post->ID]);
}

O worker monta HTML com template Blade/Twig: cabeçalho da empresa, dados do condomínio, descrição do serviço (hidrojateamento, inspeção por câmera, reparo estrutural), fotos georreferenciadas com EXIF preservado, checklist de conformidade ABNT NBR 8160/16280, assinatura digital do técnico (canvas capture no app), QR code para validação online. PDF salvo em wp-content/uploads/laudos/{condominio_id}/{ordem_id}.pdf e meta laudo_pdf atualizado. Cliente recebe e-mail com link assinado (expiração 30 dias) e notificação push no painel.

Painel do cliente: síndico e gestora com visões distintas

Roles personalizados via add_role + WP_Role::add_cap:

Interface construída com React no admin (wp-scripts + @wordpress/components), consumindo mesmos endpoints REST do app mobile. Filtros salvos via user_meta, paginação server-side, exportação CSV/Excel via PHPExcel para prestação de contas.

Notificações multicanal e rastreabilidade completa

Cada evento crítico dispara manutencao_notificar() que roteia por canal:

• WhatsApp Business API (via provedor oficial): template aprovado para “Ordem aceita”, “Técnico a caminho”, “Serviço concluído”, “Laudo disponível”. Variáveis: {{condominio}}, {{tecnico}}, {{previsao_chegada}}, {{link_laudo}}.
• E-mail transacional (SendGrid/Amazon SES): HTML responsivo com fallback texto, headers List-Unsubscribe, DKIM/SPF/DMARC configurados.
• Push no painel: WebSocket (Pusher/Laravel Echo) ou Server-Sent Events para atualização em tempo real sem refresh.
• SMS fallback: apenas para emergências sem resposta em 15 min (Twilio/Zenvia).

Toda notificação gera registro em wp_manutencao_notificacoes com canal, status_entrega, timestamp, tentativas, erro_detalhado. Dashboard de entregabilidade mostra taxa de abertura, cliques, falhas por provedor — base para melhoria contínua.

Segurança, LGPD e escalabilidade para Grande São Paulo

Autenticação: Application Passwords para integrações servidor-a-servidor, Two Factor (TOTP) obrigatório para roles gestora e sindico, limit_login_attempts com bloqueio progressivo. Dados sensíveis (CPF síndico, contratos, plantas hidráulicas) criptografados em repouso via openssl_encrypt com chave rotacionada no AWS KMS.

Consentimento LGPD: checkbox granular no primeiro acesso — “Autorizo tratamento de dados para gestão de manutenções”, “Autorizo notificações WhatsApp”, “Autorizo relatórios anonimizados para benchmarking”. Exportação (wp_privacy_personal_data_export) e exclusão (wp_privacy_personal_data_erasure) implementadas via privacy_export/privacy_erasure filters.

Performance: Redis Object Cache para queries pesadas (WP_Query com meta_query em 50k+ ordens), CDN (Cloudflare/CloudFront) para assets do painel React, WP_Cron desabilitado em favor de systemd timers + Action Scheduler com fila Redis. Testes de carga com k6 simulam 500 síndicos abrindo chamados simultâneos em chuva forte — p95 < 800ms para POST /api/ordem/nova.

Métricas que importam: SLA, reincidência e NPS condominial

Eventos GA4/GTM via dataLayer push em cada transição:

// No frontend React ao mudar status
window.dataLayer.push({
  event: 'ordem_status_changed',
  ordem_id: 12345,
  condominio_id: 678,
  old_status: 'aberta',
  new_status: 'em_atendimento',
  tecnico_id: 42,
  tempo_resposta_min: 23,
  zona_sp: 'zona_norte',
  tipo_coluna: 'esgoto'
});

Dashboards no admin (Custom Admin Page + Chart.js) mostram:

• SLA por zona: % ordens atendidas dentro do prazo contratual (ex: 2h emergência, 24h urgente)
• Reincidência por coluna: ordens repetidas mesmo condominio_id + tipo_coluna em < 30 dias
• NPS pós-serviço: pesquisa 1-10 enviada 24h após concluida, segmentada por técnico/equipe
• Custo por metro linear: integração com ERP para rateio material/hora-homem por tipo_coluna

Esses indicadores alimentam revisão contratual trimestral e alocação preventiva de equipes nas zonas com maior incidência histórica.

Expansão: multisite por região ou instalação única?

Para operações que crescem além da capital, duas estratégias validadas:

1. Multisite subdomínios (zona-norte.manutencao.com.br, guarulhos.manutencao.com.br): isolamento de dados, plugins/temas por região, deploy independente. Ideal quando legislação municipal difere (ex: licenças ambientais distintas).
2. Instalação única + taxonomia municipio + network_site_id em meta: compartilhamento de base de técnicos, catálogo de serviços unificado, relatórios consolidados. Menor overhead operacional, exige row-level security rigoroso.

A escolha depende da maturidade da gestora: início com instalação única, migração para multisite quando > 3 municípios com regras regulatórias divergentes.

Uma área do cliente bem arquitetada deixa de ser “portal de chamados” e vira sistema operacional da manutenção predial: rastreável, auditável, escalável. O síndico abre o chamado no elevador, o técnico recebe a rota otimizada no celular, o laudo sai assinado antes do café da tarde e a gestora apresenta KPIs na assembleia sem planilhas manuais. Isso só acontece quando WordPress deixa de ser CMS de conteúdo e vira plataforma de aplicação — com CPTs, REST API, hooks assíncronos e segurança em camadas pensados para a operação real de manutenção de coluna de esgoto na Grande São Paulo.

Para aprofundar a integração com ferramentas de conversão, veja como analytics de conversão para leads de desentupimento no Mandaqui estrutura funis baseados em eventos técnicos. Se o foco é autenticação segura para APIs, autenticação via Application Passwords na REST API detalha o fluxo completo com rotação de chaves. E para gestão de múltiplos condomínios, Multisite WordPress gerencia condomínios e empresas em São Paulo mostra a arquitetura de rede em produção.

Checklist prático

Perguntas frequentes