CEO / Founder Playbook LoteScan Cloud • Manual Operacional & Guia de Negócios SaaS
← Voltar ao LoteScan
+ LoteScan Enterprise Cloud • Documento Confidencial do Fundador

Manual Operacional & Guia de Negócios SaaS

Arquitetura de nuvem de baixo custo, hierarquia das 3 visões Multi-Tenant, ritual de ativação de novas farmácias em 2 minutos e gestão financeira de receita recorrente (MRR).

Versão: Production v26.0
Arquitetura: Node.js + SQLite WAL
Operação: PC + Bipador USB/Sem Fio
Classificação: Uso Exclusivo CEO
01

Infraestrutura na Nuvem & Operação Real com Bipadores Físicos

Na rotina real de uma farmácia, funcionários não utilizam celulares próprios no salão (prática proibida na maioria das lojas). O LoteScan foi desenhado para operar diretamente nos Computadores de Balcão / Recebimento de Mercadoria integrados aos Bipadores Físicos (USB ou Sem Fio) que a farmácia já possui, além de suportar coletores Android ou o tablet/aparelho corporativo da gerência.

1. Servidor VPS Linux ~R$ 40/mês

  • Provedores: Hetzner Cloud (CX22), Hostinger VPS KVM1 ou DigitalOcean.
  • Configuração: 2 vCPU, 2 GB a 4 GB RAM, 40 GB SSD NVMe com Ubuntu 24.04 LTS.
  • Capacidade: Suporta 50 a 100 lojas ativas com resposta instantânea (2ms a 15ms) a cada disparo do bipador.

2. Domínio .com.br + SSL R$ 40/ano

  • Registro.br: Registre seu domínio oficial (ex.: lotescan.com.br) por R$ 40/ano (~R$ 3,33/mês).
  • DNS Tipo A: Aponte app.lotescan.com.br para o IP público da sua VPS.
  • Zero Instalação Pesada: Roda direto no Chrome/Edge dos PCs da farmácia sem conflitar com o ERP (Linx, Trier, Hórus, Alpha7).

3. Bipador USB / Sem Fio Nativo Plug & Play

  • Captura Global (Keyboard Wedge): O operador bipa a caixa a qualquer momento sem precisar clicar em campos na tela.
  • Fluxo de 2 Segundos no PC: Bipou o produto → digitou MMAA (ex: 1127) + Enter → salvo!
  • Gôndola: Usa bipador sem fio (dongle 2.4GHz/Bluetooth) ou 1 coletor/aparelho corporativo da loja.
# Comandos de Deploy em Produção na VPS (Ubuntu + PM2 + Backup Diário) git clone https://seu-repositorio/lotescan.git /var/www/lotescan cd /var/www/lotescan && npm install --production # Variáveis de ambiente essenciais (.env) PORT=3000 GEMINI_API_KEY=sua_chave_google_ai_studio LOTESCAN_SESSION_SECRET=chave_secreta_longa_aleatoria_producao # Iniciar com PM2 (reinício automático se o servidor reiniciar) npm install -g pm2 pm2 start server.js --name "lotescan-saas" pm2 save && pm2 startup
02

Hierarquia das 3 Visões & Gatilho Secreto do CEO

O sistema possui isolamento lógico rigoroso por unidade (tenant_id) e três níveis de permissão independentes. Nem o balconista nem o gerente/dono da farmácia sabem da existência do painel de controle global do fundador.

Perfil / Nível Quem Utiliza & Acesso Permissões & Blindagens Operacionais
1. Funcionário / Balconista
FUNCIONARIO
Equipe de balcão, estoquistas e conferentes.
Login padrão: operador / 123456
• Acesso focado em Scanner & OCR, Painel FEFO e Cadastro Rápido de Lote.
• Bloqueado: Não pode excluir lotes, não vê relatórios gerenciais nem trilha de auditoria, não exporta banco de dados e não altera catálogo global.
2. Admin / Gerente da Farmácia
ADMIN
Proprietário da farmácia ou Farmacêutico Responsável (RT).
Login padrão: admin / admin123
• Acesso total aos dados exclusivos do seu CNPJ (tenant_id).
• Importa planilhas CSV/Excel do ERP, gerencia equipe da loja, baixa relatórios financeiros FEFO/ANVISA e audita operações dos seus funcionários.
• Blindagem Multi-Tenant: Oculta 100% os eventos de SUPER_ADMIN na auditoria.
3. Super Admin / CEO (Você)
SUPER_ADMIN
Exclusivo do Fundador.
Login: master / Master@LoteScan2026
• Gatilho Secreto (2 formas):
1) Toque 5 vezes rápidas (em até 2s) no ícone da cruz [+] na logo do topo esquerdo.
2) Ou acesse diretamente https://seu-dominio.com.br/?master=1.
• Abre a aba secreta LoteScan Cloud • Administração de Tenants para criar farmácias, monitorar MRR e bloquear inadimplentes em 1 clique.
03

Logística de Ativação de Nova Farmácia em 2 Minutos (PC + Bipador da Loja)

Quando você fecha uma venda com uma nova farmácia, a loja não precisa comprar nenhum equipamento novo nem pedir para funcionários usarem celulares pessoais: o sistema entra rodando nos PCs de Balcão / Entrada de Notas com os próprios Bipadores USB ou Sem Fio da farmácia em menos de 2 minutos:

1
Cadastrar o Tenant no Console SaaS (40 segundos)

Destrave o modo CEO (5 cliques no + da logo ou ?master=1), entre na aba Administração de Tenants e clique em + Cadastrar Unidade. Preencha Razão Social / Nome Fantasia, CNPJ, Cidade/UF, Farmacêutico Gestor e o Plano Contratado (ex.: R$ 149 ou R$ 249/mês). Ao salvar, a unidade já está isolada e ativa.

2
Enviar Kit de Acesso Rápido para o Gerente (30 segundos)

Envie a mensagem abaixo para o gerente abrir nos computadores do balcão/recebimento (já com o bipador plugado):

🚀 *Bem-vindo ao LoteScan — Controle Inteligente de Validades (FEFO & ANVISA)* Sua unidade já está ativa e isolada na nuvem! 🔗 *Link do Sistema (PC do Balcão / Recebimento):* https://app.seudominio.com.br 👔 *Acesso Gerente / Farmacêutico (Admin):* Usuário: admin | Senha: (sua senha) 🥼 *Acesso Terminal de Balcão (Operador):* Usuário: operador | Senha: (senha da equipe) 🔫 *Como operar com o Bipador da Farmácia (USB ou Sem Fio):* 1. Abra o link no computador do balcão/estoque (você pode clicar no ícone de instalar na barra do Chrome/Edge para fixar na Área de Trabalho do Windows). 2. *Não precisa clicar em campo nenhum:* basta bipar a caixa do medicamento com o leitor óptico, digitar os 4 números da validade (*MMAA*, ex: *1127*) e apertar *Enter*! 3. Para auditoria nos corredores/gôndolas, utilize o bipador sem fio (alcance de 30m–50m) ou o coletor/tablet corporativo da loja.
3
Importação de Planilha do ERP + Bipagem Rápida de Entrada (50 segundos)

• Aprendizado em Massa via Planilha: Ao importar uma planilha CSV/Excel exportada do ERP (Linx, Trier, Hórus, Alpha7) no botão Importar Planilha, o LoteScan cadastra os lotes e aprende automaticamente todos os códigos EAN, marcas próprias (Needs, Dauf, Panvel) e etiquetas internas da loja.
• Motor Universal para Bipadores Físicos (1D e 2D): O sanitizador global remove prefixos invisíveis GS1 (]C1, ]d2), corrige CapsLock invertido automaticamente, lê EAN-13, EAN-8, UPC-A, DataMatrix GS1 ANVISA e converte Caixa Master de Distribuidora (DUN-14) automaticamente para a unidade EAN-13!

04

Gestão Financeira, Cobrança Recorrente (Asaas) & Escala de Lucro

Cobrança Recorrente Automática (PIX / Boleto) Asaas / Efí

  • Crie uma conta PJ no Asaas (sem mensalidade fixa; taxa apenas por boleto/PIX pago ~R$ 1,99).
  • Cadastre a farmácia em Assinaturas Recorrentes (mensal, envio automático por WhatsApp e E-mail 5 dias antes do vencimento com QR Code PIX e Boleto).
  • Dica de Ouro (Ancoragem de ROI): Uma única caixa de medicamento ou dermocosmético salva do vencimento (R$ 150 a R$ 400) já paga a mensalidade inteira do LoteScan.

Régua de Inadimplência & Bloqueio em 1 Clique Controle CEO

  • Até 5 dias de atraso: Marque a unidade como Pendente (PENDENTE) no Console SaaS e envie lembrete do PIX no WhatsApp.
  • Mais de 5 dias de atraso: Clique no botão Bloquear (BLOQUEADA) na linha da farmácia dentro do Console SaaS.
  • Efeito Imediato: A loja fica impedida de operar, mas 100% dos lotes e histórico ficam preservados. Pagou o PIX? Clique em Reativar e o acesso volta em 1 segundo.

Simulação Realista de Custos vs. Receita Recorrente Mensal (MRR) — Ticket Médio R$ 199/loja

Escala da Carteira Faturamento Bruto (MRR) Custo VPS + Domínio Custo IA Gemini + PIX Lucro Líquido Mensal Margem Líquida
10 Farmácias R$ 1.990,00 / mês R$ 43,30 ~R$ 25,00 R$ 1.921,70 / mês 96,5%
30 Farmácias R$ 5.970,00 / mês R$ 43,30 ~R$ 75,00 R$ 5.851,70 / mês 98,0%
50 Farmácias R$ 9.950,00 / mês R$ 43,30 ~R$ 125,00 R$ 9.781,70 / mês 98,3%
100 Farmácias (Meta) R$ 19.900,00 / mês R$ 83,30 (VPS 4GB) ~R$ 250,00 R$ 19.566,70 / mês 98,3%