ELWO

Plataforma SaaS multi-tenant para pizzarias, lojas de alimentação e delivery: pedidos multicanal (canal próprio e iFood), cardápio, mesas e comandas, entregas, estoque, financeiro, relatórios, marketing e loja online do cliente final.

Estado atual: protótipo de frontend exportado do Google AI Studio, funcionando com dados mock (src/mockData.ts). Ainda não existe backend, banco ou autenticação real. A arquitetura-alvo (monólito modular, API-first, PostgreSQL, multi-tenant) está documentada no projeto de arquitetura do ELWO. Ver CLAUDE.md.

Rodando localmente

Pré-requisitos: Node.js 20 ou superior.

npm install
npm run dev      # http://localhost:3000

Outros comandos:

npm run lint     # checagem de tipos (tsc --noEmit)
npm run build    # build de produção
npm run preview  # servir o build localmente

Variáveis de ambiente

Copie .env.example para .env.local e preencha o que for necessário. Nenhuma chave real vai para o repositório.

Estrutura

São duas aplicações no mesmo código e na mesma origem: o painel da pizzaria em / e a loja online do cliente em /loja. Cada uma tem seu próprio ponto de entrada; não existe roteador.

Mesma origem é requisito, não preferência: enquanto não há backend, cardápio e pedido sincronizam por localStorage, que é por origem. Separar em domínios ou subdomínios quebra a sincronia.

index.html                   entrada do admin      -> src/main.tsx
loja/index.html              entrada da loja       -> src/main-loja.tsx

src/
  main.tsx  main-loja.tsx    bootstrap do React
  ErrorBoundary.tsx
  index.css                  estilos globais
  styles/                    tokens de design
  assets/images/             imagens do protótipo

  admin/                     painel da pizzaria
    App.tsx                  roteamento de telas do admin
    layout/                  Header, Sidebar
    modules/                 telas por módulo (Início, Cardápio, Mesas, Entregas, ...)
    modules/dashboard/       blocos do dashboard
    orders/                  fluxo de pedidos: modais, drawers, despacho, roteirização
    dashboard/               KanbanBoard
    utils/                   routeOptimizer

  loja/                      loja online do cliente final (white-label)
    LojaApp.tsx
    LojaClientePWA.tsx

  shared/                    usado pelos dois lados
    types.ts                 tipos do domínio
    mockData.ts              dados mock do protótipo (será substituído pela API)
    ui/                      componentes base (Button, FormModal, MetricCard, ...)
    data/                    catalogStore, orderStore, deliverySettingsStore
    pricing/                 regra de preço de meia a meia
    ProductDetailWizard.tsx  montador de pizza

O que está em shared/ está lá porque precisa ser único. O preço de uma pizza meia a meia é calculado em shared/pricing/halfAndHalf.ts: se a loja e a Central usassem cada uma a sua regra, o mesmo pedido fecharia com valores diferentes e a diferença apareceria na baixa.

Alias de import: @/ aponta para src/.

Documentação

• CLAUDE.md — regras do projeto, decisões de arquitetura, vocabulário do domínio.
• AGENTS.md — regras visuais herdadas do protótipo.
• Documentação de arquitetura completa (documento mestre, ADR Log, Visão C4, Cenários de Execução, Glossário): projeto "Arquitetura Sistema ELWO".

Licença

Software proprietário. Copyright © 2026 ELWO. Todos os direitos reservados.