202 lines
7.9 KiB
Markdown
202 lines
7.9 KiB
Markdown
# 🎉 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: `Prompt` e `PromptCategory`
|
|
- ✅ 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
|
|
|
|
1. **Instalar dependências:**
|
|
```bash
|
|
cd /root/projetos/gerador-prompts-hoteis
|
|
npm install
|
|
```
|
|
|
|
2. **Configurar banco de dados:**
|
|
```bash
|
|
cp .env.example .env
|
|
# Editar DATABASE_URL se necessário
|
|
```
|
|
|
|
3. **Executar migrations:**
|
|
```bash
|
|
npx prisma migrate dev
|
|
npx prisma db seed
|
|
```
|
|
|
|
4. **Iniciar em modo desenvolvimento:**
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
### Para Deploy (Vercel)
|
|
|
|
1. Conectar repositório ao Vercel
|
|
2. Deploy automático com pushes no main
|
|
|
|
---
|
|
|
|
## 💡 Sugestões de Melhorias Futuras
|
|
|
|
1. **Validação com Zod:** Adicionar validação nos campos de entrada
|
|
2. **Autenticação:** Sistema de login para gerenciar prompts de usuários diferentes
|
|
3. **Exportar/Copiar:** Botão para copiar prompt em TXT e área de transferência
|
|
4. **Templates Adicionais:** Criar templates de prompt para casos comuns
|
|
5. **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.ts` conforme suas necessidades
|
|
|
|
---
|
|
|
|
**Desenvolvido com auxílio do Codex CLI (GPT-5.2-codex)**
|
|
**Data:** 08/02/2026
|
|
**Status:** MVP funcional pronto! 🎉
|