# Material de publicação — Extensão AssinaPro

Este documento reúne tudo o que as lojas pedem para publicar a extensão. Copie e cole nos formulários oficiais.

---

## 1. Contas de desenvolvedor

| Loja | URL de cadastro | Custo | Prazo médio |
|---|---|---|---|
| **Chrome Web Store** | https://chrome.google.com/webstore/devconsole | **US$ 5 (taxa única, vitalícia)** | 1–3 dias úteis |
| **Microsoft Edge Add-ons** | https://partner.microsoft.com/dashboard/microsoftedge | Grátis | 1–7 dias úteis |
| **Firefox Add-ons (AMO)** | https://addons.mozilla.org/developers/ | Grátis | Automático (auto-review) |

> Só a Chrome Web Store tem custo. O mesmo `.zip` (`public/assinapro-extension.zip`) serve para as três lojas.

---

## 2. Metadados da listagem

### Nome
```
AssinaPro — Assinatura de e-mail com 1 clique
```

### Nome curto
```
AssinaPro
```

### Descrição resumida (até 132 caracteres)
```
Instale sua assinatura profissional no Gmail, Outlook e Yahoo Mail com 1 clique. Sincronize com sua conta AssinaPro.
```

### Descrição completa

```
Chega de copiar e colar assinatura toda vez que você troca de máquina ou reinstala o navegador. A extensão AssinaPro instala sua assinatura de e-mail profissional direto no editor do seu webmail — em um clique, sem quebra de formatação.

✨ Funciona em:
• Gmail (mail.google.com)
• Outlook Web (outlook.live.com, outlook.office.com, outlook.office365.com)
• Yahoo Mail (mail.yahoo.com)
• Outros webmails (Zoho, Titan, Locaweb, cPanel/Roundcube) — badge flutuante quando detecta o campo de assinatura

🔒 Privacidade em primeiro lugar:
• Não lemos, salvamos ou enviamos o conteúdo dos seus e-mails.
• Não capturamos digitação, cliques, formulários ou senhas.
• Sua sessão fica no armazenamento local do navegador.
• Comunicação exclusivamente via HTTPS com o servidor AssinaPro.

⚡ Como usar:
1. Crie sua assinatura no painel AssinaPro (assinatura.fusaoweb.com.br).
2. Instale a extensão e faça login (a aba fecha sozinha após o login).
3. Abra a tela de assinatura do seu webmail e clique no botão roxo "Instalar assinatura".

🎨 Sincronização automática:
Editou a assinatura no painel? Reabra o webmail e clique de novo — a versão mais recente é aplicada, com HTML otimizado para máxima compatibilidade em qualquer cliente de e-mail.

🏢 Para empresas:
Ideal para times que precisam padronizar assinaturas de vários colaboradores. Cada usuário instala uma vez e recebe sempre a versão aprovada.

Precisa de uma conta? Crie grátis em https://assinatura.fusaoweb.com.br

Suporte: contato@fusaoweb.com.br
Privacidade: https://assinatura.fusaoweb.com.br/extensao/privacidade
```

### Categoria
- Chrome Web Store: **Ferramentas** (Productivity)
- Edge Add-ons: **Produtividade**
- Firefox AMO: **Other**

### Idioma principal
Português (Brasil) — pt-BR

### Idiomas adicionais suportados
Português (Portugal), Espanhol, Inglês (interface principal em pt-BR; textos técnicos entendíveis nos três)

---

## 3. URLs obrigatórios

| Campo | URL |
|---|---|
| Página inicial | https://assinatura.fusaoweb.com.br/extensao |
| Política de privacidade | https://assinatura.fusaoweb.com.br/extensao/privacidade |
| Suporte / Contato | mailto:contato@fusaoweb.com.br |
| Site do desenvolvedor | https://assinatura.fusaoweb.com.br |

---

## 4. Justificativa das permissões (Chrome Web Store exige)

| Permissão | Justificativa (copie e cole) |
|---|---|
| `storage` | Armazena localmente o token JWT emitido pelo AssinaPro após o login, para que o usuário não precise entrar de novo a cada uso. Nenhum outro dado é salvo. |
| `activeTab` | Necessária para injetar a assinatura no editor do webmail quando o usuário clica no botão "Instalar assinatura". A extensão só age sob clique. |
| `scripting` | Permite executar o script que preenche o editor rich-text da aba ativa com o HTML da assinatura. |
| Host permission `mail.google.com` | Injeta o botão "Instalar assinatura" na tela Configurações → Assinatura do Gmail. |
| Host permission `outlook.live.com`, `outlook.office.com`, `outlook.office365.com` | Injeta o botão na tela Configurações → Email → Redigir e responder do Outlook Web. |
| Host permission `mail.yahoo.com` | Injeta o botão na tela Configurações → Escrevendo email do Yahoo Mail. |
| Host permission `assinatura.fusaoweb.com.br` | Captura o token da sessão Supabase quando o usuário completa o login no painel AssinaPro dentro da aba de bridge. Sem essa permissão, o login não é finalizado. |
| Content script em `<all_urls>` (excluindo os provedores acima) | Script "genérico" que só ativa quando a página tem um campo com rótulo "assinatura"/"signature" (Zoho, Titan, Locaweb, cPanel Roundcube). Não lê nem envia conteúdo da página. |

### Justificativa de uso remoto de código
```
A extensão NÃO carrega código remoto. Todo o JavaScript é bundleado no pacote publicado. As únicas requisições HTTP são chamadas de API para o próprio backend do AssinaPro (assinatura.fusaoweb.com.br) para buscar as assinaturas cadastradas do usuário autenticado.
```

---

## 5. Assets visuais

Todos gerados em `extension/store-assets/`:

| Asset | Dimensões | Arquivo | Uso |
|---|---|---|---|
| Ícone da extensão | 128×128 | `extension/icons/icon-128.png` | Todas as lojas |
| Tile promocional pequeno | 440×280 | `store-assets/promo-small-440x280.png` | Chrome Web Store (obrigatório) |
| Marquee/banner | 1400×560 | `store-assets/marquee-1400x560.png` | Chrome Web Store (opcional, aumenta destaque) |
| Screenshots | 1280×800 ou 640×400 | **A capturar** — instruções abaixo | Chrome/Edge/Firefox (mín. 1, ideal 3–5) |

### Como capturar screenshots (1280×800 recomendado)
1. Instale a extensão em modo desenvolvedor.
2. Abra o navegador em 1280×800 (Chrome DevTools → Device Toolbar → Responsive → 1280×800).
3. Capturas sugeridas:
   - **01-gmail.png** — Gmail em Configurações → Assinatura com o card roxo "Instalar assinatura" visível.
   - **02-outlook.png** — Outlook Web em Configurações → Email → Redigir e responder com o card visível.
   - **03-yahoo.png** — Yahoo Mail em Configurações → Escrevendo email com o card visível.
   - **04-popup.png** — Popup da extensão aberto mostrando "Conectado como <usuário>" + lista de assinaturas.
   - **05-resultado.png** — E-mail sendo composto no Gmail com a assinatura já preenchida.

Salve em `extension/store-assets/screenshots/`.

---

## 6. Passo a passo Chrome Web Store

1. Acesse https://chrome.google.com/webstore/devconsole e pague os US$ 5 (uma vez só).
2. Clique em **Novo item** e faça upload de `public/assinapro-extension.zip`.
3. Preencha na aba **Loja**:
   - Descrição resumida e completa → seção 2 acima.
   - Categoria → **Ferramentas**.
   - Idioma → Português (Brasil).
   - Imagem do ícone → detectado automaticamente do manifest.
   - Tile pequeno → `store-assets/promo-small-440x280.png`.
   - Marquee → `store-assets/marquee-1400x560.png`.
   - Screenshots → mínimo 1.
4. Aba **Privacidade**:
   - Uso pretendido → descreva conforme seção 4.
   - Justificativa de cada permissão → seção 4.
   - URL da política de privacidade → https://assinatura.fusaoweb.com.br/extensao/privacidade.
   - Certificar as declarações no fim do formulário.
5. Aba **Distribuição**:
   - Visibilidade: **Público**.
   - Preço: **Grátis**.
   - Regiões: **Todas**.
6. Clique em **Enviar para revisão**. Prazo típico: 1–3 dias úteis.

---

## 7. Passo a passo Microsoft Edge Add-ons

1. Acesse https://partner.microsoft.com/dashboard/microsoftedge e crie a conta grátis.
2. **Overview → Create new extension** → faça upload do mesmo `.zip`.
3. Preencha metadados (mesmos textos da seção 2, mesmas imagens da seção 5).
4. Envie para revisão.

---

## 8. Passo a passo Firefox AMO

1. Acesse https://addons.mozilla.org/developers/addon/submit/ e faça login.
2. Escolha **On this site** para hospedagem.
3. Faça upload do mesmo `.zip`.
4. O AMO valida o manifest automaticamente. Se apontar warnings de permissões amplas (`<all_urls>`), justifique com o texto da tabela em seção 4 e defenda que o script genérico só ativa sob condição de campo detectado.
5. Preencha descrição + screenshots + política de privacidade → publicar.

---

## 9. Checklist antes de submeter

- [ ] `manifest.json` versão bumpada (atualmente **1.1.0**).
- [ ] `.zip` gerado a partir do diretório `extension/` sem arquivos ocultos.
- [ ] Ícones 16/32/48/128 presentes.
- [ ] Página inicial (`/extensao`) e privacidade (`/extensao/privacidade`) acessíveis publicamente.
- [ ] Screenshots capturados em 1280×800.
- [ ] Descrição sem menção a marcas registradas de forma que sugira endosso (não dizer "extensão oficial do Gmail").
- [ ] Conta de desenvolvedor Chrome com pagamento confirmado.

---

## 10. Depois de aprovado

- Copie os IDs/URLs oficiais das lojas.
- Atualize `src/components/install/ExtensionInstallCard.tsx`: preencha `stores.chrome.href`, `stores.edge.href` e `stores.firefox.href` com os links reais. O card já detecta o navegador e mostra o botão certo automaticamente.
