Guia do Administrador
Este guia explica como usar a plataforma Divino Cestas como Administrador.
👨💼 Papel do Administrador
Como administrador, você é responsável por:
- ✅ Criar e gerenciar ciclos
- ✅ Configurar cestas
- ✅ Cadastrar produtos e categorias
- ✅ Gerenciar pontos de entrega
- ✅ Fazer composições de cestas
- ✅ Gerenciar usuários
- ✅ Gerar relatórios
- ✅ Acompanhar movimentações financeiras
🚀 Fluxo de Trabalho do Administrador
1. Configuração Inicial
├─ Cadastrar produtos
├─ Cadastrar categorias
├─ Cadastrar cestas
└─ Cadastrar pontos de entrega
2. Criar Novo Ciclo
├─ Definir datas
├─ Associar cestas
└─ Associar pontos de entrega
3. Período de Ofertas
└─ Aguardar fornecedores cadastrarem ofertas
4. Fazer Composição
├─ Selecionar ofertas
├─ Montar cestas
└─ Definir quantidades
5. Período de Pedidos
└─ Aguardar consumidores fazerem pedidos
6. Gerar Relatórios
├─ Pedidos por fornecedor
├─ Pedidos por consumidor
├─ Relatório de produtos
└─ Exportar CSV/PDF
7. Registrar Movimentações
└─ Lançar pagamentos
📋 Tarefas Detalhadas
1. Cadastrar Categorias
Categorias organizam os produtos.
Caminho: Menu → Cadastros → Categorias
Passos:
- Clique em "Nova Categoria"
- Preencha:
- Nome (ex: "Hortaliças Folhosas")
- Descrição (opcional)
- Clique em "Salvar"
Categorias Sugeridas:
- 🥬 Hortaliças Folhosas
- 🥕 Raízes e Tubérculos
- 🍅 Frutos
- 🌾 Grãos e Cereais
- 🥚 Produtos de Origem Animal
- 🍯 Processados
2. Cadastrar Produtos
Produtos são os alimentos que serão oferecidos.
Caminho: Menu → Cadastros → Produtos
Passos:
- Clique em "Novo Produto"
- Preencha:
- Nome: "Alface Crespa"
- Unidade: "maço" (ou kg, unidade, litro, dúzia)
- Peso em Gramas: 200
- Valor de Referência: 3.50
- Categoria: Selecione a categoria
- Descritivo: Informações adicionais
- Ativo: ✅ Sim
- Clique em "Salvar"
Dica: Cadastre todos os produtos que podem ser oferecidos, mesmo que não estejam disponíveis neste ciclo.
3. Cadastrar Cestas
Cestas são os tipos de pacotes oferecidos.
Caminho: Menu → Cadastros → Cestas
Passos:
- Clique em "Nova Cesta"
- Preencha:
- Nome: "Cesta Básica de Hortaliças"
- Descrição: "Cesta variada com hortaliças da estação"
- Valor de Referência: 45.00
- Peso Aproximado: 5000 (em gramas)
- Ativo: ✅ Sim
- Clique em "Salvar"
Cestas Pré-definidas:
- Cesta 1: Ofertas padrão
- Cesta 5: Itens extras/adicionais
4. Cadastrar Pontos de Entrega
Pontos onde as cestas serão retiradas.
Caminho: Menu → Cadastros → Pontos de Entrega
Passos:
- Clique em "Novo Ponto de Entrega"
- Preencha:
- Nome: "Centro Comunitário da Vila"
- Endereço: "Rua das Flores, 123"
- Cidade: "São Paulo"
- Referência: "Próximo ao mercado municipal"
- Responsável: "Maria Silva"
- Telefone: "(11) 98765-4321"
- Ativo: ✅ Sim
- Clique em "Salvar"
5. Criar Novo Ciclo
O ciclo é o coração da plataforma.
Caminho: Menu → Ciclos → Novo Ciclo
Passos:
5.1 Informações Básicas
Nome: Ciclo Primavera 2024
5.2 Janelas de Tempo
📅 Período de Ofertas
Data Início: 01/09/2024
Data Fim: 15/09/2024
→ Fornecedores cadastram ofertas
📅 Período de Pedidos
Data Início: 16/09/2024
Data Fim: 25/09/2024
→ Consumidores fazem pedidos
📅 Período de Retirada
Data Início: 01/10/2024
Data Fim: 05/10/2024
→ Entregas das cestas
5.3 Associar Cestas
Selecione quais cestas estarão disponíveis neste ciclo:
- ☑️ Cesta Básica de Hortaliças
- ☑️ Cesta Premium
- ☑️ Itens Extras
5.4 Associar Pontos de Entrega
Para cada ponto, defina:
- Data e horário de entrega
- Quantidade prevista de cestas
Exemplo:
📍 Centro Comunitário
Data: 01/10/2024
Horário: 14h - 18h
Cestas previstas: 30
📍 Feira da Praça Central
Data: 01/10/2024
Horário: 08h - 12h
Cestas previstas: 45
5.5 Salvar Ciclo
Clique em "Salvar Ciclo"
✅ Ciclo criado! Agora aguarde as ofertas dos fornecedores.
6. Acompanhar Ofertas
Durante o período de ofertas, fornecedores cadastrarão seus produtos.
Caminho: Menu → Ofertas → Ofertas do Ciclo
Visualização:
Ciclo: Primavera 2024
Status: 🟡 Recebendo Ofertas
Fornecedores que ofertaram: 8
📦 Ofertas Recebidas:
├─ João Silva (Sítio Boa Vista)
│ ├─ Alface Crespa - 50 maços - R$ 3,50
│ ├─ Rúcula - 30 maços - R$ 4,00
│ └─ Couve - 40 maços - R$ 3,00
│
├─ Maria Santos (Fazenda Sol)
│ ├─ Tomate - 30 kg - R$ 8,00/kg
│ └─ Cenoura - 50 kg - R$ 5,00/kg
│
└─ ...
Aguarde até o fim do período de ofertas.
7. Fazer Composição das Cestas
Após o período de ofertas, é hora de compor as cestas.
Caminho: Menu → Composição → Selecionar Ciclo e Cesta
Passos:
7.1 Selecionar Cesta
Ciclo: Primavera 2024
Cesta: Cesta Básica de Hortaliças
7.2 Ver Ofertas Disponíveis
O sistema mostra todos os produtos oferecidos:
Produtos Disponíveis:
├─ Alface Crespa (João) - 50 maços disponíveis
├─ Rúcula (João) - 30 maços disponíveis
├─ Tomate (Maria) - 30 kg disponíveis
├─ Cenoura (Maria) - 50 kg disponíveis
├─ Batata (Pedro) - 80 kg disponíveis
└─ ...
7.3 Montar a Cesta
Para cada produto, defina a quantidade por cesta:
🧺 Cesta Básica de Hortaliças
Produto Qtd/Cesta Fornecedor
─────────────────────────────────────────────────
Alface Crespa 1 maço João Silva
Rúcula 0.5 maço João Silva
Tomate 300g Maria Santos
Cenoura 500g Maria Santos
Batata 1 kg Pedro Costa
Cebola 500g Ana Lima
7.4 Sistema Calcula Quantidades
💡 Cálculo Automático
Baseado nas ofertas e quantidades por cesta:
Alface: 50 maços ÷ 1 maço/cesta = 50 cestas possíveis
Rúcula: 30 maços ÷ 0.5 maço/cesta = 60 cestas possíveis
Tomate: 30 kg ÷ 0.3 kg/cesta = 100 cestas possíveis
...
🎯 Cestas disponíveis: 50 (limitado pelo produto com menor disponibilidade)
7.5 Salvar Composição
Revise e clique em "Salvar Composição"
✅ Composição criada! Agora consumidores podem fazer pedidos.
8. Acompanhar Pedidos
Durante o período de pedidos, acompanhe as encomendas.
Caminho: Menu → Pedidos → Pedidos de Consumidores
Visualização:
Ciclo: Primavera 2024
Status: 🟢 Recebendo Pedidos
Cestas pedidas: 45 / 50 disponíveis
📋 Resumo por Cesta:
├─ Cesta Básica: 35 pedidos
├─ Cesta Premium: 8 pedidos
└─ Itens Extras: 12 pedidos
📍 Por Ponto de Entrega:
├─ Centro Comunitário: 28 cestas
└─ Feira da Praça: 17 cestas
9. Gerar Relatórios
Após o período de pedidos, gere os relatórios.
9.1 Relatório de Pedidos por Fornecedor
Caminho: Menu → Relatórios → Pedidos Fornecedores
Uso: Informa cada fornecedor sobre o que deve entregar
Exemplo:
═══════════════════════════════════════════════
PEDIDO FORNECEDOR: João Silva
Ciclo: Primavera 2024
═══════════════════════════════════════════════
Produto Quantidade Valor Unit. Total
──────────────────────────────────────────────────────────
Alface Crespa 45 maços R$ 3,50 R$ 157,50
Rúcula 22 maços R$ 4,00 R$ 88,00
Couve 38 maços R$ 3,00 R$ 114,00
──────────────────────────────────────────────────────────
TOTAL: R$ 359,50
Ações:
- 📄 Visualizar na tela
- 📥 Baixar PDF
- 📧 Enviar por email (futuro)
9.2 Relatório de Pedidos por Consumidor
Caminho: Menu → Relatórios → Pedidos Consumidores
Uso: Lista de todos os consumidores e seus pedidos
Exemplo:
═══════════════════════════════════════════════
PEDIDOS DE CONSUMIDORES
Ciclo: Primavera 2024
═══════════════════════════════════════════════
Consumidor: Ana Carolina
Ponto: Centro Comunitário
Data Retirada: 01/10/2024 - 14h às 18h
├─ Cesta Básica de Hortaliças (2x) - R$ 90,00
└─ Mel 500g (1x) - R$ 25,00
Total: R$ 115,00
─────────────────────────────────────────────────
Consumidor: Bruno Oliveira
Ponto: Feira da Praça
Data Retirada: 01/10/2024 - 08h às 12h
└─ Cesta Básica de Hortaliças (1x) - R$ 45,00
Total: R$ 45,00
─────────────────────────────────────────────────
9.3 Relatório de Produtos
Caminho: Menu → Relatórios → Relatório de Produtos
Uso: Visão consolidada de todos os produtos
Exemplo:
Produto Ofertado Pedido Sobra Fornecedores
───────────────────────────────────────────────────────────────
Alface 50 maços 45 maços 5 maços João, Maria
Tomate 30 kg 25 kg 5 kg Maria
Cenoura 50 kg 48 kg 2 kg Maria, Pedro
...
9.4 Exportar para CSV
Todos os relatórios podem ser exportados:
Botão: "📥 Baixar CSV"
Uso: Abrir no Excel, Google Sheets, LibreOffice
10. Gerenciar Usuários
Caminho: Menu → Usuários
10.1 Novo Usuário
Geralmente usuários se auto-cadastram ao fazer login, mas você pode criar manualmente:
Passos:
- Clique em "Novo Usuário"
- Preencha:
- Nome
- Perfil: ☑️ Fornecedor e/ou ☑️ Consumidor
- Celular
- Nome Oficial
- Descritivo
- Salvar
10.2 Editar Perfil de Usuário
Uso comum: Transformar consumidor em fornecedor
Passos:
- Busque o usuário
- Clique em "Editar"
- Marque perfis adicionais:
- ☑️ Fornecedor
- ☑️ Consumidor
- ☑️ Admin (apenas para administradores)
- Salvar
10.3 Desativar Usuário
Passos:
- Edite o usuário
- Desmarque "Ativo"
- Salvar
Efeito: Usuário não poderá mais fazer login
11. Movimentações Financeiras
Registre pagamentos e transações.
Caminho: Menu → Movimentações
11.1 Nova Movimentação
Passos:
- Clique em "Nova Movimentação"
- Preencha:
- Usuário: Selecione fornecedor/consumidor
- Tipo: Depósito ou Retirada
- Valor: 450.00
- Data: 05/10/2024
- Descrição: "Pagamento Ciclo Primavera 2024"
- Anexo: Upload de comprovante (opcional)
- Ciclo: Selecione o ciclo relacionado
- Salvar
11.2 Visualizar Todas as Movimentações
Caminho: Menu → Relatórios → Movimentações
Filtros:
- Por usuário
- Por tipo
- Por data
- Por ciclo
Exportar: CSV ou PDF
📊 Dashboard do Administrador
Ao fazer login, você verá:
═══════════════════════════════════════════════
DIVINO ALIMENTO - Painel Administrativo
═══════════════════════════════════════════════
📊 Ciclo Ativo: Primavera 2024
Status: 🟢 Recebendo Pedidos
Ofertas: 8 fornecedores
Pedidos: 45 cestas
Termina em: 5 dias
🔔 Ações Pendentes:
├─ ⚠️ Fazer composição da Cesta Premium
└─ ✅ Todas as composições prontas
📈 Estatísticas:
├─ Usuários ativos: 53
│ ├─ Fornecedores: 12
│ └─ Consumidores: 41
├─ Produtos cadastrados: 87
└─ Pontos de entrega: 4
🗓️ Próximos Ciclos:
└─ Ciclo Verão 2025 (planejado)
⚠️ Avisos Importantes
Datas do Ciclo
❌ ERRADO:
Data Oferta Fim: 15/09/2024
Data Pedido Início: 14/09/2024 ← ANTES do fim das ofertas!
✅ CORRETO:
Data Oferta Fim: 15/09/2024
Data Pedido Início: 16/09/2024 ← DEPOIS do fim das ofertas
Composição de Cestas
- ⚠️ Faça a composição ANTES do período de pedidos começar
- ⚠️ Não altere a composição depois que houver pedidos
- ⚠️ Verifique se há produtos suficientes nas ofertas
Relatórios
- 📄 Gere os relatórios APÓS o período de pedidos
- 📄 Envie para fornecedores antes da data de entrega
- 📄 Imprima etiquetas/listas para pontos de entrega
🔗 Atalhos Rápidos
| Tarefa | Caminho |
|---|---|
| Criar ciclo | Menu → Ciclos → Novo |
| Ver ofertas | Menu → Ofertas → Ciclo Atual |
| Fazer composição | Menu → Composição |
| Ver pedidos | Menu → Pedidos |
| Relatório fornecedores | Menu → Relatórios → Fornecedores |
| Relatório consumidores | Menu → Relatórios → Consumidores |
| Gerenciar usuários | Menu → Usuários |
🆘 Problemas Comuns
"Não consigo fazer a composição"
Possíveis causas:
- Ainda está no período de ofertas
- Não há ofertas suficientes
- Ciclo não está ativo
Solução: Verifique as datas do ciclo e se há ofertas cadastradas.
"Consumidores não conseguem fazer pedidos"
Possíveis causas:
- Composição não foi feita
- Não está no período de pedidos
- Cestas esgotadas
Solução: Verifique se a composição está completa e se o período está correto.
"Relatório está vazio"
Possíveis causas:
- Não há pedidos no ciclo
- Filtro incorreto
Solução: Verifique se o ciclo selecionado tem pedidos e ajuste os filtros.
🎓 Boas Práticas
- Planeje com antecedência: Crie ciclos com pelo menos 2 semanas de antecedência
- Comunique-se: Avise fornecedores e consumidores sobre datas importantes
- Faça backups: Exporte relatórios regularmente
- Revise composições: Verifique se as quantidades fazem sentido
- Monitore estoque: Acompanhe sobras e faltas de produtos
🔗 Próximos Passos
- Guia do Fornecedor - Entenda o lado do fornecedor
- Guia do Consumidor - Entenda o lado do consumidor
- Exemplo de Ciclo Completo - Veja um ciclo na prática
- Referência de API - Detalhes técnicos
Dúvidas? Consulte o Troubleshooting ou entre em contato com o suporte.