Pular para o conteúdo

Para equipe ilarika

Página de parceiros

  • parceiros.<domínio> (página pública para restaurantes)
  • parceiros.<domínio>/apps (apps da loja: Equipe e balcão)
  • parceiros.<domínio>/comparar (comparações com outros sistemas e aplicativos)
  • Super AdminDepoimentos da página de parceiros

A página em parceiros.<domínio> é onde um dono de restaurante conhece o iLarika, vê os planos e assina sozinho ou fala com um especialista. Ela tem a cara da página original (a que estava no GitHub Pages: creme, vermelho iLarika, as cenas de celular, notebook e TV) com o que veio depois: planos do Super Admin com checkout, link de afiliado, apps da loja e os acessos de cada público.

O que a página tem

  1. Topo: Soluções, Planos, Quem usa, Dúvidas, Entrar (painel) e Começar agora, que leva aos planos. Ao rolar, a barra fica vermelha.
  2. Herói da original: “Falar com especialista” (abre o WhatsApp de vendas) e “Ver planos”.
  3. Soluções: as cenas da original (App do Garçom, pedido na mesa por QR, atendente de IA no WhatsApp, marketplace, rastreamento, cozinha e gestão, KPIs no bolso e fidelidade, painel de retirada na TV). Cada uma tem “Falar com especialista”. A cena do tablet na mesa com catraca saiu (não existe no sistema hoje) e a da rede de entregadores também (a rede está fechada, ver entregas/entregadores-da-rede.md). O que depende de plano vem marcado: a atendente de IA (“Essencial e Pro”) e o cliente acompanhando o entregador no mapa (“só no plano Pro”). Dentro das molduras de celular, notebook e TV vão telas de verdade do sistema, tiradas de uma loja de demonstração (Cantina Bonomi). Só o celular do cliente no WhatsApp continua desenhado, porque ali o app é o WhatsApp dele; a conversa é a mesma que aparece no painel ao lado. O texto de cada cena diz só o que o sistema faz hoje.
  4. Planos: exatamente o que o Super Admin publicou (GET /public/planos).
    • Anual | Mensal, com o anual escolhido. No anual, o cartão mostra o preço por mês grande (“R$ 99/mês”), “cobrado anualmente: R$ 1.188 (Pix ou até 12x sem juros no cartão)” e a economia sobre 12 mensalidades (“2 meses grátis · economize R$ 250,80 por ano”). No mensal, o preço do mês e “cobrado todo mês · cartão de crédito”.
    • Como pagar segue formasDePagamento de GET /public/planos: sem Pix Automático, mensal = “cartão de crédito” e anual = “Pix ou até 12x sem juros no cartão”; com o Pix Automático ligado no Super Admin, mensal = “cartão ou Pix Automático” e anual = “Pix, Pix Automático ou até 12x sem juros no cartão”. Boleto não aparece.
    • O plano em destaque no Super Admin (Essencial) ganha Mais escolhido.
    • Com teste no preço (e a cobrança ligada): “7 dias grátis — cadastre o cartão, cancele quando quiser antes do fim do teste e não paga nada”.
    • O que cada plano inclui vem das capacidades do plano: só o que está ligado (nada de “em breve” nem “não disponível”). O primeiro plano abre com o que toda loja tem; os seguintes dizem “Tudo do , e mais:”. A atendente com IA aparece com os atendimentos do mês (“300 atendimentos por mês”); o cliente acompanhando o entregador leva a marca Pro.
    • Embaixo dos planos: “Pacotes extras a partir de R$ 49,90 (100 atendimentos), que não vencem” e o preço do atendimento excedente (“Sem pacote, cada atendimento a mais custa R$ 0,60, na fatura seguinte”). Mais abaixo, “Ficou em dúvida? Fale com um especialista · Já tem loja? Entrar no painel”.
    • Assinar com 7 dias grátis (ou Assinar, sem teste no preço) leva ao checkout com plano e ciclo (conta.<domínio>/assinar?plano=essential&ciclo=year, mais o ref; veja assinar.md).
    • Rede (sob consulta): sem preço, Fale com a gente abre o WhatsApp do suporte da plataforma (o número da instância platform-support, que a API devolve em contato.whatsapp; sem ele, o WhatsApp de vendas).
    • Sem resposta da API, a seção diz que não conseguiu carregar e oferece conversar: a página nunca inventa plano nem preço.
  5. Quem usa, indica: os depoimentos publicados em Super Admin › Depoimentos da página de parceiros (Depoimentos da página de parceiros). Sem nenhum publicado, a seção e o link “Quem usa” do topo não aparecem.
  6. Perguntas frequentes (as da original, mais “Posso assinar sozinho, pelo site?” e “Minha loja aparece no Google e nas IAs?”) e a faixa final, com “Prefere que a gente te chame?”.
  7. Rodapé vermelho: Produtos, iLarika (Soluções, Planos, Dúvidas, Acesso por IA, Seja afiliado), Acessos (painel, marketplace, cliente) e os selos dos apps da loja. “Rede de entregadores” e “Sou entregador” só aparecem com a rede aberta na plataforma (redeDeEntregadores em GET /public/planos).

“Falar com especialista” abre o WhatsApp de vendas, (27) 99807-9104 (outro número no build: VITE_LANDING_WHATSAPP_URL). “Prefere que a gente te chame?” grava o interesse na API (POST /public/landing/leads) e depois abre a conversa já escrita.

Quais planos aparecem

A vitrine é o catálogo comercial (Super Admin › Produtos, preços e cupons): aparece o produto do tipo plano que está Na vitrine, não arquivado e com preço ativo mensal ou anual. Plano sem preço só aparece se estiver marcado Sob consulta (sem checkout). O checkout recusa plano sem preço ou sob consulta, então um link antigo não cria loja de graça. O plano em destaque no Super Admin ganha o selo “Mais escolhido”. Hoje: Starter, Essencial, Pro e Rede (super-admin/produtos-e-cupons.md).

Aberta por ?ref=<código> (ou pelo /r/<código>, que grava o cookie ilrk_ref), a página confere o código (GET /public/afiliados/:code) e mostra “Indicado por . Link de indicação ativo.” (sem o nome, se o afiliado não quis aparecer) e leva o código no checkout, no marketplace, na conversa do WhatsApp e no “a gente te chama”. O login não leva o código: quem já tem conta não é indicação.

Loja de demonstração

Com VITE_LANDING_DEMO_SLUG preenchido no build, a página mostra “Abra a loja de demonstração” apontando para <slug>.<domínio>. A loja precisa existir, estar ativa e marcada como loja de teste no Super Admin (fica fora do marketplace e sem indexação).

Como atualizar a página

  • Entrou ou saiu um recurso do produto: edite apps/landing-web/src/recursos.ts no mesmo PR. Todo item precisa de prova: { capacidade: '<chave do catálogo>' } ou { arquivo: '<caminho no repo>' }. O teste recursos.test.ts confere.
  • Mudou preço ou plano: no Super Admin (Produtos, preços e cupons e Planos e recursos). A página lê de lá; não há preço no código.
  • Mudou o texto ou uma cena da original: apps/landing-web/src/App.tsx (herói, planos, depoimentos, dúvidas, rodapé) e apps/landing-web/src/antiga/solucoes.html (as cenas). As perguntas frequentes também estão no JSON-LD do index.html; o teste confere que as duas listas batem.
  • Mudou uma tela do sistema: troque a imagem em apps/landing-web/src/antiga/assets/telas/ pelo mesmo nome (tela-*.webp). Celular: 356×624 (captura em 360×664 com zoom 2, cortada no pé); notebook: 916 de largura; TV: 844; marketplace no computador: 800. Use só dados de demonstração, nunca de loja ou cliente de verdade.
  • Mudou domínio: VITE_PUBLIC_BASE_DOMAIN no build; canonical, robots.txt, sitemap.xml e llms.txt são gerados dele.
  • Depoimentos: só pelo Super Admin, e só com autorização por escrito de quem deu. Nunca escreva depoimento, nota ou número de clientes no código.

Onde ela é servida

A API serve o build de apps/landing-web em /landing em qualquer host e na raiz do host parceiros.<domínio> (ver docs/runbooks/dominios.md).

Buscadores e IAs

Os robôs das IAs (ChatGPT, Claude, Perplexity) não rodam JavaScript; o Google roda, mas indexa pior. Por isso o que importa já sai escrito no HTML:

  • Página de parceiros: o build desenha a página inteira no index.html (o texto todo, ~1.200 palavras). Os planos não entram no build, porque o preço vem do Super Admin: a API troca o “Carregando os planos…” pelos planos e preços de agora e acrescenta as ofertas em schema.org. O llms.txt sai com os planos no fim. Mudou preço no Super Admin? Vale em até 5 minutos, sem deploy.
  • Marketplace (<domínio>): título e descrição com as cidades, a lista das lojas por cidade e os dados estruturados (WebSite e ItemList).
  • Cada loja (<slug>.<domínio>): título com as duas primeiras categorias do marketplace e a cidade (“BomBar — Lanches e Hambúrguer em Aracruz | Cardápio e delivery”; a descrição cita todas as categorias e o bairro), descrição, endereço, horário e o cardápio com preço, mais o Restaurant em schema.org. Loja de teste continua com noindex. Gente e robô recebem o mesmo HTML; o app substitui o conteúdo ao abrir.
  • robots.txt, sitemap.xml e llms.txt existem nos três: o sitemap do marketplace lista todas as lojas (fora as de teste), e o robots.txt aponta o sitemap, que é como o Google os acha sozinho.
  • Na seção de recursos, “Site próprio que o Google e as IAs encontram” e a pergunta “Minha loja aparece no Google e nas IAs?” vendem isso ao dono.
  • Uma loja pode estar em várias categorias do marketplace (antes eram 3), e todas entram no SEO dela. Em distrito, a cidade é o município e o distrito vai no bairro (o botão “Estou na loja” já preenche assim).
  • No Cloudflare, os robôs de IA (inclusive os de treinamento) estão liberados: não reative “Bloquear bots de IA” nem o robots.txt gerenciado, ou as IAs voltam a não ler o site.

Comparativos com outros sistemas

parceiros.<domínio>/comparar lista os sistemas e aplicativos mais conhecidos (iFood, Anota AI, Saipos, Goomer e Aiboo) ao lado do iLarika, com preço, para quem cada um serve e perguntas comuns. Cada um tem a sua página (/comparar/ifood, /comparar/anota-ai, /comparar/saipos, /comparar/goomer, /comparar/aiboo) com tabela, diferenças, para quem cada produto é melhor, perguntas, conclusão e fontes. O rodapé da página de parceiros leva até lá (“Comparativos”), e elas estão no sitemap.xml e no llms.txt.

Servem para o dono que pesquisa “iLarika ou iFood” no Google e para as IAs, que citam esse tipo de página quando alguém pede uma recomendação. São HTML puro, sem JavaScript.

  • O texto mora em apps/landing-web/src/comparativos/dados.ts. Para incluir um concorrente, acrescente uma entrada lá; a página, o índice, o sitemap e o llms.txt saem sozinhos no build.
  • Só fato com fonte pública. Cada página mostra as fontes e a data da conferência (verificadoEm). Preço de concorrente muda: reveja a cada 3 meses e atualize a data.
  • Diga onde o outro é melhor (nota fiscal, integração com aplicativos, tablet e totem). Página que só elogia a casa não convence nem é citada.
  • Preço do iLarika não é escrito à mão: o texto usa {starter}, {essencial} e {pro}, e a API troca pelo preço do Super Admin de agora. Mudou o preço? Vale em até 5 minutos, sem deploy.
  • O robots.txt da página de parceiros libera pelo nome os robôs das IAs (ChatGPT, Claude, Perplexity, Gemini).

Apps da loja

O rodapé mostra os selos dos apps da loja que estão publicados (o app de balcão para Windows já sai publicado) e o link Apps da loja, que abre parceiros.<domínio>/apps: a página de download do iLarika Equipe e do app de balcão, com o QR para o celular e o link que vai direto para a loja certa. Detalhes em aplicativos.md.