Z-Schedule

┌────────── Z-SCHEDULE ──────────┐
│                                 │
│  📅 Calendário (/scheduling)    │
│     ├─ Por recurso              │
│     ├─ Por equipe               │
│     └─ Por tipo                 │
│                                 │
│  🛠️ Recursos agendáveis         │
│     ├─ Pessoas (técnicos)       │
│     ├─ Salas / Veículos         │
│     ├─ Equipamentos             │
│     └─ Slots de atendimento     │
│                                 │
│  ▶️ Atendimento                 │
│     ├─ Check-in                 │
│     ├─ Formulário Z-Field       │
│     ├─ Evidência                │
│     └─ Fechamento + Z-Sign      │
│                                 │
│  ⏰ Vencimentos                 │
│     ├─ EPIs                     │
│     ├─ Certificações            │
│     ├─ Manutenções preventivas  │
│     └─ Contratos                │
│                                 │
│  🔗 Integrações                 │
│     └─ Google / Outlook / APIs  │
│                                 │
│  🤖 Agente IA                   │
│     └─ Conversa e marca         │
└─────────────────────────────────┘

4.1. Calendário principal

• URL: /scheduling.
• Visões: dia, semana, mês.
• Filtros: recurso, equipe, tipo de booking, status.
• Cores configuráveis por tipo de booking.

4.2. Recursos agendáveis

• URL: /scheduling-management/resources (lista), /scheduling-management/resources/new (criar), /scheduling-management/resources/:id (detalhe), /scheduling-management/resources/:id/edit (editar).
• Tipos: pessoa (técnico), sala, equipamento, veículo, slot de atendimento, sala de reunião, recurso genérico.
• Configurações:
• capacidade (1 atendimento por vez ou múltiplos);
• janelas de disponibilidade (segunda 8h-12h, etc.);
• bloqueios (férias, manutenção);
• duração padrão e intervalo entre atendimentos;
• formulário obrigatório vinculado.

4.3. Booking (reserva)

• URL: /scheduling/booking/:id.
• O que tem: recurso, horário, cliente, formulário obrigatório, anexos, observações, histórico de status (criado → confirmado → em andamento → concluído).
• Notificações: confirmação, lembrete (24h antes, 1h antes), cancelamento.

4.4. Atendimento (execução de um booking)

• URL: /scheduling/attendance/:bookingId.
• Fluxo:

1. Check-in — registro de início (com GPS).
2. Formulário vinculado abre automaticamente (Z-Field).
3. Evidência — fotos, leituras, observações.
4. Fechamento — assinatura do cliente (Z-Sign) opcional, conclusão.

• Status persistente: ActiveAttendanceContext mantém estado entre telas para não perder progresso.

4.5. Recorrência

• Padrões: diário, semanal (dias específicos), mensal (dia X ou primeira segunda), anual.
• Casos: manutenção preventiva mensal, treinamento anual, revisão semestral.
• Renovação automática: ao concluir um booking recorrente, o próximo é criado.

4.6. Gestão de vencimentos

• URL: /gestao-vencimentos.
• O que mostra: visão consolidada de tudo que está perto de vencer:
• EPIs por colaborador;
• certificações obrigatórias;
• ASO (atestado médico);
• manutenções preventivas;
• contratos;
• validades de calibração.
• Filtros: janela (próximos 7/30/90 dias), equipe, unidade, tipo.
• Ação: botão "Renovar" abre fluxo no Z-Flow para tratar.

4.7. Alertas proativos

• Configuráveis por canal (WhatsApp, e-mail, in-app).
• Antecedência customizável (30/15/7/3/1 dia).
• Escalonamento por nível.
• Integração com Z-Flow — alerta vencido vira ação obrigatória.

4.8. Integrações de agenda

• URL: /scheduling-management/integrations.
• Provedores: Google Calendar, Outlook, APIs externas.
• Sincronização: bidirecional, configurável.

4.9. Agente IA de agendamento

• URL: /scheduling-management/agent.
• Caso de uso: o cliente final conversa com o agente (chat ou WhatsApp), o agente identifica intenção, sugere horários disponíveis, confirma, gera booking.
• Diferencial: sem app, sem ligação, sem espera.

[ Cliente conversa com agente IA no WhatsApp ]
              │
              ▼
[ Agente identifica intenção: "manutenção preventiva" ]
              │
              ▼
[ Sugere 3 horários disponíveis ]
              │
              ▼
[ Cliente escolhe → booking criado ]
              │
              ▼
[ Lembrete 24h antes via WhatsApp ]
              │
              ▼
[ Técnico recebe agenda no app ]
              │
              ▼
[ Faz check-in com GPS → /scheduling/attendance/:id ]
              │
              ▼
[ Formulário vinculado abre automaticamente ]
              │
              ▼
[ Preenche, fotos, leituras ]
              │
              ▼
[ Cliente assina termo de conclusão (Z-Sign) ]
              │
              ▼
[ Atendimento concluído + Z-Score pontua técnico ]
              │
              ▼
[ Próximo booking recorrente já criado para mês seguinte ]

Cenário A — Manutenção preventiva industrial

50 equipamentos com revisão mensal. Recurso = "Equipe Manutenção". Booking recorrente. Técnico recebe agenda, executa, formulário fecha automaticamente o booking e cria o próximo. Painel de vencimentos mostra zero em atraso.

Cenário B — Controle de EPI em obra

500 colaboradores, cada um com 4 EPIs (capacete, óculos, luvas, botina). Painel /gestao-vencimentos mostra os 12 EPIs vencendo nesta semana. Alerta dispara, líder libera substituição, fluxo Z-Flow controla entrega.

Cenário C — Clínica de pequeno porte

Recurso = "Dr. Silva" + "Sala 1". Cliente marca pelo agente IA via site. Booking confirma, lembrete envia, atendimento abre prontuário (formulário), cliente assina termo de consentimento. Tudo em uma plataforma.

Cenário D — Visita técnica de telecom

Cliente abre chamado. Z-Flow encaminha para agendamento. Agente IA sugere janela, cliente confirma. Técnico recebe agenda + formulário de instalação + termo de aceite do cliente. Fecha em campo, dispara nota de pagamento.

7.1. Pitch 5 minutos

7.2. Apresentação 15 minutos

Objetivos

• Criar recurso agendável com disponibilidade e duração.
• Marcar e executar atendimento completo.
• Configurar recorrência.
• Ler o painel de vencimentos e tratar 1 item.

Agenda

Exercício 1 — Recurso e booking

• Crie recurso "Técnico João" com disponibilidade seg-sex 8h-17h, duração padrão 1h, intervalo 15min.
• Crie 3 bookings em horários diferentes para clientes diferentes.

Exercício 2 — Atendimento completo

• Atravesse 1 booking: check-in, preenchimento de formulário, fotos, assinatura, fechamento.
• Confirme que o próximo booking recorrente foi criado.

Exercício 3 — Vencimentos + IA

• Abra /gestao-vencimentos, identifique o item mais urgente, abra o fluxo de tratamento.
• Use o agente IA para marcar 1 agendamento conversando.

Quiz (6 perguntas)

1. Quais tipos de recurso são suportados?
2. Como configurar capacidade de 5 atendimentos paralelos?
3. O que ActiveAttendanceContext evita?
4. Como gerar booking recorrente automaticamente?
5. Onde vejo tudo que vence em 30 dias?
6. Como o agente IA marca pelo cliente?

Setup inicial

• [ ] Cadastrar todos os recursos críticos.
• [ ] Definir janelas de disponibilidade reais (sem otimismo).
• [ ] Vincular formulário obrigatório por tipo de booking.
• [ ] Configurar lembretes proativos (24h, 1h).
• [ ] Conectar Google/Outlook se necessário.
• [ ] Cadastrar vencimentos críticos (EPI, ASO, certificações).

Revisão mensal

• [ ] Há recurso superlotado? Aumentar capacidade ou criar outro.
• [ ] Há recurso ocioso? Realocar.
• [ ] Taxa de cancelamento alta? Investigar causa.
• [ ] Painel de vencimentos sem itens em vermelho?

Posso bloquear feriados de uma vez? Sim — bloqueio em massa por janela.

Suporta múltiplos recursos no mesmo booking? Sim — técnico + veículo + ferramenta.

Cliente precisa de login para marcar? Não — pode marcar pelo agente IA ou por link público de scheduling.

Sincronização com Google é em tempo real? Sim — webhooks bidirecionais.

O atendimento pode ser pausado e retomado? Sim — ActiveAttendanceContext preserva estado.

O agente IA cobra por interação? Custo do modelo de IA. Veja `10-agentes-autonomos.md`.

Posso ter agenda diferente por unidade? Sim — recursos isolados por unidade/empresa.

Esta galeria expõe o percurso prático do Z-Schedule: calendário, detalhes da reserva, recursos disponíveis, atendimento ativo, vencimentos e integrações. O fechamento visual mostra como automação e lembretes ajudam a manter o agendamento vivo até a execução.

As telas operacionais foram capturadas no sandbox em 24/05/2026. O lembrete móvel é uma ilustração conceitual identificada na legenda, incluída para demonstrar a experiência fora do navegador.

Print 01 - Calendario operacional

Ampliar

Leitura do print: A agenda real apresenta recursos, proximos horarios e status de atendimento.

Evidência capturada; desktop / 1440 x 980; origem: `/scheduling`.

Print 02 - Detalhe do agendamento

Ampliar

Leitura do print: O booking de inspeção mostra a jornada operacional associada a um horario.

Evidência capturada; desktop / 1440 x 980; origem: `/scheduling/booking/:id`.

Print 03 - Lista de recursos

Ampliar

Leitura do print: A gestao administrativa concentra agendas e seus acessos.

Evidência capturada; desktop / 1440 x 980; origem: `/scheduling-management/resources`.

Print 04 - Detalhe do recurso

Ampliar

Leitura do print: O recurso Treinamento exibe disponibilidade e recorte temporal real.

Evidência capturada; desktop / 1440 x 980; origem: `/scheduling-management/resources/:id`.

Print 05 - Atendimento ativo

Ampliar

Leitura do print: A execução associa operador, serviço e acompanhamento da atividade.

Evidência capturada; desktop / 1440 x 980; origem: `/scheduling/attendance/:bookingId`.

Print 06 - Painel de vencimentos

Ampliar

Leitura do print: A tela consolida itens que demandam ação antes do prazo.

Evidência capturada; desktop / 1440 x 980; origem: `/gestao-vencimentos`.

Print 07 - Integrações de agenda

Ampliar

Leitura do print: A área comprova a conexão prevista com calendarios externos.

Evidência capturada; desktop / 1440 x 980; origem: `/scheduling-management/integrations`.

Print 08 - Agente de agendamento

Ampliar

Leitura do print: A conversa com o agente demonstra a camada assistiva da agenda.

Evidência capturada; desktop / 1440 x 980; origem: `/scheduling-management/agent`.

Print 09 - Lembrete WhatsApp

Ampliar

Leitura do print: O lembrete informa horário e equipe da visita e permite confirmar ou reagendar com um toque, reduzindo ausências operacionais.

Imagem ilustrativa gerada com GPT Image a partir da marca oficial ZIINP; representa o conceito de lembrete por WhatsApp, não uma captura real de conversa.

🏭 Indústria — Manutenção preventiva de 200 equipamentos

Cada equipamento tem ciclo próprio (alguns trimestral, outros mensal). Z-Schedule:

• recurso "Equipe Manutenção";
• recurrência configurada por equipamento;
• formulário "Plano de Manutenção" vinculado;
• ao concluir, próximo booking criado automaticamente.

Resultado: zero equipamento esquecido, dashboard de utilização da equipe.

⚡ Telecom — Visita técnica

Cliente abre chamado → Z-Flow → Z-Schedule sugere 3 janelas → cliente confirma pelo agente IA via WhatsApp. Técnico recebe ordem com formulário + termo de aceite + tempo estimado. Resultado: taxa de remarcação caiu 70%, NPS subiu 18 pontos.

🏥 Saúde — Clínica com 8 especialidades

Cada especialista é um recurso. Salas são recursos. Booking combina especialista + sala + horário. Paciente marca pelo agente IA conversacional. Recebe lembrete 24h e 1h antes. Resultado: taxa de no-show caiu de 22% para 7%.

🛒 Varejo — Auditoria mensal de lojas

Recurso "Auditor regional", recorrência mensal. Cada booking vincula formulário de auditoria. Painel de vencimentos: lojas que estão sem auditoria há mais de 35 dias.

🏗️ Construção — Controle de validades

EPI por colaborador, ASO, NR-10, NR-35, calibrações. /gestao-vencimentos mostra próximos 30 dias. Alertas D-30, D-15, D-7 disparam automaticamente. Vencidos viram ação obrigatória no Z-Flow.

📞 Atendimento — Slots de SAC

Recurso "Slot atendimento": 30 slots de 15 min por dia. Cliente marca pelo site, sem ligação. Quando atendente entra no slot, formulário de atendimento abre automático.

🌾 Agro — Visita técnica em fazenda

Agrônomo agendado por talhão. Cada visita: formulário de inspeção + foto de praga + GPS. Recorrência por talhão configurável (algumas culturas exigem visita semanal).

🎓 RH — Treinamentos obrigatórios

Cada treinamento NR vira recurso agendável. Colaborador escolhe data, recebe lembrete. Conclusão atualiza status em /gestao-vencimentos.

Receita 1 — Recurso "Técnico de instalação"

Tipo: Pessoa
Capacidade: 1 atendimento/vez
Disponibilidade:
  seg-sex 8h-17h
  intervalo almoço 12h-13h
  buffer entre bookings: 30 min (deslocamento)
Duração padrão: 1h30
Formulário vinculado: "Instalação Telecom"
Notificações:
  ✓ Confirmação ao agendar
  ✓ Lembrete D-1 17h (WhatsApp)
  ✓ Lembrete D 1h antes (WhatsApp)

Receita 2 — Recurso "Sala de Reunião"

Tipo: Sala
Capacidade: 10 pessoas
Disponibilidade: 24/7
Bloqueios: feriados, manutenções
Formulário vinculado: nenhum
Reservável por: cargo "Líder" ou superior

Receita 3 — Recorrência "Manutenção preventiva mensal"

Recurso: "Equipe Manutenção"
Frequência: mensal, primeira segunda do mês
Duração: 4h
Formulário vinculado: "Plano de Manutenção"
Equipamento alvo: variável por booking (lista de Data Source)
Recriar próximo automaticamente: SIM

Receita 4 — Painel "Vencimentos críticos"

Filtros padrão:
  janela = próximos 30 dias
  tipo = todos
  severidade = todos
Ordenação: data de vencimento ascendente
Cores:
  vencendo em 7 dias = vermelho
  vencendo em 15 dias = laranja
  vencendo em 30 dias = amarelo
Ação clicar: abre fluxo de renovação

Receita 5 — Agente IA conversacional

Persona: Você é o assistente de agendamento da Acme.
Você atende clientes via WhatsApp e marca visitas técnicas.

Tools:
  - query_sql(disponibilidade)
  - create_booking(recurso, horário, cliente)
  - send_notification(canal=whatsapp, conteudo=confirmacao)

Fluxo:
  1. Cliente: "preciso de visita"
  2. Agente identifica intenção e tipo
  3. Lista 3 horários disponíveis
  4. Cliente escolhe
  5. Confirma e envia comprovante

• Conectar com Z-Score — comparecimento pontua.
• Plugar agente IA em todos os tipos de booking — automação total da marcação.
• Vencimentos críticos viram alerta no Modo Foco (`07-experiencia-operador.md`).
• Dashboard de utilização por recurso (`09-dashboards.md`).