# Bem-vindo aos Manuais

# Manuais de usuário — MOC Fidelidade

Manuais completos em pt-BR pra cada um dos produtos da plataforma. Tudo
publicado em **[docs.mocsolucoes.com.br](https://docs.mocsolucoes.com.br)**
com busca, índice e versão atualizada automaticamente via CI.

## Por onde começar

| Você é… | Use… | Tempo de leitura |
|---|---|---|
| **Dono ou gerente da empresa** | [Manual do Admin (web)](admin.md) | 20 min |
| **Atendente/operador da empresa** | [Manual do AppEmpresa](app-empresa.md) | 15 min |
| **Cliente final** | [Manual do AppCliente](app-cliente.md) | 8 min |

> **Quick start:** [admin.md#primeiro-acesso](admin.md#primeiro-acesso) — em 5 passos seu programa de fidelidade está no ar.

## Links rápidos por necessidade

- **Cadastrar primeira empresa:** [admin.md#primeiro-acesso](admin.md#primeiro-acesso)
- **Gerar QR Code pra colar no balcão:** [admin.md#qr-code-da-empresa](admin.md#qr-code-da-empresa)
- **Convidar operadores da equipe:** [admin.md#operadores](admin.md#operadores)
- **Criar primeira recompensa:** [admin.md#recompensas](admin.md#recompensas)
- **Trocar/escolher um plano:** [admin.md#plano-e-faturas](admin.md#plano-e-faturas)
- **Como o cliente acumula:** [app-cliente.md#vincular-empresa](app-cliente.md#vincular-empresa)
- **Operação no balcão (gerar código de marcação/pontos):** [app-empresa.md#gerar-codigo](app-empresa.md#gerar-codigo)
- **Configurar pagamento (PIX/boleto/cartão):** [admin.md#pagamento](admin.md#pagamento)
- **Reembolso ou cancelamento de conta:** [admin.md#encerrar-empresa](admin.md#encerrar-empresa)

## Treinamento ao vivo

Empresas em plano Pro ou superior têm direito a 1h de treinamento em vídeo
no primeiro mês de contrato. Para agendar, abra ticket em
**Suporte > Treinamento** dentro do painel ou escreva pra
[contato@mocfidelidade.com.br](mailto:contato@mocfidelidade.com.br).

## Para quem escreve / contribui

- Linguagem **acessível** — evita jargão técnico, explica conceito quando precisa.
- Foco em **tarefa** ("como fazer X") em vez de descrição de feature.
- **Screenshots** podem ser adicionadas depois; manuais são auto-suficientes
  em texto puro pra serem renderizados como markdown em qualquer lugar.

## Versionamento

Os manuais devem ser atualizados sempre que houver mudança de UX ou fluxo.
Em particular:

- Feature nova entrou em produção.
- Passo a passo de algo já documentado mudou.
- Mensagem de erro descrita mudou.

Toda alteração em `docs/manuais/*.md` é sincronizada automaticamente pra
BookStack (docs.mocsolucoes.com.br) e Wiki do GitLab via pipeline CI.

## Distribuição

- **Online (recomendado):** [docs.mocsolucoes.com.br](https://docs.mocsolucoes.com.br)
  — sempre na última versão, com busca e formatação rica.
- **Site institucional:** linkado na seção [FAQ](https://mocfidelidade.com.br/faq).
- **Dentro do Admin:** menu lateral **Suporte > Manuais**.
- **GitLab Wiki:** espelho versionado pra time interno.
- **Markdown bruto:** este diretório, pra leitura em editor ou IDE.