# Administração da instalação

Quem opera o draften (o **operador**, superadmin na interface) vê no menu uma
parte extra, **Instalação**, com as páginas **Organizações**, **Instalação** e
**Operação**. Ele não vê, porém, o que há dentro das organizações: conhece só o
nome, os vínculos, os proprietários e o tamanho delas. Na sua própria instalação,
o operador é o primeiro administrador que você informa ao instalador.

## Instalação

A versão, as atualizações, os backups e a licença desta instalação, e os
padrões para todas as organizações.

**Versão** – qual versão está em execução e se o **updater** está rodando (e
quando buscou novas versões pela última vez). Quando há uma nova versão
disponível, ela aparece aqui com as notas da versão e um botão **Atualizar
para …**; o aplicativo continua funcionando durante a atualização e você
acompanha o progresso diretamente no cartão. Depois de uma atualização, há
também **Voltar para …** a versão anterior. O guia
[Atualizar com o updater](/pt/admin/updating-with-the-updater) mostra o
procedimento. Quando o updater não está rodando, o cartão avisa e indica a
linha de comando (`./draften update`).

**Processos de worker** – quantos processos de worker estão em execução e um
campo para o novo número (1–16). O updater grava o número no `.env`
(`WORKER_REPLICAS`) e reinicia os processos. Antes de adicionar um processo,
tente aumentar a simultaneidade na página Operação – veja
[Operação e capacidade](/pt/admin/operations).

**Chave de criptografia** – a troca da `MASTER_KEY`. O updater cria uma nova
chave e a grava no `.env` do servidor; ela nunca chega à interface. Depois,
guarde uma cópia do `.env` fora do servidor – veja
[Backup e restauração](/pt/admin/backup-and-restore).

**Backups do banco de dados** – os sete últimos dumps do banco de dados na pasta
`backups/` do servidor (quando foram feitos, tipo, versão, tamanho), o horário
do backup diário com o fuso horário e um botão **Fazer backup agora**. O
updater faz backup todos os dias (às 01:00 por padrão) e antes de cada
atualização; quando o backup diário falha, o cartão mostra o motivo. Os backups
ficam no mesmo disco que o banco de dados – copie-os para outro lugar, veja
[Backup e restauração](/pt/admin/backup-and-restore). Sem o updater, o cartão
indica o comando `./draften backup`.

**Solicitações** – as dez últimas solicitações ao updater (atualização, volta
para a versão anterior, número de processos, troca da chave, backup sob
demanda): quem as fez, quando terminaram e eventuais erros.

O updater trata só uma solicitação por vez; a próxima pode ser feita quando ele
tiver terminado. Uma solicitação que ele ainda não assumiu pode ser cancelada.

**Retenção de dados** – depois de quantos dias as mensagens, os rascunhos e os
textos com que os assistentes aprendem são apagados em todas as organizações
(90 por padrão, 30–3.650 dias, ou “Nunca apagar”). Lições e correções no
conhecimento ficam. Reduzir o prazo pede confirmação – os dados mais antigos
são apagados de vez na próxima limpeza. Depois da atualização que traz a
retenção de dados, a primeira limpeza só acontece 24 horas depois. O que
exatamente é apagado está em [Onde os dados ficam guardados](/pt/admin/data-storage).

**Licença** – a quem a licença pertence, até quando vale, quantas caixas de
e-mail e assistentes ela permite e quantos já foram criados; uma nova também é
carregada aqui. Veja [A licença](/pt/admin/licence).

No nosso serviço (SaaS), é o nosso pipeline que implanta as novas versões: o
cartão Versão avisa isso, e nenhuma licença é carregada aqui.

**Status da instalação** – se a `MASTER_KEY` está definida (sem ela nada do que
foi guardado criptografado pode ser lido), se existe um remetente de e-mails
padrão, em quais organizações nenhum proprietário entrou ainda e quantas caixas
de e-mail estão sem acesso.

**Chaves de API padrão** – chaves de modelos para organizações e caixas de
e-mail sem chaves próprias. Só aqui é possível adicionar uma chave para um
servidor compatível com a OpenAI (um modelo local), porque ela traz o endereço
do servidor. Veja [Chaves de API dos modelos](/pt/admin/api-keys).

**Envio de e-mails padrão** – de onde saem os convites das organizações sem
remetente próprio, e também os convites para criar uma organização. Veja
[Envio de e-mails](/pt/admin/outgoing-mail).

## Organizações

**Convites para criar uma organização** – o jeito mais fácil: informe o e-mail
do futuro proprietário, opcionalmente o nome da organização (ele já vem
preenchido) e o idioma do e-mail. O convidado recebe um link válido por 7 dias,
cria a organização ele mesmo e se torna o proprietário dela. Um novo convite
para o mesmo endereço substitui o antigo. A lista mostra o status de cada
convite (pendente, usado, expirado); um convite não enviado pode ser enviado de
novo com **Reenviar**, e um válido pode ser cancelado com **Revogar**. Os passos
do convidado estão no guia
[Criar uma organização](/pt/admin/founding-an-organisation).

**Nova organização** – ou configure-a você mesmo: o nome, o e-mail do primeiro
proprietário (e o nome, se for uma pessoa nova), opcionalmente o ID do tenant do
Entra e os domínios de e-mail.

**Organizações configuradas** – a lista com a forma de entrar, os proprietários
e o tamanho. Para cada uma:

- **Editar a forma de entrar** – os vínculos com o diretório (o proprietário
  também pode defini-los),
- **Definir um proprietário** – quando o proprietário se perdeu,
- **Suspender** / **Reativar** – uma organização suspensa fica bloqueada: os
  membros não conseguem entrar e os assistentes pulam as caixas de e-mail dela,
- **Apagar** – só uma organização suspensa, com tudo o que há nela (caixas de
  e-mail, assistentes, mensagens, rascunhos, chaves, configurações). As contas de
  usuário ficam. Não pode ser desfeito; você confirma digitando o nome.

## Operação

A página **Operação** mostra os workers em execução, o atraso dos assistentes e
a fila de jobs. Ela está descrita em [Operação e capacidade](/pt/admin/operations).