> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral do Painel Dev

> O painel admin do seu script, montado pelo código na pasta painel-dev/.

O **Painel Dev** é o painel admin do seu script: código, versões, usuários, vendas, MCP, webhook, funções e configurações. Ele é montado pela pasta `painel-dev/`, que todo script já recebe ao ser criado.

> [!NOTE]
>
> Só o **dono** do script vê as funções criadas pelo código e a tela Traduções. Colaboradores são recusados também no servidor, não só escondidos na tela.

## A pasta

```text theme={null}
painel-dev/
├── painel.json               menu: ícone, nome, grupo e posição de cada item
├── inicio.json               boas-vindas, ordem dos cartões e atalhos do Início
├── funcoes/
│   └── avisos/               uma pasta por função (abre em ?tab=avisos)
│       ├── funcao.json       "@nav" + ligação
│       └── tela.html         tela montada com peças <dt-*>
├── traducoes/
│   ├── pt-BR.json
│   ├── en.json
│   └── es.json
├── componentes.md            guia das peças (para você e para a IA)
├── icones.md                 lista dos ícones
└── SKILL.md                  regras que a IA segue ao editar o painel
```

| Arquivo | O que controla | Obrigatório |
| - | - | - |
| `painel.json` | Ordem, nome, ícone e grupo dos itens do menu | Não |
| `inicio.json` | Só `welcome`, `cards` e `shortcuts` do Início | Não |
| `funcoes/<id>/funcao.json` | Item do menu e de onde vêm os dados | Sim, por função |
| `funcoes/<id>/tela.html` | O desenho da tela | Sim, por função |
| `traducoes/<idioma>.json` | Textos de cada idioma | Não |

## Funções fixas e funções novas

> [card] Funções fixas (@core)
>
> Início, Código, Versões, Usuários, Vendas, MCP e API, Webhook, Funções, Configurações e Traduções (mais Instalações e Bot Discord em alguns tipos). Nunca saem do menu: só ícone, nome, grupo e posição mudam.

> [card] Funções novas (@fn)
>
> Você cria quantas quiser (até 30). Cada uma tem tela própria, item no menu e endereço `?tab=<id>`.

## O Início

```json painel-dev/inicio.json theme={null}
{
  "welcome": "@t.home.welcome",
  "cards": ["@card:sales", "@card:users", "@card:releases", "@card:code"],
  "shortcuts": ["@fn:avisos", "@core:config"]
}
```

| Campo | O que é |
| - | - |
| `welcome` | Frase de boas-vindas (até 120 caracteres ou `@t.chave`) |
| `cards` | Cartões na ordem desejada: `@card:code`, `releases`, `users`, `discord`, `api`, `webhook`, `sales`, `config` |
| `shortcuts` | Até 8 atalhos: `@core:<id>` ou `@fn:<id>` |

Os números do topo do Início são fixos. Qualquer outro campo é recusado.

## Como aplicar

**1. Edite numa branch**

Ex.: `painel-novo`.

**2. Valide**

`dev_panel_validate` com `ref: "painel-novo"`. A lista de erros diz o arquivo e o motivo.

**3. Faça merge na main**

O painel muda na hora. Confira com `dev_panel_get` (`applied_sha`).

> [!WARNING]
>
> Se a pasta tiver qualquer erro, o painel continua com a **última versão válida**. Nada quebra para quem está usando.

> [card] [Menu e @nav](https://docs.doglytdc.dev/pt-BR/scripts/dev-panel/navigation.md)

> [card] [Criar uma função](https://docs.doglytdc.dev/pt-BR/scripts/dev-panel/create-function.md)

> [card] [Peças da tela](https://docs.doglytdc.dev/pt-BR/scripts/dev-panel/pieces.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.