88 lines
4.8 KiB
Markdown
88 lines
4.8 KiB
Markdown
# Manifesto de Desenvolvimento: Jasmine & Daniela (Reservas com Pix)
|
|
**Data:** 17/01/2026
|
|
**Responsável:** Arquiteto de Software (AI)
|
|
|
|
## 1. Visão Geral e Objetivo
|
|
Este documento define o padrão de desenvolvimento e comportamento para a funcionalidade de **Reservas via Chat** no Chatwoot (projeto Chatwoot-Develop). O objetivo final é uma experiência fluida onde a agente principal (**Jasmine**) orquestra o atendimento, delegando a lógica de negócio complexa para a especialista (**Daniela**), sem que o cliente perceba fricção ou "troca de robôs".
|
|
|
|
## 2. Experiência de Atendimento Ideal (Script de Referência)
|
|
*Todo o desenvolvimento deve buscar replicar exatamente este fluxo de interação:*
|
|
|
|
**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"
|
|
*(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% antecipado (R$ 150,00).
|
|
Posso gerar o Pix para você agora?"
|
|
|
|
**Cliente:** "Pode sim"
|
|
*(Internamente: Daniela gera intenção e Pix)*
|
|
**Jasmine:** "Perfeito 😊 Segue abaixo o Pix para pagamento da entrada:
|
|
💰 Valor: R$ 150,00
|
|
📌 Chave Pix: [Copia e Cola]
|
|
👉 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"
|
|
*(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! 😊✨"
|
|
|
|
## 3. Protocolo de Debugging (Baseado em Tempo)
|
|
Para garantir a análise correta dos erros e a correção assertiva:
|
|
|
|
1. **Input do Usuário:** O Rodrigo fornecerá o **Horário de Início da Conversa** (Horário de Brasília).
|
|
2. **Conversão e Análise:** O Arquiteto converterá esse horário para o fuso do servidor (UTC/Local) e analisará os logs (`log/tool_debug.log`, `log/brain_debug.log`, `log/development.log`) a partir desse ponto exato.
|
|
3. **Reconstrução:** O Arquiteto reconstruirá o fluxo passo-a-passo (Intenção -> Ferramenta -> Resposta -> Erro).
|
|
4. **Ação de Correção:** O ajuste será feito para corrigir a raiz do problema, garantindo que o fluxo futuro respeite o item 2 (Script de Referência).
|
|
|
|
## 4. Princípios de Arquitetura (CTO Mode)
|
|
|
|
### A. Jasmine é a Interface, Daniela é o Cérebro da Reserva
|
|
* **O cliente NUNCA fala diretamente com a Daniela.** A Jasmine é a "persona" que fala.
|
|
* A Daniela opera como uma *Tool* ou *Scenario* avançado que mantém estado.
|
|
* A Jasmine repassa a entrada do usuário para a Daniela, que processa a lógica de negócio e devolve instruções ou fatos.
|
|
* **Jasmine:** Responsável pela polidez, emojis e formatação final.
|
|
* **Daniela:** Responsável pelo fluxo lógico, cálculo de preços (50%) e validação de dados.
|
|
|
|
### B. O Estado é Sagrado (Stateful)
|
|
* Não podemos depender da memória de curto prazo do LLM para dados críticos (CPF, Valor).
|
|
* O estado da reserva (etapa atual, dados coletados) deve ser persistido em `conversation.custom_attributes['jasmine_state']`.
|
|
* O fluxo é sequencial: Coleta Nome/CPF -> Coleta Suíte/Data -> Check Disponibilidade -> Acordo de Valor -> Pix -> Confirmação.
|
|
|
|
### C. Postura "Fix It All"
|
|
* Não faremos correções pontuais (ex: "arruma esse erro de sintaxe").
|
|
* Ao encontrar um erro, analisaremos o **fluxo completo**.
|
|
* Se o Pix falhou, verificaremos desde a coleta do CPF até a chamada da API.
|
|
|
|
## 5. Estrutura Técnica
|
|
* **JasmineBrain (`jasmine_brain.rb`):** Detecta intenção de reserva e delega para `Daniela Reservas`.
|
|
* **Daniela (`seed_jasmine_hotel_v3.rb`):** Scenario configurado com instruções rigorosas para seguir o script ideal.
|
|
* **Tools:**
|
|
* `update_contact`: Salva Nome/CPF.
|
|
* `check_availability`: Calcula preço total.
|
|
* `create_reservation_intent`: Salva 50% do valor como depósito.
|
|
* `generate_pix`: Gera o Pix Cobrança (Inter/Simulado) para o valor do depósito.
|
|
|
|
---
|
|
*Este documento deve ser lido no início de cada sessão de manutenção desta feature para garantir alinhamento.*
|