Estrutura da Documentação do Grupos Inteligentes

Visão Geral

A documentação do Grupos Inteligentes está organizada em seções principais para ajudar usuários a encontrar rapidamente o que precisam.

Novas Seções Adicionadas

As seguintes seções foram adicionadas para complementar a documentação existente:

Getting Started (Começando)

Ajudando novos usuários a começar rápido:

quick-start.md - Checklist de 5 minutos para configuração inicial
first-launch.md - Preparação de primeiro grande lançamento
understanding-dashboard.md - Explicação completa do painel e métricas

Onde usar: Novos usuários que precisam de introdução completa

Best Practices (Melhores Práticas)

Estratégias para otimizar resultados:

paid-traffic.md - Como usar com tráfego pago (Facebook, Google, etc.)
large-launches.md - Lançamentos de grande volume (10.000-50.000+ leads)
optimization-tips.md - Dicas para melhorar continuamente conversões e ROI

Onde usar: Usuários que já têm experiência e querem otimizar

Troubleshooting (Solução de Problemas)

Resolução rápida de problemas comuns:

common-issues.md - Problemas frequentes com links, grupos, relatórios
lost-access.md - Recuperação de conta se esqueceu senha/e-mail
billing-issues.md - Problemas com pagamento, planos e notas fiscais

Onde usar: Encontrar soluções rapidamente antes de contactar suporte

Plans Reference (Referência de Planos)

Comparação completa de funcionalidades por plano:

feature-comparison.md - Tabela comparativa detalhada dos planos Iniciante, Profissional e Escalável
upgrade-guide.md - Quando e por que mudar de plano, processo de upgrade

Onde usar: Decidir qual plano adequado para suas necessidades

Estrutura de Arquivos

docs/
├── index.md                     # Documentação principal em português
├── account-management/          # Gestão de conta e pagamento
│   ├── basics-data.md
│   ├── payment-method.md
│   └── plans.md
│
├── features/                    # Funcionalidades principais
│   ├── redirector.md
│   ├── distribution-mode.md
│   ├── group.md
│   ├── reports.md
│   ├── update-trackers.md
│   └── automatic-update-participants.md
│
├── getting-started/             # Novas seções de iniciação
│   ├── index.md
│   ├── quick-start.md
│   ├── first-launch.md
│   └── understanding-dashboard.md
│
├── best-practices/              # Novas seções de práticas
│   ├── paid-traffic.md
│   ├── large-launches.md
│   └── optimization-tips.md
│
├── troubleshooting/             # Novas seções de solução
│   ├── common-issues.md
│   ├── lost-access.md
│   └── billing-issues.md
│
├── plans-reference/             # Novas seções de planos
│   ├── feature-comparison.md
│   └── upgrade-guide.md
│
├── notifications/               # Notificações do sistema
│   └── index.md
│
├── images/                      # Screenshots e imagens
│   ├── account-management/
│   ├── features-redirector/
│   ├── migration-plans/
│   ├── notifications/
│   ├── plan-cancel/
│   ├── plan-resume/
│   └── smart-notifications/
│
├── en/                           # Documentação em inglês
│   └── index.md
│
└── es/                          # Documentação em espanhol
    └── index.md

Como Navegar

Para Usuários Novos

Comece com Getting Started → quick-start.md
Leia understanding-dashboard.md para entender o painel
Siga os links na página principal para funcionalidades específicas

Para Usuários Experientes

Best Practices → Escolha com base no seu objetivo:
- Tráfego pago → paid-traffic.md
- Lançamentos grandes → large-launches.md
- Otimização → optimization-tips.md
Feature Comparison → Se precisa entender planos, veja:
- feature-comparison.md (tabela completa)
- upgrade-guide.md (quando mudar)

Para Problemas

Troubleshooting → Encontre problema específico:
- common-issues.md para problemas frequentes
- lost-access.md para perda de acesso
- billing-issues.md para problemas de pagamento
Se não resolver → Contate o Suporte por email

Padrões de Documentação

Estrutura de Arquivo

Cada arquivo segue este padrão:

---
title: 'Título Amigável e Descritivo'
description: 'Resumo de 1-2 frases sobre o que o usuário vai aprender'
---

[Introdução ao tópico]

## Seções principais

[Conteúdo detalhado]

:::note[Importante ou Dica]
[Informação relevante em linguagem simples]
:::

[Capturas de tela com legenda]

## Quando usar este recurso

[Casos de uso específicos]

## Próximos passos

- [Link para documento relacionado]

Princípios de Linguagem

Evite jargão técnico: Ex: “API endpoint” → “comunicação com sistema”
Frases curtas: 10-15 palavras no máximo
Voz ativa: “Crie seu link” em vez de “O link é criado”
Analogias de mundo real: Ex: “redirecionador” = “sistema de encaminhamento”
Linguagem simples: Evitar termos técnicos quando possível

Frontmatter e Metadados

Todos os arquivos incluem:

---
title: 'Título completo da página'
description: 'Resumo breve para SEO e navegação'
---

Estes metadados são usados para:

SEO e busca
Navegação automática
Títulos de página
Descrições em redes sociais

Conteúdo por Seção

Getting Started (Começando)

Público-alvo: Novos usuários

Conteúdo:

Introdução à plataforma
Guia rápido de 5 minutos
Preparação para lançamento
Explicação de painel e métricas

Objetivo: ajudar novos usuários a criar seu primeiro redirecionador e entender como funciona

Best Practices (Melhores Práticas)

Público-alvo: Usuários experientes

Conteúdo:

Estratégias para tráfego pago
Lançamentos de grande volume
Dicas de otimização contínua

Objetivo: Maximizar ROI e resultados com estratégias avançadas

Troubleshooting (Solução de Problemas)

Público-alvo: Quem tem problemas

Conteúdo:

Problemas comuns e como resolver
Perda de acesso
Problemas de pagamento e cobrança

Objetivo: Resolver problemas rapidamente sem contatar o suporte

Plans Reference (Referência de Planos)

Público-alvo: Decisores de plano

Conteúdo:

Tabela comparativa completa dos três planos (Iniciante, Profissional e Escalável)
Guia de quando fazer upgrade
Comparação de custo-benefício

Objetivo: ajudar a escolher o plano adequado para orçamento e necessidades

Features (Funcionalidades)

Público-alvo: Todos os usuários

Conteúdo:

Explicação de cada funcionalidade
Como configurar
Casos de uso específicos

Objetivo: Entender e usar cada funcionalidade

Account Management (Gestão de Conta)

Público-alvo: Usuários ativos

Conteúdo:

Dados básicos e endereço
Métodos de pagamento
Faturas e notas fiscais
Planos e assinaturas

Objetivo: Gerenciar seus dados e pagamentos

Contribuindo

Adicionando Nova Documentação

Coloque no diretório adequado (ver “Estrutura de Arquivos”)
Siga padrão de frontmatter e estrutura
Adicione links internos para documentos relacionados
Use linguagem simples e amigável

Formatando Documentos

Use o formato Markdown
Adicione capturas de tela com legenda explicativa
Use admonitions (note, caution) para destaques
Crie links internos para documentos relacionados
Checklists para processos e procedimentos

Manutenção

Ao Atualizar Funcionalidades

Sincronizar documentação em português, inglês e espanhol
Atualizar imagens se mudança de interface
Adicionar novas funcionalidades em feature-comparison.md

Links de Suporte

Se encontrou problema:

E-mail: Entre em contato direto
Horário: 2ª a 6ª 9h-18h (Brasil)

Changelog

Versão Atual (Março 2026)

Novo conteúdo adicionado:

✅ Seção Getting Started com guias para novos usuários
✅ Seção Best Practices com estratégias avançadas
✅ Seção Troubleshooting com soluções de problemas
✅ Plans Reference com comparação dos planos Iniciante, Profissional e Escalável
✅ Documentação para tráfego pago
✅ Documentação para lançamentos de grande volume
✅ Guia de otimização contínua
✅ Documentação de problemas comuns
✅ Guia de upgrade e downgrade

Organização aprimorada:

Estrutura lógica por tipo de documento
Navegação clara por tipo de usuário
Links internos por todos os documentos

Padrões mantidos:

Linguagem simples e amigável
Evitar terminologia técnica
Formato de frontmatter consistente
Capturas de tela com legenda

Total de arquivos de documentação: 25 arquivos (antes: 12, agora: +13 novos)

Pronto para uso!