# Entidades iniciais - Wezapp Shots

## Cliente

Representa quem contrata ou solicita campanhas.

Campos conceituais iniciais:

- Nome
- Tipo
- Documento, se aplicavel
- Responsavel
- Telefone
- E-mail
- Observacoes
- Status

Tipos possiveis:

- Campanha politica
- Prefeitura
- Governo
- Mandato
- Agencia
- Empresa
- Outro

## Campanha

Representa uma acao de comunicacao vinculada a um cliente.

Campos conceituais iniciais:

- Cliente
- Nome da campanha
- Descricao
- Tipo da campanha
- Data de inicio
- Data prevista de termino
- Status
- Observacoes internas

Tipos possiveis:

- Politica
- Institucional
- Governo
- Prefeitura
- Mobilizacao
- Aviso publico
- Pesquisa
- Relacionamento
- Outro

## Pacote de shots

Representa uma compra de quantidade de disparos.

Campos conceituais iniciais:

- Cliente
- Campanha
- Quantidade de shots comprados
- Valor por shot
- Valor total
- Data da compra
- Forma de pagamento
- Status financeiro
- Observacoes

Regra inicial:

```text
valor_total = quantidade_de_shots * valor_por_shot
```

## Shot

Representa uma unidade de envio ou tentativa de envio.

Status iniciais:

- Disponivel
- Reservado
- Usado
- Falhou
- Estornado
- Cancelado

## Canal

Representa um numero, conta, instancia ou meio usado para envio.

Pode representar:

- Numero de WhatsApp
- Conta conectada
- Canal Meta
- Provedor externo
- Instancia de envio
- Chip fisico ou virtual
- API de disparo conectada

## Chipeira digital

Agrupa e gerencia multiplos canais de disparo.

Deve permitir:

- Cadastrar canais
- Ativar e desativar canais
- Definir limites
- Definir prioridade
- Definir aquecimento
- Distribuir disparos
- Pausar canal com erro
- Identificar canal com risco
- Ver estatisticas por canal

## Base de contatos

Representa a lista de destinatarios de uma campanha.

Campos conceituais iniciais:

- Campanha
- Nome da base
- Origem
- Quantidade de contatos
- Data de importacao
- Status
- Observacoes

## Disparo

Representa a execucao pratica de envio para um contato.

Campos conceituais iniciais:

- Campanha
- Base
- Contato
- Canal
- Mensagem
- Status
- Data de enfileiramento
- Data de envio
- Data de retorno

## Log de envio

Registra o historico tecnico e operacional de cada tentativa.

Deve armazenar:

- Requisicao enviada
- Resposta recebida
- Canal usado
- Status retornado
- Erro tecnico, se houver
- Usuario responsavel pela acao
- Data e hora