> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/configuracoes/auditoria.md).

# Auditoria

### Auditoria

**Finalidade:** consultar alterações de configurações, política de retenção e logs gerais de ações do sistema, com checagem de integridade (hash).

**Caminho:** Configurações → **Auditoria** (`/configuracoes/auditoria?tab=…`)\
Redirect legado: `/configuracoes/log-auditoria` → `tab=sistema`

**Código:** `ConfiguracoesAuditoriaIndex.vue` + abas\
**i18n:** `auditoriaIndex.*`, `auditoriaConfiguracoes.*`, `auditoriaRetencao.*`, `auditoriaSistema.*`

\[\[FOTO]]

***

#### Permissões / licença

| Requisito | Valor                                                          |
| --------- | -------------------------------------------------------------- |
| Menu      | **Master** apenas (`requireMaster` + `requiresMaster` na rota) |
| Licença   | **FREE**                                                       |

Abas sincronizam com `?tab=configuracoes|configuracao|sistema`.

***

#### Aba Configurações (`ConfiguracoesAuditoria.vue`)

Histórico de mudanças em settings (tenant/global).

**Filtros:** período, empresa (tenant), usuário.\
**Ações:** Aplicar / Limpar / Exportar Excel.

**Colunas:**

| Coluna                | Descrição                              |
| --------------------- | -------------------------------------- |
| Data/Hora             |                                        |
| Usuário               | Quem alterou                           |
| Escopo                | Global ou Tenant                       |
| Configuração          | Chave (`settingKey`)                   |
| Valor anterior / novo |                                        |
| Integridade           | Íntegro / adulterado / cadeia inválida |

\[\[FOTO]]

***

#### Aba Retenção (`ConfiguracoesAuditoriaConfig.vue`)

| Campo / ação                        | Descrição                                                                 |
| ----------------------------------- | ------------------------------------------------------------------------- |
| Desligar auditoria (todo o sistema) | `globalAuditDisabled` — SettingsGlobal; nenhum tenant grava               |
| Empresa                             | Filtro de tenant                                                          |
| Dias de retenção                    | 1–365                                                                     |
| Desligar auditoria (esta empresa)   | `auditDisabled` por tenant                                                |
| Salvar                              | Persiste retenção/flags                                                   |
| Métricas                            | Tamanho da tabela, registros do tenant, registros a limpar, data de corte |
| Limpar registros desta empresa      | Purge confirmado                                                          |
| Limpar toda a tabela                | Purge global confirmado                                                   |

**Retenção padrão** exibida na UI (ex.: 15 dias). Com auditoria desligada, limpeza automática para; use purge manual.

\[\[FOTO]]

***

#### Aba Sistema (`LogAuditoria.vue`)

Log geral de ações HTTP/domínio.

**Filtros:** ação, entidade, usuário, tenant, período, status HTTP, IP.\
**Ações:** Filtrar / Limpar / Exportar CSV / ver detalhe.

**Colunas:** Data/Hora, Usuário, Tenant, Ação, Entidade, Método, Caminho, Status, IP, Ações.

**Detalhe:** entityId/label, user-agent, old/new values, metadata, hash anterior e de integridade.

**Ações tipadas (i18n):** create, update, delete, login, logout, test, migrate, repair, export, import.\
**Entidades (exemplos):** users, contacts, tickets, queues, settings, connections, chat-flow, prompts, templates, campaigns…

\[\[FOTO]]

***

#### Regras

* Acesso exclusivo **Master**.
* Integridade `tampered` / `chain_invalid` indica possível adulteração — investigar.
* Purge é irreversível.