Capacidades e funções
As capacidades da guarda pertencem ao módulo GCVD e só têm efeito com o módulo licenciado e o interruptor Guarda documental (master) ligado.
Modelo de autorização
A autorização da guarda é por capacidade (permissão granular atribuída a uma função), e não por permissão documento a documento do Alfresco. As capacidades da guarda são um papel central de compliance, que age no repositório inteiro, atravessando sites.
Conceder uma capacidade da guarda a um usuário dá a ele poder sobre todos os sites do repositório, e não apenas sobre aqueles em que ele é membro. Ao montar as funções, conceda cada capacidade somente a quem deve agir sobre o repositório todo.
Listas e filas
O mesmo vale para as filas de compliance central, que mostram o repositório inteiro a quem tem a capacidade, sem filtrar pela permissão de leitura dos sites: Vencidos (DocDispose), Bloqueios (DocHold), Pastas por classe (ClassificationAdmin), Não conformes do Decreto (GcvdAdmin ou DocReviewAdmin), Validade pendente e Relatório de temporalidade (RetentionAdmin), a fila do descarte do físico e a autorização do descarte do físico (DocPhysicalDiscard). As ações de pedir descarte (DocDisposeRequest), aplicar bloqueio (DocHold) e classificar na guarda (DocClassify) também valem fora dos sites do usuário: quem descarta, bloqueia ou classifica não precisa abrir o documento.
Há duas exceções:
- o documento sob sigilo continua restrito: só aparece a quem tem a credencial (permissão de leitura);
- as filas de conferência (pendente e refação,
DocReview) seguem a permissão de leitura, porque revisar exige abrir o documento: o conferente vê o que consegue abrir. Para conferir documentos de outros sites, o conferente precisa de acesso de leitura a eles.
As contas internas do sistema e de serviço não sofrem as proteções, o que permite que as rotinas da guarda (preservação, reconciliação, migração) operem sobre documentos protegidos por bloqueio, termo, em guarda ou conferido.
Onde administrar
Console, tela Funções (capacidade Usuários e grupos, RolesAdmin). Cada função combina capacidades e membros (usuários e grupos) lado a lado. Os administradores recebem todas as capacidades automaticamente.
Catálogo de capacidades
Guarda
| Capacidade | Rótulo no Share | O que libera |
|---|---|---|
DocReview | Conferir documentos digitalizados (conferência de legibilidade) | Conferir documentos (vê a própria fila) na tela de conferência |
DocReviewAdmin | Administrar a conferência (filas de re-digitalização, reatribuir) | Administrar a conferência (todas as filas, reatribuir); ver a lista de não conformes ao Decreto |
DocReviewedEdit | Metadados, mover e excluir documento conferido protegido (não troca o binário) | Editar metadados, mover e excluir documento conferido protegido; sair do estado OK para não OK. Não libera a troca do conteúdo |
DocRetentionEdit | Metadados e mover documento em guarda (temporalidade; não troca o binário) | Editar metadados e mover documento em guarda protegido; ajustar prazo, base e destinação no cartão de metadados. Não libera a troca do conteúdo |
DocDispose | Descartar documentos vencidos (temporalidade) | Descartar documentos vencidos (destinação DESTROY e vencimento até hoje), na tela Controle de descarte |
DocDisposeRequest | Solicitar descarte prematuro (em guarda, não vencido) | Pedir descarte prematuro (antes do vencimento), somente para destinação DESTROY |
DocDisposeApprove | Aprovar/rejeitar descarte prematuro | Aprovar ou rejeitar pedidos de descarte prematuro |
DocReclassify | Reclassificar a destinação de documento em guarda | Reclassificar a destinação final (auditado como "Destinação reclassificada"), pela ação Reclassificar destinação |
DocHold | Colocar bloqueio + pedir a liberação (litígio / valor histórico) | Bloquear (aplicar hold) e pedir a liberação |
DocHoldRelease | Aprovar/rejeitar pedidos de liberação de bloqueio | Aprovar ou rejeitar a liberação de bloqueio |
DocClassify | Classificar um documento numa classe (guarda) | Classificar documento na guarda (ação Classificar na guarda) |
DocPhysicalDiscard | Autorizar descarte do físico | Autorizar o descarte do papel original após a homologação digital |
DocImportNative | Ingestão de nato-digital (API de integração) | Ingestão de documento nato-digital por API, pensada para conta de serviço |
DocConfidentialityClassify | Classificar documento/pasta (definir sigilo) | Definir o sigilo de um documento (nível e marcas) |
DocConfidentialityReclassify | Reclassificar sigilo (mudar nível/marcas) | Reclassificar o sigilo (mudar nível e marcas, auditado) |
DocConfidentialityDeclassify | Desclassificar documento/pasta | Desclassificar (remover o sigilo do documento) |
Temporalidade, dossiê, classificação e sigilo
| Capacidade | Rótulo no Share | O que libera |
|---|---|---|
RetentionAdmin | Gerenciar a tabela de temporalidade | Tabela de temporalidade, corte por evento, perfis de dossiê e reconciliação, migração do legado |
DossierView | Ver o inventário/relatórios de dossiês | Ver o inventário e os relatórios de dossiês (leitura) |
ClassificationAdmin | Gerenciar o plano de classificação (árvore de classes) | Manter a árvore de classificação, atribuir classe a pasta e reaplicar classe em lote |
ConfidentialityAdmin | Gerenciar sigilo (níveis, marcas, credenciais) | Administrar o sigilo: escada de níveis, catálogo de marcas e credenciais dos usuários |
Sistema (governança e operação)
| Capacidade | Rótulo no Share | O que libera |
|---|---|---|
GcvdAdmin | Configurar a guarda documental (tela de configuração do GCVD) | Tela Configuração da guarda (todos os interruptores); lista de não conformes ao Decreto (também com DocReviewAdmin) |
AuditAdmin | Ver toda a auditoria | Ver toda a trilha de auditoria do Alfresco (de todos os usuários), no Console em Auditoria de conteúdo e na página de auditoria do Share. Somente leitura: a trilha é imutável e não é configurável nem apagável |
AccessAudit | Ver a própria auditoria | Abrir a página de auditoria e ver somente os eventos do próprio usuário |
ExportAudit | Exportar Auditoria | Exportar a trilha de auditoria (exigida também no servidor: sem ela a exportação é recusada) |
Maintenance | Ligar/desligar modo manutenção (repo somente leitura) | Manutenção global, com o repositório somente leitura |
CapturePause | Pausar recepção de captura / fila de processamento | Pausa da captura (recepção e processamento) |
FaultsView | Ver falhas de produção (outbox local) | Ver o painel de falhas do sistema |
BackupAdmin | Acessar o Backup Agent (backups/restauração) | Acesso ao Backup Agent |
PreservationAdmin | Executar o batch de preservação (propriedades/resumo/assinatura) | Preservação (lote, diária, reassinatura, estimativa de custo) |
DocCleanVersionHistory | Limpar histórico de versões (documentos sem bloqueio) | Apagar o histórico de versões de um documento não bloqueado; exige o parâmetro de plataforma correspondente habilitado, sem exceção para administradores |
DocCleanVersionHistoryAdmin | Limpar histórico de versões também em protegidos (conferido ou em guarda) | Papel administrativo correlato, que limpa o histórico também em documentos protegidos |
DocVerifyView / DocVerifyDownload | Verificar integridade (ver revisões) / Verificar integridade (baixar revisões) | Abrir e baixar o verificador de versões |
RolesAdmin | Usuários e grupos | Criar e editar funções e atribuir capacidades, na tela Funções |
CertificateAdmin | Gestão de certificados | Gerir templates de certificado A1 de Fluxo e captura (grupo designers). Os templates da guarda (termo, guia, preservação) são geridos por quem tem GcvdAdmin |
Quem vê o quê: auditoria do Alfresco e auditoria da captura
São duas auditorias diferentes, com capacidades diferentes:
| Auditoria | O que registra | Onde se vê | Capacidades |
|---|---|---|---|
| Auditoria do Alfresco (trilha da guarda) | Ações sobre documentos e configurações: conferência, classificação, descarte, bloqueio, sigilo, acesso, login | Console, Auditoria de conteúdo, e página de auditoria do Share | AccessAudit (só os próprios eventos), AuditAdmin (todos os eventos), ExportAudit (exportar) |
| Auditoria da captura (Capture Audit) | Documentos que entraram pela captura: job, arquivo, usuário, site, páginas, data, recusado ou removido | Capture/Process, Capture Audit | ViewAllAudit (Ver todas as auditorias), entre as capacidades de operação da captura |
Dar ViewAllAudit não amplia o que o usuário vê na auditoria do Alfresco, e AuditAdmin não amplia a auditoria da captura. Para um auditor da guarda que precisa ver todos os eventos, use a função gcvd_auditor (ou AccessAudit, AuditAdmin e ExportAudit).
Funções prontas por persona
Na tela Funções, o botão Popular com roles da guarda cria, mediante confirmação, um catálogo de funções pré-configuradas por persona. O administrador só precisa colocar usuários e grupos dentro da função que já existe, em vez de montar o conjunto de capacidades do zero.
Como funciona
- O botão cria as funções do catálogo que ainda não existem; funções já existentes (com o mesmo nome) são preservadas e nunca sobrescritas.
- As funções criadas aparecem em uma terceira seção, Do seed, na lista (distinta de "Do sistema" e "Personalizadas"), com marcador visual próprio.
- Funções do seed podem ser excluídas pelo administrador, mas não podem ser renomeadas. As capacidades continuam editáveis.
- As três funções de sistema (
admins,process_admins,capture_admins) não podem ser excluídas nem renomeadas, mas suas capacidades também são editáveis. - O botão não altera essas três funções de sistema: elas ficam propositalmente de fora das capacidades da guarda, reforçando a segregação inclusive para o administrador geral (que se atribui à função Gerente da guarda explicitamente, se for acumular o papel).
- O botão cria apenas a definição da função (nome e capacidades), sem grupo nem usuário. Use a interface de membros da própria tela para colocar pessoas.
Catálogo da guarda documental
| Função | Rótulo | Capacidades | Responsabilidade |
|---|---|---|---|
gcvd_manager | Gerente da guarda | GcvdAdmin, RetentionAdmin, ClassificationAdmin, DossierView, PreservationAdmin, DocCleanVersionHistoryAdmin | Dono do programa de gestão documental: configura a guarda, o plano de classificação, os perfis de retenção e migração e a preservação. Não executa conferência nem descarte no dia a dia |
gcvd_reviewer | Conferente | DocReview | Confere a legibilidade e a qualidade dos documentos na fila de conferência |
gcvd_review_admin | Supervisor de conferência | DocReviewAdmin, DocReviewedEdit | Administra a fila (reatribuir, ver todos os lotes) e edita metadados, move e exclui documento já conferido quando necessário (não troca o conteúdo) |
gcvd_classifier | Classificador | DocClassify | Aplica a classe de guarda a documentos e pastas (ação manual) |
gcvd_retention_editor | Editor de temporalidade | DocRetentionEdit | Ajusta prazo, data-base e destinação de um documento específico em guarda (não troca o conteúdo) |
gcvd_dispose_requester | Solicitante de descarte | DocDisposeRequest | Pede descarte prematuro |
gcvd_dispose_approver | Aprovador de descarte | DocDisposeApprove | Aprova ou recusa pedidos de descarte prematuro |
gcvd_dispose_executor | Executor de descarte | DocDispose | Executa o descarte (vencidos ou prematuros já aprovados) |
gcvd_hold_officer | Oficial de bloqueio (hold) | DocHold, DocHoldRelease | Aplica e libera bloqueio por litígio ou valor histórico |
gcvd_confidentiality_officer | Oficial de sigilo | ConfidentialityAdmin, DocConfidentialityClassify, DocConfidentialityReclassify, DocConfidentialityDeclassify | Classifica, reclassifica e desclassifica sigilo; administra níveis, marcas e credenciais |
gcvd_physical_discard_officer | Autorizador de descarte físico | DocPhysicalDiscard | Autoriza o descarte do papel original após a homologação digital |
gcvd_auditor | Auditor da guarda (só leitura) | AccessAudit, AuditAdmin, ExportAudit, DocVerifyView, DocVerifyDownload | Vê toda a trilha (de todos os usuários), exporta e verifica versões; não age sobre nenhum documento |
gcvd_cert_admin | Administrador de certificados (fluxo e captura) | CertificateAdmin | Gere os templates de certificado A1 de Fluxo e captura. Não gere os da guarda: esses exigem GcvdAdmin |
gcvd_native_import | Integração nato-digital (conta de serviço) | DocImportNative | Apenas a capacidade de ingestão por API (ERP, RPA); pensado para conta de serviço, não para pessoa |
Demais funções prontas do sistema
| Função | Rótulo | Capacidades |
|---|---|---|
capture_designer | Designer de captura | ScanDesigner |
workflow_designer | Designer de fluxo | WFDesigner |
capture_operations | Operação de captura | ViewAllAudit, ViewAllJobs, ViewAllLinks, ViewAllPauseds, CapturePause |
workflow_operations | Operação de fluxos | AllTasks, ClaimAll, FormAll, ReassignAll |
system_maintenance | Operador de manutenção | Maintenance |
backup_operator | Operador de backup | BackupAdmin |
faults_viewer | Visualizador de falhas | FaultsView |
integrations_viewer | Auditor de integrações 3rd-party | 3rdSMSViewAll, 3rdGeminiViewAll |
portal_admin | Administrador de tenant (Portal) | PortalAdmin |
portal_super_admin | Super-administrador do Portal | PortalSuperAdmin |
access_control_admin | Administrador de controle de acesso | RolesAdmin |
audit_admin | Ver toda a auditoria | AuditAdmin |
Ver também Funções.
Segregação de função
O descarte tem um controle em três funções: DocDisposeRequest (pede), DocDisposeApprove (aprova) e DocDispose (executa) são deliberadamente funções separadas, e nenhuma pessoa deveria acumular as três na mesma operação crítica. Esse controle é aplicado pelo sistema no fluxo de descarte.
Para as demais combinações, o sistema não impede que um usuário acumule capacidades conflitantes; é decisão do administrador ao montar grupos e usuários. Pares que o catálogo evita colocar na mesma função:
| Capacidade A | Capacidade B | Por que não juntar |
|---|---|---|
DocDisposeRequest | DocDisposeApprove | Quem pede não pode aprovar o próprio pedido |
DocDisposeRequest / DocDisposeApprove | DocDispose | Quem decide não deveria executar a operação irreversível |
GcvdAdmin (configuração) | DocDisposeApprove | Quem configura a régua de retenção não deveria aprovar exceções a ela |
ConfidentialityAdmin | AccessAudit / AuditAdmin / ExportAudit | Quem classifica sigilo não deveria auditar a si mesmo sem checagem externa |
DocReview | DocReviewAdmin | Na mesma pessoa é aceitável, mas em equipes grandes separar reduz o viés de conferir o próprio trabalho |
Trate isto como orientação de projeto, para registrar no manual do administrador.
O que cada ação de documento exige
A relação das ações de documento (o que cada uma modifica, a capacidade exigida, quando aparece e o que a bloqueia) está em Matriz de ações do documento.
Proteções do documento
Documentos em bloqueio, com termo de eliminação, conferidos, em guarda, digitalizados ou sigilosos têm proteções específicas:
- Bloqueio (hold): vale pela presença do bloqueio, sem exceção por capacidade; só sai pela liberação aprovada.
- Termo de eliminação: sem exceção, nem para administradores.
- Em guarda: com o interruptor Proteger documentos em guarda ligado, o conteúdo não é trocado por ninguém; metadados e mover abrem com
DocRetentionEdit; a exclusão nunca abre por edição (só pelo descarte). - Conferido: com Proteger documentos conferidos ligado, o conteúdo não é trocado por ninguém; metadados, mover e excluir abrem com
DocReviewedEdit. - Digitalizado: com Binário do digitalizado imutável ligado, o conteúdo não muda, sem exceção por capacidade; a assinatura é a única passagem.
- Sigilo: com Sigilo e Trava de acesso mandatória ligados, a alteração manual de permissões é recusada.
- Identidade do documento: o identificador único e o hash não são editáveis manualmente; só o sistema os recompõe.
Conteúdo absoluto. Com a proteção ligada, o conteúdo de um documento digitalizado, conferido ou em guarda não é trocado por ninguém, nem por quem tem DocReviewedEdit ou DocRetentionEdit, nem pelo administrador. As únicas passagens são a assinatura feita por usuário (que continua permitida em conferido e em guarda) e as contas internas do sistema e de serviço. As capacidades de exceção liberam apenas metadados, mover e (no conferido) excluir. Quem precisar corrigir o conteúdo de um documento conferido ou em guarda deve desligar a respectiva proteção na tela Configuração da guarda; com ela desligada, o documento fica sem essa trava.
Edição offline e versões. Nesses três estados, o usuário também não faz check-out (editar offline) nem reverte versão: qualquer reversão é recusada, inclusive voltar um documento conferido para uma versão anterior à conferência, mesmo para quem tem capacidade e para o administrador. Subir nova versão e editar online continuam recusados. Na interface, some Editar offline; no Share some também Atualizar propriedades (que reescreve o PDF ao embutir os metadados); no histórico de versões, Enviar nova versão some, Reverter some no Share e Restaurar fica desativado no Content App. Permissões segue disponível para quem pode editar os metadados do documento. Excluir uma versão do histórico também é recusado; no Content App a opção Excluir some do histórico.
Mais de um estado. Um documento pode estar em mais de um estado ao mesmo tempo (por exemplo, digitalizado, conferido e em guarda); vale sempre o mais restritivo.
Excluir pasta. Com as proteções ligadas, a exclusão de uma pasta que contenha algum documento protegido (em guarda, conferido sem DocReviewedEdit, bloqueado ou com termo de eliminação) é recusada para o usuário. Cada documento da pasta é verificado pelas mesmas regras de excluir o próprio documento. O descarte controlado e as contas de serviço seguem passando.