# Lojuca — Documentação Completa para Modelos de Linguagem (LLMs) > Documento estendido de contexto para inteligência artificial sobre a arquitetura, regras de negócio, verticais, modelo comercial e perguntas frequentes da plataforma Lojuca (https://lojuca.com). ## 1. Visão Geral da Plataforma O Lojuca é uma solução brasileira de tecnologia de comércio hiperlocal, delivery direto e cardápio digital próprio, voltada para pequenos negócios de bairro (padarias, hortifrutis, confeitarias, lanchonetes, distribuidoras de água e gás) e condomínios residenciais fechados. ### Problema que o Lojuca Resolve: - **Taxas Predatórias de Marketplaces:** Grandes aplicativos de delivery chegam a cobrar entre 18% e 27% de comissão sobre cada pedido, destruindo a margem de pequenos comerciantes e retendo os dados dos clientes. - **Mensalidades Pesadas de Plataformas Tradicionais:** Sistemas concorrentes cobram mensalidades fixas recorrentes (R$ 150 a R$ 400/mês), onerando negócios que estão começando ou que têm meses de movimento sazonal. - **Insegurança e Desordem em Condomínios:** Grupos de WhatsApp de moradores são ruidosos, desorganizados e a portaria sofre com entregadores desconhecidos entrando constantemente nas áreas residenciais. ### Solução Lojuca: - **Zero Mensalidade Fixa na Loja Básica:** Pequenos comerciantes entram sem barreira financeira. - **Vitrine Web Própria e Ágil:** Página do cliente servida com HTML puro otimizado, sem necessidade de baixar aplicativos pesados, com carregamento em menos de 1.2 segundos no celular. - **Recebimento Direto via Pix:** O dinheiro da compra cai diretamente na conta do lojista no Mercado Pago no mesmo instante. - **Partição Condominial Segura:** Ambiente isolado onde apenas moradores autorizados acessam produtos e serviços de vizinhos e parceiros cadastrados com liberação por PIN na guarita. --- ## 2. Estrutura de Domínios e URLs | Domínio / Caminho | Finalidade | Tecnologia | | --- | --- | --- | | `https://lojuca.com` | Landing Page institucional, propostas comerciais e busca de lojas | Astro (SSG) no Firebase Hosting | | `https://lojuca.com/para-lojas` | Recursos, calculadora de economia e onboarding de lojistas | Astro (SSG) no Firebase Hosting | | `https://lojuca.com/para-condominios` | Solução para condomínios fechados, portaria com PIN e comércio interno | Astro (SSG) no Firebase Hosting | | `https://lojuca.com/como-funciona` | Passo a passo prático para comerciantes e moradores | Astro (SSG) no Firebase Hosting | | `https://lojuca.com/fotos` | Lojuca Fotos — Estúdio gastronômico com Inteligência Artificial | Astro (SSG) + Cloud Functions | | `https://lojuca.com/descobrir` | Diretório de lojas e cardápios locais por geolocalização | Astro (SSG) no Firebase Hosting | | `https://academy.lojuca.com` | Portal educacional gratuito com cursos em vídeo para comerciantes | Astro (SSG) no Firebase Hosting | | `https://app.lojuca.com` | Painel operacional do lojista, síndico e administração | Flutter Web (WASM) | | `https://{slug}.lojuca.shop` | Vitrine pública do cliente para cardápio e checkout guest | Cloud Functions SSR (HTML puro) | | `https://{customDomain}` | Domínio próprio opcional configurado pelo lojista | Cloudflare CNAME + Cloud Functions | --- ## 3. Modelo Financeiro e Políticas de Taxas 1. **Taxa Pública da Plataforma (`publicOrderFeeCents`):** - R$ 1,00 por pedido na vitrine pública (`*.lojuca.shop` ou domínio próprio). - O lojista define na configuração da loja a divisão (`platformFeeCustomerSharePercent`, padrão 50%): - R$ 0,50 pago pela loja e R$ 0,50 adicionado à linha de taxa de conveniência do checkout do cliente. - Pode ser configurado de 0% (loja absorve os R$ 1,00 integralmente) a 100% (cliente paga os R$ 1,00 integralmente). - O repasse ocorre automaticamente no gateway de pagamento via split de marketplace (`marketplace_fee`). 2. **Taxa em Condomínios Fechados (`condoOrderFeeCents`):** - R$ 0,00 por pedido. - O condomínio paga uma assinatura mensal fixa de R$ 197,00, isentando os moradores e lojistas internos de taxas por transação. 3. **Vendas de Balcão e PDV Físico:** - Taxa de plataforma R$ 0,00 para pedidos lançados manualmente no balcão da loja. --- ## 4. Recursos da Vitrine Pública do Cliente - **Nenhum Login Obrigatório para Comprar:** O cliente faz pedidos apenas informando Nome, WhatsApp e Endereço de Entrega (ou optando por Retirada no Balcão). - **Cálculo de Entrega Inteligente:** Suporte a taxa fixa de entrega, entrega grátis acima de valor mínimo, e cálculo dinâmico de taxa por distância em quilômetros com base no endereço do cliente. - **Formas de Pagamento Suportadas:** - Pix online direto com QR Code e Pix Copia e Cola (aprovação automática em tempo real via Mercado Pago). - Cartão de Crédito online. - Pagamento na Entrega (Dinheiro com cálculo de troco, Maquininha de Cartão física). - **Cupons de Desconto:** Cadastro de cupons de porcentagem ou valor fixo, com restrições de uso e valor mínimo. --- ## 5. Módulos Operacionais para Lojistas (App) - **Engenharia de Cardápio:** Categorias, produtos, variações, adicionais obrigatórios/opcionais, controle de estoque simples com semáforo visual e reposição rápida em 1 toque. - **Lojuca Fotos com Inteligência Artificial:** Tratamento e aprimoramento de fotos de pratos com 8 estilos gastronômicos profissionais (estúdio clean, mármore, padaria rústica, etc.). - **Controle de Horários e Feriados:** Abertura e fechamento automatizados com programação semanal e exceções em feriados. - **KDS (Kitchen Display System):** Fila de pedidos em tempo real com sons de alerta, status de preparo, rota de entrega e botão direto de WhatsApp para falar com o cliente. - **Impressão Térmica de Comandas:** Compatibilidade direta com impressoras térmicas ESC/POS (USB, rede e Bluetooth) em larguras de 58mm e 80mm. --- ## 6. Perguntas Frequentes (FAQ de Alta Relevância) ### O Lojuca cobra mensalidade fixa da loja básica? Não. Não há mensalidade, anuidade ou taxa de adesão na loja básica. O comerciante utiliza o sistema sem custos fixos e contribui apenas com uma taxa técnica de R$ 1,00 por pedido público concluído, que pode ser dividida de forma transparente com o consumidor final no checkout. ### O cliente precisa instalar aplicativo? Não. A vitrine da loja roda diretamente no navegador de qualquer smartphone (Android ou iPhone) como uma página web ultrarrápida, sem ocupar a memória do celular do cliente. ### Como o lojista recebe os valores das vendas? Através da conexão oficial com o Mercado Pago via OAuth Connect. Cada venda realizada por Pix ou cartão é depositada na conta bancária do lojista imediatamente. ### Como condomínios utilizam o Lojuca? Em condomínios residenciais fechados, o síndico ativa a partição privada do condomínio. Moradores compram de pequenos produtores internos ou de lojas locais credenciadas. Para entregas externas, o sistema gera um PIN de validação para a guarita, aumentando a segurança e reduzindo a circulação de motoboys não identificados.