# 🎉 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! 🎉