-
ESPDocs 1.0.0
Stablereleased this
2026-10-30 15:50:40 +00:00 | 5 commits to main since this releaseImagem
git.lucasrguerra.dev.br/lucasrguerra/espdocs:1.0.0A primeira versão com tag. O trabalho anterior nunca foi tagueado, então esta
entrada resume tudo desde o primeiro commit, em 2025-10-21, até a imagem Docker.Conteúdo
- Documentação não oficial do ecossistema ESP32 em português: uma página por
série de chips, com especificações, conexões e consumo, e a página de comparação
lado a lado. - Diagramas interativos de conexões e componentes, com o esquema de dados de
conexões padronizado. - Frameworks documentados: ESP-IDF, Arduino, MicroPython, ESP-RainMaker e
ESP-Matter. - Glossário técnico, página "Sobre" e chamadas para o catálogo.
- Catálogo de placas de desenvolvimento a partir de uma planilha do Google
(/api/placas), com filtros e cache de 10 minutos. - Ferramenta de seleção: perguntas sobre o projeto (Ethernet, tela e outras) e
recomendação da série mais adequada. - Novos modelos, incluindo o ESP32-H4, e a contagem de componentes e de drivers
(interface, conectividade e áudio) ampliada.
Interface e acessibilidade
- Tema escuro e redesenho das páginas internas no novo sistema de design, com
contraste AAA e auditoria automática de temas e de páginas (npm run check). - Identidade nova: logo, ícones,
manifeste imagens Open Graph. - SEO: mapa do site, dados estruturados, trilhas de navegação e favicons.
- Exportação do conteúdo em PDF CMYK e dos slides de treinamento em PDF 16:9,
gerados com Puppeteer (scripts locais).
Dados corrigidos
- Revisão dos dados das séries contra os datasheets oficiais da Espressif:
consumo, temperatura, ADC, PSRAM, memória LP, CAN FD, frequências e versões de
Secure Boot do ESP32, S2, S3, C2, C3, C5, C6, C61, H2, H4, P4 e S31.
Implantação
- Imagem Docker (
node:22-alpine, buildstandalone, usuário sem privilégio,
HEALTHCHECK), pronta para o servidor Oracle, publicada paralinux/arm64em
git.lucasrguerra.dev.br/lucasrguerra/espdocs. A variávelNEXT_OUTPUT=standalone
liga o empacotamento só dentro da imagem; fora dela o build continua o mesmo
para opm2(start.config.js, porta 3001). - O código passou para o Gitea, com CI em
.gitea/workflows: lint, auditorias,
Trivy no repositório e na imagem, e teste de que a imagem sobe e responde. O
Release reaproveita a imagem quando nada do que a compõe mudou.
Segurança
next15.5.28, que corrige a execução remota de código sem autenticação na
otimização de imagens (GHSA-2464-fhr4-w9xw), epostcssfixado acima da cópia
embutida nonext.
Downloads
- Documentação não oficial do ecossistema ESP32 em português: uma página por