# Manual da Emissora — E-radios

> Plataforma E-radios — Marketplace B2B de publicidade em rádio programática.
>
> Este manual é dedicado ao **dono/administrador da conta de emissora** (broadcaster owner).
> Para vendedores (sub-usuários "sales"), consulte o [Manual do Vendedor](vendedor.md).

---

## 1. Introdução

O E-radios é o marketplace B2B onde sua emissora vende espaços publicitários (inserções, patrocínios e combos) para anunciantes e agências de todo o Brasil.

Como dono da conta de emissora (**broadcaster owner / manager**) você tem controle total sobre:

- Cadastro e perfil público da rádio
- Catálogo de produtos (inserções / spots) e patrocínios
- Combos pré-definidos para acelerar propostas
- Pedidos recebidos via marketplace
- Propostas comerciais enviadas por você ou pela sua equipe
- Equipe de vendedores (até o limite definido pela equipe E-radios)
- Metas, relatórios e calendário

> ℹ️ **Nota:** Este manual cobre o que **você, dono da emissora**, pode fazer. Ações que dependem da equipe E-radios (aprovação de cadastro, validação de mudanças sensíveis de perfil, aprovação de pedidos pagos por faturamento) são mencionadas de forma resumida.

### Hierarquia de usuários na sua conta

| Quem | O que faz |
|------|-----------|
| **Você (Manager / dono)** | Acesso total. Cadastra produtos, gerencia equipe, vê todos os relatórios e propostas. |
| **Vendedor (Sales / sub-usuário)** | Você convida até o limite permitido. Por padrão só vê Propostas, Clientes e Minha Conta (permissões ajustáveis por grupo). |

---

## 2. Cadastro da Emissora

### Como funciona

Diferente de anunciantes e agências (que se auto-cadastram), o cadastro de emissora **é feito sob aprovação da equipe E-radios**. Você manifesta interesse pelo formulário público e a equipe entra em contato para validar dados, contratos e ativar sua conta.

### Como acessar

- Tela de login → link **"Criar conta"** → **"Sou Emissora"**
- Rota: `/register/broadcaster`

### Etapas do cadastro público

#### Etapa 1 — Tipo de cadastro
Selecione a categoria de emissora (FM / AM / Digital / Web).

#### Etapa 2 — Dados de contato e da rádio

| Campo | Descrição | Obrigatório |
|-------|-----------|:---:|
| Nome do responsável | Quem vai falar com a equipe E-radios | Sim |
| E-mail corporativo | Domínios gratuitos (Gmail, Hotmail, etc.) são bloqueados | Sim |
| Telefone | DDD + número | Sim |
| Nome da emissora | Nome fantasia da rádio | Sim |
| Dial / Frequência | Ex: 99.7 FM, 820 AM | Não (recomendado) |
| Cidade | Cidade-base da emissora | Não (recomendado) |
| Mensagem | Conte sobre sua emissora, audiência e expectativas | Sim |

#### Etapa 3 — Confirmação
A solicitação é enviada como mensagem de contato para a equipe E-radios.

### O que acontece depois

> ⚠️ **Importante:** Sua conta **não é criada automaticamente**. A equipe E-radios revisa o pedido, entra em contato (e-mail / telefone), coleta CNPJ, razão social, contrato e cria sua conta no sistema. Só após esse processo você receberá as credenciais por e-mail.

> 💡 **Dica:** Capriche na mensagem. Quanto mais informação você enviar (cobertura, audiência, cidade, formato), mais rápido a equipe consegue avaliar.

---

## 3. Login, 2FA e Recuperação de Senha

### Como acessar
- Rota: `/login`

### Campos
| Campo | Descrição |
|-------|-----------|
| E-mail ou CNPJ | Aceita ambos como identificador |
| Senha | Sua senha de acesso |

### Fluxo de login

1. Acesse `/login`
2. Informe e-mail (ou CNPJ) + senha
3. Se o **2FA** estiver ativo, digite o **código de 6 dígitos** enviado por e-mail
4. Você será redirecionado para o **Painel da Emissora** (`/home`)

### Regras importantes

- **2FA por e-mail**: pode ser ativado em **Minha Conta → Segurança**. Código expira após 5 tentativas erradas.
- **Sub-usuários sales** logam pela mesma tela e são redirecionados para `/broadcaster/proposals`.

### Esqueci minha senha

1. Em `/login`, clique em **"Esqueceu a senha?"**
2. Informe seu e-mail cadastrado
3. Abra o e-mail e clique no link de redefinição (validade limitada)
4. Crie uma nova senha respeitando os requisitos

### Regras da senha

| Requisito | Valor |
|-----------|-------|
| Comprimento mínimo | 10 caracteres |
| Letra maiúscula | ≥ 1 |
| Letra minúscula | ≥ 1 |
| Número | ≥ 1 |
| Caractere especial | ≥ 1 |

---

## 4. Onboarding (Primeiro Acesso)

Ao logar pela primeira vez (ou enquanto seu perfil estiver incompleto), o sistema abre automaticamente o **assistente de onboarding** sobre o painel.

### Quando aparece
- Perfil ainda não completado.
- Você pode pular agora e completar depois em **Perfil da Emissora**.

### Etapas do assistente

1. **Informações Gerais** — Nome da estação, dial/frequência, banda (FM/AM/Digital), slogan, logo, e-mail comercial, site, redes sociais.
2. **Descrição** — Vantagens, descrição do formato musical, descrição do veículo, categorias.
3. **Perfil da Audiência** — Distribuição por gênero (% homens / % mulheres), faixa etária, classe social (AB / C / DE).
4. **Cobertura** — Cidades atendidas, população total estimada, URL de streaming.

> 💡 **Dica:** Quanto mais completo o perfil, melhor a emissora aparece no marketplace e nas comparações feitas por anunciantes.

---

## 5. Painel da Emissora (Dashboard)

A página inicial do broadcaster (`/home`) reúne métricas, pedidos recentes, pipeline de propostas e atalhos.

### Como acessar
- Logo do canto superior esquerdo da sidebar
- Rota: `/home`

### Boas-vindas
- Saudação dinâmica (Bom dia / Boa tarde / Boa noite) com nome fantasia da emissora e logo.
- Data atual completa.
- Botão **Tour Guiado** para um passeio interativo da página.

### Alerta de pedidos pendentes
Se houver pedidos com status **"Aguardando Aprovação"** ou recém-pagos, um banner destaca:
> "X pedidos aguardam sua aprovação — Revise e aprove para iniciar as veiculações"

Clique para ir direto a `/broadcaster/campaigns`.

### Métricas (KPIs em destaque)

| KPI | O que mostra |
|-----|--------------|
| **Receita Projetada** | Soma da sua parte (`myTotalValue`) de todos os pedidos válidos + propostas aprovadas. Mostra contagem de campanhas ativas + concluídas. |
| **Aprovadas este Mês** | Quantidade de pedidos/propostas aprovados desde o dia 1 do mês corrente. |
| **Inserções Vendidas** | Total de spots confirmados (somatório de quantidades de orders + propostas aprovadas). |

### Pedidos Recentes
- Lista das últimas 6 ordens (ordenadas por data).
- Cada item mostra: avatar com inicial do anunciante, nome, número do pedido, data, valor a receber e badge do status.
- Clique para ir à tela de Campanhas.

### Painel lateral

#### Propostas (Pipeline)
- Barra horizontal com contagem por estágio: **Rascunho — Enviadas — Visualizadas — Aprovadas**.
- Mini-stats: **Conversão** (% de aprovadas sobre enviadas) e **Valor Aprovado**.
- Botão **Criar Nova Proposta** leva para `/broadcaster/proposals/new`.

#### Clientes
- Contagem de clientes ativos.
- Lista dos 3 clientes mais recentes (avatar + nome + e-mail/telefone).
- Botão **Cadastrar Cliente** leva para `/broadcaster/clients`.

### Atalhos rápidos
Cards de navegação na parte inferior:
- Produtos
- Propostas
- Equipe
- Perfil

---

## 6. Perfil da Emissora

É o cartão de visita público da sua rádio dentro do marketplace. Aqui você edita todas as informações que anunciantes veem ao escolher sua emissora.

### Como acessar
- Sidebar → **Perfil**
- Rota: `/broadcaster/profile-settings`

### Estrutura

A página é dividida em 5 abas (steps), navegáveis por pills no topo:

#### Step 0 — Dados da Empresa
| Campo | Observação |
|-------|------------|
| Razão Social | Tipicamente preenchido pela equipe E-radios |
| Nome Fantasia | Como sua emissora aparece publicamente |
| CNPJ | Somente leitura (alterações via suporte) |
| Telefone | Editável |
| E-mail | Editável |
| PMM (código de mercado) | Somente leitura |
| Endereço | CEP, rua, número, complemento, bairro, cidade, UF |

#### Step 1 — Informações Gerais
- **Nome da estação** (visualizado no marketplace)
- **Dial / Frequência** (ex: 99.7)
- **Banda**: FM, AM ou Digital
- **Slogan** curto
- **Logo** da emissora (upload de imagem)
- **E-mail comercial**
- **Website**
- **Redes sociais** (Instagram, Facebook, YouTube, TikTok, etc.)

#### Step 2 — Descrição
- **Vantagens de anunciar** (texto livre)
- **Descrição do formato** musical/programação
- **Descrição do veículo** (perfil do que é a emissora)
- **Categorias** (multiselect: notícia, esporte, evangélica, jovem, popular, etc.)

#### Step 3 — Perfil do Público
- Gênero da audiência: % feminino + % masculino (devem somar 100)
- Faixa etária predominante
- Classe social: % AB + % C + % DE (devem somar 100)

> 💡 Use dados de pesquisa real (Kantar, Inside, IPDM, etc.) ou sua própria pesquisa de audiência.

#### Step 4 — Cobertura
- Lista de **cidades atendidas** (com adicionar/remover)
- **População total** estimada do alcance
- **URL de streaming** (player online)

### Ações
- **Salvar** — persiste alterações via PUT.
- Algumas mudanças sensíveis (ex: razão social, CNPJ) seguem como solicitação para a equipe E-radios validar antes de publicar.

> ⚠️ **Atenção:** Logo enviada deve ser quadrada e em alta resolução (recomendado ≥ 512px) para não ficar pixelada nos cards do marketplace.

---

## 7. Produtos e Patrocínios

A página central do seu **catálogo comercial**. Aqui você define o que vende, por quanto e em que horário.

### Como acessar
- Sidebar → **Produtos**
- Rota: `/broadcaster/products`

### Abas

| Aba | O que contém |
|-----|--------------|
| Visão Geral | Resumo combinado de Inserções + Patrocínios |
| Inserções | Spots avulsos (ex: Comercial 30s, Vinheta 5s) |
| Patrocínios | Pacotes mensais de programas |
| Combos | Pacotes pré-definidos de Inserções + Patrocínios |
| Faixas | Faixas horárias reutilizáveis (organização) |

### Ações globais
- **Como funciona?** — abre modal explicando markup da plataforma e composição do preço.
- **Exportar XLSX** — exporta todas as inserções em planilha.
- **Tour Guiado** disponível.

### 7.2 Inserções (Spots)

São os comerciais avulsos vendidos por unidade.

#### O que cadastrar
| Campo | Descrição | Obrigatório |
|-------|-----------|:---:|
| Nome | Ex: "Comercial Manhã 30s", "Vinheta Esporte" | Sim |
| Duração | Em segundos (qualquer valor positivo) | Sim |
| Faixa horária | Selecionada das faixas cadastradas (ou criada inline) | Sim |
| Dias da semana | Multiselect dom-sáb (vazio = todos os dias) | Não |
| Preço líquido (netPrice) | Valor que você, emissora, recebe por inserção | Sim |

#### Ações em cada item
- **Editar** — modifica nome, duração, faixa, dias e preço.
- **Excluir** — remove o produto (inserções já em pedidos ativos são preservadas).
- **Filtrar** via barra de busca por nome / tipo / faixa.

> ℹ️ **Sugestões inteligentes:** ao criar uma nova inserção, o sistema sugere nomes já usados e durações mais comuns para padronizar.

### 7.3 Faixas Horárias

São "etiquetas" reutilizáveis de horário (ex: "Manhã", "Horário Nobre", "Madrugada").

| Campo | Valores |
|-------|---------|
| Nome | "Manhã Premium", "Tarde Esporte", etc. |
| Tipo | `determinado` (com início/fim) ou `outro` (rótulo livre) |
| Início / Fim | HH:MM (apenas para tipo determinado) |
| Rótulo customizado | Texto livre (apenas para tipo `outro`) |

> 💡 Faixas servem para padronizar — você as escolhe ao criar/editar uma inserção em vez de redigitar horário toda vez.

### 7.4 Patrocínios de Programa

Diferente de spots, **patrocínio é um pacote mensal fechado**: o anunciante compra "X meses do programa Y", e a emissora veicula várias inserções durante o programa todo o mês.

#### Modelo
| Campo | Descrição |
|-------|-----------|
| Nome do programa | Ex: "Bom Dia Cidade", "Domingo Esportivo" |
| Descrição | Detalhes do programa |
| Horário | Início (HH:MM) — Fim (HH:MM) |
| Dias da semana | Pelo menos 1 dia |
| Lista de inserções do programa | Cada inserção com: nome, duração, **quantidade por dia** e se exige material gravado |
| Preço mensal líquido (netPrice) | Valor que a emissora recebe por mês patrocinado |
| Locutor | Campo opcional reservado para uso futuro |

#### Como funciona a venda
- Anunciante compra **mês fechado** (ou múltiplos meses)
- Sistema gera automaticamente o cronograma de inserções durante todo o mês nos dias e horários do programa
- Inserções podem misturar tipos (ex: "1x Citação 5s + 2x Comercial 30s + 1x Vinheta 5s" por dia)

> 💡 Patrocínios são ideais para vender pacotes de "programa fechado" — mais previsibilidade de receita e menos fricção no agendamento.

### 7.5 Combos

Combos são **pacotes pré-definidos** que misturam Inserções e/ou Patrocínios em um único clique. Servem para acelerar a criação de propostas quando você vende sempre os mesmos pacotes.

#### Como criar
1. Aba **Combos** → **Novo Combo**
2. Informe nome e descrição
3. Adicione itens existentes (inserções/patrocínios) ao combo
4. Para cada item, defina **quantidade default** e **desconto default**
5. Salve

#### Como usar
- Em `/broadcaster/proposals/new`, clique em **Usar Combo**.
- Selecione o combo e o carrinho da proposta é pré-preenchido.
- Você pode editar quantidades e descontos depois (item a item ou desconto global).

> ℹ️ Excluir um combo não afeta propostas já criadas — elas guardam um snapshot dos valores.

### 7.6 Como funciona o preço

A plataforma trabalha com **markup** sobre o preço líquido:

```
preço final no marketplace = netPrice * 1.25
```

| Componente | Quem fica |
|------------|-----------|
| `netPrice` | Você, a emissora |
| 25% de markup | Plataforma E-radios |

> ℹ️ **Para propostas criadas pela emissora** (módulo Propostas), o preço final = netPrice direto, sem markup. Você vende com seu preço cheio. Markup só se aplica a vendas via marketplace de anunciantes.

> 💡 **Pagamentos:** a parte financeira é operada **por fora da plataforma** (NF, transferência, boletos). A E-radios apenas centraliza a venda e a logística.

---

## 8. Campanhas Recebidas (Pedidos)

Aqui você vê todas as compras feitas por anunciantes na sua emissora (via marketplace) **e** também campanhas geradas a partir de propostas suas que foram aprovadas e convertidas em ordem.

### Como acessar
- Sidebar → **Campanhas**
- Rota: `/broadcaster/campaigns`

### KPIs no topo
| Métrica | Cálculo |
|---------|---------|
| Receita Total (minha parte) | Soma `myTotalValue` de pedidos não cancelados/expirados |
| Total de Campanhas | Quantidade de pedidos válidos |
| Campanhas Ativas | Pedidos em paid / pending_approval / approved / scheduled / in_progress |
| Inserções Totais | Somatório de `myTotalItems` |

### Filtros rápidos
- Todas
- Ativas (paid, pending_approval, approved, scheduled, in_progress)
- Concluídas
- Canceladas (cancelled, expired)

### Card de Campanha

Cada campanha aparece como um card colapsável mostrando:

- **Número do pedido** (`orderNumber`)
- **Status** com badge colorido + ícone
- **Número do contrato** (se houver) com quantidade de parcelas
- **Cliente** + data do pedido
- **Resumo conversado dos itens**: ex. "6x Comercial 60s + 3 meses de Patrocínio: Bom Dia Cidade"
- **Período**: data início — data fim — quantidade de dias
- **Total de inserções**
- **Quantidade de itens**
- **Parcelamento** (Nx, 1º vencimento)
- **Valor a receber** (em destaque, valor líquido para você)

### Ações principais
- **Ver P.I.** — abre o **Pedido de Inserção** completo, formatado para impressão (modal grande estilo documento).
- **Exportar** — exporta esta campanha como Excel (3 abas: resumo, itens detalhados, distribuição diária).
- **Expandir** — mostra detalhes inline com cronograma e materiais por item.

### Pedido de Inserção (P.I.)

Documento profissional com:
- Cabeçalho com logo, razão social, CNPJ, endereço da emissora.
- Dados do anunciante (nome, e-mail, telefone).
- Tabela de serviços (produto, tempo, inserções, valor unitário com desconto, subtotal).
- Distribuição de veiculação em grid dia-a-dia.
- Totalizadores (bruto, desconto, líquido a receber).
- Condições de pagamento (vigência, parcelamento, cronograma).
- Observações e linhas de assinatura.
- Botão **Imprimir** — abre janela de impressão do navegador.

### Exportação

Botão **Exportar Excel** (cabeçalho da página) gera planilha com 3 abas:
- **Resumo**: 1 linha por pedido
- **Itens**: detalhamento item a item (inclui patrocínios)
- **Veiculação Diária**: data + dia da semana + quantidade de inserções (gerado também para patrocínios pelo cronograma virtual do mês)

> 💡 **Dica:** Para fechamento mensal, exporte o período todo e cruze com o que sua equipe veiculou — facilita a conferência.

---

## 9. Ciclo de Vida do Pedido

O fluxo padrão do ponto de vista da **emissora**:

```
Aguardando Contato → Pagamento Pendente → Pago → Aprovado → Agendado → Em Veiculação → Concluído
                                                  ↘ Recusado pela emissora → Cancelado
                                                  ↘ Tempo expirado → Expirado
```

### Estados detalhados

| Status | Quando aparece | O que você faz |
|--------|----------------|----------------|
| **Aguardando Contato** | Pedido enviado mas pagamento ainda não processado | Aguardar |
| **Pagamento Pendente** | Cliente em processo de pagamento | Aguardar |
| **Pago** | Pagamento confirmado pela equipe E-radios | Revisar e **aprovar** os itens da sua emissora |
| **Aguardando Aprovação** | Pedido pago aguardando aprovação do broadcaster | Aprovar (libera veiculação) ou recusar com motivo |
| **Aprovado** | Você aprovou os itens | Aguardar agendamento / iniciar veiculação |
| **Agendado** | Pedido com cronograma definido | Veicular conforme datas |
| **Em Veiculação** | Inserções em andamento | Acompanhar, fazer upload de gravação se solicitado |
| **Concluído** | Todas as inserções veiculadas | Receber pagamento (operação por fora da plataforma) |
| **Cancelado** | Você recusou ou ocorreu cancelamento | Sem ação |
| **Expirado** | Pedido não confirmado a tempo | Sem ação |

### Aprovar ou recusar pedido

Quando um pedido chega com status **paid** ou **pending_approval**:

- **Aprovar** — confirma que você aceita os itens, datas e materiais. Pedido vai para **approved** e cliente recebe e-mail.
- **Recusar** — exige motivo de no mínimo 10 caracteres. Itens da sua emissora são recusados e o valor é estornado para o comprador.

> ⚠️ **Atenção:** Pedidos com pagamento por **faturamento** (billing) ainda dependem da equipe E-radios validar a NF antes da liberação final.

> 💡 **Dica:** Use a aba **Notificações** ou o badge no header (ícone de sino) para não perder pedidos pendentes — quanto mais rápido aprovar, mais cedo a campanha vai ao ar.

---

## 10. Material Criativo

Cada item de pedido pode chegar com um dos 3 tipos de material:

| Tipo | O que você recebe | O que você faz |
|------|-------------------|----------------|
| **Áudio pronto** | Arquivo MP3/WAV enviado pelo anunciante | Aprovar (libera veiculação) ou rejeitar (cliente reenvia) |
| **Texto** | Roteiro digitado para locução | Locutar internamente, gravar e fazer upload da produção |
| **Solicitação de Gravação** | Roteiro + estilo musical + gênero da voz | Gravar na sua emissora e fazer upload do áudio final — cliente aprova/rejeita |

### Ações da emissora

- **Aprovar material do cliente** — o áudio enviado é aceito.
- **Rejeitar material do cliente** — você recusa (qualidade, conteúdo, etc.) e o cliente envia outro.
- **Upload de produção própria** — anexa o MP3/WAV gerado por você (max 50MB).
- **Chat por item** — troca mensagens com o anunciante sobre aquele material específico.

### Aprovação do cliente
- Quando você envia uma produção, o cliente recebe e pode **aprovar** ou **rejeitar com observação**.
- Após aprovação, o material está liberado para veiculação no cronograma.

> 💡 Mantenha o chat ativo — dúvidas sobre pronúncia, marca, jingle e tudo o que evita retrabalho.

---

## 11. Propostas Comerciais

O módulo Propostas é uma das ferramentas mais poderosas para a emissora: permite enviar **orçamentos profissionais e personalizados** para clientes diretos (sem precisar passar pelo carrinho do marketplace).

### Como acessar
- Sidebar → **Propostas**
- Rota: `/broadcaster/proposals`

### Visualização Kanban

A tela usa **kanban com drag-n-drop**. Colunas padrão:

| Coluna | Status | O que significa |
|--------|--------|-----------------|
| Rascunho | draft | Proposta sendo construída (não enviada) |
| Enviada | sent | Link enviado ao cliente |
| Visualizada | viewed | Cliente abriu o link público |
| Aprovada | approved | Cliente aceitou (vai virar order) |
| Recusada | rejected | Cliente rejeitou |
| Em Revisão | returned | Reaberta para ajustes |
| Expirada | expired | Validade vencida sem resposta |

> ℹ️ Você pode criar **colunas customizadas** (nome, cor, ícone) só para organizar visualmente — elas não mudam o status real da proposta. Cards finalizados (Recusada/Expirada) ficam recolhidos por padrão; toggle "Mostrar Finalizadas" exibe novamente.

### Ações do menu de cada proposta
- **Editar** (rascunho) — abre o ProposalEditor (visual / branding) ou Edit Items
- **Duplicar** — clona a proposta como nova rascunho
- **Compartilhar** — copia o link público (`/p/:slug`)
- **Reabrir** — volta uma proposta finalizada para `returned` (com nota explicativa)
- **Analytics** — estatísticas de visualização
- **Excluir**

### Criar Proposta — Step 1: Selecionar Itens

Em `/broadcaster/proposals/new`:
- Lista todos os produtos, patrocínios e combos da emissora
- Botão **Usar Combo** abre seletor de combos pré-definidos
- Para cada item adicionado: quantidade, desconto individual, marcação opcional como **bonificação** (grátis), edição de preço unitário
- Carrinho lateral mostra subtotal acumulado

### Step 2: Distribuição
- Define o **período de campanha** (datas de início/fim) usando o builder
- Distribui as inserções por dia (manual ou automático)
- Para patrocínios, define os **meses** comprados
- Ferramenta de revisão de cronograma item a item

### Step 3: Dados da Proposta
| Campo | Descrição |
|-------|-----------|
| Título | Ex: "Proposta Comercial — Marca XPTO" |
| Cliente | Selecione cliente cadastrado ou digite novo |
| E-mail / telefone | Contato do destinatário |
| Validade | Data limite para o cliente responder |
| Desconto global | % ou valor fixo aplicado sobre o total |
| Observações | Texto livre |

### Step 4: Condições de Pagamento (Contrato)
Configure parcelamento e contrato:
- Número do contrato (gerado automaticamente, editável)
- Vigência (início — fim)
- Quantidade de parcelas
- Intervalo entre parcelas (dias / semanas / quinzenas / meses)
- Data do 1º vencimento
- Portador (Carteira / Banco / etc.)
- Procedimento (boleto, PIX, etc.)
- Descrição livre + tags reutilizáveis (ex: "10% entrada", "30/60/90")
- Cronograma de parcelas (preview com simulação)

### Ações finais
- **Salvar Rascunho** — mantém como `draft`
- **Enviar** — gera link público e envia por e-mail ao cliente
- **Exportar XLSX** — planilha com itens, datas e totais

### Página pública da proposta

Quando enviada, a proposta tem URL `/p/:slug`. O cliente:
- Vê o documento sem precisar logar
- Pode aprovar / recusar / pedir revisão
- Pode adicionar comentários

### Customização visual
Em **Editar → Customization**:
- Logo de capa
- Cor primária, secundária, fundo
- Fonte
- Layout (compacto / detalhado)

### Versões e histórico
- A cada salvamento, uma versão é arquivada.
- Você pode **restaurar** uma versão anterior pelo botão no menu.

### Templates
- Salve uma proposta como **template** para reuso.
- Templates ficam em **/broadcaster/proposals → Templates** (aba/listagem).

### Analytics de Propostas

Em `/broadcaster/proposals/analytics`:
- Funil: Criadas → Enviadas → Visualizadas → Aprovadas
- Taxa de conversão
- Valor total aprovado
- Tempo médio para fechamento
- Vendedor que mais converte

> 💡 **Sem markup:** propostas da emissora **não têm markup** da plataforma. O cliente paga exatamente o que você orçou (netPrice direto). Sem tech fee, sem taxa de gravação, sem custo de monitoramento.

> ℹ️ **Sub-usuários sales:** você e seus vendedores compartilham o mesmo kanban e podem editar qualquer proposta da emissora. Cada um aparece como autor da proposta que criou.

---

## 12. Clientes da Emissora

Agenda comercial completa de quem compra ou já comprou de você.

### Como acessar
- Sidebar → **Clientes**
- Rota: `/broadcaster/clients`

### O que cadastrar

| Campo | Descrição |
|-------|-----------|
| Nome / Razão Social | Obrigatório |
| CNPJ ou CPF | Documento fiscal |
| E-mail comercial | Para envio de propostas |
| Telefone | Contato direto |
| Nome do contato | Pessoa que você conversa |
| Endereço completo | CEP + logradouro + cidade + UF |
| Notas | Texto livre |
| Tipo de cliente | Selecionável (gerenciado pela emissora) |
| Origem do cliente | Como você conheceu (gerenciado pela emissora) |
| Logo do cliente | Upload opcional |

### Ações
- Buscar por nome, CNPJ ou e-mail
- Adicionar / Editar / Excluir cliente
- Exportar lista em XLSX
- Anexar logo do cliente (visível em propostas)

### Tipos de Cliente
- Crie categorias customizadas (ex: "Direto", "Agência", "VIP")
- Cada tipo tem uma **cor** para identificação visual

### Origens de Cliente
- Crie origens (ex: "Indicação", "Marketing", "Cold call")
- Útil para entender de onde vem a receita nos relatórios

> 💡 Manter os clientes bem cadastrados acelera muito a criação de propostas — basta selecionar e o sistema preenche dados, e-mail e histórico.

---

## 13. Equipe Comercial (Sub-usuários Sales)

Você pode convidar **vendedores** (sub-usuários `sales`) para criar propostas e gerenciar clientes em nome da sua emissora.

### Como acessar
- Sidebar → **Equipe**
- Rota: `/broadcaster/sales-team`

### Limite
- Default: até **3 vendedores** por emissora.
- O limite pode ser **customizado pela equipe E-radios** (negociado caso a caso).
- Você vê o saldo no topo: `<usados>/<máximo> vendedores`.

### Convidar um vendedor

1. Clique em **Adicionar Vendedor**
2. Preencha:
   - Nome completo
   - E-mail
   - Telefone
   - CPF ou CNPJ
3. Envie — o vendedor recebe e-mail com link para definir senha (token de password reset)
4. Após definir senha, ele logra normalmente em `/login` e cai em `/broadcaster/proposals`

### O que o vendedor pode fazer (padrão)
- Criar e editar propostas de qualquer membro da emissora
- Gerenciar clientes
- Acessar Minha Conta
- **Não** acessa: Produtos, Equipe, Relatórios, Metas, Calendário, Perfil (a menos que você ajuste via Grupos)

### Visualização da Equipe (aba "Equipe")

Cada vendedor aparece em um card com:
- Avatar + nome + e-mail
- Status: **Ativo** (aceitou convite) ou **Pendente** (ainda não definiu senha)
- Grupo de permissão atribuído (se houver)
- Stats inline: Propostas, Enviadas, Aprovadas, Conversão, Valor aprovado
- Indicador de **última atividade**

### Ações em cada vendedor
- **Reenviar convite** (ícone de refresh)
- **Remover** (ícone lixeira) — ação irreversível
- **Expandir** — revela detalhes:
  - Dados de contato completos
  - Atribuir/trocar **grupo de acesso**
  - Breakdown de desempenho (rascunhos, enviadas, aprovadas, rejeitadas, expiradas, valor total)
  - Barra de taxa de conversão
  - Lista de propostas recentes

### Resumo da Equipe
Cards no topo da página mostram totais agregados de toda a equipe: propostas criadas, enviadas, aprovadas, conversão geral e valor aprovado total.

### Outras visões (toggle no canto superior)
- **Equipe** (lista detalhada)
- **Dashboard** (cards de KPI por vendedor + ranking)
- **Metas** (atalho para `/broadcaster/goals`)
- **Grupos** (gerenciar permissões — ver seção 15)

> ⚠️ **Atenção:** Ao remover um vendedor, as propostas que ele criou **não são excluídas** — ficam na conta da emissora. Mas o vendedor perde acesso imediato.

> 💡 **Dica:** Distribua propostas/clientes entre vendedores criando **Grupos** com permissões específicas (ex: vendedor que só cuida do segmento varejo).

---

## 14. Metas Comerciais

Defina metas para a emissora ou para vendedores individuais e acompanhe progresso em tempo real.

### Como acessar
- Sidebar → **Metas**
- Rota: `/broadcaster/goals`

### Tipos de meta
- **Geral** (toda a emissora)
- **Individual** (atribuída a um vendedor específico)

### Campos
| Campo | Descrição |
|-------|-----------|
| Tipo | Geral ou Individual |
| Vendedor | Obrigatório se Individual |
| Valor alvo | Em R$ |
| Período | Data início — data fim |
| Período pré-definido | Mês / Trimestre / Semestre / Ano (opcional) |
| Descrição | Texto livre |

### Visualização
- Card de cada meta com **anel de progresso** (% atingido)
- Cor muda conforme atingimento: verde (≥ 100%), azul (≥ 70%), amarelo (≥ 40%), vermelho (< 40%)
- Mostra: valor alvo, valor realizado, gap, período, dias restantes
- Para metas individuais: avatar do vendedor

### Ações
- Criar / Editar / Excluir meta
- Filtrar por período

### Analytics de Metas
- Distribuição por vendedor (gráfico de barras)
- Ranking de quem está acima/abaixo da meta
- Troféus para os destaques

> 💡 Combine metas com a aba **Dashboard** da Equipe para uma reunião 1:1 mais consistente com cada vendedor.

---

## 15. Grupos de Permissão

Personalize **o que cada sub-usuário pode acessar** criando grupos com permissões específicas.

### Como acessar
- Sidebar → **Equipe** → aba **Grupos**

### Como funciona
- Cada **vendedor** pode ser atribuído a **1 grupo**.
- Sem grupo: ele vê apenas Propostas + Clientes (padrão).
- Com grupo: vê as páginas marcadas como permitidas.

### Permissões disponíveis
| Permissão | Página liberada |
|-----------|-----------------|
| `proposals` | Propostas |
| `clients` | Clientes |
| `products` | Produtos |
| `campaigns` | Campanhas (pedidos) |
| `calendar` | Calendário |
| `sales_team` | Equipe |
| `goals` | Metas |
| `reports` | Relatórios |

### Como criar grupo
1. Aba **Grupos** → **Novo Grupo**
2. Informe nome (ex: "Comercial Sênior", "Estagiário")
3. Marque as permissões
4. Salve
5. Volte para **Equipe** → expanda o vendedor → selecione o grupo no dropdown

> 💡 Ideal: criar um grupo "Vendedor Estagiário" sem `products` (só propostas e clientes), e um grupo "Vendedor Sênior" com tudo exceto `sales_team`.

---

## 16. Calendário

Visão mensal unificada de tudo que está agendado para sua emissora.

### Como acessar
- Sidebar → **Calendário**
- Rota: `/broadcaster/calendar`

### Tipos de evento exibidos
| Tipo | Descrição | Cor |
|------|-----------|-----|
| Veiculação | Inserção de pedido marcada para o dia | Primary |
| Patrocínio | Mês patrocinado por anunciante | Secondary |
| Vencimento de Proposta | Proposta enviada cuja validade vence | Warning |
| Proposta Aprovada / Veiculação | Início/fim de campanha aprovada | Tertiary |
| Vencimento de Parcela | Parcela de contrato a vencer | Neutral |

### Recursos
- Navegação mês a mês
- Filtros: ligar/desligar cada tipo
- Clique em uma data: modal lateral com lista detalhada de eventos do dia (cliente, valor, contrato, etc.)
- Indicador "hoje" destacado

> 💡 Use o calendário antes de aceitar novos pedidos para conferir capacidade do dia/semana.

---

## 17. Relatórios

Módulo completo de relatórios comerciais e operacionais.

### Como acessar
- Sidebar → **Relatórios**
- Rota: `/broadcaster/reports`

### Categorias

#### Visão Geral
- Resumo executivo: total vendido, propostas criadas, conversão, ticket médio.

#### Comercial
- Por Cliente
- Por Vendedor
- Por Etapa de Negociação
- Por Tipo de Proposta

#### Produtos
- Por Tipo de Inserção
- Por Tabela de Inserções
- Por Combo
- Por Horário
- Por Dia da Semana

#### Clientes
- Por Tipo de Cliente
- Por Grupo (de vendedores)
- Por Tipo de Usuário

#### Temporal
- Por Mês
- Por Ano
- Por Vigência

#### Metas
- Por Meta
- Valor Realizado (mensal)

### Recursos
- Filtros de período
- Gráficos compostos (barras + linha)
- Tabelas exportáveis para Excel
- Drill-down com expansão de linhas

> 💡 Use **Relatórios + Metas** combinados na reunião mensal de fechamento — cobre 80% das dores de gestão comercial.

---

## 18. Radio Analytics

Plataforma externa de monitoramento de veiculação (substituiu o antigo OPEC).

### Como acessar
- Sidebar → **Radio Analytics**
- Rota: `/radio-analytics` (redireciona para site externo)

### O que tem lá
- Confirmação de veiculação spot a spot
- Relatório de execução por anunciante
- Verificação técnica de horário / duração

> ℹ️ O acesso ao Radio Analytics é fornecido pela equipe E-radios. Se você não tem login, fale com o suporte.

---

## 19. Notificações e Pedidos Pendentes

### Badge no header
- Sino de notificações mostra a quantidade de pedidos com status pendente de aprovação.
- Atualiza automaticamente em tempo real (polling) e sempre que você age em um pedido.

### Banner no Dashboard
- Quando há pedidos `paid` ou `pending_approval`, aparece um banner em destaque até você tratar.

### E-mails automáticos
Você recebe e-mail quando:
- Cliente aprova uma proposta sua
- Cliente recusa uma proposta sua
- Novo pedido chega via marketplace

Você pode ligar/desligar cada tipo em **Minha Conta → Notificações**.

---

## 20. Minha Conta

Configurações pessoais e da emissora.

### Como acessar
- Avatar do header → **Minha Conta**
- Rota: `/my-account`

### Abas

#### Perfil
- Nome do responsável
- E-mail (mudanças podem exigir reconfirmação)
- Telefone
- Razão social, CNPJ (somente leitura)
- Função na emissora ("Manager")
- Endereço completo

#### Segurança
- **Alterar senha** (senha atual + nova senha + confirmação)
- **Autenticação 2FA** (toggle on/off; ao desligar, exige senha de confirmação)
- Sessões ativas

#### Notificações
| Notificação | Descrição |
|-------------|-----------|
| Propostas | E-mail quando proposta for aceita ou recusada |
| Pedidos do marketplace | E-mail quando novo pedido chegar para sua emissora |

Cada uma é ligada/desligada individualmente.

#### Sair
- Botão **Sair** encerra a sessão e leva ao login.

---

## 21. Tour Guiado

Quase todas as páginas têm um botão **Tour Guiado** (ícone de bússola/pergunta) que abre um passo a passo interativo destacando os principais elementos.

### Páginas com tour
- Dashboard / Início
- Produtos e Patrocínios
- Campanhas
- Propostas (lista e criação)
- Equipe Comercial
- Metas
- Relatórios
- Calendário
- Perfil da Emissora
- Clientes

> 💡 Tours são ótimos para treinar novos vendedores que você convida para a equipe.

---

## 22. Documentação, Termos e Suporte

### Documentação pública
- Acessível em `/docs` (menu inferior — Footer)
- Inclui este manual + FAQs + termos

### Termos de Uso e Privacidade
- `/terms` — Termos de Uso
- `/policy` — Política de Privacidade

### Footer presente em todas as páginas
- Links institucionais
- Contato
- Redes sociais E-radios

### Suporte / Contato
- Para qualquer dúvida operacional, comercial ou técnica, abra um ticket pelo formulário de contato (link no footer).
- Tempo de resposta varia por categoria.

---

## 23. Resumo dos atalhos de menu (sidebar do broadcaster)

| Item | Rota | Onde no manual |
|------|------|----------------|
| Início (Dashboard) | `/home` | Seção 5 |
| Campanhas | `/broadcaster/campaigns` | Seção 8 |
| Calendário | `/broadcaster/calendar` | Seção 16 |
| Produtos | `/broadcaster/products` | Seção 7 |
| Equipe | `/broadcaster/sales-team` | Seção 13 |
| Propostas | `/broadcaster/proposals` | Seção 11 |
| Clientes | `/broadcaster/clients` | Seção 12 |
| Metas | `/broadcaster/goals` | Seção 14 |
| Relatórios | `/broadcaster/reports` | Seção 17 |
| Perfil | `/broadcaster/profile-settings` | Seção 6 |
| Radio Analytics | `/radio-analytics` (externo) | Seção 18 |
| Minha Conta | `/my-account` | Seção 20 |

---

## 24. Glossário rápido

| Termo | Significado |
|-------|-------------|
| **Broadcaster** | Emissora (vendedor na plataforma) |
| **Manager** | Você, dono/admin da conta de emissora |
| **Sales** | Sub-usuário vendedor (subordinado ao manager) |
| **Inserção / Spot** | Comercial avulso veiculado |
| **Patrocínio** | Pacote mensal de programa com várias inserções |
| **Combo** | Pacote pré-definido de inserções/patrocínios |
| **Faixa Horária** | Etiqueta reutilizável de horário |
| **netPrice** | Valor líquido que a emissora recebe |
| **Markup** | 25% adicionados em vendas via marketplace |
| **P.I.** | Pedido de Inserção (documento formal do pedido) |
| **Order** | Pedido confirmado de um anunciante |
| **Proposal** | Proposta comercial enviada por você |
| **Kanban** | Quadro visual com colunas de status |
| **Schedule** | Cronograma diário de inserções |

---

> Este manual cobre **todas as funcionalidades disponíveis ao broadcaster owner** na versão atual da plataforma E-radios. Funcionalidades do sub-usuário "sales" são um subconjunto destas, dependendo do grupo de permissões que você atribuir. Para qualquer divergência entre o que você vê no sistema e este manual, sempre prevalece a interface — dúvidas vão para o suporte E-radios.