Full Stack & IA Generativa

Gerador de Planos de Aula com IA

Aplicação full stack moderna que conecta o ecossistema educacional às capacidades de IA generativa do Google Gemini 2.5 Flash, gerando planos estruturados conforme diretrizes da Base Nacional Comum Curricular (BNCC).

Next.js 14TypeScriptGoogle Gemini APITailwind CSSZodSupabase

Ver Repositório no GitHub Acessar Aplicação (Live Demo)

Destaques de Engenharia

Integração direta com Google Gemini 2.5 Flash via Server Actions

Validação ponta a ponta com schemas Zod garantindo tipagem forte em runtime

Estratégia de retries automatizados com ajuste adaptativo de temperatura

Persistência estruturada em PostgreSQL com suporte a campos JSONB

Interface responsiva e minimalista construída com Tailwind CSS

Fluxo de Arquitetura

[Next.js Client] ──► [Server Action] ──► [Zod Input Validation]
                                               │
                                               ▼
                                      [Gemini 2.5 Flash API]
                                               │
                                               ▼
[PostgreSQL Database] ◄── [Safe Parsing] ◄── [Response Normalizer]

• Frontend: Next.js 14 (App Router) com React Hook Form

• Validação: Zod garantindo imunidade a payloads malformados ou incompletos da LLM

• Serviço de IA: SDK Gemini com pipeline de sanitização de blocos markdown e regex

Implementação em Código

Pipeline de Validação e Sanitização de LLM com Zodtypescript

const PlanSchema = z.object({
  tema: z.string().min(3),
  habilidadesBNCC: z.array(z.string()),
  metodologia: z.string().min(20),
  recursos: z.array(z.string())
});

export async function parseGeminiResponse(rawText: string) {
  const sanitized = rawText.replace(/```json|```/g, "").trim();
  const parsedJson = JSON.parse(sanitized);
  return PlanSchema.parse(parsedJson);
}

Desafios Técnicos Resolvidos

Desafio:

Variação na estrutura JSON devolvida pelo modelo de linguagem em requisições consecutivas.

Resolução Implementada:

Criação de parser intermediário com sanitização de formatação e fallback automático com temperatura restritiva.

Desafio:

Falhas de tipagem estrita no processo de build em produção.

Resolução Implementada:

Refatoração dos blocos de captura de erro do Zod para runtime typesafe defensivo.

Tem interesse em detalhes da arquitetura ou código deste projeto?

Conversar no WhatsApp