1. Acessa página de registro
2. Preenche dados básicos:
   - Nome completo
   - CPF/CNPJ
   - Email
   - Telefone
   - Senha
3. Sistema valida CPF/CNPJ via HubDev API
4. Sistema cria usuário com tipo "Produtor"
5. Envia email de confirmação
6. Produtor completa cadastro:
   - Endereço (busca CEP via ViaCep)
   - Dados da propriedade rural
   - Culturas plantadas
   - Área cultivada

1. Acessa página de registro
2. Preenche dados básicos:
   - Razão Social / Nome
   - CNPJ/CPF
   - Email
   - Telefone
   - Senha
3. Sistema valida CNPJ/CPF via HubDev API
4. Sistema cria usuário com tipo "Fornecedor"
5. Envia email de confirmação
6. Fornecedor completa cadastro:
   - Endereço (busca CEP via ViaCep)
   - Estados e cidades atendidas
   - Raio de entrega (calculado via OpenRouteService)
   - Produtos fornecidos
   - Marcas trabalhadas

1. Usuário acessa tela de login
2. Informa email + senha
3. Sistema valida credenciais
4. Sistema gera token de acesso (Sanctum)
5. Redireciona para dashboard apropriado:
   - Produtor → Dashboard Verde
   - Fornecedor → Dashboard Azul

1. Dashboard → "Nova Licitação"
2. Preenche dados da licitação:
   - Título da licitação
   - Descrição geral
   - Data de encerramento
   - Modalidade (menor preço, melhor proposta)

3. Adiciona produtos:
   - Busca produto no catálogo
   - Define quantidade
   - Define unidade de medida
   - Adiciona especificações (opcional)
   - Pode adicionar múltiplos produtos

4. Define configurações:
   - Tipo de entrega (retirada, entrega)
   - Endereço de entrega (se aplicável)
   - Forma de pagamento aceita
   - Prazo de entrega desejado

5. Revisa informações (wizard step)
6. Publica licitação
7. Sistema:
   - Calcula distância fornecedores via OpenRouteService
   - Notifica fornecedores elegíveis via WhatsApp (Z-API)
   - Envia email para fornecedores
   - Muda status para "Aberta"

1. Dashboard → "Marketplace"
2. Sistema exibe licitações:
   - Filtradas por região atendida
   - Ordenadas por data de encerramento
   - Mostra distância (via OpenRouteService)
3. Fornecedor pode filtrar:
   - Por produto
   - Por localização
   - Por data
   - Por valor estimado

1. Fornecedor clica em licitação de interesse
2. Visualiza detalhes:
   - Produtos solicitados
   - Quantidades
   - Especificações
   - Condições de entrega
   - Prazo de entrega

3. Preenche proposta para cada produto:
   - Marca oferecida
   - Preço unitário
   - Preço total
   - Prazo de entrega
   - Condições de pagamento
   - Observações (opcional)

4. Anexa documentos (opcional):
   - Ficha técnica do produto
   - Certificações
   - Nota fiscal pro-forma

5. Calcula valor total da proposta
6. Revisa e envia proposta
7. Sistema:
   - Valida proposta
   - Notifica produtor via WhatsApp
   - Envia email ao produtor
   - Muda status para "Proposta Enviada"

1. Recebe notificação de nova proposta
2. Dashboard → "Minhas Licitações" → Licitação específica
3. Visualiza todas as propostas recebidas:
   - Comparação lado a lado
   - Ordenação por preço, prazo, marca
   - Ranking automático

4. Analisa cada proposta:
   - Preço total e unitário
   - Marcas oferecidas
   - Prazo de entrega
   - Histórico do fornecedor
   - Avaliações anteriores
   - Distância

5. Opções de ação:
   - Aceitar proposta → Gera pedido
   - Rejeitar proposta → Fornecedor notificado
   - Solicitar contraproposta → Negociação
   - Adicionar à lista de comparação

6. Ao aceitar:
   - Sistema gera pedido automaticamente
   - Rejeita demais propostas
   - Fecha licitação
   - Notifica fornecedor vencedor
   - Gera contrato (PDF assinado)

Após aceitar proposta:
1. Sistema cria pedido com:
   - Dados do produtor
   - Dados do fornecedor
   - Produtos e quantidades
   - Valores acordados
   - Prazo de entrega
   - Condições de pagamento

2. Gera número único do pedido
3. Status inicial: "Aguardando Pagamento"

1. Sistema gera cobrança via Banco Inter:
   - Boleto bancário OU
   - PIX dinâmico

2. Produtor visualiza opções de pagamento
3. Produtor escolhe forma e realiza pagamento
4. Webhook Banco Inter notifica sistema:
   - Status: Pago ✅
   - Data/hora do pagamento
   - Comprovante

5. Sistema atualiza pedido:
   - Status → "Pago - Aguardando Preparação"
   - Notifica fornecedor via WhatsApp
   - Libera processo de entrega

1. Sistema gera contrato em PDF:
   - Template com dados do pedido
   - Condições comerciais
   - Responsabilidades

2. Assina digitalmente via certificado digital
3. Disponibiliza para download:
   - Produtor
   - Fornecedor

4. Armazena em storage seguro

1. Fornecedor acessa "Meus Pedidos"
2. Visualiza pedido pago
3. Atualiza status → "Em Preparação"
4. Separa produtos conforme pedido
5. Embala e prepara documentação
6. Atualiza status → "Pronto para Entrega"
7. Sistema notifica produtor

OPÇÃO A - Entrega pelo Fornecedor:
1. Fornecedor agenda entrega
2. Informa dados do transporte:
   - Transportadora / Veículo
   - Motorista
   - Previsão de chegada
3. Atualiza status → "Em Trânsito"
4. Sistema envia tracking ao produtor

OPÇÃO B - Retirada pelo Produtor:
1. Produtor agenda retirada
2. Fornecedor confirma disponibilidade
3. Produtor retira no local
4. Fornecedor confirma retirada

1. Produto chega ao destino
2. Produtor confirma recebimento:
   - Verifica produtos
   - Verifica quantidades
   - Verifica qualidade
   - Assina recebimento (digital)

3. Opções:
   - ✅ Confirmar recebimento completo
   - ⚠️ Reportar divergência
   - ❌ Recusar entrega

4. Sistema atualiza status → "Entregue"
5. Libera pagamento ao fornecedor (se retido)
6. Solicita avaliação

1. Após confirmar entrega:
2. Sistema solicita avaliação do fornecedor
3. Produtor avalia:
   - Qualidade dos produtos (1-5 estrelas)
   - Prazo de entrega (1-5 estrelas)
   - Atendimento (1-5 estrelas)
   - Custo-benefício (1-5 estrelas)
   - Comentário escrito (opcional)

4. Envia avaliação
5. Sistema:
   - Atualiza rating do fornecedor
   - Torna avaliação pública (anônima ou não)
   - Notifica fornecedor

6. Pedido finalizado → Status: "Concluído"

1. Produtor identifica problema com produto
2. Acessa pedido → "Solicitar Devolução"
3. Preenche formulário:
   - Motivo da devolução
   - Produtos afetados
   - Fotos/evidências
   - Descrição detalhada

4. Envia solicitação
5. Sistema:
   - Cria registro de devolução
   - Notifica fornecedor
   - Status: "Devolução Solicitada"

1. Produtor/Fornecedor identifica problema
2. Acessa "Suporte" → "Novo Chamado"
3. Preenche:
   - Tipo do problema
   - Urgência
   - Descrição
   - Anexos

4. Sistema:
   - Cria ticket com número único
   - Atribui a administrador
   - Envia notificações

5. Acompanhamento:
   - Produtor/Fornecedor recebe atualizações
   - Pode adicionar comentários
   - Sistema mantém histórico

6. Resolução:
   - Administrador resolve
   - Notifica interessados
   - Solicita confirmação
   - Fecha chamado

1. Sistema de planos:
   - Gratuito: 3 licitações/mês
   - Básico: 10 licitações/mês
   - Premium: Ilimitado

2. Produtor decide fazer upgrade:
3. Acessa "Assinatura" → "Alterar Plano"
4. Escolhe novo plano
5. Sistema calcula valor proporcional
6. Gera cobrança via Banco Inter
7. Produtor realiza pagamento
8. Sistema:
   - Ativa novo plano
   - Atualiza limites
   - Gera recibo
   - Notifica produtor

9. Renovação automática:
   - Sistema gera cobrança mensal
   - Webhook atualiza status
   - Em caso de falha:
     - Notifica produtor
     - Aguarda 3 dias
     - Downgrade automático

1. Produtor solicita cancelamento
2. Sistema:
   - Confirma com produtor
   - Mantém ativo até fim do período pago
   - Não renova automaticamente
   - Registra motivo (opcional)
   - Faz downgrade ao fim

1. Fornecedor → "Meus Produtos"
2. Adiciona novo produto:
   - Nome / Marca
   - Tipo de produto
   - Unidade de medida
   - Preço de referência
   - Estoque disponível
   - Especificações técnicas

3. Sistema valida e salva
4. Produto fica disponível para propostas

Eventos notificados via WhatsApp + Email:
- Nova licitação na sua região (Fornecedor)
- Nova proposta recebida (Produtor)
- Proposta aceita/rejeitada
- Pagamento confirmado
- Pedido em preparação
- Pedido em trânsito
- Entrega confirmada
- Solicitação de avaliação
- Devolução solicitada
- Atualização de chamado
- Vencimento de assinatura

- Total de licitações criadas
- Licitações ativas
- Propostas recebidas (pendentes)
- Pedidos em andamento
- Economia gerada (comparativo)
- Fornecedores favoritos
- Histórico de compras

- Licitações disponíveis na região
- Propostas enviadas
- Taxa de aceitação
- Pedidos ativos
- Faturamento do período
- Avaliação média
- Produtos mais vendidos