# Manual do Usuário — BRANDSTORY
Este manual orienta usuários da plataforma BRANDSTORY sobre como criar projetos, preencher briefings e gerar brand stories com auxílio de IA.
---
## 1. Acesso à Plataforma
### Cadastro
1. Acesse a landing page da plataforma.
2. Clique em **Cadastrar** (visível apenas quando os cadastros estão abertos).
3. Preencha nome, e-mail e senha.
4. Sua conta é criada e confirmada automaticamente — não é necessário confirmar e-mail.
5. Você receberá um **e-mail de boas-vindas** com o link de acesso e a conta iniciará com o nível **Gratuito (`free`)** e um lote inicial de **10 VIK** válidos por 1 ano.
### Login
1. Clique em **Entrar** na landing page ou acesse `/login` diretamente.
2. Informe seu e-mail e senha cadastrados.
3. Caso tenha esquecido a senha, use o link **Esqueci minha senha** na tela de login.
> Se a plataforma estiver em modo manutenção, você verá uma tela "Em Breve" no lugar da landing page. O login continua funcionando normalmente pela URL `/login`.
---
## 2. Consentimento e Triagem de Segurança
No primeiro acesso após o cadastro, a plataforma exibe uma tela de **consentimento e triagem de segurança**. É obrigatório concluir essa etapa antes de acessar o dashboard.
- Leia os Termos de Uso e a Política de Privacidade.
- Responda às perguntas de triagem com honestidade.
- Clique em **Aceitar e Continuar**.
> O aceite fica registrado com data e hora. Alterações críticas nos termos podem exigir um novo consentimento.
---
## 3. Dashboard — Seus Projetos
Após o login, você é direcionado para o **Dashboard**, que lista todos os seus projetos narrativos.
### Saldo em VIK
No canto superior direito do dashboard há um **badge de saldo** mostrando quantos créditos **VIK** a sua conta tem disponíveis e a data do próximo vencimento:
```
X VIK · vence em DD/MM/AAAA
```
- **X VIK** = saldo disponível da conta no momento
- Os créditos entram em **lotes com validade de 1 ano**, e cada consumo sai primeiro do lote que vence antes
- Cada geração de Brand Story custa **10 VIK** (informado antes de clicar em gerar); a avaliação pela rubrica é gratuita (**0 VIK**)
- Não há assinatura mensal: se uma geração falhar, o saldo reservado é estornado automaticamente; em caso de saldo insuficiente, o sistema exibe o aviso correspondente (a compra de novos pacotes VIK estará disponível em breve)
### Criar um novo projeto
1. Clique no botão **Novo** no canto superior direito (rota `/dashboard/projetos/novo`).
2. Escolha por onde começar o nome da marca:
- **Já tenho o nome da marca** (`keep_name`): fluxo disponível agora para seguir direto ao briefing estratégico de Brand Story.
- **Ainda não tenho nome — quero criar do zero** (`no_name`): módulo de Naming **em breve** (ainda não cria projeto nesta etapa).
- **Quero renomear uma marca existente** (`rename`): módulo de Naming/Renaming **em breve** (ainda não cria projeto nesta etapa).
3. Com **Já tenho o nome da marca** selecionado, preencha:
- **Nome do Projeto**: nome interno de referência.
- **Nome da Marca**: a marca que será trabalhada.
- **Tipo de Marca**, **Objetivo Principal** e **Canal Principal**.
4. Clique em **Iniciar Briefing**.
### Gerenciar projetos existentes
Na lista do dashboard, cada card de projeto exibe:
- Nome do projeto e da marca
- Canal principal
- Etapa atual do projeto (ex.: **Briefing** / **Pronto p/ Gerar** / **Gerado** ou **Arquivado**)
Clique em qualquer card para abrir a página do projeto (`/dashboard/projetos/[id]`).
---
## 4. Briefing de Marca
O **Briefing** (`/dashboard/projetos/[id]/briefing`) é o coração do projeto. Quanto mais completo, melhor a qualidade da brand story gerada.
### Como preencher
1. Abra um projeto no dashboard (`/dashboard/projetos/[id]`).
2. Clique no botão **Preencher Perguntas** ou **Editar Briefing**.
3. Responda às perguntas organizadas em blocos (combinando o tronco comum da marca e o aprofundamento de Brand Story):
- **Essência da Marca**, **Público e Percepção**, **Valor e Diferencial**, **Inusitude e Risco** e **Tom e Efeito**.
4. Salve as respostas ao avançar em cada etapa.
> Você pode salvar e retomar o briefing em qualquer momento. Ao concluir a última etapa, o módulo de Brand Story passa para **Pronto p/ Gerar** e o sistema registra uma versão do projeto.
---
## 5. Geração da Brand Story
Com o briefing preenchido, o módulo fica em **Pronto p/ Gerar** (`/dashboard/projetos/[id]/gerar`).
### Como gerar
1. Abra o projeto e clique em **Calibrar & Gerar História** (ou **Gerar Nova Cópia**, se já houver uma história gerada).
2. Selecione o nível de ousadia desejado.
3. Clique em **Gerar com IA**.
4. Aguarde o processamento — o conteúdo fica disponível na página do projeto (`/dashboard/projetos/[id]`).
> **Atenção**: cada geração consome **10 VIK** do saldo da conta (com estorno automático em caso de erro na geração). Confira seu saldo no dashboard antes de iniciar; se não houver VIK suficiente, a tela exibirá o aviso de saldo insuficiente.
### O que é gerado
A IA produz uma brand story completa calibrada ao perfil da marca e ao canal definido, incluindo:
- Título e diagnóstico estratégico da marca
- Modelo narrativo recomendado (StoryBrand, Golden Circle, etc.)
- Tensão criativa e território simbólico
- Metáfora central da marca
- 4 versões de brand story (principal, segura, inusitada, ousada)
- Opções de hook e CTA
- Manifesto de marca
- Adaptação para o canal escolhido
> O status do projeto muda para **Gerado** após a primeira geração bem-sucedida.
---
## 6. Exportação em PDF
Após a geração, você pode baixar o relatório estratégico em PDF.
1. Na tela do projeto gerado, clique em **Baixar PDF**.
2. O arquivo é gerado no servidor e o download inicia automaticamente.
3. O PDF contém a brand story completa, briefing resumido e metadados do projeto.
---
## 7. Alternância de Tema (Claro / Escuro)
O botão de tema (ícone de sol/lua) fica no canto superior direito de todas as páginas. Clique para alternar entre **modo claro** e **modo escuro**. A preferência é salva no navegador.
---
## 8. Minha Conta e Exclusão de Dados
### Acessando as configurações da conta
No header do dashboard, clique no ícone **Conta** (ao lado do ícone de início). Você verá:
- Seu e-mail e ID de usuário
- Data de criação da conta
- **Zona de perigo**: opção para excluir a conta
### Excluindo sua conta (usuário autenticado)
1. Acesse o dashboard e clique em **Conta** no header
2. Na seção **Zona de perigo**, clique em **Excluir minha conta e todos os dados**
3. Confirme na janela de confirmação
4. Todos os seus dados são apagados permanentemente e você recebe um e-mail de confirmação
5. Você é redirecionado para a página inicial
> **Atenção**: a exclusão é imediata e irreversível. Projetos, briefings e histórias de marca são apagados permanentemente.
### Solicitando exclusão sem acesso à conta
Caso não consiga mais acessar sua conta:
1. Acesse `/excluir-dados` (link disponível no rodapé do site e na página de login)
2. Informe o e-mail cadastrado e clique em **Solicitar exclusão de dados**
3. Você receberá um e-mail de confirmação do recebimento
4. O processamento ocorre em até **15 dias úteis** (prazo legal — LGPD art. 18)
### O que é excluído
- Conta e dados de perfil
- Todos os projetos de marca e briefings preenchidos
- Histórias de marca geradas por IA
- Dados de uso vinculados ao e-mail
> **Retenção legal**: dados fiscais obrigatórios por lei são mantidos por até 5 anos conforme o art. 195 do CTN — mesmo após a exclusão da conta.
---
## 9. Documentos Legais
Os documentos da plataforma estão disponíveis a qualquer momento:
- **Termos de Uso**: `/termos`
- **Política de Privacidade**: `/privacidade`
- **Exclusão de dados**: `/excluir-dados`
Links também disponíveis no rodapé da página inicial e na tela de login.
---
## 10. Privacidade e Segurança dos Dados
- Seus briefings e brand stories são armazenados de forma isolada e privada — nenhum outro usuário tem acesso.
- O acesso é protegido por Row Level Security (RLS) no banco de dados: mesmo que haja uma falha de autenticação, as políticas de banco impedem o acesso cruzado entre contas.
- Nenhum dado de briefing é usado para treinar modelos de IA.
- Todas as respostas HTTP incluem headers de segurança padrão da indústria (X-Frame-Options, X-Content-Type-Options, Referrer-Policy).
---
## 11. Suporte
Em caso de dúvidas ou problemas, entre em contato pelo e-mail de suporte informado na tela de triagem de segurança ou na Política de Privacidade da plataforma.
Para reportar vulnerabilidades de segurança, consulte o arquivo `SECURITY.md` no repositório ou envie e-mail para `security@cardinallis.com.br`.
## Quando o site está fechado (em breve, inscrição ou manutenção)
- Você pode encontrar, no lugar das páginas, uma tela **"Em breve"** com contagem regressiva, uma **página de inscrição** ou um aviso de **manutenção**. A entrada da conta e as páginas legais continuam funcionando.
- Para ser avisado do lançamento, preencha o formulário (nome, e-mail e, se quiser, WhatsApp) e marque o consentimento. Você pode cancelar quando quiser.
- **Recebeu um link de acesso antecipado?** Abra-o: o site fica liberado por 30 dias naquele navegador. Ou clique em "Tenho uma chave de acesso" e digite a chave recebida.
- Em manutenção, a área logada também pode ficar fechada por alguns minutos. Tente de novo mais tarde.
## Recuperar a senha
1. Na tela de login, clique em "Esqueci minha senha" (`/recuperar`).
2. Informe o seu e-mail. Se aparecer a verificação de segurança, aguarde a confirmação antes de enviar.
3. Abra o e-mail e clique no link **no mesmo navegador** em que fez o pedido. Em outro navegador ou aparelho o link não funciona.
4. Na tela `/reset-password`, escolha a nova senha (mínimo de 8 caracteres) e confirme.
Se aparecer "verificação de segurança falhou", recarregue a página e tente de novo. Se o link expirou, peça outro. A mensagem de envio é a mesma para qualquer e-mail, cadastrado ou não, por segurança.
## Compra de Créditos VIK
O consumo de IA na plataforma utiliza créditos **VIK** vinculados à sua conta, sem assinatura mensal.
### Pacotes disponíveis (`/dashboard/comprar-vik`)
Quando a compra estiver habilitada, você pode adquirir pacotes avulsos por cartão de crédito em pagamento único via Stripe (R$ 2,99 por VIK pago):
| Pacote | VIK pagos | Bônus | Total recebido | Valor |
| ------- | --------- | ------- | -------------- | --------- |
| 10 VIK | 10 | — | 10 VIK | R$ 29,90 |
| 25 VIK | 25 | +2 VIK | 27 VIK | R$ 74,75 |
| 50 VIK | 50 | +5 VIK | 55 VIK | R$ 149,50 |
| 100 VIK | 100 | +15 VIK | 115 VIK | R$ 299,00 |
### Regras de validade e consumo
- **Validade de 1 ano**: todos os VIK recebidos na compra (pagos e bônus) valem por **365 dias** a partir da confirmação do pagamento.
- **Ordem de uso**: o sistema consome primeiro os créditos cujo vencimento esteja mais próximo. Quando o lote pago e o lote bônus têm o mesmo vencimento, o lote pago é utilizado antes.
- **Upgrade automático para o nível Pro**: na sua primeira compra de qualquer pacote, a conta passa automaticamente do nível gratuito (`free`) para o nível `pro`, sem cobrança recorrente.
- **Garantia em caso de falha técnica**: se a inteligência artificial estiver indisponível ou ocorrer problema técnico momentâneo na geração, a operação é interrompida com um aviso claro na tela e **nenhum crédito VIK é descontado** da conta (qualquer reserva aberta é devolvida automaticamente).
<!-- widgets do Turnstile (12/11/2026) -->