# Administração

O painel, as telas de recursos, configurações, histórico, jobs e funções.

O admin em `/nb-admin/` faz parte de todo site Nimbly. Ele é gerado a partir das definições de recursos, então um recurso novo ganha suas telas assim que o `.meta` dele existe. O que um usuário vê segue a função dele.

## Painel

O painel mostra o que precisa de atenção e o que o site contém:

- **Needs attention**: jobs falhos, um erro fatal recente, pouco espaço em disco, ou assets que precisam de um novo build após uma atualização do core.
- **Site status**: quando os dados mudaram pela última vez, se o core e a aplicação estão atualizados, com uma ação de atualização para funções que podem atualizar, e a memória e o disco do servidor.
- **Visits**: visitas, visualizações de página e tráfego de bots dos últimos 30 dias, para funções com `view-stats`.
- **Your data**: todos os recursos que o usuário pode ver, com número de registros, tamanho e última alteração, e um link para o histórico.
- **Manage**: usuários e funções, a biblioteca de mídia e a fila de jobs com suas ações de manutenção.

Uma aplicação acrescenta seu próprio painel com um `dashboard-band.tpl` em `ext/tpl/` ou no `tpl/` de um módulo.

## Telas de recursos

| Endereço | Tela |
|---|---|
| `/nb-admin/<resource>` | Visão geral com as colunas, a busca, os filtros e a paginação que o `.meta` define |
| `/nb-admin/<resource>/add` | Formulário para adicionar um registro, com importação de documento quando configurada |
| `/nb-admin/<resource>/<uuid>` | Formulário para editar um registro, com o painel de ações |
| `/nb-admin/<resource>/<uuid>/history` | Todas as alterações do registro, com restauração |
| `/nb-admin/<resource>/history` | As últimas alterações do recurso inteiro, incluindo registros excluídos |

O painel de ações ao lado de um registro mostra as últimas alterações e as ações do registro. Um recurso acrescenta ações próprias, como um link de visualização, com `record_actions` no seu `.meta`; `actions.url` acrescenta um link para o registro no site.

Entre registros, um seletor pula para o próximo registro sem voltar à visão geral.

## Histórico

Toda criação, alteração e exclusão feita por um usuário autenticado, um usuário da API ou um agente é guardada, com quem fez, quando e quais campos mudaram. **Restore** devolve um registro ao estado anterior a uma alteração, e um registro excluído pode ser restaurado a partir do histórico do recurso. O histórico é mantido por 90 dias. Textos de página editados no próprio lugar, configurações de página e menus também têm histórico.

## Configurações

`/nb-admin/settings` edita o nome e a descrição do site, os idiomas, a direção do texto e o lado da barra do Nimbly. Nome, descrição e direção são definidos por idioma. Usuários com `manage-system` também ligam ou desligam aqui as páginas personalizadas e a edição da navegação.

As configurações de uma página, como o título, são editadas a partir da própria página, pelas ações da página.

## Usuários e funções

`/nb-admin/users` e `/nb-admin/roles` gerenciam contas e permissões. A tela de funções mostra uma linha por recurso com uma caixa por operação e uma coluna para gerenciar tudo nesse recurso. Veja [Usuários e permissões](/pt/docs/guides/permissions/). O painel de ações de um usuário tem a chave **API access**, que decide se esse usuário pode pedir tokens da API.

## Biblioteca de mídia

`/nb-admin/media` lista todos os envios, mostra onde cada um é usado e remove arquivos que não são mais necessários. Veja [Mídia e edição inline](/pt/docs/guides/media/).

## Jobs

`/nb-admin/jobs` mostra a fila: jobs na fila, em execução, concluídos e falhos, com o último erro, e executa sob pedido os jobs pendentes ou remove os antigos. Veja [Trabalho em segundo plano](/pt/docs/guides/jobs/).

## Substituindo uma tela do admin

O admin é um módulo do core, e suas rotas e templates são procurados primeiro em `ext/`, como todo o resto. Um projeto substitui uma tela colocando uma rota ou um template com o mesmo caminho em `ext/`, e deixa o resto com o core.