YSH AI Chatbot

Este é um chatbot de IA para pré-vendas de energia solar, construído com Next.js 15, React 19, TypeScript e Vercel AI SDK.

Documentação

Toda a documentação do projeto está organizada na pasta docs/:

• README Principal - Visão geral e guia de instalação
• AI Gateways - Configuração de provedores de IA
• Docker Setup - Configuração com Docker/FOSS
• Load Balancing - Sistema de balanceamento de carga
• Personas Blueprint - Sistema de personas do usuário
• UI Components - Mapeamento de componentes
• Microcopy Library - Biblioteca de microcopies reutilizáveis
• Environment Variables - Configuração de variáveis de ambiente
• Esquema Canônico - Contratos Zod e exemplos JSON
• Fluxos E2E Omni - Sequência bus→workers→agents→dispatcher
• Playbooks Operacionais - Operar, depurar e recuperar

Estrutura do Projeto

├── app/                 # Next.js App Router
├── components/          # Componentes React reutilizáveis
├── lib/                 # Lógica de negócio e utilitários
├── config/              # Configurações organizadas
│   ├── docker/         # Configurações Docker
│   └── playwright/     # Configurações Playwright
├── docs/                # Documentação completa
├── tests/               # Testes automatizados
└── scripts/             # Scripts utilitários

Desenvolvimento

# Instalar dependências
pnpm install

# Executar em modo desenvolvimento
pnpm dev

# Executar testes
pnpm test

# Build para produção
pnpm build

Para mais informações detalhadas, consulte a documentação completa.