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

# Partições de monorepo

> Separe achados, configurações e agendamentos de scan por diretório dentro de um repositório

Use partições quando os times precisarem escanear e gerenciar diretórios do mesmo repositório separadamente. Cada partição aparece como um repositório no ZeroPath, com seus próprios achados, histórico de scans, configurações e agendamentos. Todas usam a mesma conexão com o controle de versão.

Por exemplo, você pode dividir um repositório assim:

| Partição | Caminhos dos diretórios |
| - | - |
| Web | `apps/web/` |
| API | `services/api/`, `services/worker/` |
| Fallback | Caminhos fora das partições nomeadas, como `packages/shared/` e arquivos na raiz do repositório |

O ZeroPath adiciona a partição de **fallback** automaticamente na conversão. Ela não tem caminhos de diretório próprios; seu escopo abrange os caminhos que nenhuma partição nomeada cobre.

Você configura as partições. As [aplicações](https://zeropath.com/docs/pt/platform/threat-model.md) exibidas nos modelos de ameaças e filtros de issues são descobertas a partir do código, e uma partição pode conter mais de uma aplicação.

## Criar partições

Comece com um repositório já conectado ao ZeroPath. Criar partições ou alterar seus caminhos exige a permissão **Create Repositories**.

1. Abra **Repositories → Monorepos** e selecione **Create monorepo**.
2. Selecione o repositório que deseja converter.
3. Preencha **Partition Name** e um ou mais **Directory paths** para a primeira partição.
4. Use **Add Another Partition** para cada grupo adicional de diretórios.
5. Clique em **Convert to Monorepo**. O fallback é adicionado junto com as partições nomeadas.
6. Abra a página de repositório de cada partição para revisar as configurações, definir o agendamento e iniciar um scan.

Novas partições herdam as configurações da organização e das tags. Configurações específicas e agendamentos do repositório original não são copiados para as novas entradas. O histórico de scans existente permanece na entrada original.

Você também pode gerenciar partições em **Settings → General → Monorepo configuration** na página do repositório.

### Regras dos caminhos

* Use caminhos relativos à raiz do repositório, terminados em `/`, como `apps/web/`.
* Uma partição pode incluir vários diretórios.
* Os caminhos são prefixos de diretório. Nomes de arquivos, padrões glob como `**/*.ts`, caminhos absolutos e `..` não são aceitos.
* Partições diferentes não podem se sobrepor: `apps/` e `apps/web/` não podem pertencer a partições separadas.

## Como os scans usam as partições

### Scans completos

Cada partição executa um scan separado. O scanner pode ler o repositório inteiro para entender imports e código compartilhado, então o tempo de scan também inclui trabalho fora dos diretórios da partição.

Um achado de SAST é mantido em uma partição nomeada quando sua localização reportada ou o início do seu fluxo de dados está dentro dela. Por exemplo, a partição API pode reportar um fluxo que começa em `services/api/` e alcança código vulnerável em `packages/shared/`.

Quando seu plano impõe um limite de tamanho para scans completos, a verificação usa o escopo da partição. Para o fallback, isso exclui os diretórios atribuídos às partições nomeadas.

### Pull requests

Scans de PR de uma partição nomeada são ignorados quando as alterações não atingem seus diretórios. No GitHub, os arquivos alterados determinam quais partições recebem scans; um PR que altera Web e API pode disparar um scan para cada uma.

No exemplo acima, um PR no GitHub que altera apenas `packages/shared/` é direcionado ao fallback. Ele não dispara automaticamente scans para todos os serviços que importam esse código. Execute scans completos das partições afetadas quando precisar verificar esses serviços após uma alteração no código compartilhado.

## Editar ou remover partições

Abra **Repositories → Monorepos → Existing monorepos** e expanda um repositório. Use **Add Partition** para criar outra partição ou o ícone de lápis para alterar seu nome ou caminhos.

Excluir partições exige a permissão **Repository Deletion**. Ao remover a configuração de monorepo, você pode manter uma entrada como repositório normal ou excluir todas do ZeroPath. Manter uma entrada limpa seu escopo de diretórios para que ela escaneie o repositório inteiro. Se restar apenas uma partição, a página oferece convertê-la de volta em um repositório normal.


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