# Boflow — Marketplace

> Marketplace brasileiro para encontrar salões de beleza, barbearias, spas e profissionais de estética: agendar atendimentos online, pagar com PIX ou cartão e assinar planos Clube de Assinaturas.

O Boflow é o site onde **clientes finais** descobrem estabelecimentos, escolhem serviços, reservam horários e acompanham agendamentos e assinaturas. O acesso é em **www.boflow.com.br**. Donos de negócios e equipes usam o **painel de gestão** em **app.boflow.com.br** — não é por lá que o cliente agenda.

## Onde cada coisa acontece

- **Marketplace (www.boflow.com.br):** busca, páginas públicas de estabelecimentos e profissionais, agendamento online, pagamento, perfil do cliente, carteira de cartões e clube de assinaturas.
- **Painel de gestão (app.boflow.com.br):** uso interno do estabelecimento (agenda, cadastros, configurações). Clientes **não** agendam pelo painel.
- **Apps Android:** [Boflow para Clientes](https://play.google.com/store/apps/details?id=com.khaneland.boflow) e [Boflow para Profissionais](https://play.google.com/store/apps/details?id=com.khaneland.boflow.professionals&hl=pt_BR); página com os dois em www.boflow.com.br/download-app/. iOS ainda não publicado.

É possível **navegar e pesquisar** estabelecimentos sem login. Para **criar agendamentos, pagar, salvar cartões ou assinar planos**, é necessário entrar ou criar conta.

## Descobrir e escolher

### Página inicial (/)

- Busca por tratamento/categoria, localização e horário (manhã, tarde, noite ou personalizado).
- Seções **Recomendados** e **Novos no Boflow**.

### Busca (/search/)

- Alternar entre **lista** e **mapa**.
- Resultados em **Estabelecimentos** e **Profissionais**.
- Filtros: pesquisa, ordenação, preço máximo e outros filtros.

### Página do estabelecimento (/b/{slug}/)

Cada unidade tem uma URL pública no formato `www.boflow.com.br/b/{slug-da-unidade}`.

O que o cliente encontra:

- **Fotos**, **Serviços** (cada um com **Agendar**), **Equipe**, **Portfólio**, **Avaliações**, **Sobre**
- **Clube de Assinaturas** / **Assinaturas** (quando o estabelecimento oferece planos)
- Localização, horários de funcionamento e indicação de **Agendamento online disponível**
- Botão principal: **Agendar agora**

### Página do profissional (/p/{slug}/)

Página pública de um profissional específico, com serviços e **Agendar agora**.

### Diretórios

- **Por segmento:** `/segmentos/{slug}/` (ex.: barbearia, manicure)
- **Por cidade:** `/cidades/{slug}/` (ex.: são-paulo-sp)

## Agendamento online (/a/{slug}/)

Fluxo em etapas, com barra de progresso e **Passo X de Y**:

| Etapa | Nome | O que acontece |
|-------|------|----------------|
| 1 | **Serviços** | Escolher um ou mais serviços |
| 2 | **Profissional** | Escolher quem vai atender (omitida se só há um profissional elegível por serviço) |
| 3 | **Horário** | Escolher data e horário disponível |
| 4 | **Atendimento** | Escolher como será o atendimento (omitida se só há um modo) |
| 5 | **Confirmar agendamento** | Revisar resumo e, se disponível, pagar |

Entre as etapas 1 e 4, o botão de avanço é **Continuar**.

### Login durante o agendamento

- Dá para escolher serviços, profissional e horário **sem estar logado**.
- Ao tentar avançar da etapa **Horário** sem conta, o sistema pede **Entrar** ou **Criar conta**.
- Depois do login, as escolhas feitas como visitante são mantidas.

### Modos de atendimento (etapa Atendimento)

Pergunta: **"Como você quer ser atendido?"**

- **No estabelecimento** — o cliente vai até o local
- **A domicílio** — exige endereço cadastrado no perfil (casa ou trabalho)
- **Online** — atendimento remoto, quando o estabelecimento oferece

### Sair do agendamento

Ao sair no meio do fluxo, aparece o modal **"Cancelar agendamento?"** com:

- **Continuar** — volta ao agendamento
- **Sair** — abandona o fluxo

### Clube no checkout

Se o cliente tem plano ativo com benefícios aplicáveis, o resumo pode mostrar desconto ou **Incluso no clube** (valor estimado na tela; o cálculo final é do sistema).

### Depois de confirmar

1. O agendamento é **criado** (pode ficar sem pagamento, conforme regras do estabelecimento).
2. Em seguida, se o estabelecimento aceita pagamento online, o cliente pode pagar com PIX ou cartão.
3. Tela de sucesso: **Agendamento confirmado** ou **Pagamento confirmado**, com resumo de serviços, data/hora e valor (ou **Incluso no clube**).

Durante validação do pagamento com cartão, aparece **Validando seu pagamento** com mensagens rotativas **Só um instante…**.

## Pagamento de agendamentos

Pagamento online só aparece quando o estabelecimento tem essa opção habilitada. Se não estiver disponível, a interface de pagamento **não é exibida** (não fica apenas desabilitada).

### Formas de pagamento

- **PIX** — QR code e código copia e cola; prazo de expiração exibido (**Este PIX expira em…**)
- **Cartão de crédito** — novo cartão ou cartão salvo
- **Cartão de débito** — quando disponível

### Pagamento obrigatório vs opcional

| Situação | Comportamento para o cliente |
|----------|------------------------------|
| Pagamento **obrigatório** | Precisa pagar para concluir; na lista de atividades aparece **Pagamento pendente** enquanto não pago |
| Pagamento **opcional** | Pode agendar sem pagar; ao confirmar sem método, aparece **Agendar sem pagar online?** com **Pagar agora** e **Agendar sem pagar** |
| Com método escolhido (opcional) | O botão vira **Pagar com PIX** ou **Pagar** |

### PIX — regras importantes

- **Fechar a tela do PIX não cancela** o agendamento nem invalida o código automaticamente.
- Só o botão **Cancelar PIX** invalida explicitamente a tentativa de pagamento PIX.
- É possível **retomar o pagamento depois** em **Atividade** → detalhe do agendamento → **Revisar pagamento** ou **Pagar agora**.

### Cartões salvos (Carteira)

- Página **Carteira** em `/profile/wallet/` — título **Meus cartões**.
- Cada cartão mostra bandeira, tipo (**Crédito** ou **Débito**) e final mascarado (ex.: •••• 4914).
- Ações: definir como padrão, remover.
- Cartões novos são salvos **durante o checkout** (checkbox opcional ao pagar com cartão novo). Não há formulário separado de "adicionar cartão" na Carteira.
- Ao pagar com cartão salvo, pode pedir confirmação de CVV no modal **Confirmar cartão salvo**.

### Status de pagamento nos agendamentos

- **Pagamento efetuado**
- **Pagamento pendente** — quando o pagamento é obrigatório e ainda não foi feito, ou há cobrança PIX/cartão ativa
- **Revisar pagamento** — CTA no detalhe quando o pagamento é obrigatório ou há cobrança ativa
- **Pagar agora** — CTA quando o pagamento é opcional e o cliente quer pagar voluntariamente

Formas exibidas: **Pix**, **Cartão de crédito**, **Cartão de débito**.

## Clube de Assinaturas

Planos mensais oferecidos por estabelecimentos, com benefícios como cortesias e descontos em serviços.

### Como assinar

1. Na página do estabelecimento (`/b/{slug}/`), aba **Clube de Assinaturas** ou **Assinaturas**
2. Escolher plano → **Assinar agora**
3. Revisar resumo e aceitar termos, se necessário
4. **Continuar no Mercado Pago** — o pagamento da assinatura é feito no Mercado Pago (redirect), não dentro do site com PIX/cartão do agendamento
5. Antes do redirect, pode aparecer confirmação com o e-mail de cobrança

### Depois de assinar

- Retorno em `/memberships/checkout/return/` — o sistema aguarda a assinatura ficar **Ativa**
- Acompanhar em **Atividade** → aba **Planos de assinatura**

### Gerenciar assinatura

Na aba **Planos de assinatura** em Atividade:

- Filtros: **Todas**, **Ativas**, **Pendentes**, **Em atraso**, **Canceladas**
- Detalhe do plano: benefícios, cobrança (**Mensal**), **Cancelar ao fim do período** ou **Reativar renovação automática**
- Não há botão **Continuar no Mercado Pago** na tela de Atividade — nova assinatura é feita pela página do estabelecimento

## Minha conta

Menu do usuário logado: **Perfil**, **Atividade**, **Carteira**, **Configurações**.

### Perfil (/profile/)

- Nome, e-mail, telefone, data de nascimento, gênero, foto
- **Meus endereços:** **Casa** e **Trabalho** — adicionar, editar, excluir, definir principal
- Endereço é necessário para atendimento **a domicílio**

### Atividade (/profile/activity/)

Central de **Agendamentos** e **Planos de assinatura**.

**Sem login:** mensagem **Nenhuma atividade** com opções **Pesquisar locais** e **Acesse ou cadastre-se**.

#### Aba Agendamentos

- Busca: **Pesquisar atividades**
- Listas: **Próximos** e **Anteriores**
- Cada item: estabelecimento, data/hora, status do agendamento, situação de pagamento quando aplicável

**Status do agendamento** (exemplos): Agendado, Confirmado, Em atendimento, Concluído, Cancelado, Não compareceu.

**No detalhe do agendamento:**

- **Revisar pagamento** / **Pagar agora**
- **Como chegar** (abre rotas no mapa)
- **Adicionar ao calendário**
- **Gerenciar agendamento** → **Reagendar** ou **Cancelar agendamento**
- **Avaliar** (após atendimento concluído)

#### Aba Planos de assinatura

- Ver e filtrar assinaturas ativas, pendentes, em atraso ou canceladas
- Abrir detalhe com benefícios e opções de cancelamento/reativação

### Carteira (/profile/wallet/)

Gerenciar cartões salvos (ver seção Pagamento).

### Configurações (/profile/configuracoes/)

- **Alterar senha**
- **Excluir conta**

### Criar conta e entrar (/auth/)

- Fluxo por e-mail: **Criar conta** ou login com **Senha**
- Cadastro inclui telefone (DDD + número), aceite de termos
- **Termos e licença de uso** e **Política de privacidade** disponíveis no cadastro e em `/terms/` e `/privacy/`

## Fluxos comuns

### Encontrar um lugar e agendar

1. Buscar na home ou em `/search/`
2. Abrir página do estabelecimento (`/b/{slug}/`)
3. **Agendar agora** ou **Agendar** em um serviço
4. Seguir as etapas até **Confirmar agendamento**
5. Entrar ou criar conta quando solicitado (após escolher horário)
6. Pagar online, se quiser e se estiver disponível

### Agendar e pagar depois

1. Concluir o agendamento
2. Se o pagamento for opcional, escolher **Agendar sem pagar** ou fechar o PIX sem cancelar
3. Depois, em **Atividade** → agendamento → **Revisar pagamento** ou **Pagar agora**

### Assinar o Clube de um estabelecimento

1. Página do estabelecimento → aba de assinaturas
2. Escolher plano → **Assinar agora**
3. Confirmar e seguir para o Mercado Pago
4. Após retorno, acompanhar em **Atividade** → **Planos de assinatura**

### Usar benefícios do Clube no agendamento

1. Ter assinatura **Ativa** com o estabelecimento
2. Agendar normalmente — o resumo pode indicar benefício ou **Incluso no clube**

### Baixar o app

Acesse `/download-app/` para os apps de clientes e profissionais.

- Clientes (Android): https://play.google.com/store/apps/details?id=com.khaneland.boflow
- Profissionais (Android): https://play.google.com/store/apps/details?id=com.khaneland.boflow.professionals&hl=pt_BR

App Store (iOS) ainda não publicada.

## Ajuda e suporte

- **Termos e licença de uso:** www.boflow.com.br/terms/
- **Política de privacidade:** www.boflow.com.br/privacy/
- Dúvidas sobre **agendamento, pagamento ou assinatura como cliente** devem ser tratadas com o **estabelecimento** ou pelos canais de suporte ao consumidor Boflow, quando disponíveis no site ou app.
- Estabelecimentos que querem **usar o Boflow para gerir o negócio** devem acessar **app.boflow.com.br**, a área **Para negócios** em www.boflow.com.br/for-business/, ou o app [Boflow para Profissionais](https://play.google.com/store/apps/details?id=com.khaneland.boflow.professionals&hl=pt_BR) na Google Play.

## Optional

- [Para negócios](https://www.boflow.com.br/for-business/): informações para salões e clínicas que desejam anunciar e receber agendamentos pelo Boflow (não é o fluxo do cliente final).
- [Painel de gestão](https://app.boflow.com.br): sistema interno dos estabelecimentos; documentação de uso do painel está em app.boflow.com.br/llms.txt.

Este arquivo descreve o Boflow Marketplace do ponto de vista do **cliente final** que agenda e paga serviços. Destina-se a assistentes de IA que ajudam consumidores a usar o site e o app. Não inclui documentação técnica de desenvolvimento nem instruções do painel de gestão.