====== Módulo: Pet Shop ======

O módulo **Pet Shop** permite que estabelecimentos veterinários e pet shops gerenciem seus atendimentos de forma completa dentro do Ello ERP: cadastro de animais, agendamento de serviços, controle de vacinação e histórico de pesos — tudo integrado ao faturamento e ao estoque.

===== Funcionalidades disponíveis =====

^ Tela ^ O que faz ^
| **Veterinários** | Cadastra os veterinários do estabelecimento com nome e número de registro no CRMV. |
| **Animais** | Cadastra os animais dos clientes com todas as informações relevantes. |
| **Pesos de Animais** | Registra e acompanha o histórico de pesagens de cada animal. |
| **Procedimentos** | Mantém a lista de procedimentos realizáveis (serviços de vacinação, banho, tosa, etc.). |
| **Agendamento Pet Shop** | Agenda e gerencia os atendimentos dos animais. É a funcionalidade central do módulo. |
| **Agendamentos (relatório)** | Exibe um relatório de agendamentos com filtros por período, animal, cliente, veterinário e procedimento. |

===== Cadastro de Animais =====

Cada animal é vinculado a um **cliente** (o dono) e possui as seguintes informações:

  * **Dados gerais:** nome, espécie, raça, pelagem, data de nascimento, sexo e se possui pedigree
  * **Saúde:** alergias conhecidas e observações gerais
  * **Status:** registro de data de falecimento e motivo, quando aplicável

Espécies, raças e pelagens não precisam ser pré-cadastradas: ao digitar um valor novo no cadastro do animal, ele é registrado automaticamente na lista.

Cada animal também pode ter uma **configuração de serviço recorrente** — veja a seção [[#agendamento_recorrente_automatico|Agendamento Recorrente]] abaixo.

===== Pesagem de Animais =====

O histórico de pesagens fica vinculado ao cadastro de cada animal. Cada registro contém:

  * Data da pesagem
  * Peso registrado (em kg)
  * Usuário que realizou o lançamento

Isso permite acompanhar a evolução do peso do animal ao longo do tempo.

===== Agendamentos =====

O agendamento é o coração do módulo. Por meio dele é possível:

  - Definir o animal que será atendido e o veterinário responsável
  - Informar a data e o horário do atendimento
  - Adicionar os serviços e produtos que serão consumidos (banho, tosa, vacinas, medicamentos, etc.)
  - Registrar observações sobre o atendimento

==== Situações do agendamento ====

Um agendamento passa pelas seguintes situações:

<uml>
@startuml
hide empty description
[*] --> Agendado : criação
Agendado --> Confirmado : confirmar presença
Confirmado --> Concluído : concluir atendimento
Agendado --> Cancelado : cancelar
Confirmado --> Cancelado : cancelar
Concluído --> [*]
Cancelado --> [*]
@enduml
</uml>

  * **Agendado:** o atendimento foi marcado, aguardando confirmação
  * **Confirmado:** o cliente confirmou a presença
  * **Concluído:** o atendimento foi realizado; neste momento o sistema gera automaticamente o pedido de venda com os itens do agendamento
  * **Cancelado:** o atendimento foi desmarcado; se havia um pedido em aberto, ele é cancelado automaticamente

==== Produtos e serviços no agendamento ====

Durante o agendamento é possível adicionar qualquer produto ou serviço cadastrado no estoque. Ao concluir o agendamento, esses itens geram um **pedido de venda** que segue o fluxo normal de faturamento do Ello.

===== Vacinação =====

O módulo oferece um controle completo do ciclo de vacinação dos animais.

==== Como funciona ====

  * Cada vacina tem um número de doses definido e um intervalo entre elas (por exemplo, "2ª dose em 21 dias")
  * No agendamento, é possível informar que se trata de uma vacinação e indicar qual dose está sendo aplicada
  * Ao **concluir** o agendamento, o sistema oferece a opção de já criar o próximo agendamento automaticamente:
    * Se houver mais doses na mesma vacina → agenda a próxima dose com o intervalo correto
    * Se for a última dose → agenda automaticamente a 1ª dose da próxima vacina na sequência (por exemplo, V8 → Antirrábica)

==== Regras importantes ====

  * Um agendamento comporta no máximo **uma vacina por vez**
  * Não é possível registrar uma vacinação para o **animal genérico** do sistema (cadastro utilizado como placeholder quando o animal real ainda não está cadastrado)
  * O sistema impede registrar uma dose que já foi aplicada ou que já está agendada para o mesmo animal

===== Agendamento Recorrente (automático) =====

Animais que utilizam serviços com regularidade (banho semanal, tosa quinzenal, etc.) podem ter uma configuração de **recorrência** no próprio cadastro.

==== Tipos de recorrência disponíveis ====

^ Tipo ^ Como configurar ^
| **Semanal** | Marcar os dias da semana desejados (segunda, quarta, sexta, etc.) |
| **Quinzenal** | Escolher a 1ª quinzena, a 2ª quinzena ou ambas, e o dia do mês |
| **Mensal** | Marcar os meses do ano e o dia específico |

==== Comportamento ====

Ao **concluir** um agendamento de um animal com recorrência configurada, o sistema verifica automaticamente se já existe um próximo agendamento em aberto para esse animal. Se não existir, **cria o próximo agendamento automaticamente** com a data calculada conforme a regra de recorrência.

Isso evita que o atendente precise lembrar de remarcar toda vez que um atendimento é finalizado.

===== Veterinários e Procedimentos =====

==== Veterinários ====

Cadastro simples com nome e número de registro no CRMV. O veterinário é selecionado em cada agendamento e pode ser configurado como **veterinário padrão** nos parâmetros do módulo.

==== Procedimentos ====

Lista os tipos de procedimentos realizados no estabelecimento. Cada procedimento tem:

  * **Descrição:** nome do procedimento
  * **Tipo:** "Vacina/Vermífugo" ou "Outros"

Os procedimentos são usados para classificar e filtrar os agendamentos no relatório.

===== Relatório de Agendamentos =====

O relatório exibe todos os agendamentos realizados e pode ser filtrado por:

  * **Período** (data de início e fim)
  * **Cliente** (dono do animal)
  * **Animal**
  * **Veterinário**
  * **Procedimento**

É útil para conferir a agenda do dia, acompanhar o histórico de atendimentos de um animal específico ou verificar a produtividade de um veterinário em um período.

===== Parâmetros de Configuração =====

Os parâmetros do módulo Pet Shop podem ser ajustados em **Arquivo → Parâmetros → Pet Shop**:

^ Parâmetro ^ Descrição ^
| **Veterinário padrão** | O veterinário que aparece pré-selecionado ao abrir um novo agendamento |
| **Animal padrão** | O animal genérico do sistema — utilizado como placeholder quando o animal real ainda não foi cadastrado. A vacinação fica bloqueada para ele. |
| **Procedimento padrão** | O procedimento que aparece pré-selecionado nos novos agendamentos |

===== Integração com Outros Módulos =====

O módulo Pet Shop funciona em conjunto com outras partes do Ello:

  * **Vendas:** ao concluir um agendamento, os produtos e serviços adicionados geram automaticamente um pedido de venda, que segue o fluxo normal de faturamento
  * **Estoque:** os produtos utilizados nos atendimentos são descontados do estoque quando o pedido de venda é processado
  * **Cadastro de Clientes:** o dono de cada animal deve estar cadastrado como cliente no sistema; o vínculo é feito diretamente no cadastro do animal