## Guia de pensamento para alinhar Jasmine + Daniela Reservas

Sempre que precisar revisar ou ajustar o fluxo de reservas, siga este checklist mental. Ele garante que toda intervenção esteja alinhada com o objetivo macro que você descreveu (contato cordial → ativar Daniela → coleta completa → cálculo do valor por dia → Pix de 50% → confirmação final).

1. **Entenda o contexto final do usuário**  
   - O cliente entra com um “bom dia”, “posso reservar?” ou similar.  
   - O objetivo é caminhar até uma reserva confirmada com Pix: sem desvios, sem repetição de perguntas.  
   - Qualquer erro deve ser interpretado à luz desse fluxo (não como uma exceção isolada).

2. **Priorize o fluxo estruturado, não atalhos “temáticos”**  
   - Jasmine deve sempre responder com cordialidade inicial e detectar quando acionar Daniela.  
   - Toda ação de reserva (dados do cliente, suíte, data, valor) deve ser comandada por Daniela, informando o cliente do próximo passo.
   - Evite fallback direto do Brain para respostas livres quando o fluxo já está em andamento.

3. **Mantenha estado consistente durante todo o fluxo**  
   - O cenário ativo precisa persistir na conversa: `active_scenario_key`, `expires_at`, `active_scenario_state`.  
   - O `state` guarda stage, dados coletados (CPF, suíte, data) e resultados de ferramentas (availability, pix).  
   - Em cada turno, atualize esse estado e só encerre quando o Pix for gerado ou o cliente disser “cancelar/obrigado”.

4. **Ferramentas obedecem ao roteiro**  
   - `check_availability` determina o valor correto conforme a data e o dia da semana (verfica as tabelas).  
   - `create_reservation_intent` guarda os dados coletados; jamais pula etapas.  
   - `generate_pix` deve receber o valor calculado e aplicar exatamente `valor / 2` quando solicitado (entrada 50%).  
   - Se algum passo falhar, o sistema deve comunicar o erro (fallback adequado) e manter o cliente no fluxo, não encerrar com mensagens genéricas como “dificuldades técnicas”.

5. **Fluxo conversacional esperado**  
   1. Jasmine responde com cordialidade e confirma a intenção.  
   2. Daniela entra pedindo nome/CPF, suíte, data, horário.  
   3. Daniela informa valor, explica “pode pagar 50% agora via Pix”.  
   4. Daniela chama `generate_pix`, envia o código, explica "copie e cole".  
   5. Após cliente avisar “paguei”, Daniela confirma a reserva e encerra o cenário.  
   6. Se o cliente desistir ou pedir humano, encerre/limpe sticky e deixe Lucia (Jasmine) responder com fallback apropriado.

6. **Logs e documentação**  
   - Sempre que alterar algo, registre nas instruções/prompt das agents (ex: prompt da Daniela deve explicitar o roteiro).  
   - Se necessário fazer mudanças pontuais, vincule essas mudanças ao fluxo (não apenas "ajustar o Pix").  
   - Use este documento como ponto de referência antes de testar: se você “esquecer”, leia e repita mentalmente o que o Rodrigo quer.

Se precisar de ajuda para transformar isso em tarefas técnicas (migrations, short-circuit, state), é só avisar.

---

## Documento de referência ampliado (fluxo reserva + Pix)

### 1. Objetivo “padrão-ouro”
O sistema deve rodar este fluxo previsível para cada pedido de reserva:
1. Cliente cumprimenta → Jasmine responde educadamente.
2. Cliente manifesta “quero reservar” → Jasmine delega para Daniela.
3. Daniela conduz todo o plano: coleta dados, chama ferramentas (precio/disponibilidade/pix), monta a próxima mensagem.
4. Jasmine publica o texto final no tom oficial (voz única para o cliente).
5. Coleta obrigatória concentrada na Daniela: nome completo, CPF, suíte, data, horário/período.
6. Daniela confirma: “Sua reserva ficou assim… total R$T. Posso gerar o Pix (50%)?”
7. Cliente confirma → Daniela gera Pix de metade do total e instrui “copie e cole no seu banco”.
8. Após o cliente avisar “paguei”, Daniela confirma o pagamento e informa que a reserva está confirmada.

Sucesso significa que a reserva segue esse roteiro, com Pix gerado/confirmado e sem decisões aleatórias.

### 2. Papéis e responsabilidades
- **Jasmine (“interface única”)**: cumprimenta, decide se deve delegar, publica as respostas da Daniela e mantém o tom padrão. Nunca responde diretamente sobre reservas, preços ou Pix — sempre delega ao subagente adequado.
- **Daniela (“motor transacional”)**: permanece na camada interna. Recebe contexto, coleta dados, valida, chama `check_availability`, `create_reservation_intent`, `generate_pix`, constrói o `mensagem_para_cliente` e retorna também o `estado_atualizado` e as ações requisitadas.

### 3. Regras de comportamento
- Tom educado e uniforme mesmo quando a resposta vem da Daniela.
- Não inventar preços ou disponibilidade: os valores derivam exclusivamente de `check_availability` e do histórico fornecido.
- Sempre perguntar “posso gerar o Pix?” antes de chamar `generate_pix`.
- Não sair do fluxo: enquanto o sticky scenario estiver ativo, o Brain não deve responder com mensagens independentes ou fallback.

### 4. Arquitetura mínima para consistência
A) **Sticky “modo reserva”** – Conversa persiste: `active_scenario_key`, `active_scenario_expires_at`, `active_scenario_state`. Uma vez ativado por Daniela, todas as próximas mensagens vão direto para ela até conclusão/cancelamento.
B) **Estado mínimo persistido** – `active_scenario_state` deve conter:
   - `stage` (p.ex. collecting_data, quoting, waiting_payment)
   - `collected` (nome, CPF, suíte, data, horário)
   - `last_quote` (preço, disponibilidade, dia/turno)
   - `pix_status` (pending/paid/confirmed)
Isso evita perda de memória entre turnos e mantém o fluxo determinístico.

### 5. Tratamento de erros (visão macro)
Quando surgir um erro (resposta desalinhada, ferramenta falhando, handoff disparado), trace o contexto:
1. Qual stage estava ativo?
2. Jasmine desviou e respondeu sozinha?
3. Daniela repetiu perguntas ou perdeu dados?
4. Qual tool falhou ou retornou inválido?
Corrija sempre com base nesse fluxo padrão — não apenas “ajuste a frase”, mas reforce o sticky/state/sequence.

### 6. Como trabalhamos na prática
Sempre que você me mostrar um erro, envie:
1. Mensagem do cliente.
2. Resposta publicada pela Jasmine.
3. Trecho do log relevante (20–60 linhas) indicando decisão/tool.

Com isso eu devolvo:
* Onde travar o sticky/state.
* Qual prompt deve ser ajustado.
* Qual ferramenta/filtro precisa validar o valor ou o Pix.

### 7. Regra mestre
“Daniela é o cérebro do fluxo transacional e retorna o texto pronto; Jasmine é a única voz que publica para o cliente no tom oficial. O sistema deve manter estado e sticky para que o fluxo seja determinístico.”

---

## 🎯 Simulação de atendimento ideal – experiência perfeita de reserva

**Cliente:**  
Boa noite

**Jasmine:**  
Boa noite! 😊  
Seja bem-vindo. Como posso te ajudar hoje?

**Cliente:**  
Gostaria de fazer uma reserva

**Jasmine:**  
Perfeito! Vou te ajudar com isso 😊  
Para darmos continuidade à sua reserva, poderia me informar, por favor, seu nome completo e CPF?

**Cliente:**  
João Pedro da Silva, CPF 123.456.789-00

**Jasmine:**  
Obrigada, João 😊  
Agora me diga, por favor: qual suíte você deseja reservar?

**Cliente:**  
Suíte Luxo

**Jasmine:**  
Ótima escolha! ✨  
Para qual data e horário/período você gostaria da reserva?

**Cliente:**  
Dia 20/02, das 22h às 10h

**Jasmine:**  
Perfeito! Só um instante que vou verificar a disponibilidade e os valores para você 😊

(internamente: Daniela consulta disponibilidade e preço)

**Jasmine:**  
Prontinho! 😊  
Sua reserva ficou assim:

• Suíte: Luxo  
• Data: 20/02  
• Horário: das 22h às 10h  
• Valor total: R$ 300,00

Para confirmar a reserva, é necessário o pagamento de 50% (R$ 150,00).  
Posso gerar o Pix para você agora?

**Cliente:**  
Pode sim

**Jasmine:**  
Perfeito 😊  
Segue abaixo o Pix para pagamento da entrada:

💰 Valor: R$ 150,00  
📌 Chave Pix: 123e4567-e89b-12d3-a456-426614174000

👉 Basta copiar a chave Pix, colar no aplicativo do seu banco e realizar o pagamento.  
Assim que pagar, me avise por aqui para que eu confirme sua reserva, tudo bem?

**Cliente:**  
Pronto, acabei de pagar

**Jasmine:**  
Só um instante que vou confirmar o pagamento para você 😊

(internamente: Daniela confirma pagamento)

**Jasmine:**  
Pagamento confirmado com sucesso! ✅

Sua reserva está confirmada 🎉  
Resumo final:

• Suíte: Luxo  
• Data: 20/02  
• Horário: das 22h às 10h  
• Entrada paga: R$ 150,00

Qualquer dúvida ou se precisar de algo mais, é só me chamar.  
Será um prazer te receber! 😊✨

### 🔑 Por que essa experiência é boa  
- Linguagem humana e educada  
- Um pedido por vez (sem sobrecarregar)  
- Confirmação clara antes da cobrança  
- Segurança no Pix  
- Encerramento com sensação de sucesso

Se quiser, nos próximos passos posso:
- marcar onde entra cada stage,  
- transformar isso em script técnico para os prompts da Daniela/Jasmine, ou  
- criar a versão “anti-confusão” (quando o cliente muda de assunto ou responde errado).

### 💬 Instrução extra: Pix Copia e Cola completo
Quando o GeneratePixTool retornar o código, **garanta que o bloco de código contenha a string inteira**, iniciando em `0002010...` e terminando no checksum `...6304XXXX`. Esse é o valor que o cliente precisa colar no banco; qualquer corte causa “Pix inválido”. Copie exatamente o `raw_payload` do tool (ou o `formatted_message` caso já contenha a string completa) e anexe no bloco antes de enviar. Nada deve ser truncado ou substituído pela Jasmine depois de a mensagem sair.