Audit — Coordenador não conseguia copiar o link do Mural

Data: 2026-05-03 Escopo: Edge Function mural-escola (batch_init), hook useMuralEscola, UI "Mural Olímpico" Severidade: Alta — feature visível ao gestor escolar parecia indisponível Status: Resolvido (Wave 7)

---

1. Sintoma reportado

Coordenador autenticado via OLP, ao acessar Mural Olímpico, não enxergava o link público da escola e não conseguia copiá-lo. A UI exibia o estado "Mural não configurado" mesmo para escolas com escola_mural_config.mural_slug válido e mural_ativo = true.

2. Hipótese inicial (descartada): RLS

Suspeita: a policy de escola_mural_config estaria bloqueando coordenador/diretor. Verificação:

• Policy escola_mural_config_select_coordenador_diretor existe e cobre os papéis.
• principal_role IN ('coordenador','diretor') + escola_id::text = (auth.jwt()->>'escola_id') casa o JWT real do usuário afetado.
• Query manual com a mesma chave de claim retorna a linha esperada.

Conclusão: RLS não é a causa. A policy está correta — ver MURAL_OVERVIEW.md §RLS.

3. Causa raiz

Regressão de orquestração no batch_init da Edge Function mural-escola:

// ANTES (bug)
const [pubResult, olimpResult, portalResult] = await Promise.all([
  publicacoesQuery,
  olimpiadasQueryA,
  olimpiadasQueryB,   // duplicata
  portalConfigQuery,  // resultado IGNORADO pelo destructuring
]);
// portalResult recebia a 3ª posição (olimpíadas duplicadas), não o portal.

Sintomas observáveis nos logs:

✅ batch_init escola=<uuid>: 12 pub, 4 olimp, portal.slug=null (ok)

diagnostico='ok' + slug=null em escola comprovadamente configurada é o anti-sinal que deveria ter sido tratado antes como erro de integração.

4. Correção aplicada

Arquivo: supabase/functions/mural-escola/index.ts

1. Removida a query duplicada de olimpíadas no Promise.all.
2. Destructuring agora casa 1:1 com as queries (pubResult, olimpResult, portalResult).
3. escola_mural_config lida via .maybeSingle() para distinguir corretamente "linha ausente" de "erro técnico".
4. portalDiagnostico passou a ser explícito em 4 estados:

Estado	Quando
ok	Linha encontrada e shape válido (mural_slug, mural_ativo)
not_configured	Sem linha (PGRST116 ou data === null)
rls_blocked	Erro 42501
error	Qualquer outro erro técnico ou shape inesperado

5. Endurecimento de shape: se data não tiver mural_slug string ou mural_ativo boolean, retorna error em vez de mascarar como ok.
6. useMuralEscola confirmado preservando comportamento fail-close (nunca inventa slug).

5. Lição / regra preventiva

Edge Function — Promise.all com destructuring O número de variáveis no const [...] DEVE ser idêntico ao número de queries no array. Quando o array tiver ≥3 itens, é obrigatório code review específico desse trecho. Ver docs/development/CODING_STANDARDS.md.

Anti-sinal a tratar como bugdiagnostico='ok' com campo de identidade nulo (slug, id, …) em registro confirmadamente existente no banco = problema de integração/orquestração, nunca "comportamento esperado". Ver docs/development/PROBLEM_SOLVING.md Caso 14.

6. Validação pós-correção

• Coordenador da escola afetada: link copiado com sucesso, portal.slug populado nos logs.
• batch_init para escola sem config: diagnostico='not_configured' + UI exibe estado correto.
• Sem regressão em listas de publicações ou olimpíadas.

7. Referências

• supabase/functions/mural-escola/index.ts
• src/hooks/useMuralEscola.ts
• docs/features/MURAL.md — seção "Diagnóstico do portal"
• docs/mural/MURAL_OVERVIEW.md
• docs/development/PROBLEM_SOLVING.md — Caso 14