> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/pt/gestao-de-utilizadores-e-projetos/project-management.md).

# Gestão de projetos

### Visualizar o registo de auditoria de um projeto

Os administradores podem ver um **Registo de auditoria** para cada projeto. Este registo de auditoria mostra eventos como quando a partilha de ligações mudou entre privado/baseado em token, quando convites foram enviados/aceites e quando um utilizador entrou no projeto usando um token. Os administradores podem ver estes registos por projeto através de **A sua instância** -> **Administração** -> **Gerir utilizadores** depois:

* Procure o utilizador
* Clique no **Projetos** separador
* Selecione um projeto
* Clique no ícone (i)
* Clique no **Registo de auditoria** separador

Se um projeto for partilhado com um colaborador identificado (usando o respetivo endereço de email), assim que o destinatário tiver aderido, ele aparecerá na janela modal de Partilha com a respetiva permissão e ficará visível para o proprietário do projeto. Esta informação também será mostrada aos Administradores ao visualizarem o separador Informações do Projeto desse projeto através do painel de administração.

### Recuperar documentos eliminados

1. Inicie sessão com as suas credenciais de administrador
2. Clique em **Administração** e selecione **Gerir utilizadores**
3. Usando o campo de pesquisa, introduza o email do utilizador para o qual pretende restaurar o documento
4. Clique no respetivo endereço de email na lista de resultados devolvidos para abrir a respetiva página de informações do utilizador
5. Clique no **Projetos** separador e utilize o campo de pesquisa para procurar o projeto
6. Clique no ícone de informação junto ao nome do projeto para abrir o **Informações do Projeto**
7. Clique no **Documentos eliminados** separador
8. Clique no **Restaurar** botão junto ao documento eliminado para o restaurar para o projeto do utilizador.

O ficheiro restaurado terá o seguinte formato: `FILENAME-TIMESTAMP.EXTENSION`. Por exemplo, uma versão restaurada de `main.tex` será restaurada para a raiz do projeto com o nome de ficheiro `main-2024-02-23-130441542.tex`.

### Transferir a propriedade de um projeto

O painel de administração no Server Pro tem uma página dedicada por projeto. Pode aceder a ela pesquisando o utilizador em "/admin/user" e depois indo ao respetivo **Projetos** separador, encontrando o projeto na lista e clicando no ícone de informação; ou navegando diretamente para a página com um project-id conhecido [**https://your-instance-url/admin/project/**](https://your-instance-url/admin/project/). Na página de informações do projeto, pode encontrar um **Transferir propriedade** botão, que abre uma janela modal onde pode especificar qualquer utilizador como novo proprietário. O novo proprietário não precisa de ser um colaborador já existente no projeto.

{% hint style="info" %}
Note que o proprietário anterior será adicionado como colaborador com acesso de leitura e escrita ao projeto como parte do processo de transferência de propriedade.
{% endhint %}

### Atualizar o tempo limite de compilação do projeto&#x20;

O tempo limite de compilação predefinido para projetos está atualmente definido para 180 segundos. É possível alterar este valor e tal requer um processo em dois passos.

Primeiro, edite o **config/variables.env** ficheiro e adicione a `COMPILE_TIMEOUT`variável de ambiente e defina o seu valor para o tempo limite pretendido em segundos. Por exemplo, `COMPILE_TIMEOUT=300` para 5 minutos.

{% hint style="danger" %}
Não vale a pena aumentar o tempo limite para além de 10 minutos. Se o fizer, é muito provável que encontre um tempo limite noutro componente da aplicação.
{% endhint %}

Depois de esta alteração ter sido feita, terá de recriar o **sharelatex** contentor executando o `bin/up -d`comando.

Definir esta variável de ambiente atualizará o valor do tempo limite apenas para novos utilizadores; ele **não** será aplicado retroativamente aos utilizadores existentes, uma vez que é preenchido quando o utilizador é criado pela primeira vez.

Para ajustar o tempo limite para utilizadores existentes, terá de alterar cada registo de utilizador na base de dados. Aconselhamos muita cautela ao fazê-lo e recomendamos a criação de uma cópia de segurança consistente antes de fazer quaisquer alterações.

Pode encontrar informações sobre como fazer cópias de segurança [aqui](/on-premises/pt/manutencao/data-and-backups.md).

Para atualizar o valor do tempo limite de compilação para todos os utilizadores existentes, terá de executar o seguinte comando de shell no anfitrião Docker:

{% code overflow="wrap" %}

```bash
echo 'db.users.updateMany({}, {$set: {"features.compileTimeout": <value>}})' | docker exec -i mongo mongosh --quiet localhost/sharelatex
```

{% endcode %}

Terá de substituir `<value>` na consulta acima pelo valor pretendido do tempo limite em segundos.

Após o comando concluir, deverá ver uma confirmação com o número de registos modificados. Em seguida, pode escrever exit e depois premir a tecla Enter para regressar à shell do anfitrião.

### Acompanhar o acesso ao projeto

É possível ver quem e quando um projeto é carregado com o seguinte comando:

{% code overflow="wrap" %}

```bash
docker exec sharelatex bash -c 'grep "join project request" /var/log/overleaf/web.log'
```

{% endcode %}

Isto fornecerá tanto o `carimbo de data/hora`, `user_id` e `project_id`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/pt/gestao-de-utilizadores-e-projetos/project-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
