Pular para o conteúdo

OPAOPA, Orçamento Participativo do PiauíSEPLAN-PI

Um portal do Estado com um
frontend que o time mantém

Na refatoração do frontend público, refiz a landing e o observatório, corrigi inconsistências de design e reorganizei o código. O painel administrativo ficou com outros devs do time.

Papel
Frontend da landing pública e do observatório
Autoria
180 commits na refatoração; o painel administrativo é de outros devs
Período
Maio e junho de 2026
Stack
  • Next.js 15
  • React 19
  • Mantine 7
  • Tailwind 3
  • TanStack Query
  • nuqs

Contexto

O OPA é o portal em que a população do Piauí participa do orçamento do Estado: editais, cronograma, propostas e o observatório dos projetos. A landing cresceu com os arquivos no mesmo nível, e ficou difícil encontrar onde mexer. O time refez o frontend público a partir do boilerplate da SEPLAN, e eu fiquei com a landing e o observatório.

Autoria

O que foi meu
A landing pública e o observatório: estrutura de pastas, componentes, cache das consultas, filtros na URL e acessibilidade da busca, dos filtros e da paginação.
O que foi do time
Outros devs da SEPLAN fizeram o painel administrativo e o resto do produto.

Decisões

Decisões que tomei na refatoração.

Uma pasta por seçãoDescartei manter as seções no mesmo nível da pasta

A landing cresceu com os arquivos no mesmo nível, e ficou difícil encontrar onde mexer. Na refatoração, cada seção ganhou sua pasta, com componentes e dados juntos.

Ler a decisão
Cache das consultas por cinco minutosDescartei consultar a API em toda visita

Como os dados são públicos e iguais para todos, deixei a resposta guardada por cinco minutos. Alguns minutos de atraso são aceitáveis para uma vitrine como o observatório.

Ler a decisão
Hero do observatório renderizado no servidorDescartei renderizar o hero inteiro como componente de cliente

O texto e a imagem do topo chegam prontos do servidor. Só a animação dos números roda no navegador.

Ler a decisão
Filtros na URLDescartei manter o estado dos filtros só no navegador

Com os filtros na URL, um link compartilhado abre o observatório já filtrado, e o servidor monta a lista com esses parâmetros.

Ler a decisão
Tokens de tipografia e espaçoDescartei definir valores soltos em cada componente

Com tokens, tamanhos e espaçamentos se mantêm iguais entre as seções e podem ser ajustados em um só lugar.

Ler a decisão
Acessibilidade na busca, nos filtros e na paginaçãoDescartei manter os botões só com ícone e os controles sem rótulos acessíveis

O Lighthouse apontou botões sem nome acessível e falta de rótulos nos filtros e na paginação. Corrigi esses pontos para deixar os controles mais claros para quem navega pela interface.

Ler a decisão
Ver todas em Decisões

Estrutura

A pasta da landing antes e depois. Organizei por seção e tirei o conteúdo de dentro dos componentes.

Antes

src/landing

  • about-section.tsx
  • banner-section.tsx
  • benefits-section.tsx
  • carousel.tsx
  • contact-section.tsx
  • faq-section.tsx
  • features-section.tsx
  • gallery-section.tsx
  • hero-section.tsx
  • newsletter-section.tsx
  • partners-section.tsx
  • e outros arquivos no mesmo nível da pasta

Depois

src/landing

  • componentslayout, shell, ui
  • libassets, navegação, hooks
  • sectionsuma pasta por seção
    • hero
      • hero-section.tsx
      • hero-title.tsx
      • slides.tsconteúdo fora do componente
    • stats
      • stats-section.tsx
      • stat-card.tsx
      • stats-data.tsdados separados
      • index.tsexportação única
    • e mais seções no mesmo formato
Exemplo ilustrativo com nomes fictícios, criado para mostrar o padrão da mudança sem revelar a estrutura real do projeto.

Como dá para ver funcionando

O que mudou para quem usa:

  • O cronograma destaca o evento ativo pela data.
  • O carrossel do topo leva cada slide a um link.
  • Os cards carregam com esqueleto, um por card.
  • Os filtros do observatório ficam na URL e podem ser compartilhados.

Resultado

ResultadoAinda não medido

  • Landing e observatório publicados.

Ainda não medi desempenho nem uso.

Próximo case

Plataforma de preços

A busca de preços das compras públicas, reescrita

Ler o case