Pular para o conteúdo principal
Versão: Versão Mercados

Guia de Início Rápido

Agora que você conhece o Sistema Divino Alimento e suas funcionalidades principais, vamos colocar a mão na massa! Este guia mostrará como configurar e realizar seu primeiro ciclo de comercialização, passo a passo.

Antes de Começar

Se você chegou até aqui, já entende:

  • ✓ O que é o Sistema Divino Alimento
  • ✓ Como funcionam os ciclos de comercialização
  • ✓ A diferença entre cestas e produtos extras
  • ✓ As funcionalidades principais da plataforma

Este guia assume que você é um administrador fazendo a configuração inicial do sistema para sua comunidade.

Tempo estimado total: 2 a 3 horas

Você precisará de:

  • Navegador web moderno (Chrome, Firefox, Safari, Edge)
  • Conta Google para autenticação
  • Lista dos produtos que serão comercializados
  • Informações dos pontos de entrega da comunidade

Fase 1: Configuração Inicial

Tempo estimado: 60 minutos

Primeiro Acesso

  1. Acesse o sistema através da URL fornecida pela sua comunidade
  2. Clique em "Login" e autentique com sua conta Google
  3. Preencha seus dados complementares:
    • Nome completo
    • Celular para contato
    • Dados para pagamento (conta bancária ou PIX)
  4. Aceite a política de privacidade
  5. Defina seu perfil inicial (você pode ajustar depois)

Importante: O primeiro usuário a fazer login será automaticamente definido como administrador do sistema.

Cadastros Básicos Essenciais

Acesse o menu CADASTROS na tela inicial ou navegue diretamente para /cadastros.

1. Categorias de Produtos

Por que começar aqui? Cada produto precisa de uma categoria. Cadastre primeiro as categorias, depois os produtos.

Sugestões de categorias:

  • Frutas
  • Legumes e Verduras
  • Folhas
  • Grãos e Cereais
  • Tubérculos
  • Laticínios
  • Ovos
  • Produtos Processados

Como cadastrar:

  1. Acesse "Categoria de Produtos"
  2. Clique em "Adicionar Categoria"
  3. Digite o nome da categoria
  4. Salve

Dica: Comece com 4-5 categorias principais. Você pode adicionar mais depois.

2. Produtos

Cadastre os produtos que serão ofertados pelos agricultores.

Informações obrigatórias:

  • Nome do Produto - Seja específico (ex: "Alface Crespa", não apenas "Alface")
  • Categoria - Selecione uma categoria cadastrada
  • Medida - Unidade de venda (kg, maço, dúzia, litro, unidade...)
  • Peso em Gramas - Para padronização (ex: 1 maço = 200g)
  • Valor de Referência - Preço base do produto
  • Situação - Ativo (para usar) ou Inativo

Informações opcionais:

  • Descrição para consumidor - Detalhes que aparecem nos pedidos extras

Exemplo prático:

Nome: Tomate Cereja Orgânico
Categoria: Legumes e Verduras
Medida: kg
Peso: 1000g
Valor: R$ 12,00
Situação: Ativo
Descrição: Cultivado sem agrotóxicos, direto da horta

Dica: Comece com 10-15 produtos mais comuns. Expanda gradualmente conforme os agricultores ofertam mais variedades.

3. Pontos de Entrega

Cadastre os locais onde acontecerá a distribuição.

Informações necessárias:

  • Nome do ponto (ex: "Centro Comunitário Vila Verde")
  • Endereço completo
  • Responsável pelo local (opcional)
  • Observações (horários, instruções de acesso)

Exemplo:

Nome: Sede da Associação de Moradores
Endereço: Rua das Palmeiras, 456 - Jardim Esperança
Responsável: João Silva
Observações: Entrada pelo portão lateral. Horário: 8h às 18h

Dica: Para começar, cadastre apenas o ponto principal. Você pode adicionar outros pontos posteriormente.

4. Tipos de Cestas

Defina os tipos de cestas que sua comunidade utilizará.

Informações necessárias:

  • Nome da cesta (ex: "Cesta Mensal Família")
  • Valor máximo (limite para composição)
  • Descrição (para identificação interna)

Exemplos práticos:

Cesta 1:
Nome: Mensal Família
Valor máximo: R$ 80,00
Descrição: Cesta para famílias mensalistas

Cesta 2:
Nome: Semanal Individual
Valor máximo: R$ 25,00
Descrição: Cesta pequena para entrega semanal

Atenção: O sistema possui uma cesta especial (ID=5) para produtos extras, gerenciada automaticamente. Você não precisa cadastrá-la.

Dica: Comece com 1-2 tipos de cesta. Adicione mais conforme a demanda da comunidade.

5. Usuários

Cadastre os membros da sua comunidade.

Processo:

  1. Os usuários fazem login via Google OAuth
  2. Você (administrador) define os perfis de cada um:
    • Fornecedor - Pode registrar ofertas de produtos
    • Consumidor - Pode fazer pedidos extras
    • Administrador - Acesso completo ao sistema

Dica: Um usuário pode ter múltiplos perfis. Por exemplo, um agricultor pode ser Fornecedor e Consumidor ao mesmo tempo.

Checklist de Configuração Inicial

Antes de criar seu primeiro ciclo, confirme que você cadastrou:

  • Pelo menos 4 categorias de produtos
  • Pelo menos 10 produtos ativos
  • Pelo menos 1 ponto de entrega
  • Pelo menos 1 tipo de cesta
  • Pelo menos 3 usuários (1 fornecedor, 1 consumidor, 1 administrador)

Resultado esperado: Sistema configurado e pronto para criar ciclos!


Fase 2: Criar Seu Primeiro Ciclo

Tempo estimado: 15-20 minutos
Responsável: Administrador

Com os cadastros básicos completos, você pode criar seu primeiro ciclo de comercialização baseado nas práticas da sua comunidade.

Planejamento do Ciclo

Antes de criar o ciclo no sistema, defina com sua comunidade:

1. Periodicidade

  • Ciclos semanais, quinzenais ou mensais?
  • Qual frequência funciona melhor para os agricultores e consumidores?

2. Cronograma

  • Quantos dias os agricultores precisam para registrar ofertas?
  • Quanto tempo os consumidores precisam para fazer pedidos extras?
  • Quando será a entrega/retirada dos produtos?

3. Tipos de Cestas

  • Quantas cestas de cada tipo serão montadas neste ciclo?
  • Quais consumidores receberão cada tipo de cesta?

4. Logística

  • Qual ponto de entrega será usado?
  • Quem coordenará a distribuição?
  • Como serão realizados os pagamentos?

Criar o Ciclo no Sistema

Acesse a tela inicial e clique em "Criar Novo Ciclo".

Informações obrigatórias:

Nome do ciclo: 
Exemplo: "Maio 2024 - Mensal"
Dica: Use um nome que identifique claramente o período

Ponto de entrega:
Selecione o ponto cadastrado onde ocorrerá a distribuição

Cestas participantes:
Tipo: Selecione o(s) tipo(s) de cesta
Quantidade: Defina quantas cestas de cada tipo

Configuração de períodos:

Período de ofertas (agricultores registram produtos):
Data/hora início: Quando começa a janela de ofertas
Data/hora fim: Quando fecha a janela de ofertas
Sugestão: 3-5 dias

Período de pedidos extras (consumidores fazem pedidos):
Data/hora início: Quando abre para pedidos extras
Data/hora fim: Quando fecha para pedidos extras
Sugestão: 3-5 dias, após o período de ofertas

Período de entrega (fornecedores entregam):
Data/hora início: Quando começam as entregas
Data/hora fim: Até quando podem entregar
Sugestão: 1 dia específico, após fechamento de pedidos

Período de retirada (consumidores retiram):
Data/hora início: Quando consumidores podem retirar
Data/hora fim: Até quando podem retirar
Sugestão: 1-2 dias, logo após as entregas

Campo Observações:

Use este campo para comunicar informações importantes aos participantes:

  • Composição estimada das cestas
  • Instruções de entrega e retirada
  • Formas de pagamento aceitas
  • Contato para dúvidas

Exemplo de observações:

🌾 Ciclo de Maio - Bem-vindos!

CESTAS:
Cada cesta conterá aproximadamente 5kg de produtos frescos e variados.

PRODUTOS EXTRAS:
Disponíveis a partir de 08/05 para pedidos individuais.

ENTREGA E RETIRADA:
Local: [Nome do ponto de entrega]
Entrega: [Data] das [horário]
Retirada: [Data(s)] das [horário]

PAGAMENTO:
[Descrever formas aceitas: PIX, dinheiro, etc.]

DÚVIDAS:
[Contato do administrador ou grupo da comunidade]

Exemplo de Cronograma

Para um ciclo mensal típico:

Nome: Maio 2024 - Mensal
Duração total: 2 semanas

Semana 1:
Segunda a sexta (01-05/05): Agricultores registram ofertas
Fim de semana (06-07/05): Administrador monta cestas

Semana 2:
Segunda a sexta (08-12/05): Consumidores fazem pedidos extras
Fim de semana (13-14/05): Administrador organiza relatórios

Semana 3:
Quarta (15/05): Agricultores entregam produtos
Quinta e sexta (16-17/05): Consumidores retiram cestas e pedidos

Após Criar o Ciclo

O ciclo aparecerá na tela /ciclo-index com todos os botões de ação:

  • Editar Ciclo
  • Inserir Ofertas
  • Composição Cestas
  • Relatórios
  • E outros recursos conforme o ciclo avança

Dica importante: Comunique a criação do ciclo para todos os participantes (agricultores e consumidores) informando as datas importantes!

Resultado esperado: Primeiro ciclo criado e participantes informados das datas!


Próximos Passos

Após dominar os cadastros básicos e criar seu primeiro ciclo:

  1. Exemplo de Ciclo - Veja um exemplo completo e detalhado de operação de ciclo
  2. Funcionalidades Principais - Conheça todos os recursos em profundidade
  3. Manual de Instalação - Configure seu próprio servidor
  4. Casos de Uso Detalhados - Situações específicas e soluções

Parabéns por configurar o Sistema Divino Alimento! 🎉

Você agora tem as ferramentas para fortalecer a economia local e promover segurança alimentar em sua comunidade. Lembre-se: a tecnologia é o meio, mas são as pessoas que fazem a diferença.

Bom trabalho e ótimos ciclos! 🌾