Automação em n8n que pesquisa fontes reais com SerpAPI, usa Groq para síntese estruturada, considera feriados do Google Calendar, persiste planos em Data Tables e entrega missões pelo Telegram. Regras determinísticas controlam idempotência, grounding, datas, estados e feedback.
- n8n
- JavaScript
- Groq
- SerpAPI
- Google Calendar
- Telegram
- Docker
Contexto e problema #
Aprender todos os dias exige escolher temas úteis, encontrar fontes confiáveis, encaixar atividades na agenda e preservar o histórico. O projeto automatiza esse ciclo sem delegar regras críticas ao modelo.
Minha contribuição #
O repositório reúne modelagem de dados, geração determinística de quatro workflows n8n, lógica JavaScript reutilizável, integrações OAuth e HTTP, testes, documentação operacional e varredura de segredos.
Arquitetura #
O planejador semanal pesquisa e valida fontes antes de materializar temas e missões. Um fluxo diário entrega a missão elegível; outro resolve callbacks e atualiza apenas o item endereçado. Cinco Data Tables mantêm categorias, temas, planos, missões e destinos.
- ✓ 4 workflows / 149 nodes
- ✓ 5 Data Tables / 48 fields
- ✓ Grounding by exact source URL
- ✓ Idempotent state transitions
Avaliação e qualidade #
A suíte registra 25 testes funcionais e 1.021 verificações estruturais e de segurança. Groq, SerpAPI, Calendar e o comando /start do Telegram foram validados em serviços reais.
Limitações #
O Planner corrigido ainda precisa de reteste real ponta a ponta, seguido pelo Dispatcher e pelo callback de uma missão. Por isso, os agendamentos de produção permanecem inativos.
Próximos passos #
Reimportar os exports corrigidos, provar idempotência em duas execuções, validar entrega e feedback reais e só então ativar os agendamentos.
Teste o produto e inspecione o código
A demo online executa o fluxo principal com dados locais e seguros. O repositório público preserva backend, testes, infraestrutura e documentação técnica completos.