Pular para o conteúdo principal

Plano Mestre do Projeto

Plataforma de Gestão e Compartilhamento Orgânico​

Status:Documento Vivo (Atualizado em Junho de 2026)
Projeto:Elo Orgânico
Escopo Principal:Digitalização e Otimização da Cadeia de Compartilhamento de Produtos Orgânicos.

Fase 1: Proposta Funcional e Escopo​

Este documento detalha o desenvolvimento de uma plataforma digital robusta para a gestão otimizada do compartilhamento de produtos orgânicos. Nosso objetivo estratégico é migrar processos manuais baseados em planilhas e mensagens para um sistema centralizado, de alta performance e escalável.

1.1. Escopo e Fluxo Operacional​

A solução é arquitetada como um par de ambientes integrados dentro do Escopo de Instância:

  • @elo-instance/api (Backend): API REST Fastify lidando com a lógica de negócio, persistência de dados e integrações bancárias.
  • @elo-instance/web (Frontend): React SPA contendo tanto o Painel Administrativo (para gestão de ciclos) quanto a Loja do Cliente (para execução de pedidos).

Fluxo de Ciclo Ponta a Ponta:

  • Configuração do Ciclo: O administrador define e agenda janelas de compra (ciclos) através da interface administrativa do @elo-instance/web. [ESTÁVEL]
  • Ingestão de Produtos: Uma lista de produtos em texto puro é processada por um Parser Inteligente no frontend. [WIP - Refinando Lógica]
  • Abertura de Compras: O catálogo estruturado é habilitado automaticamente para os membros na loja @elo-instance/web. [ESTÁVEL]
  • Execução de Pedidos: Os membros montam cestas personalizadas e enviam seus pedidos. [ESTÁVEL]
  • Processamento de Pagamento: Integração direta com a API do Banco EFI para pagamentos via Pix. [WIP - Fase de Especificação Técnica]
  • Confirmação: O sistema realiza a conciliação bancária e confirma o pedido automaticamente. [WIP]

1.2. Arquitetura e Orientação Técnica​

Todas as decisões arquiteturais, estrutura do projeto e detalhes da stack tecnológica estão centralizados na Visão Geral da Arquitetura.

Phase 2: Diretrizes Operacionais e Padrões​

Todos os fluxos de desenvolvimento, padrões de codificação e requisitos de qualidade estão definidos no Guia de Estilo.

Phase 3: Estimativa de Custos​

3.1. Detalhamento de Custos​

A estratégia "Self-Hosted" na Hetzner Cloud proporciona uma relação custo-benefício altamente favorável e previsível.

Categoria de CustoDetalhesCusto Mensal Estimado
Hospedagem (Hetzner Cloud VPS)Servidor de Alta Performance (Linux VPS) cobrindo containers atuais e futuros.€5.00 a €7.00 (Fixo)
Banco de Dados & CacheUtilização dos recursos próprios da VPS (MongoDB/Redis).Custo Adicional Zero
Gateway de Pagamento (EFI Bank)Taxa fixa por transação Pix recebida.Variável
Domínio e DNSRegistro anual e manutenção.Custo Anual Padrão

3.2. Conclusão Financeira​

A arquitetura selecionada garante previsibilidade total dos custos de infraestrutura. O custo mensal fixo é extremamente baixo, garantindo a sustentabilidade financeira do projeto a longo prazo.

Phase 4: Identidade de Marca & Design System​

O desenvolvimento estratégico da identidade de marca do Elo Orgânico está consolidado na documentação de design especializada.

Phase 5: Fluxograma Operacional​

1. Etapa de Preparação (Administrador)​

  • Acesso: O Administrador acessa as funcionalidades de gestão dentro do @elo-instance/web.
  • Ingestão de Dados: O Admin cola os dados brutos dos produtos. O frontend os estrutura e salva via @elo-instance/api.
  • Abertura de Ciclo: O Admin define as datas e ativa o ciclo.

2. Etapa de Compras (Cliente)​

  • Navegação: O Cliente acessa as funcionalidades da loja dentro do @elo-instance/web.
  • Carrinho & Checkout: Montagem das cestas e envio do pedido.
  • Pagamento: QR Code Pix único gerado pela @elo-instance/api via integração com Banco EFI.

3. Etapa de Fechamento (Admin/Sistema)​

  • Fechamento: Bloqueio automático de novos pedidos no horário limite.
  • Consolidação: O Admin acessa relatórios consolidados no @elo-instance/web para finalizar a logística com os fornecedores.

Phase 6: Escalonamento de Longo Prazo para SaaS (Pós-v1.0)​

6.1. Visão Estratégica​

IMPORTANTE: O foco atual é estritamente nas Fases 1-5 para entregar um produto de instância única polido (@elo-instance/*). O desenvolvimento do SaaS começará apenas após a aplicação principal estar totalmente operacional.

O objetivo de longo prazo é evoluir para uma Plataforma SaaS Multi-tenant:

  • Escopo do Portal (@elo-portal/web & @elo-portal/api): Um ponto de entrada global único para onboarding e descoberta.
  • Múltiplos Pares de Instância (@elo-instance/api & @elo-instance/web): Cada comunidade recebe seu próprio par de ambiente isolado.
  • Bibliotecas Core (@elo-instance/core & @elo-portal/core): Fonte única de verdade (SSOT) específica de domínio para cada escopo.

6.2. Principais Funcionalidades SaaS​

  • Isolamento de Tenant: Dados e configurações independentes para cada instância de comunidade.
  • Autogestão do Produtor: Gestão direta de estoque e preços para os produtores.
  • Gestão de Assinaturas: Níveis de serviço gerenciados via @elo-portal/api.

6.3. Evolução Arquitetural​

  • Implantação Multi-Instância: Criação automatizada de containers @elo-instance/* por tenant.
  • Roteamento Dinâmico: Load balancer global roteando usuários para sua instância de comunidade específica.