Guias rapidos

Roteiros por objetivo para sair da duvida e chegar no conteudo certo.

Escolha o resultado que voce precisa alcancar. Cada guia organiza sinais, perguntas de triagem, leituras e proximos passos para investigar tecnologia com mais criterio.

Ver problemas tecnicos Ver FAQ tecnico Comparar decisoes

Quando usar estes guias

Use esta pagina quando voce sabe o objetivo, mas ainda nao sabe qual termo buscar, qual artigo ler ou qual decisao tecnica tomar primeiro. A ideia e reduzir dispersao e conduzir a leitura por contexto.

O que cada guia entrega

Cada roteiro combina sintomas, perguntas de triagem, caminhos de leitura e um resultado esperado. Quando houver uma decisao com impacto real em producao, use o guia como orientacao inicial e valide no ambiente do sistema.

Roteiros de decisao

Escolha pelo objetivo, nao pela ferramenta.

Ferramentas mudam, mas problemas recorrentes de software costumam nascer de observabilidade, processo, documentacao, seguranca, deploy e manutencao. Estes guias conectam esses temas ao conteudo do portal.

Performance

Quero descobrir por que uma API esta lenta

Um roteiro para separar sintomas, medir tempos, conferir logs e evitar mudancas cegas em infraestrutura, banco ou codigo.

Use quando

Um endpoint responde bem em alguns horarios e mal em outros
A equipe nao sabe se o gargalo esta no banco, na API ou em chamada externa
O problema aparece em producao, mas nao se repete facilmente no ambiente local

Perguntas de triagem

Qual rota, payload, usuario e horario mostram o problema?
Existe tempo separado para banco, integracoes externas e processamento interno?
Os logs permitem correlacionar uma requisicao do inicio ao fim?

Caminho recomendado

Resultado esperado: Um mapa simples de sintomas, metricas iniciais, hipoteses e primeira correcao testavel.

Proximo passo: Revisao de API Spring Boot

Deploy

Quero publicar um sistema na VPS sem quebrar DNS, SSL ou rotas

Um caminho para organizar Docker, Nginx, Cloudflare, portas, rotas SPA, health checks e validacao pos-deploy.

Use quando

O container sobe, mas o dominio abre outro sistema ou uma pagina antiga
A API funciona por IP/porta, mas falha pelo dominio final
Rotas internas do React quebram ao atualizar a pagina

Perguntas de triagem

Quais portas sao internas do container e quais portas estao expostas no host?
O Nginx separa corretamente frontend, API, sitemap, robots, ads.txt e feed?
A virada de DNS foi validada no dominio real, e nao apenas por localhost?

Caminho recomendado

Resultado esperado: Uma lista de validacao antes e depois da virada, com menos tentativa e erro em producao.

Proximo passo: Apoio em deploy Docker/VPS

Legados

Quero organizar um sistema legado antes de modernizar

Um roteiro para transformar conhecimento oral em mapa tecnico antes de decidir entre estabilizar, refatorar ou reescrever.

Use quando

Poucas pessoas entendem regras, banco, rotinas e integracoes
A empresa tem medo de mexer porque cada ajuste gera risco
A ideia de reescrever tudo apareceu antes de mapear o que existe

Perguntas de triagem

Quais fluxos sustentam faturamento, atendimento ou operacao diaria?
Quais regras estao documentadas e quais vivem apenas na memoria da equipe?
Quais partes podem ser estabilizadas antes de qualquer modernizacao maior?

Caminho recomendado

Resultado esperado: Um mapa inicial de fluxos, riscos, integracoes, pontos de manutencao e proximas modernizacoes possiveis.

Proximo passo: Modernizacao Java legado

IA aplicada

Quero usar IA em codigo ou documentos com mais controle

Um caminho para separar ganho real de produtividade, revisao humana, fontes confiaveis, permissao e risco de respostas sem contexto.

Use quando

A equipe quer usar IA para codigo, documentacao ou suporte interno
Documentos estao duplicados, desatualizados ou sem dono claro
O codigo gerado por IA parece correto, mas ainda nao foi revisado em contexto

Perguntas de triagem

Quais fontes sao confiaveis e quais sao rascunhos ou informacao antiga?
Quem revisa seguranca, regra de negocio, teste e impacto em producao?
As respostas de IA mostram origem ou apenas uma conclusao pronta?

Caminho recomendado

Resultado esperado: Uma base de fontes, perguntas de teste, limites de uso e criterios de revisao antes de automatizar.

Proximo passo: Diagnostico tecnico

Seguranca

Quero reduzir risco de dependencias, segredos e pipeline

Um roteiro para tratar bibliotecas, SBOM, imagens Docker, segredos e CI/CD como parte da operacao, nao como detalhe invisivel.

Use quando

O projeto tem dependencias antigas sem plano de atualizacao
Segredos aparecem em arquivos locais, variaveis soltas ou historico
O deploy depende de passos manuais ou pipeline sem verificacoes claras

Perguntas de triagem

Existe inventario das dependencias diretas e transientes?
Segredos, variaveis publicas e configuracoes por ambiente estao separados?
O pipeline roda build, teste e verificacoes antes de publicar imagem ou deploy?

Caminho recomendado

Resultado esperado: Um inventario inicial de risco tecnico, segredos, dependencias, imagens e pontos de controle no CI/CD.

Proximo passo: Diagnostico tecnico

Conteudo e descoberta

Quero transformar um site tecnico em portal util para busca

Um roteiro para organizar conteudo por temas, perguntas, problemas, trilhas, fontes, autoria, sitemap e materiais reais.

Use quando

O site tem paginas isoladas, mas falta caminho claro de leitura
O conteudo precisa mostrar autoria, criterio editorial e fontes de apoio
A estrategia depende de SEO, AdSense, Google Ads ou captura de leads

Perguntas de triagem

O visitante encontra conteudo por problema, por tema e por nivel de decisao?
Existem paginas de confianca como autoria, politica editorial, fontes e mapa do site?
Os CTAs aparecem depois de conteudo util ou a pagina parece apenas comercial?

Caminho recomendado

Resultado esperado: Uma estrutura editorial com navegação interna, paginas de confianca e conteudo reaproveitavel no layout futuro.

Proximo passo: Ver politica editorial