Visão Geral

Contexto, atores, arquitetura e estado atual da integração SIMPE × SAGE/MGDI.

O problema

O SIMPE precisa exibir indicadores oficiais (números de equipes de saúde, valores repassados, cobertura, etc.) dentro do plano estratégico. Esses dados já existem na SAGE. Em vez de duplicar a coleta, integramos via API do MGDI.

Escopo do piloto

Saúde Bucal, 16 cards de indicadores nos mockups. Cobertura técnica atual: 7 indicadores com endpoint funcional. O restante depende de mapeamento ou novas fontes a confirmar com o DEMAS. A expansão para outras secretarias já começou: em 26/05/2026 chegaram 5 códigos novos de Saúde Bucal (CEO Tipo I/II/III, eSB Modalidade I/II) — registrados, mas ainda sem dado (carga/resultset retornam 500 ou vazio). E o SGTES (Mais Médicos) entrou em dois lotes: 09/06/2026 com 2 códigos MN prontos pra renderizar, e 22/06/2026 com 13 códigos que cobrem vagas ativas, vagas em processo de ocupação (BR/UF/DSEI) e as residências PRORES/PRAPS (anuais) — 12 com dado real até 2026; só MGDI_MS_XAW segue quebrado (HTTP 500). Detalhes em 🗺️ Cobertura e 🩺 SGTES.

Arquitetura

Stack do SIMPE

• Frontend: Next.js 16 (App Router) + React 19 + TypeScript
• Backend: server actions + camada rpc/ (lógica de banco)
• Banco: Supabase (Postgres) — dados SAGE persistidos em 4 tabelas + 1 view (ver 🗄️ Schema)
• Sync: client-side no navegador do admin (na VPN) → server actions → upsert via service_role

Cobertura

Cruzamento entre os 16 cards dos mockups e os endpoints disponíveis na API MGDI.

Cola rápida — o que cada endpoint retorna

São 5 padrões de URL. Cada um responde uma pergunta diferente sobre o indicador (independente do código):

Resumo mental: metadado = "quem é", carga = "quando tem", resultset BR = "linha do tempo nacional", resultset MN = "mapa", ficha = "documento". Os 4 primeiros bastam pra montar o card; a ficha é o (i).

4 elementos de cada card

Fonte: _source/01-cobertura-api-simpe-saude-bucal.md §1

Cards × código MGDI × status

Fonte: _source/01-cobertura-api-simpe-saude-bucal.md §2

Resumo quantitativo

A API entrega 100% dos elementos visuais exigidos (título, evolução, mapa, ficha) para os indicadores que ela cobre. O gap é de cobertura de indicadores, não de funcionalidade da API.

Novos códigos SAPS (lote 26/05/2026) — dados pendentes

Fonte: _source/05-novos-codigos-2026-05.md · _source/reports/novos-codigos-report.csv

SGTES — Mais Médicos

Primeira secretaria além da Saúde Bucal. Dois lotes: 09/06/2026 (PMM, lote PPF*) e 22/06/2026 (vagas por granularidade + residências). Todos testados na VPN.

Indicadores

Diferença entre os dois: PPFVAPMM conta apenas as vagas do Programa Mais Médicos; PPFTVA é o agregado que soma PMM + PMpB (Programa Médicos pelo Brasil), os dois programas de provimento federal em vigência.

Endpoints & samples

Lote 22/06/2026 — vagas por granularidade + residências

Segundo lote do SGTES, vinculado a AE 11.5 RE 11.5.1 (Objetivo Estratégico 11) e ao eixo de residências (AE 1.12). 13 códigos testados na VPN em 22/06/2026.

Vagas ativas, por tipo de equipe

Vagas em processo de ocupação

Residências (PRORES / PRAPS) — eixo AE 1.12

Fonte: lote 22/06/2026 · _source/reports/codigos-22-06-report.csv · _source/reports/problema-indicadores-22-06.csv

Resumo SGTES

Cobertos: PMM (vagas ativas) via PPFVAPMM; vagas ativas por tipo de equipe e vagas em processo de ocupação, cada um com agregado MN + fatias BR/UF/DSEI; e as 4 residências PRORES/PRAPS (anuais, via anodata=<ano>). PPFTVA aparece nos dois lotes. Único bloqueado: vagas por status — MGDI_MS_XAW dá HTTP 500 (bug de backend).

Fonte: PPF* (09/06/2026) · lote 22/06/2026 · _source/reports/novos-codigos-report.csv · codigos-22-06-report.csv · problema-indicadores-22-06.csv

Endpoints

Catálogo dos 5 tipos de endpoint usados no piloto. Base: http://apisix.demas.saude.gov/api-dev (rede interna do MS).

Tipos de chamada

Os 7 indicadores cobertos (CEOIMP, CEOVLR, SBESB, SBESB40H, SBRCUOM, SBUOMP, SBVRFAF) usam os mesmos 5 padrões de URL. Tamanhos e tempos de resposta vêm dos testes reais executados em 27/04/2026 (_source/reports/saps-bucal-report.csv).

{
  "id": 1185,
  "codigo": "CEOIMP",
  "titulo": "Número de Centros de Especialidades Odontológicas implantado e custeado",
  "tituloCompleto": "Número de Centros de Especialidades Odontológicas pago no período",
  "descricao": "Quantidade de CEO - Centro de Especialidades Odontológicas, tipos I, II e III...",
  "fonte_dados": "<p>SISAB</p>",
  "ativo": true,
  "acumulativo": false,
  "cache_ttl": 43200,
  "co_unidade_medida": 2,
  "Tags": [
    { "codigo": 120, "descricao": "Política Nacional de Saúde Bucal (PNSB)",
      "TagCategoria": { "codigo": 1, "descricao": "Ações e Programas" } }
  ],
  "UnidadeMedida":   { "codigo": 2, "descricao": "Número", "fl_fator": 1 },
  "Polaridade":      { "codigo": 1, "descricao": "Maior - melhor" },
  "Granularidade":   { "codigo": 4, "sigla": "MN", "descricao": "Município" },
  "ParametroFonte":  null,
  "ResponsavelTecnico":   [{ "codigo": 17494, "sigla": "CGSB", "nome": "COORDENAÇÃO-GERAL DE SAÚDE BUCAL" }],
  "ResponsavelGerencial": [{ "codigo": 19174, "sigla": "SAPS", "nome": "SECRETARIA DE ATENÇÃO PRIMÁRIA À SAÚDE" }],
  "VisualizacaoIndicador": [{ "codigo": 5, "nome": "Gráfico de linha" }]
}

[
  { "co_anomes": 201612 },
  { "co_anomes": 201712 },
  { "co_anomes": 201812 },
  { "co_anomes": 202112 },
  { "co_anomes": 202212 },
  { "co_anomes": 202301 },
  { "co_anomes": 202302 },
  ... // mensal a partir de 202301
  { "co_anomes": 202408 },
  { "co_anomes": 202409 },
  // ⚠️ falta 202410 — pendência aberta com DEMAS
  { "co_anomes": 202411 },
  { "co_anomes": 202412 },
  ...
  { "co_anomes": 202601 },
  { "co_anomes": 202602 }
]

[
  { "anomes": 202601, "CEOIMP": 1154 },
  { "anomes": 202602, "CEOIMP": 1175 },
  { "anomes": 202501, "CEOIMP": 1209 },
  { "anomes": 202502, "CEOIMP": 1209 },
  { "anomes": 202503, "CEOIMP": 1210 },
  { "anomes": 202504, "CEOIMP": 1210 },
  { "anomes": 202505, "CEOIMP": 1211 },
  // ... 39 pontos mensais cobrindo 5 anos calendário
  { "anomes": 202412, "CEOIMP": 1209 },
  { "anomes": 202312, "CEOIMP": 1192 },
  { "anomes": 202212, "CEOIMP": 1158 }
]

[
  { "anomes": 202602, "CEOVLR":  89421018.12 },  // PARCIAL: jan+fev/2026
  { "anomes": 202512, "CEOVLR": 506377601.91 },  // 2025 fechado
  { "anomes": 202412, "CEOVLR": 502460676.17 },  // 2024 fechado
  { "anomes": 202312, "CEOVLR": 282328339.49 },  // 2023 fechado
  { "anomes": 202212, "CEOVLR": 226805471.18 }   // 2022 fechado
]

[
  { "anomes": 202601, "uf": "AC", "regiao": "Norte", "local": "Acrelândia",  "codigogeo": 120001, "CEOIMP": 0 },
  { "anomes": 202602, "uf": "AC", "regiao": "Norte", "local": "Acrelândia",  "codigogeo": 120001, "CEOIMP": 0 },
  { "anomes": 202601, "uf": "AC", "regiao": "Norte", "local": "Assis Brasil","codigogeo": 120005, "CEOIMP": 0 },
  { "anomes": 202602, "uf": "AC", "regiao": "Norte", "local": "Assis Brasil","codigogeo": 120005, "CEOIMP": 0 },
  // ... ~5500 municípios, cada um com múltiplas competências do ano corrente
]

Bônus — listagem paginada

{
  "count": 1002,
  "rows": [
    {
      "id": 2290,
      "codigo": "AIDSNCN",
      "titulo": "Número de casos de aids identificados no período",
      "tituloCompleto": "Número de casos de aids identificados no período",
      "ativo": true,
      "UnidadeMedida":   { "codigo": 2, "descricao": "Número" },
      "Granularidade":   { "codigo": 4, "descricao": "Município" },
      "ResponsavelTecnico": [{ "codigo": 7060, "sigla": "SVSA", "nome": "SECRETARIA DE VIGILÂNCIA EM SAÚDE E AMBIENTE" }]
    }
  ]
}

Tabela de testes (27/04/2026)

Fonte: _source/reports/saps-bucal-report.csv

Schema do Banco

Schema implementado na migration 20260608150050_create_indicadores_sage_schema.sql — catálogo, dados observados (série nacional + mapa municipal) e o vínculo com os itens estratégicos. Incorpora os indicadores SAGE/MGDI ao SIMPE em 4 tabelas + 1 view.

Visão geral — 4 tabelas + 1 view

                     ┌───────────────────────────┐
                     │     indicadores_sage      │   catálogo (1 linha/indicador)
                     │  PK codigo  ('CEOIMP'...)  │
                     └────────────┬──────────────┘
            ┌─────────────────────┼───────────────────────┐
            │                     │                       │
 ┌──────────────────────┐ ┌──────────────────────────┐ ┌──────────────────────┐
 │ indicador_sage_      │ │ indicador_sage_valor_    │ │  item_indicador_sage │
 │   serie_br           │ │   municipio              │ │  (junção N:N)        │
 │ PK (codigo, anomes)  │ │ PK (codigo,anomes,       │ │ PK id                │
 │ → série nacional     │ │      codigogeo)          │ │ UQ (item_id, codigo) │
 │   (≈5 linhas)        │ │ → mapa, histórico        │ │        │             │
 └──────────────────────┘ │   (≈5500×comp×ind)       │ │        ▼             │
                          └────────────┬─────────────┘ │  itens_estrategicos  │
                                       │               │  (tabela existente)  │
                          ┌────────────▼─────────────┐ └──────────────────────┘
                          │ vw_indicador_sage_       │
                          │   mapa_atual  (view)     │  max(anomes) por município
                          └──────────────────────────┘

Mapa: endpoint MGDI → onde mora no schema

{
  "codigo": "CEOIMP",
  "titulo": "Número de Centros de Especialidades Odontológicas implantado e custeado",
  "titulo_completo": "Número de Centros de Especialidades Odontológicas pago no período",
  "unidade": "Número",
  "periodicidade_carga": "anual",
  "fonte": "SAGE/MGDI",
  "secretaria": "SAPS",
  "tema": "Saúde Bucal",
  "ficha": { "objetivo": "...", "metodo_calculo": "...", "fonte_dados": "..." },
  "competencias_disponiveis": [202412, 202512, 202601, 202602],
  "ativo": true,
  "serie_br_synced_at": "2026-06-03T09:00:05Z",
  "municipio_synced_at": "2026-06-03T09:01:10Z"
}

[
  { "codigo": "CEOVLR", "anomes": 202212, "valor": 226805471 },
  { "codigo": "CEOVLR", "anomes": 202312, "valor": 282328339 },
  { "codigo": "CEOVLR", "anomes": 202412, "valor": 502460676 },
  { "codigo": "CEOVLR", "anomes": 202512, "valor": 506377601 },
  { "codigo": "CEOVLR", "anomes": 202602, "valor":  89421018 }
]

[
  { "codigo": "CEOIMP", "anomes": 202601, "codigogeo": 120001, "uf": "AC", "regiao": "Norte", "local": "Acrelândia",   "valor": 0 },
  { "codigo": "CEOIMP", "anomes": 202602, "codigogeo": 120001, "uf": "AC", "regiao": "Norte", "local": "Acrelândia",   "valor": 0 },
  { "codigo": "CEOIMP", "anomes": 202601, "codigogeo": 120005, "uf": "AC", "regiao": "Norte", "local": "Assis Brasil", "valor": 0 },
  { "codigo": "CEOIMP", "anomes": 202602, "codigogeo": 355030, "uf": "SP", "regiao": "Sudeste", "local": "São Paulo",  "valor": 24 }
]

{
  "id": "8f3a1c2e-...-uuid",
  "item_id": "c12d77ab-...-uuid",
  "codigo": "CEOIMP",
  "arvore_vinculacao": "AE 6.2 RE 6.2.2",
  "numero_composto": "6.2.2",
  "criado_por": "a91b...-uuid",
  "data_criacao": "2026-06-03T09:05:00Z"
}

create view public.vw_indicador_sage_mapa_atual as
select distinct on (codigo, codigogeo)
  codigo, codigogeo, uf, regiao, local, anomes, valor
from public.indicador_sage_valor_municipio
order by codigo, codigogeo, anomes desc;

[
  { "codigo": "CEOIMP", "codigogeo": 120001, "uf": "AC", "local": "Acrelândia",   "anomes": 202602, "valor": 0 },
  { "codigo": "CEOIMP", "codigogeo": 355030, "uf": "SP", "local": "São Paulo",    "anomes": 202602, "valor": 24 }
]

DDL completo

As tabelas, view, índices, GRANTs e políticas RLS vivem na migration supabase/migrations/20260608150050_create_indicadores_sage_schema.sql (imutável, já aplicável). Núcleo dos CREATE TABLE (idêntico ao migrado):

create table public.indicadores_sage (
  codigo                   text primary key,
  titulo                   text not null,
  titulo_completo          text,
  unidade                  text,                              -- 'Número' | 'Moeda'
  periodicidade_carga      text not null default 'anual',     -- 'mensal' | 'anual'
  fonte                    text not null default 'SAGE/MGDI',
  secretaria               text,
  tema                     text,
  ficha                    jsonb not null default '{}',
  metadado_raw             jsonb not null default '{}',
  competencias_disponiveis jsonb not null default '[]',
  ativo                    boolean not null default true,
  metadado_synced_at       timestamptz,
  serie_br_synced_at       timestamptz,
  municipio_synced_at      timestamptz,
  ficha_synced_at          timestamptz,
  data_criacao             timestamptz not null default now(),
  data_atualizacao         timestamptz not null default now()
);

create table public.indicador_sage_serie_br (
  codigo text not null references public.indicadores_sage(codigo) on delete cascade,
  anomes integer not null,
  valor  numeric,
  primary key (codigo, anomes)
);

create table public.indicador_sage_valor_municipio (
  codigo    text not null references public.indicadores_sage(codigo) on delete cascade,
  anomes    integer not null,
  codigogeo integer not null,
  uf        char(2),
  regiao    text,
  local     text,
  valor     numeric,
  primary key (codigo, anomes, codigogeo)
);

create table public.item_indicador_sage (
  id                uuid primary key default gen_random_uuid(),
  item_id           uuid not null references public.itens_estrategicos(id) on delete cascade,
  codigo            text not null references public.indicadores_sage(codigo) on delete cascade,
  arvore_vinculacao text,
  numero_composto   text,
  criado_por        uuid references auth.users(id),
  data_criacao      timestamptz not null default now(),
  unique (item_id, codigo)
);
-- + view, índices, GRANTs e RLS na migration

Fonte: supabase/migrations/20260608150050_create_indicadores_sage_schema.sql · docs-indicadores/modelagem-banco-indicadores-sage.md

Design do Card

Para a equipe de design: o shape composto de um card de indicador, montado a partir do banco/cache (leitura VPN-independente), e de onde cada parte vem no 🗄️ Schema. A estratégia de componentes (EUI/Elastic Charts) está em 🎨 Estratégia de Frontend.

4 elementos → origem no schema

Cada card no painel precisa de 4 elementos: título descritivo, gráfico de barras (evolução anual BR), mapa por município (escala de cor gradiente) e ícone (i) (ficha).

Shape do payload

{
  "codigo": "CEOIMP",
  "card": {
    "titulo": "CEO cofinanciados",
    "subtitulo": "Nº de Centros de Especialidades Odontológicas",
    "unidade": "Número",
    "formato": "inteiro"
  },
  "evolucaoBR": [
    { "anomes": 202212, "ano": 2022, "valor": 1098, "parcial": false },
    { "anomes": 202312, "ano": 2023, "valor": 1142, "parcial": false },
    { "anomes": 202412, "ano": 2024, "valor": 1175, "parcial": false },
    { "anomes": 202512, "ano": 2025, "valor": 1209, "parcial": false },
    { "anomes": 202602, "ano": 2026, "valor": 1175, "parcial": true }
  ],
  "mapa": {
    "competencia": 202602,
    "municipios": [
      { "codigogeo": 120001, "uf": "AC", "local": "Acrelândia", "valor": 0 },
      { "codigogeo": 355030, "uf": "SP", "local": "São Paulo",  "valor": 24 }
    ]
  },
  "fichaUrl": "/api/sage/indicadores/CEOIMP/ficha"
}

Guia de Implementação

A camada de ingestão já está construída. Esta seção descreve como o sync e o vínculo funcionam de fato — não é mais uma receita a escrever. A UI dos cards (o que ainda falta) tem sua estratégia em 🎨 Estratégia de Frontend.

Fluxo de ponta a ponta

Navegador do admin (na VPN)                Supabase (Postgres)
┌──────────────────────────────┐           ┌───────────────────────────┐
│ lib/sage/mgdi-client.ts       │           │ indicadores_sage          │
│  fetch 5 endpoints (CORS open)│  payload  │ indicador_sage_serie_br   │
│  parse + chunk (MN)           │ ───────►  │ indicador_sage_valor_     │
│         │                     │  server   │   municipio               │
│         ▼                     │  actions  │ item_indicador_sage       │
│ actions/indicadores-sage/*    │ ───────►  │   (via service_role,      │
│  (re-checa papel Admin)       │   RPC     │    upsert/replace)        │
└──────────────────────────────┘           └───────────────────────────┘
                                                       │
                              leitura (cache/admin, VPN-independente) ▼
                                            SIMPE front renderiza os cards

Onde fica

A página é a aba Painel Admin → Indicadores SAGE (app/(main)/painel-admin/indicadores-sage/page.tsx) — Admin/SuperAdmin apenas (checado na server action e em RLS, defesa em profundidade). Dois painéis:

• Sincronizar (IndicadoresSageSyncPanel) — puxa os 5 datasets da MGDI.
• Vincular (VincularIndicadorPanel) — liga indicadores a itens do plano.

1. Sincronização (browser → server action → RPC)

O lib/sage/mgdi-client.ts roda no navegador (na VPN), busca e parseia cada endpoint, e chama as server actions de actions/indicadores-sage/sync.ts. Cada dataset persiste com a estratégia adequada e carimba seu próprio *_synced_at — freshness honesta mesmo em falha parcial.

2. Vínculo indicador ↔ item estratégico

O VincularIndicadorPanel associa um indicador a um item do plano (tipicamente Resultado ou Ação), criando uma linha em item_indicador_sage. Dois caminhos:

• Auto-sugestão pela "árvore de vinculação" do CSV: token 'AE 6.2 RE 6.2.2' → número composto '6.2.2' → casa contra as colunas numero denormalizadas dos *_dashboard_cache (escopo por plano) → item_id (resolve-arvore-vinculacao.ts) → o admin confirma em 1 clique.
• Picker manual: cascata Objetivo → Ação → Resultado (IndicadorHierarchyPicker) quando não há sugestão ou se quer ajustar.

A proveniência (arvore_vinculacao cru + numero_composto resolvido + criado_por) fica gravada na linha para auditoria. O parser do número composto é coberto por testes (__tests__/rpc/indicadores-sage/resolve-arvore-vinculacao.test.ts).

3. Seed — dado real, sem VPN no dev local

Para desenvolver fora da VPN, o dado real da MGDI está commitado em seeds divididos:

• supabase/seeds/indicadores-sage.sql — catálogo (7 códigos do piloto) + série BR + vínculos.
• supabase/seeds/indicadores-sage-municipio.sql — mapa municipal (~4 MB, via COPY).

Gerados por scripts/gen-indicadores-sage-seed.mjs e referenciados em supabase/config.toml (sql_paths). Num supabase db reset o banco local já nasce populado.

4. Leitura (o que a UI vai consumir)

Os cards leem do Postgres (cache/admin client), nunca da MGDI — por isso a leitura é VPN-independente. As helpers de tratamento já existem; ex. o ano corrente parcial dos financeiros é derivável do grão sem coluna extra:

// Marca o ponto parcial: mês ≠ 12 no ano corrente, em indicador mensal.
// `anomes` (AAAAMM) + `periodicidade_carga='mensal'` bastam — sem coluna "parcial".
export function isPontoParcial(anomes: number, anoCorrente: number): boolean {
  const ano = Math.floor(anomes / 100);
  const mes = anomes % 100;
  return ano === anoCorrente && mes !== 12;
}

Estratégia de Frontend

Recomendação para construir os cards de indicador com paridade visual e de UX com o stack Elastic/Kibana — Elastic UI (EUI) + Elastic Charts. Esta seção é estratégia: não há código de front implementado ainda.

Realidade de compatibilidade (verificado jun/2026)

Como introduzir no stack atual — honestamente

• (a) Mismatch de peer com React 19. Instalar com overrides no package.json (ou --legacy-peer-deps) para destravar o peer, e validar os componentes específicos que usarmos — não assumir o pacote inteiro. Evitar montar a árvore EUI sob <StrictMode> (double-invoke quebra os componentes legados citados no épico). Travar versões exatas e cobrir os cards com smoke tests.
• (b) Emotion/CSS-in-JS + SSR. EUI usa Emotion e exige <EuiProvider>. No App Router isso pede um cache Emotion próprio conectado via useServerInsertedHTML (de next/navigation) para o CSS sair no SSR sem flash — tudo atrás de fronteiras "use client" (EUI é client-only).
• (c) Escopo restrito às superfícies de indicador. Montar EUI só numa ilha (subárvore de rota dos indicadores) com seu próprio cache + provider, para não brigar com o theming Tailwind/shadcn no resto do app. Conter/resetar estilos na fronteira da ilha (Tailwind preflight × reset do EUI). O dark/light do EUI (EuiProvider colorMode) deve seguir o tema já existente do SIMPE.

# Premissa: peer forçado até o suporte oficial a React 19 sair.
npm i @elastic/eui @elastic/eui-theme-borealis @elastic/charts \
      @emotion/react @emotion/css moment @elastic/datemath
# package.json → "overrides": { "react": "19.2.0", "react-dom": "19.2.0" }
# Escopar a uma ilha "use client" com EuiProvider + cache Emotion próprio.

4 elementos do card → componente Elastic + fonte de dado

Mapa: por que NÃO o Elastic Maps

Rollout em fases

1. Prova de conceito (1 card): título + gráfico de evolução (Elastic Charts) numa ilha "use client" com EuiProvider, validando EUI/Charts sob React 19 (peer forçado, sem StrictMode). Mede risco real antes de investir.
2. Um indicador completo: adicionar mapa coroplético + ficha (i) ao card de PoC, fechando os 4 elementos para 1 código (ex. CEOIMP).
3. Galeria: replicar para os 7 do piloto, montar o dicionário lib/sage/titulos.ts e a grade de cards.

Ressalvas

Três comportamentos da API que precisam ser tratados no front. Ignorá-los gera bugs silenciosos — gráficos renderizam, mas com valor errado.

[
  { "anomes": 202601, "uf": "AC", "local": "Acrelândia", "codigogeo": 120001, "CEOIMP": 0 },
  { "anomes": 202602, "uf": "AC", "local": "Acrelândia", "codigogeo": 120001, "CEOIMP": 0 }
]

function ultimaPorMunicipio<C extends string>(rs: ResultsetMN<C>): ResultsetMN<C> {
  const acc = new Map<number, ResultsetMN<C>[number]>();
  for (const row of rs) {
    const atual = acc.get(row.codigogeo);
    if (!atual || row.anomes > atual.anomes) acc.set(row.codigogeo, row);
  }
  return Array.from(acc.values());
}

Pendências

Itens acionáveis até o piloto rodar em produção. Bloqueadores travam o lançamento; não-bloqueadores afetam qualidade ou completude visual.

Bloqueadores do piloto

• 8 indicadores sem código MGDI

  Dono: DEMAS · Próxima ação: mapear oficialmente os indicadores dos mockups 4.5 e 4.6 + Novas UOM (4.2) + eSB cofinanciadas (4.4). Painéis das áreas têm endpoint público? Parcialmente endereçado: o lote de 26/05 já trouxe códigos para CEO Tipo I/II/III e eSB Modalidade I/II — mas sem dado (ver item abaixo).
• Dados não carregados nos novos códigos de Saúde Bucal (lote 26/05/2026)

  Dono: DEMAS · Próxima ação: os 5 códigos de Saúde Bucal têm metadado e ficha, mas /carga e /resultset retornam HTTP 500 (SBCEOTIPO1, SBCEOTIPII, SBESBMODII — erro syntax error at or near "null") ou array vazio (SBCEOTPIII, SBESBMODI). Carregar os dados / corrigir o pipeline. Evidência: _source/reports/novos-codigos-report.csv. Nota: o PMM (SGTES) já foi resolvido pela área com os códigos PPFVAPMM e PPFTVA — ver 🩺 SGTES.
• Endpoint quebrado: MGDI_MS_XAW (lote 22/06/2026)

  Dono: DEMAS · Próxima ação: MGDI_MS_XAW ("vagas por status — PMM") dá HTTP 500 já no /carga (syntax error at or near "null", Postgres 42601) — persiste com qualquer parâmetro de data, então é bug de backend, o mesmo que derruba 3 códigos de Saúde Bucal do lote 26/05. Corrigir o pipeline. Evidência: _source/reports/problema-indicadores-22-06.csv. Resolvido no mesmo lote: as 4 residências (3KP/4RU/543/XLJ) não estavam sem dado — eram anuais chamadas com janela mensal; com anodata=<ano> retornam as 27 UFs. Ver 🩺 SGTES.

Não-bloqueadores

• Construir a UI dos cards de indicador

  Dono: front · Próxima ação: implementar os cards (título, evolução, mapa, ficha) seguindo a 🎨 Estratégia de Frontend (EUI + Elastic Charts em ilha, sob React 19 com peer forçado). É o principal trabalho restante; a leitura é VPN-independente.
• Sync de produção depende de admin na VPN

  Dono: operação · Próxima ação: o app não precisa mais de acesso externo à API (leituras vêm do Postgres). Resta a operação: o sync precisa ser disparado por um Admin/SuperAdmin conectado à VPN interna do MS. Avaliar cadência (manual periódico) e quem opera.
• Corrigir códigos e rótulos no CSV de Saúde Bucal

  Dono: Mariana / área · Próxima ação: SBCEOTIPOII→SBCEOTIPII e SBCEOTIPOIII→SBCEOTPIII (os do CSV dão 404), e as duas linhas estão rotuladas "Tipo III".
• Tratamento visual do ano corrente parcial

  Dono: Luísa · Próxima ação: definir entre filtrar o ponto, mostrar com hash/listrado e label "fev/2026" (recomendado, replica mockup SAGE), ou substituir anodata=-5 por chamada explícita por competências.
• Validar mapeamento "Carga Horária Diferenciada" = SBESB - SBESB40H

  Dono: Mariana · Próxima ação: confirmar se "diferenciada" = "20h + 30h" no contexto operacional da Saúde Bucal (subtração já confirmada na API: SBESB cobre 20h+30h+40h, SBESB40H só 40h).
• Construir dicionário de títulos por código MGDI

  Dono: Mariana · Próxima ação: preencher 4 slots por indicador (cardTitulo, cardSubtitulo, graficoEvolucao, mapa) alinhados aos mockups, em lib/sage/titulos.ts. Contexto na 🎨 Estratégia de Frontend.
• Confirmar política de rate-limit no APISIX

  Dono: DEMAS · Próxima ação: qual o limite efetivo por consumer? Cadastrar SIMPE com cota dedicada? Hoje não há cabeçalhos X-RateLimit-*.
• Investigar gap de carga 202410 no CEOVLR

  Dono: DEMAS · Próxima ação: indisponibilidade real ou falha de carga? Afeta totalizador anual de 2024? (também aparece gap em 202509).