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ção
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ãoCache das consultas por cinco minutos
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ãoHero do observatório renderizado no servidor
O texto e a imagem do topo chegam prontos do servidor. Só a animação dos números roda no navegador.
Ler a decisãoFiltros na URL
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ãoTokens de tipografia e espaço
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ãoAcessibilidade na busca, nos filtros e na paginação
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ãoEstrutura
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
- hero
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.