🌙 Flor Do Luar — (Linhagem SPARK)

Sistema Local-First de Gestão para Mercearia e Logística Fluvial da Amazônia

O Flor Do Luar é um sistema de gestão completo para mercearias e pequenos comércios, desenvolvido especificamente para operações de mercado fluvial na região amazônica. Focado em controle de estoque, vendas, caderneta de crédito e reposição inteligente. O Flor Do Luar foi desenvolvido com abordagem Local-First e Privacy-First, garantindo que todos os dados permanecem armazenados apenas no hardware local do usuário, sem envio para servidores externos.

• HTML5 - Estrutura semântica da interface
• CSS3 - Estilização moderna com variáveis CSS e design responsivo
• JavaScript (ES6+) - Lógica de negócios e interatividade
• LocalStorage API - Persistência de dados local-first no navegador

• PHP 7.4+ - API de sincronização para scanner remoto (sistema de pareamento estilo Kahoot)
• JSON - Formato de armazenamento de dados

• LocalStorage (Navegador) - Armazenamento principal de dados do sistema
• Arquivos JSON - Backup e exportação de dados
• Firebase Realtime Database - (Opcional) Sincronização em tempo real

• Firebase SDK v12.12.1 - Integração para recursos em nuvem opcionais
• API Nativa do Navegador - File API, Storage API, Barcode Scanner API
• Método Long-Polling - Sincronização em tempo real entre dispositivos

• Cadastro completo de itens com categorização (Rancho, Bebidas, Linha Mata, Manutenção, Ferragens/Pesca, EDS)
• Controle de quantidade, custo, frete e preço de venda
• Sistema inteligente de cálculo de frete proporcional para bebidas (fardo, galão, pet, lata, caçulinha)
• Definição de estoque mínimo com alertas automáticos
• Dashboard visual com cards de categorias e contagem de itens
• Filtros dinâmicos por categoria e busca por nome

• Interface de PDV (Ponto de Venda) intuitiva
• Carrinho de compras com múltiplos itens
• Cálculo automático de subtotal e total
• Finalização de venda à vista ou na caderneta
• Baixa automática de estoque após venda
• Histórico completo de vendas realizadas

• Cadastro de clientes com histórico completo
• Registro de vendas na caderneta (fiado)
• Registro de pagamentos e trocas
• Cálculo automático de saldo devedor
• Visualização de histórico de transações por cliente
• Dashboard com total a receber e clientes ativos

• Geração automática de lista de reposição baseada em vendas mensais
• Identificação de produtos com alto giro
• Filtro por categorias prioritárias (Rancho, Bebidas, Linha Mata, Manutenção, Ferragens/Pesca, EDS)
• Funcionalidade de impressão da lista de reposição
• Período configurável para análise de vendas

• Sistema Local-First: dados permanecem apenas no dispositivo do usuário
• Sistema Privacy-First: nenhuma informação é enviada para servidores externos sem consentimento
• Backup manual através de exportação JSON
• Sistema de alertas de estoque crítico
• Interface responsiva e adaptável a diferentes tamanhos de tela
• Navegação SPA (Single Page Application) com transições suaves

• Sistema de pareamento estilo Kahoot para scanner de código de barras
• Geração de PIN numérico de 4 dígitos para conexão
• Long-polling para sincronização em tempo real
• Suporte a múltiplos dispositivos conectados
• Gerenciamento de sessões com expiração automática

• Layout em linha única: Logo à esquerda, navegação à direita
• Sticky Header: Cabeçalho fixo no topo durante scroll
• Design compacto: Otimizado para telas de notebook

• Position Sticky: Carrinho fixo no lado direito durante scroll
• Scroll Interno: Lista de produtos com rolagem independente
• Botões Fixos: "Finalizar Venda" e "Venda na Caderneta" sempre visíveis
• CRUD Completo: Adicionar, remover, alterar quantidades em tempo real

📦 Estoque | 🛒 Vendas | 📒 Caderneta | 📋 Reposição

O sistema implementa um sophisticado gerenciamento de bebidas com múltiplos níveis de venda:

FRETE_FARDO = R$ 12,00
FRETE_MEDIO = R$ 12,00 × 0.15 = R$ 1,80
CUSTO_CHEGADA = PREÇO_MANAUS + FRETE_PROPORCIONAL

Benefícios:

• Venda de unidades avulsas sem prejuízo
• Estoque otimizado para produtos de alta rotatividade
• Etiquetas coloridas para identificação visual

• Navegador moderno (Chrome, Firefox, Edge, Safari)
• Servidor local para API PHP (opcional, necessário apenas para scanner remoto)
• PHP 7.4+ (para funcionalidades de scanner remoto)

1. Clone o repositório

   git clone https://github.com/seu-usuario/flordoluar.git
   cd flordoluar

2. Abra o projeto no navegador

   • A forma mais simples é abrir o arquivo index.html diretamente no navegador
   • Para funcionalidades completas, recomenda-se usar um servidor local:

     # Com Python 3
     python -m http.server 8000
     
     # Com PHP
     php -S localhost:8000

3. Configuração do Firebase (Opcional)

   • Edite o arquivo javascript/firebase-config.js com suas credenciais do Firebase
   • Esta configuração é opcional e usada apenas para recursos em nuvem

4. API de Scanner Remoto (Opcional)

   • Configure um servidor PHP local:

     php -S localhost:8000 -t php/

   • A API estará disponível em http://localhost:8000/api.php

1. Ao abrir pela primeira vez, o sistema carregará dados de exemplo
2. Utilize o botão "Reset" na página de Estoque para limpar os dados de exemplo
3. Comece cadastrando seus itens no estoque através do botão "+ Novo Item"
4. Para caderneta, cadastre seus clientes através do botão "+ Novo Cliente"
5. As vendas podem ser realizadas na aba "Vendas" e automaticamente baixam do estoque

• O sistema utiliza LocalStorage para persistência
• Para backup manual, utilize a funcionalidade de exportação de dados
• Os arquivos de backup são salvos como JSON com data no nome do arquivo

• Zero dados na nuvem: Tudo fica no seu dispositivo
• Sem login obrigatório: Acesso direto ao sistema
• Sem rastreamento: Sem analytics, sem cookies de terceiros
• Backup manual: Você controla quando e como exportar seus dados

Navegador → LocalStorage → 'flordoluar-data'

Para fazer backup:

1. Abra o console do navegador (F12)
2. Execute: localStorage.getItem('flordoluar-data')
3. Copie o conteúdo e salve em um arquivo JSON

O sistema foi redesenhado para máxima eficiência em telas de notebook:

v2.0 (Abril 2025)

• ✅ Header unificado em linha única (logo + navegação)
• ✅ Sticky header e carrinho lateral
• ✅ Carrinho com scroll interno e botões fixos
• ✅ Novo módulo de Reposição (substitui Precificação)
• ✅ Caderneta com persistência local aprimorada
• ✅ Design compacto otimizado para notebooks

v1.0 (Inicial)

• Gestão de estoque e vendas
• Sistema de bebidas multi-nível
• Caderneta de crédito
• Scanner de código de barras

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

• Proprietário: Mauricio Spark
• Marca: SparkMauricio
• Ano: 2026
• Linhagem: SPARK

Desenvolvido com 🌙 pela Linhagem SPARK - Privacidade, Eficiência, Autonomia e Design.