# Guia completo do calendário Unefesta

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/calendarios/guia-completo-do-calendario-unefesta

Este documento explica **todas as formas de usar o calendário** na Unefesta, com exemplos do dia a dia e o **passo a passo** de configuração.

---

## 1. Em uma frase: para que serve?

O calendário controla **quando** o comprador pode reservar ou encomendar um produto/serviço (fotógrafo, buffet, locação, bolo, etc.). Ele evita que duas pessoas peguem o mesmo horário quando isso não pode acontecer — ou organiza a **capacidade de encomendas** quando várias entregas no mesmo dia fazem sentido.

> **Importante:** o comprador final **não** vê uma tela de “Calendários”. Ele só escolhe datas na vitrine/carrinho/checkout. Quem configura e acompanha a agenda é o **vendedor** em **Calendários** no painel.

---

## 2. Mapa mental (como as peças se encaixam)

```
CALENDÁRIO (regras gerais da agenda)
   ├── Opção: permitir vários itens do mesmo pedido no período (sim/não)
   ├── Antecedência mínima, fuso, cor
   ├── Flexível ou sequencial
   ├── Horário de funcionamento
   ├── Feriados extras
   ├── Bloqueios manuais / Google / compartilhamento
   └──
PRODUTO OU KIT (liga o calendário e afina a regra)
   ├── Habilitar calendário + escolher quais calendários consultar
   ├── Com ou sem estoque  ← muda muito o comportamento!
   ├── Duração (fixa ou mín/máx, em horas ou dias)
   ├── Dias da semana bloqueados
   └── Exceto feriados
```

**Regra de ouro:** o calendário sozinho não vende nada. O item precisa ter **“Habilitar calendário”** marcado e o(s) calendário(s) selecionado(s).

---

## 3. Onde clicar no painel

| O que fazer | Caminho |
|-------------|---------|
| Ver / criar calendários | Menu → **Calendários** |
| Criar | **Criar Novo Calendário** |
| Ver agenda, bloqueios, Google | Abrir o calendário → **Ver detalhes** |
| Editar regras | No calendário → **Editar** |
| Compartilhar com outro vendedor Unefesta | No calendário → **Compartilhar** |
| Tratar eventos do Google | No calendário → **Ver eventos importados** |
| Ligar calendário a um produto | Produto/serviço → seção **Calendário** → **Habilitar calendário** |
| Documentação na loja | “Entenda como funciona o calendário” |

---

## 4. Passo a passo: criar um calendário do zero

1. Vá em **Calendários** → **Criar Novo Calendário** (ou “Criar Novo Calendário” no formulário do produto).
2. Preencha:
   - **Nome** (ex.: “Agenda Ana — Buffet”, “Encomendas confeitaria”)
   - **Permitir reservar após X horas/dias** (antecedência mínima)
   - **Fuso horário**
   - **Cor** (ajuda a identificar na lista)
3. Escolha o **Tipo de uso do calendário** (seção abaixo — é a decisão mais importante).
4. Escolha **Início flexível** ou **Início sequencial**. Opcional: **Permitir reserva com dias bloqueados no meio** (só duração em dias).
5. Informe **Horários de funcionamento** (faixas Início/Fim + **ao menos um dia** da semana).  
   - Obrigatório marcar dias: esses dias são a janela bookable **e** entram na conta do prazo de produção.  
   - Dia inteiro: início **00:00** e fim **23:59**.  
   - A tela mostra o resumo **Aberto:** / **Fechado:** com o que você configurou.
6. Opcional: **Feriados extras** (municipais / datas especiais da loja).
7. Opcional: vincule **Produtos e kits** já existentes.
8. Clique em **Criar calendário**.
9. No produto/kit: marque **Habilitar calendário**, selecione este calendário e configure duração / dias bloqueados.

---

## 5. Os dois tipos de uso do calendário

Ao criar ou editar, a tela mostra:

| Botão na tela | Ideia | Exemplo típico |
|---------------|-------|----------------|
| **Opção desligada** | “1 reserva bloqueia o horário.” | Fotógrafo, espaço, buffet presencial |
| **Opção ligada** (mesmo pedido no período) | “Mesmo pedido compartilha horário; capacidade entre clientes.” | Bolo/doces sob encomenda, recreação montar com várias oficinas, buffet de carrinhos opcionais |

⚠️ Aviso da tela: a opção só vale para produtos/kits com **calendário habilitado e sem controle de estoque**. Se o item tiver estoque, o comportamento volta a ser exclusive.

---

### 5.1 Agenda de recurso — quando usar

Use quando **uma pessoa, um espaço ou um equipamento** não pode atender dois clientes no mesmo horário.

**Exemplos**

| Negócio | Configuração sugerida |
|---------|------------------------|
| Fotógrafa com 3 pacotes | 1 calendário “Agenda Maria”, **sem estoque** nos 3 pacotes, todos no mesmo calendário |
| Buffet com cardápios Básico / Premium / Luxo | 1 calendário; cardápios **sem estoque**; reserva de qualquer cardápio bloqueia o horário para os outros |
| Empresa com 3 recreadores | 3 calendários (um por pessoa); o **mesmo** serviço ligado aos 3; o comprador vê vaga se **pelo menos um** estiver livre |

**Passo a passo (fotógrafo)**

1. Criar calendário **Agenda de recurso**, nome “Agenda João”.
2. Antecedência: ex. **2 dias**.
3. Horário: ex. 08:00–18:00, seg–sáb.
4. Flexível ou sequencial conforme o estilo de atendimento (ver seção 6).
5. Nos pacotes: **Habilitar calendário** → selecionar “Agenda João” → duração (ex. fixa 4 horas) → **sem estoque**.

**O que o comprador vê:** seção **Disponibilidade** / escolha de período; CTAs do tipo **Reservar**, **Agendar**, etc.

---

### 5.2 Encomendas / entregas — quando usar

Use quando o “horário” é na prática **data de produção/entrega**, e vários itens do **mesmo pedido** (bolo + doces) devem ocupar **uma vaga só**.

**Só funciona bem se:** calendário = Encomendas **e** produto/kit = calendário ligado **e sem estoque**.

Ao escolher este tipo, aparecem mais dois campos:

#### Quem define a data

| Opção na tela | O que acontece |
|---------------|----------------|
| **Cliente escolhe a data** | Comprador vê a grade (em geral **depois do frete**, quando há frete) |
| **Sistema agenda; você pode alterar depois** | Sistema reserva a primeira janela válida; comprador vê algo como **“a partir de…”**; vendedor **realoca** em Pedidos |

#### Máximo de pedidos por horário

- **Vazio** = ilimitado (cuidado com a operação real).
- **1** = só um pedido de cliente diferente por janela (mais seguro).
- **> 1** = vários clientes no mesmo período — a tela avisa em vermelho.

**Exemplo — confeitaria**

1. Calendário **Encomendas / entregas**, nome “Encomendas doces”.
2. Quem define: **Cliente escolhe a data**.
3. Máximo: **5** (cinco entregas no mesmo dia, se a cozinha aguentar).
4. Antecedência: **3 dias** (ou deixe a produção do produto fazer o peso maior — ver lead time).
5. Produtos bolo/doces: **sem estoque**, calendário habilitado, duração em **dias** se a unidade de preço for por dia / entrega por data.

**Mesmo pedido:** bolo + doces no mesmo horário = **1 ocupação**, não 2.

---

## 6. Flexível vs sequencial (tipo de disponibilidade)

Configurado no calendário: **Tipo de disponibilidade no calendário**.

### Início flexível

Cria janelas **de hora em hora com sobreposição**.

Exemplo com duração de **2 horas**:

```
08:00 às 10:00
09:00 às 11:00   ← sobrepõe
10:00 às 12:00   ← sobrepõe
```

**Quando usar:** o cliente pode começar em horários diferentes (ex. foto das 9h ou das 10h).

### Início sequencial

Um bloco **depois** do outro, **sem** sobreposição.

```
08:00 às 10:00
10:00 às 12:00
12:00 às 14:00
```

**Quando usar:** precisa de turnos limpos, tempo de montagem/desmontagem, ou menos conflito entre reservas.

---

## 7. Antecedência mínima e prazo de encomenda

No calendário: **Permitir reservar após X horas/dias**.

Em **encomendas**, a primeira data possível usa o **maior** entre:

1. Antecedência mínima do calendário  
2. **Dias úteis de produção** do produto/kit **+** dias úteis de **frete/deslocamento** (quando o frete já foi escolhido)

Assim o sistema não oferece um dia em que a loja não conseguiria produzir e entregar a tempo.

**Ordem na vitrine (com frete):** frete primeiro → depois data / disponibilidade já com o prazo do frete.

---

## 8. Horário de funcionamento

No calendário, liste faixas **Início / Fim** e marque os dias (dom…sáb).

- Fora dessas faixas **não** dá para agendar.
- É **obrigatório** ter ao menos uma faixa com **pelo menos um dia** marcado. Sem isso a grade não abre e o formulário bloqueia o save.
- Os dias marcados também entram na **conta do prazo de produção** (com calendário no produto).
- Dia inteiro nos dias marcados: **00:00–23:59**.
- A tela e a visualização mostram **Aberto:** / **Fechado:** com o resumo da configuração.
- Evite faixas **sobrepostas** no mesmo dia (o formulário valida isso).

---

## 9. Ligar o calendário no produto / serviço / kit

### Pelo produto (mais comum)

1. Abra o produto/serviço (variant).
2. Marque **Habilitar calendário**.
3. Selecione quais calendários serão consultados (ou **Criar Novo Calendário**).
4. Configure **Duração**:
   - **Fixa** — sempre a mesma
   - **Mínima e máxima** — o comprador escolhe dentro do intervalo
   - Intervalo em **horas** ou **dias** (alinhar com a precificação: por hora → horas; por dia → dias)
5. Opcional: **Dias da semana bloqueados** + **Exceto feriados**.
6. Defina se usa **estoque** ou não (isso muda o impacto das reservas — seção 10).
7. Salve.

### Pelo calendário

Na criação/edição: seção **Produtos e kits vinculados**.  
Útil para ver de uma vez quem já está ligado e se controla estoque.

### Vários calendários no mesmo item

Disponibilidade aparece se **pelo menos um** calendário tiver vaga (caso clássico: vários recreadores).

### Kits

- Kit pode herdar calendário dos componentes.
- Kit **misto** (um item de agenda de recurso + outro de encomenda): o comprador faz **uma única** escolha de data.
- Se todos forem “sistema agenda”, prevalece a UI de **“a partir de…”**.

---

## 10. Com estoque vs sem estoque (o “truque” que mais confunde)

Mesmo calendário, comportamentos diferentes:

### Sem estoque + mesmo calendário

Uma reserva **bloqueia o horário para todos** os produtos ligados àquele calendário.

| Exemplo | Efeito |
|---------|--------|
| Cardápio Básico, Premium e Luxo no mesmo calendário | Cliente reserva Premium no sábado → Básico e Luxo também somem naquele horário |

Ideal para **re