Pular para o conteúdo

Para equipe ilarika

Aplicativos e downloads

  • Super AdminAplicativos e downloads
  • PainelConfiguraçõesAplicativos (selos e QR para o celular da equipe)
  • parceiros.<domínio>/apps (página de download dos apps da loja)
  • parceiros.<domínio> e conta.<domínio>rodapé ("Apps da loja")
  • <domínio>/app (página de download do app do cliente)
  • Marketplacerodapé (selos e "Instalar no celular")
  • entregadores.<domínio>/app (página de download do app do entregador)
  • Entregadoresentrada ("Prefere o app?")

Onde o Super Admin diz de onde cada aplicativo do iLarika é baixado e quando ele passa a aparecer para as pessoas. Cada app tem um público e uma tela só: o lojista vê os apps da equipe em Configurações, o entregador vê o dele na entrada do app, o cliente vê o do marketplace no rodapé. Nenhuma tela mistura os três, porque são situações diferentes.

Os aplicativos

App Público Plataformas Página de download Onde o selo aparece
iLarika Equipe equipe da loja Android, iPhone parceiros.<domínio>/apps Painel › Configurações › Aplicativos; rodapé de parceiros. e conta.
iLarika Negócios para Windows (balcão) equipe da loja Windows parceiros.<domínio>/apps os mesmos do Equipe
iLarika Entregadores entregador Android, iPhone entregadores.<domínio>/app Entrada do app do entregador
iLarika (marketplace) cliente Android, iPhone <domínio>/app Rodapé do marketplace e do cardápio

O app de balcão já nasce publicado, apontando para a última versão em GitHub Releases. Os outros começam sem endereço e sem publicação: até o Super Admin configurar, nenhuma tela mostra nada, nem promessa de app.

Antes de começar

  • Ser superadmin. Outros papéis do Super Admin só consultam.
  • Ter o endereço de download do app naquela plataforma. Vale:
    • Android: a página na Play Store, a release no GitHub ou um APK direto (sempre https://).
    • iPhone: só apps.apple.com (App Store) ou testflight.apple.com (TestFlight). A Apple não permite instalar por outro caminho, e um link que não abre a loja só frustra quem clica.
    • Windows: a release no GitHub ou um instalador direto.

Passo a passo

  1. Super Admin › Aplicativos e downloads. Cada app é um painel, com uma linha por plataforma e o aviso “Aparece em” dizendo em que tela o link vai sair.
  2. Na linha da plataforma, cole o endereço. A tela identifica o canal (Play Store, App Store, TestFlight, GitHub ou direto) e mostra como etiqueta.
  3. Ligue Publicado quando quiser que o link apareça. Pode salvar o endereço sem publicar, para testar antes.
  4. Salvar. A tela do público daquele app passa a mostrar o link na hora (o painel e o entregador em até cinco minutos, pelo cache da lista).
  5. Para desfazer, Voltar ao padrão (só nas linhas que têm padrão, como o app de balcão) ou desligue Publicado e salve.

O que acontece depois

  • GET /public/apps devolve só os apps com pelo menos um download publicado, e só os downloads publicados. É o que as três telas públicas leem.
  • Os botões nunca dizem “TestFlight” nem outro rótulo técnico. Um link testflight.apple.com vira o botão preto da Apple com “Baixar para iPhone”, e embaixo a nota “No iPhone, o app abre pelo TestFlight da Apple (instale o TestFlight quando pedir)”. Um APK (Android fora da Play Store) vira “Baixar para Android”, com a nota de permitir a instalação.
  • No painel, a lista fica em Configurações › Aplicativos com um selo por plataforma. Sem nada publicado, a tela diz para usar o painel pelo navegador.

Cada público tem uma página de download no próprio site (tabela acima). Nenhuma mistura os apps: quem abre <domínio>/app só vê o app do cliente.

  • No celular, a página olha o aparelho e põe o selo da loja certa grande, no topo (App Store no iPhone, Google Play no Android).
  • No computador, entra um QR. Ele abre a mesma página no celular com ?ir=1, e com ?ir=1 no celular a página manda direto para a loja do aparelho. É o link para divulgar: o mesmo endereço serve para Android e iPhone (ex.: <domínio>/app?ir=1 num cartaz, num post, no WhatsApp).
  • Sem app publicado para aquele aparelho, a página não promete nada: no marketplace e no entregador, ensina a instalar pelo navegador (botão “Instalar” no Chrome; no Safari, Compartilhar › Adicionar à Tela de Início); na página da loja, leva ao painel no navegador.
  • Dentro do app, a página diz “Você já está no app”, e os rodapés não mostram selo nenhum.

Os botões de loja (pretos, logo branco e duas linhas, no desenho que todo mundo reconhece: “Baixar na App Store”, “Disponível no Google Play”, “Baixar para iPhone/Android/Windows”) aparecem só para o que está publicado; o do aparelho de quem está vendo vem primeiro, com um anel na cor da marca, e os outros continuam à vista. O nome oficial da loja só aparece quando o link é mesmo da loja. No painel, em Configurações › Aplicativos, o computador mostra também o QR da página da loja, para levar o app ao celular de quem trabalha.

Perguntas comuns

Por que o selo não é a arte oficial do Google e da Apple? A arte oficial tem regras de uso (cores, margens, idioma) e não pode ser recolorida. O selo do iLarika diz o nome da loja com todas as letras e combina com o tema.

parceiros.<domínio>/apps dá 404. Enquanto o DNS de parceiros apontar para o site antigo (GitHub Pages), a página nova, inclusive /apps, não existe ali. Troque o DNS (docs/runbooks/dominios.md); até lá, a mesma página abre em painel.<domínio>/landing/apps.

Posso apontar para uma loja antes de o app estar aprovado? Pode salvar o endereço, mas deixe Publicado desligado até a loja aceitar: um link para uma página que ainda não existe quebra a confiança de quem clica.

Como obrigar quem está numa versão velha a atualizar? Em Super Admin › Versão mínima dos apps: veja Obrigar a atualizar os apps. O que o app nunca mostra (preço, botão de assinar) está em Modo “app nativo”.

O app de uma loja específica aparece no marketplace? Não. O app iLarika é um só e abre o marketplace; dentro dele a pessoa escolhe a loja.

Onde isso fica guardado? Em PlatformSetting, nas chaves apps.<app>.<plataforma>, com { url, publicado }. Apagar a chave volta ao padrão do catálogo em packages/domain/src/aplicativos.ts.