# Exclusão compartilhada de clientes

O master utiliza exclusão lógica: preserva cadastro, palavras-chave, templates, jobs e arquivos. A marca oficial compartilhada é `clients.deleted_at`, uma data em UTC.

## Alteração no banco

```sql
ALTER TABLE clients ADD COLUMN deleted_at DATETIME NULL;
```

Essa coluna já foi aplicada pelo master. Antes de executar novamente, verificar `information_schema.COLUMNS`. Clientes ativos possuem `NULL`; clientes excluídos possuem a data da exclusão.

Ao excluir, o master grava em transação:

```sql
UPDATE clients
SET deleted_at = UTC_TIMESTAMP(),
    master_archived_at = COALESCE(master_archived_at, UTC_TIMESTAMP()),
    master_updated_at = UTC_TIMESTAMP()
WHERE id = ?;
```

A transação bloqueia o cliente e só atualiza se ainda não estiver excluído, preservando a primeira data em reenvios. Registra também um evento em `master_client_history`. Não altera status de jobs ou consome comandos do gerador.

Cadastros anteriormente arquivados apenas no master permanecem com a semântica anterior; não são convertidos automaticamente em exclusão compartilhada.

## Texto para o Codex do gerador

Implemente a exclusão lógica compartilhada de clientes com o Absolut - Master, utilizando o mesmo banco já configurado. O master já adicionou `clients.deleted_at DATETIME NULL` e, ao excluir um cliente, grava a data UTC nessa coluna. NULL significa ativo; data preenchida significa excluído. Não crie outro banco nem outro sinalizador.

1. Em toda lista, pesquisa, seleção de clientes, dashboard e contagem, use `WHERE clients.deleted_at IS NULL`. Em consultas de jobs, fila, arquivos e relações, faça JOIN com clients e aplique `c.deleted_at IS NULL`. Preserve os filtros existentes. Evite apenas filtrar na interface: endpoints também precisam proteger o acesso direto.
2. Bloqueie edição, cadastro de palavras/regiões, enfileiramento, reativação de jobs e comandos pendentes referentes a cliente excluído. Retorne erro claro; não restaure o cliente implicitamente. Verifique novamente dentro da transação de execução de comandos, pois ele pode ser excluído depois de o comando ser enviado.
3. O executor deve selecionar somente jobs de clientes ativos. Revalide a marca antes de cada item e após a resposta do modelo, antes de salvar/publicar. Se houver exclusão durante a geração, interrompa em um ponto seguro, remova o job da fila executável pelo mecanismo já existente e preserve tudo que já foi gravado. Libere os controles da máquina sem impedir a geração de outros clientes. Nunca apague os arquivos anteriores.
4. Se houver botão de excluir no gerador, use a mesma marca em transação, com UTC_TIMESTAMP(), preservando a primeira data. O master desaparecerá com o cliente na próxima atualização. Não use DELETE físico nem exclusão em cascata.
5. Atualize periodicamente as listas; se o cliente aberto for excluído pelo master, feche seus detalhes e remova-o das seleções e filas exibidas.
6. Se a instalação usar cópia local ou cache de clientes, sincronize também o tombstone deleted_at, sem ressuscitar clientes excluídos. Se o banco for o compartilhado, consulte diretamente essa coluna.
7. Teste exclusão no master refletida no gerador, acesso direto por ID, comandos antigos pendentes, exclusão durante geração e reenvio da exclusão. Garanta que cadastro, arquivos e histórico continuem no banco.

Exemplos de filtros:

```sql
SELECT c.* FROM clients c WHERE c.deleted_at IS NULL;

SELECT j.* FROM generation_jobs j
INNER JOIN clients c ON c.id = j.client_id
WHERE c.deleted_at IS NULL;
```

O gerador precisa aplicar essas mudanças para respeitar a marca. O master não modifica os arquivos do projeto do gerador nesta etapa.
