feat: rewrite doc templates based on real script structure

Replaced the minimal placeholder templates with a richer generic
structure modeled after real MRI scripts. Sections now cover main
features, quick install, config, commands, exports (client/server),
server/client modules, file structure, and troubleshooting — all with
clear bracketed placeholders for the AI to fill in per-script.

Author: ggfto

.github/templates/MANUAL.template.md

@@ -1,103 +1,86 @@
-# Manual — Nome do Script
+# [Nome do Recurso] - Manual Funcional
 
-> Guia completo para instalação, configuração e uso do script.
+[Descrição curta do que o recurso oferece e para quem é destinado.]
 
----
+## O que o recurso faz
 
-## O que este script faz
+[Descrição detalhada das funcionalidades principais, explicando o que o recurso oferece para o servidor e para os jogadores.]
 
-Descrição detalhada das funcionalidades principais, explicando o que o script oferece para o servidor e para os jogadores.
+## Funcionalidades principais
 
----
+- **[Funcionalidade 1]**: [Descrição detalhada].
+- **[Funcionalidade 2]**: [Descrição detalhada].
+- **[Funcionalidade 3]**: [Descrição detalhada].
 
-## Requisitos
+## Como funciona
 
-- **FiveM** atualizado
-- **ox_lib** instalado e iniciado antes deste recurso
-- **qbx_core** instalado e configurado
+1. [Passo 1 do fluxo principal].
+2. [Passo 2].
+3. [Passo 3].
 
----
+## Configurações disponíveis
 
-## Instalação
+[Descreva as opções de configuração disponíveis em `shared/config.lua` ou equivalente.]
 
-### 1. Download
+### Permissões
 
-Baixe a última versão em **Releases** e extraia o conteúdo.
+[Se houver sistema de permissões, descreva os grupos e níveis de acesso disponíveis.]
 
-### 2. Adicionar ao servidor
+## Comandos disponíveis
 
-```
-resources/
-└── [mri]/
-    └── nome-do-script/   ← pasta aqui
-```
-
-### 3. server.cfg
-
-```cfg
-ensure nome-do-script
-```
-
-### 4. Configuração
-
-Abra `shared/config.lua` e ajuste as opções conforme necessário (veja seção [Configuração](#configuração)).
-
----
-
-## Configuração
-
-### Config.Debug
-
-```lua
-Config.Debug = false
-```
-
-Ativa mensagens de debug no console do servidor e do cliente. Desative em produção.
+| Comando | Descrição |
+|---------|-----------|
+| `/[comando]` | [O que o comando faz]. |
 
-### Config.MaxItems
-
-```lua
-Config.MaxItems = 10
-```
+## Eventos
 
-Define a quantidade máxima de itens que um jogador pode carregar.
+### Callbacks principais
 
----
+| Callback | Direção | Descrição |
+|----------|---------|-----------|
+| `[nome:do:callback]` | C→S | [O que faz]. |
 
-## Comandos
+## Exports
 
-### Para jogadores
+### Client
 
-#### `/comando`
+| Export | Parâmetros | Retorno | Descrição |
+|--------|------------|---------|-----------|
+| `[ExportName]` | [params ou -] | [tipo ou -] | [O que faz]. |
 
-Descrição do que o comando faz para o jogador.
+### Server
 
-**Uso:** `/comando [argumento]`
+| Export | Parâmetros | Retorno | Descrição |
+|--------|------------|---------|-----------|
+| `[ExportName]` | [params ou -] | [tipo ou -] | [O que faz]. |
 
----
+## Módulos Server
 
-### Para administradores
+| Módulo | Funcionalidade |
+|--------|---------------|
+| `main.lua` | Lógica principal do servidor. |
 
-#### `/admincomando [id]`
+## Módulos Client
 
-Descrição do que o comando administrativo faz.
+| Módulo | Funcionalidade |
+|--------|---------------|
+| `main.lua` | Entry point do cliente. |
 
-**Uso:** `/admincomando 1`
-**Permissão:** `admin`
+## Exemplos práticos
 
----
+### [Título do exemplo 1]
 
-## Perguntas frequentes
-
-**O script não inicia, o que verifico?**
-Confirme que todas as dependências estão listadas antes deste recurso no `server.cfg`.
+```lua
+[Código de exemplo mostrando uso típico do recurso]
+```
 
-**Como desativar as notificações?**
-Defina `Config.Notificacoes = false` no `shared/config.lua`.
+### [Título do exemplo 2]
 
----
+```lua
+[Outro exemplo prático relevante]
+```
 
-## Suporte
+## Solução de problemas
 
-- Discord: [MRI Qbox Brasil](https://discord.gg/uEfGD4mmVh)
-- Issues: abra uma issue no repositório do GitHub
+- **[Problema comum 1]**: [Como resolver].
+- **[Problema comum 2]**: [Como resolver].

.github/templates/README.template.md

@@ -1,65 +1,75 @@
-# Nome do Script
+# [Nome do Recurso]
 
-> Descrição curta e objetiva do que o script faz.
+[Descrição curta e objetiva do que o recurso faz.]
 
-![FiveM](https://img.shields.io/badge/FiveM-GTA%20V-green?style=flat-square)
-![Lua](https://img.shields.io/badge/Lua-5.4-orange?style=flat-square)
-![MRI Qbox](https://img.shields.io/badge/MRI%20Qbox-Brasil-blue?style=flat-square)
+## Principais recursos
 
----
+- **[Feature principal 1]** — [Descrição].
+- **[Feature principal 2]** — [Descrição].
+- **[Feature principal 3]** — [Descrição].
 
-## Dependências
+## Instalação rápida
 
-| Recurso | Obrigatório |
-|---------|-------------|
-| `ox_lib` | Sim |
-| `qbx_core` | Sim |
+1. Copie a pasta `[nome_recurso]` para a pasta de resources do servidor.
+2. [Passos adicionais, ex: build do frontend se houver NUI]
+3. Adicione `ensure [nome_recurso]` no `server.cfg` (após as dependências obrigatórias).
+4. [Execute o script SQL se houver banco de dados]
 
----
-
-## Instalação
+## Configuração
 
-1. Adicione a pasta do recurso em `resources/[mri]/`
-2. Adicione `ensure nome-do-script` no `server.cfg`
-3. Configure o arquivo `shared/config.lua`
-4. Reinicie o servidor
+### Dependências obrigatórias
 
----
+- `[dependência]` — [Para que é utilizada].
 
-## Configuração
+[Se houver banco de dados, descreva o schema e as tabelas aqui.]
 
-| Opção | Tipo | Padrão | Descrição |
-|-------|------|--------|-----------|
-| `Config.Debug` | `boolean` | `false` | Ativa logs de debug no console |
-| `Config.MaxItems` | `number` | `10` | Quantidade máxima de itens permitidos |
+### Permissões
 
----
+[Se houver sistema de permissões, descreva os grupos e níveis de acesso aqui.]
 
 ## Comandos
 
-| Comando | Permissão | Descrição |
-|---------|-----------|-----------|
-| `/comando` | Jogador | Descrição do que o comando faz |
-| `/admincomando` | Admin | Descrição do comando administrativo |
+| Comando | Descrição |
+|---|---|
+| `/[comando]` | [O que o comando faz]. |
+
+## Exports
+
+### Client
+
+| Export | Descrição |
+|---|---|
+| `[ExportName]` | [O que faz]. |
+
+### Server
 
----
+| Export | Descrição |
+|---|---|
+| `[ExportName]` | [O que faz]. |
 
-## Eventos
+## Server Modules
 
-### Client → Server
+| Módulo | Descrição |
+|---|---|
+| `main.lua` | Lógica principal do servidor. |
 
-| Evento | Parâmetros | Descrição |
-|--------|-----------|-----------|
-| `script:client:acao` | `data: table` | Descrição do evento |
+## Client Modules
 
-### Exports
+| Módulo | Descrição |
+|---|---|
+| `main.lua` | Entry point do cliente. |
 
-| Export | Retorno | Descrição |
-|--------|---------|-----------|
-| `exports['script']:funcao()` | `boolean` | Descrição do export |
+## Estrutura de arquivos 📁
 
----
+```
+[nome_recurso]/
+├── client/
+├── server/
+├── shared/
+[└── web/                 # Apenas se houver NUI]
+└── fxmanifest.lua
+```
 
-## Licença
+## Observações importantes ⚠️
 
-MIT License — MRI Qbox Team Brasil
+- [Observação técnica ou de uso relevante para quem for instalar ou usar o recurso.]