aprova

Aprova All Toral

Central de aprovação de posts e anúncios do ALL TORAL, com os stickers do Larot.

Roda no Cloudflare (plano grátis): o servidor é um Worker e os dados, artes e vídeos ficam num banco D1.

Como publicar (uma vez só)

  1. Crie a conta grátis em dash.cloudflare.com.
  2. Crie o banco: no menu, Storage & databases → D1 SQL database → Create database. Nome: aprova. Depois de criar, copie o Database ID.
  3. Cole o ID: no GitHub, abra o arquivo wrangler.toml, troque COLE_AQUI_O_DATABASE_ID pelo ID copiado e salve (Commit changes).
  4. Conecte o repositório: no Cloudflare, Workers & Pages → Create → Import a repository, conecte o GitHub e escolha o repositório aprova. Deixe as configurações como vierem (o comando de deploy é npx wrangler deploy) e clique em Deploy.
  5. Crie a senha do painel: acesse https://aprova.<seu-subdominio>.workers.dev/admin. No primeiro acesso aparece a tela Crie a senha do painel. Defina a senha e pronto, você já entra. Nos próximos acessos ela é pedida para entrar.

A partir daí, toda alteração enviada ao GitHub é publicada sozinha. A senha e o banco continuam intactos entre publicações.

Uso no dia a dia

  1. No painel, clique em Novo cliente, marque as redes que o estúdio cuida e salve. Depois envie o logo.
  2. + Nova peça: rede, orgânico ou anúncio pago, formato, artes ou vídeo (com capa), legenda e, se for anúncio, a segmentação.
  3. Salvar rascunho deixa escondido do cliente. Enviar para o cliente publica.
  4. Copiar link do cliente e mande para ele.
  5. Quando pedirem ajuste, edite a peça e use Enviar nova versão para aprovação.

Produtos digitais (sites, páginas de venda e apps)

  1. Em Novo cliente, escolha Produtos digitais e marque o que o estúdio faz (site, página de vendas, aplicativo, sistema).
  2. Na página do cliente, + Nova entrega: tipo, nome e o link do site no ar (GitHub Pages, Netlify, Vercel ou Cloudflare). O link do repositório (github.com) não abre dentro de outra página; o Aprova sugere o endereço do GitHub Pages.
  3. Opcional: envie telas (prints da página inteira). O cliente circula direto na imagem.
  4. O cliente abre o projeto no modo Computador ou Celular, toca em Circular e comentar, circula o ponto e escreve a consideração. Você responde e marca como resolvido. Para mandar os ajustes, edite a entrega e use Enviar nova versão.
  5. Para os círculos ficarem presos no lugar certo quando o cliente rola a página, cole no site, antes do </body>:
<script src="https://SEU-APROVA/embed.js" async></script>

Ele só funciona quando o site está aberto dentro do Aprova. Sem ele, o círculo fica marcado na parte do site que estava na tela.

Guia visual (os dois tipos de cliente)

Na página do cliente, + Guia visual: logo e versões, cores (nome, código e uso), fontes do Google Fonts (com exemplo na fonte de verdade), elementos e aplicações, tom de voz e o que pode e não pode. O cliente abre o guia, comenta cada parte e aprova com os stickers do Larot.

Limites

Instalar como app

O app instalado abre direto na última página usada.

Estrutura

public/          páginas, estilos, stickers e ícones
worker/index.js  servidor: senha, links dos clientes, banco e arquivos
wrangler.toml    configuração do Cloudflare

Para trocar os stickers, substitua os PNG em public/stickers/ mantendo os nomes (aprovado.png, alteracao.png, reprovado.png).

Testar no computador (opcional)

npm install
echo "ADMIN_PASSWORD=teste" > .dev.vars
npm run dev

Atualizações do app

Antes de publicar uma mudança em public/, rode ./scripts/bump-version.sh. Ele marca uma versão nova em public/version.json, e o app aberto nos aparelhos percebe em até 1 minuto e se atualiza sozinho (sem interromper quem estiver preenchendo algo).