7.9 KiB
7.9 KiB
🎉 MVP - Gerador de Prompts para Hotéis/Motéis
📋 Visão Geral
Aplicativo web para criação rápida e eficiente de prompts de IA para hotéis e motéis, com:
- Interface guiada de 14 categorias universais
- Preview em tempo real do prompt final
- Persistência de prompts salvos
- Pré-conhecimento embutido de boas práticas
🛠️ Stack Tecnológica
- Frontend: Next.js 15 + TypeScript + Tailwind CSS
- Backend/API: Next.js API Routes + Zod
- Banco de dados: SQLite + Prisma ORM
- Deploy: Vercel (sugerido)
📁 Estrutura do Projeto
gerador-prompts-hoteis/
├── app/ # Páginas Next.js
│ ├── layout.tsx # Layout principal
│ ├── page.tsx # Página inicial
│ ├── globals.css # Estilos Tailwind
│ └── prompts/ # Wizard de 14 etapas
│ ├── page.tsx # Página do wizard
│ └── [id]/ # Detalhes de prompt salvo
│ └── page.tsx # Página de visualização
├── app/api/ # API Routes (Backend)
│ └── prompts/
│ ├── route.ts # POST /api/prompts (salvar)
│ └── [id]/
│ └── route.ts # GET /api/prompts/[id] (carregar)
├── components/ # Componentes React
│ ├── CategoryStep.tsx # 14 categorias com dicas
│ ├── Wizard.tsx # Gerenciador do fluxo
│ ├── StepIndicator.tsx # Indicador de progresso
│ ├── CategoryForm.tsx # Formulário de entrada
│ └── PromptPreview.tsx # Preview em tempo real
├── lib/ # Funções auxiliares
│ ├── categories.ts # Metadados das 14 categorias
│ ├── prompt-builder.ts # Montador de prompts finais
│ └── prisma.ts # Cliente Prisma compartilhado
├── prisma/ # Schema e dados
│ ├── schema.prisma # Modelo do banco (Prompt, PromptCategory)
│ └── seed.ts # Dados iniciais de exemplo
└── configs/ # Arquivos de configuração
├── package.json # Dependências e scripts
├── tsconfig.json # Configuração TypeScript
├── next.config.js # Configuração Next.js
├── tailwind.config.ts # Configuração Tailwind
├── postcss.config.js # PostCSS
└── next-env.d.ts # Tipos Next.js
✅ Funcionalidades Implementadas
🎨 Fase 0 - Fundamentos e Escopo
- ✅ 14 categorias universais identificadas
- ✅ Estrutura padrão de prompts documentada
- ✅ Boas práticas mínimas definidas
🔧 Fase 1 - Base Técnica
- ✅ Projeto Next.js criado com TypeScript
- ✅ Tailwind CSS configurado
- ✅ Arquivos de config básicos criados
🗂️ Fase 2 - Banco de Dados
- ✅ Prisma configurado com SQLite
- ✅ Schema criado:
PromptePromptCategory - ✅ Seed inicial criado com 3 prompts de exemplo
- ✅ Cliente Prisma compartilhado (
lib/prisma.ts)
🖥️ Fase 3 - Interface do Usuário
- ✅ Página principal com wizard de 14 etapas
- ✅
CategoryStep.tsx- 14 categorias com prompts e dicas - ✅
Wizard.tsx- Gerenciador do fluxo principal - ✅
StepIndicator.tsx- Indicador visual de progresso - ✅
CategoryForm.tsx- Formulário de entrada por categoria - ✅ Pasta
app/prompts/preparada
📝 Fase 4 - Geração do Prompt Final
- ✅
lib/categories.ts- Metadados das 14 categorias - ✅
lib/prompt-builder.ts- Função modular para montar prompts - ✅
app/components/PromptPreview.tsx- Preview em tempo real com useMemo
💾 Fase 5 - Persistência (API Routes)
- ✅
app/api/prompts/route.ts- POST para salvar prompts - ✅
app/prompts/[id]/route.ts- GET para carregar prompts - ✅ Sistema de salvamento e carregamento implementado
🏷️ As 14 Categorias Universais
| # | Categoria | Prompt Principal | Dica Principal |
|---|---|---|---|
| 1 | Perfil do Hotel | Descriva o hotel em uma ou duas frases. | Inclua estilo (boutique, resort, econômico) |
| 2 | Localização | Onde o hotel está localizado e quais pontos são relevantes? | Mencione proximidade de atrações, acessos e diferenciais. |
| 3 | Público-alvo | Quem é o hóspede ideal? | Descreva perfil demográfico e motivação de viagem. |
| 4 | Objetivo da Comunicação | Qual o principal objetivo desta peça? | Defina um objetivo claro. |
| 5 | Tom de Voz | Qual tom de voz deve ser usado? | Escolha 2-3 adjetivos. |
| 6 | Diferenciais | Quais são os diferenciais do hotel? | Priorize até 3 atributos. |
| 7 | Serviços e Amenidades | Liste os serviços e amenidades mais relevantes. | Agrupe por experiência. |
| 8 | Experiência do Hóspede | Como você quer que o hóspede se sinta? | Foque em sensações. |
| 9 | Gastronomia | O que destacar na oferta gastronômica? | Cite estilos culinários. |
| 10 | Bem-estar | Quais experiências de relaxamento ou saúde existem? | Inclua spa, terapias. |
| 11 | Sustentabilidade | Há práticas sustentáveis relevantes? | Seja específico. |
| 12 | Sazonalidade | Existe alguma sazonalidade ou período-chave? | Mencione eventos, feriados. |
| 13 | Restrições e Observações | Há algo que não deve ser dito ou prometido? | Liste limitações. |
| 14 | Chamada para Ação | Qual CTA deve encerrar a comunicação? | Use verbo direto. |
🎯 Características do MVP
✅ Modularidade: Cada componente é independente e adaptável ✅ Templates Flexíveis: Estrutura de prompts padronizada mas customizável ✅ Preview em Tempo Real: O prompt atualiza conforme o usuário responde ✅ Boas Práticas Embutidas: Cada categoria tem dicas inline ✅ Persistência: Salvar e carregar prompts via API ✅ 14 Categorias: Cobre todos os aspectos essenciais de hotelaria
📦 Boas Práticas Embutidas
O aplicativo já inclui dicas de prompt engineering em cada categoria:
- Objetivo claro: Cada pergunta tem um propósito específico
- Contexto fornecido: Pedidos anteriores ajudam a montar o prompt
- Tom consistente: Perguntas para definir estilo, tom e idioma
- Exemplos: Casos de uso para guiar as respostas da IA
- Restrições explícitas: Limitações do que pode ou não dizer
- CTA direto: Chamada para ação clara e objetiva
🚀 Próximos Passos
Para Rodar o Aplicativo
-
Instalar dependências:
cd /root/projetos/gerador-prompts-hoteis npm install -
Configurar banco de dados:
cp .env.example .env # Editar DATABASE_URL se necessário -
Executar migrations:
npx prisma migrate dev npx prisma db seed -
Iniciar em modo desenvolvimento:
npm run dev
Para Deploy (Vercel)
- Conectar repositório ao Vercel
- Deploy automático com pushes no main
💡 Sugestões de Melhorias Futuras
- Validação com Zod: Adicionar validação nos campos de entrada
- Autenticação: Sistema de login para gerenciar prompts de usuários diferentes
- Exportar/Copiar: Botão para copiar prompt em TXT e área de transferência
- Templates Adicionais: Criar templates de prompt para casos comuns
- Múltiplos Idiomas: Suporte para prompts em inglês, espanhol, etc.
📌 Observações Importantes
- O MVP está pronto para uso local com SQLite
- Para produção, sugerimos migrar para PostgreSQL (Supabase)
- A estrutura é modular e fácil de adaptar às suas 14 categorias
- Você pode modificar os prompts em
lib/categories.tsconforme suas necessidades
Desenvolvido com auxílio do Codex CLI (GPT-5.2-codex) Data: 08/02/2026 Status: MVP funcional pronto! 🎉