My Rep

Páginas únicas para representantes comerciais. Cada perfil tem uma rota por path: /kp-representacao, /silva-protecao, e assim por diante.

A home (/) é a landing do produto. A lista interna de perfis fica em /representantes (sem link público por enquanto).

Gerador estático: um script Node lê os JSONs e gera /dist. Clientes criam conta (Supabase Auth), assinam na Asaas e usam o painel (/painel/) para montar a página, gerenciar catálogos/logos e compartilhar o cartão. A operação fica no /admin/ (usuários, adimplência, inbox).

Rodar

npm install
npm run geo          # baixa malhas do IBGE → /geo (quando muda UF/cidade)
npm run dev          # http://localhost:3000 + rebuild ao salvar
npm run build        # gera /dist

Node 18+. Com o dev rodando, mudanças em clientes/, template/, publico/, assets-clientes/ ou api/ reconstrói o site.

Estrutura

clientes/              um JSON por representante
template/
  pagina.html          página do representante
  home.html            landing
  cadastro.html        criar conta (email+senha)
  entrar.html          login
  recuperar-senha.html
  painel.html          área do cliente
  admin.html           painel /admin/
publico/
  css/style.css
  js/painel.js         painel do cliente
  js/admin.js          painel admin
api/
  auth/perfil.js       sessão do cliente
  painel/*             checkout, alterações, página, suporte
  asaas/webhook.js     adimplência + assinaturas
  admin.js             KPIs, inbox, usuários, páginas
  _lib/auth.js         Supabase Auth (Bearer)
  _lib/assinaturas.js  espelho local da assinatura
  _lib/inbox.js
assets-clientes/<slug>/
supabase/schema.sql
build.js
dev.js
vercel.json
.env.example

Fluxo do cliente

1. /cadastro/ — cria conta Supabase (email + senha)
2. Escolhe plano → Asaas (checkout no painel)
3. Webhook confirma pagamento → assinaturas + adimplência
4. /painel/ — edita a página, catálogos/logos, suporte e Compartilhar Cartão
5. A página publica em /{slug}/ após configuração no painel

Painel do cliente (/painel/)

Requer login. Fluxo: assinatura → reserva de URL → editor com prévia ao vivo → publicar e compartilhar → suporte.

O painel inclui uma trilha de primeiros passos, ajuda contextual em cada campo (“O que é isso?”) e um manual de uso recolhível no fim da página. As alterações de texto, estados e cores salvam sozinhas; foto, logo e PDF entram ao enviar o arquivo. A página só fica visível para outras pessoas depois de Publicar. A URL escolhida é definitiva.

Painel admin (/admin/)

Login com ADMIN_PASSWORD. Abas:

• Visão geral — MRR, assinaturas ativas, recebido no mês, ticket médio, vencidos; KPIs de páginas
• Caixa de entrada — alterações e suporte (vinculados a user_id quando houver)
• Usuários — contas Auth, assinatura local, página vinculada; vincular slug ↔ e-mail
• Páginas — dono, e-mail de cobrança, adimplência, Automático/Manual
• Assinantes — assinaturas e pagamentos Asaas

Ativação e inadimplência

• Cada página tem email_cobranca, ativo, inadimplente_desde e controle_manual (Supabase representantes ou data/paginas.json).
• Webhook Asaas (PAYMENT_OVERDUE) marca inadimplência; após 3 dias de carência a página desativa sozinha (ativo: false → 404 no middleware).
• Pagamento confirmado reativa automaticamente — exceto se a página estiver em controle manual.
• No admin, Ativar/Desativar entra em controle manual (a automação não altera ativo até Voltar ao automático).
• “Atualizar adimplência” sincroniza com a Asaas respeitando o modo manual.

Rode o supabase/schema.sql atualizado (inclui user_id, tabela assinaturas e RLS). Veja também supabase/README.md para Auth (email/senha) e redirect URLs.

/assinantes/ redireciona para /admin/. /alteracoes/ e /briefing/ redirecionam para /painel/. Em produção a inbox usa mensagens / mensagens_anexos e o bucket privado inbox do Supabase.

Configurar Resend + Vercel

1. Crie conta em resend.com, gere uma API key e (em produção) verifique seu domínio.
2. Copie .env.example → .env e preencha:

SUPABASE_URL=https://xxxx.supabase.co
SUPABASE_ANON_KEY=eyJ...
SUPABASE_SERVICE_ROLE_KEY=eyJ...
RESEND_API_KEY=re_xxxxxxxx
[email protected]
BRIEFING_FROM_EMAIL=My Rep <[email protected]>
[email protected]
ADMIN_PASSWORD=...
ASAAS_API_KEY=...
ASAAS_LINK_MENSAL=...

3. Na Vercel: importe o repo, use build npm run build e output dist (já em vercel.json).
4. Em Settings → Environment Variables, cadastre as variáveis (inclua as do Supabase e ADMIN_PASSWORD).
5. Deploy. Conta: /cadastro/; painel do cliente: /painel/; admin: /admin/.

Em npm run dev sem Supabase, a inbox grava em /inbox/<id>/. Auth de cliente exige Supabase configurado.

Cadastrar um representante novo

1. Crie clientes/nome-do-cliente.json
2. Crie assets-clientes/nome-do-cliente/ com foto, logos e PDFs
3. Rode npm run geo quando incluir UFs novas (baixa malhas municipais usadas nos JSONs)
4. Salve — o site reconstrói sozinho

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗