> ## 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.

# Resumen del Panel Dev

> El panel admin de tu script, armado desde el código en la carpeta painel-dev/.

El **Panel Dev** es el panel admin de tu script: código, versiones, usuarios, ventas, MCP, webhook, funciones y configuración. Se arma con la carpeta `painel-dev/`, que todo script recibe al crearse.

> [!NOTE]
>
> Solo el **dueño** del script ve las funciones creadas desde el código y la pantalla Traducciones. Los colaboradores también son rechazados en el servidor, no solo ocultos en pantalla.

## La carpeta

```text theme={null}
painel-dev/
├── painel.json               menú: icono, nombre, grupo y posición de cada elemento
├── inicio.json               bienvenida, orden de tarjetas y atajos del Inicio
├── funcoes/
│   └── avisos/               una carpeta por función (abre en ?tab=avisos)
│       ├── funcao.json       "@nav" + conexión
│       └── tela.html         pantalla armada con piezas <dt-*>
├── traducoes/
│   ├── pt-BR.json
│   ├── en.json
│   └── es.json
├── componentes.md            guía de las piezas (para ti y para la IA)
├── icones.md                 lista de iconos
└── SKILL.md                  reglas que sigue la IA al editar el panel
```

| Archivo | Qué controla | Obligatorio |
| - | - | - |
| `painel.json` | Orden, nombre, icono y grupo de los elementos del menú | No |
| `inicio.json` | Solo `welcome`, `cards` y `shortcuts` del Inicio | No |
| `funcoes/<id>/funcao.json` | Elemento del menú y de dónde vienen los datos | Sí, por función |
| `funcoes/<id>/tela.html` | El diseño de la pantalla | Sí, por función |
| `traducoes/<idioma>.json` | Textos de cada idioma | No |

## Funciones fijas y funciones nuevas

> [card] Funciones fijas (@core)
>
> Inicio, Código, Versiones, Usuarios, Ventas, MCP y API, Webhook, Funciones, Configuración y Traducciones (más Instalaciones y Bot de Discord en algunos tipos). Nunca salen del menú: solo cambian icono, nombre, grupo y posición.

> [card] Funciones nuevas (@fn)
>
> Crea las que quieras (hasta 30). Cada una tiene pantalla propia, elemento en el menú y dirección `?tab=<id>`.

## El Inicio

```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 | Qué es |
| - | - |
| `welcome` | Frase de bienvenida (hasta 120 caracteres o `@t.clave`) |
| `cards` | Tarjetas en el orden deseado: `@card:code`, `releases`, `users`, `discord`, `api`, `webhook`, `sales`, `config` |
| `shortcuts` | Hasta 8 atajos: `@core:<id>` o `@fn:<id>` |

Los números de arriba del Inicio son fijos. Cualquier otro campo es rechazado.

## Cómo aplicar

**1. Edita en una rama**

Ej.: `panel-nuevo`.

**2. Valida**

`dev_panel_validate` con `ref: "panel-nuevo"`. La lista de errores indica el archivo y el motivo.

**3. Haz merge en main**

El panel cambia al instante. Compruébalo con `dev_panel_get` (`applied_sha`).

> [!WARNING]
>
> Si la carpeta tiene cualquier error, el panel sigue con la **última versión válida**. Nada se rompe para quien lo usa.

> [card] [Menú y @nav](https://docs.doglytdc.dev/es/scripts/dev-panel/navigation.md)

> [card] [Crear una función](https://docs.doglytdc.dev/es/scripts/dev-panel/create-function.md)

> [card] [Piezas de la pantalla](https://docs.doglytdc.dev/es/scripts/dev-panel/pieces.md)


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