Em Desenvolvimento
Esta documentação ainda está em desenvolvimento. Agradecemos sua paciência!
Pular para o conteúdo principal
Versão: 03.008.000 🚧 (em desenvolvimento)

Capacidades e funções

Licença

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 dá poder sobre todos os 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​

CapacidadeRótulo no ShareO que libera
DocReviewConferir documentos digitalizados (conferência de legibilidade)Conferir documentos (vê a própria fila) na tela de conferência
DocReviewAdminAdministrar 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
DocReviewedEditMetadados, 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
DocRetentionEditMetadados 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
DocDisposeDescartar documentos vencidos (temporalidade)Descartar documentos vencidos (destinação DESTROY e vencimento até hoje), na tela Controle de descarte
DocDisposeRequestSolicitar descarte prematuro (em guarda, não vencido)Pedir descarte prematuro (antes do vencimento), somente para destinação DESTROY
DocDisposeApproveAprovar/rejeitar descarte prematuroAprovar ou rejeitar pedidos de descarte prematuro
DocReclassifyReclassificar a destinação de documento em guardaReclassificar a destinação final (auditado como "Destinação reclassificada"), pela ação Reclassificar destinação
DocHoldColocar bloqueio + pedir a liberação (litígio / valor histórico)Bloquear (aplicar hold) e pedir a liberação
DocHoldReleaseAprovar/rejeitar pedidos de liberação de bloqueioAprovar ou rejeitar a liberação de bloqueio
DocClassifyClassificar um documento numa classe (guarda)Classificar documento na guarda (ação Classificar na guarda)
DocPhysicalDiscardAutorizar descarte do físicoAutorizar o descarte do papel original após a homologação digital
DocImportNativeIngestão de nato-digital (API de integração)Ingestão de documento nato-digital por API, pensada para conta de serviço
DocConfidentialityClassifyClassificar documento/pasta (definir sigilo)Definir o sigilo de um documento (nível e marcas)
DocConfidentialityReclassifyReclassificar sigilo (mudar nível/marcas)Reclassificar o sigilo (mudar nível e marcas, auditado)
DocConfidentialityDeclassifyDesclassificar documento/pastaDesclassificar (remover o sigilo do documento)

Temporalidade, dossiê, classificação e sigilo​

CapacidadeRótulo no ShareO que libera
RetentionAdminGerenciar a tabela de temporalidadeTabela de temporalidade, corte por evento, perfis de dossiê e reconciliação, migração do legado
DossierViewVer o inventário/relatórios de dossiêsVer o inventário e os relatórios de dossiês (leitura)
ClassificationAdminGerenciar o plano de classificação (árvore de classes)Manter a árvore de classificação, atribuir classe a pasta e reaplicar classe em lote
ConfidentialityAdminGerenciar 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)​

CapacidadeRótulo no ShareO que libera
GcvdAdminConfigurar 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)
AuditAdminVer toda a auditoriaVer 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
AccessAuditVer a própria auditoriaAbrir a página de auditoria e ver somente os eventos do próprio usuário
ExportAuditExportar AuditoriaExportar a trilha de auditoria (exigida também no servidor: sem ela a exportação é recusada)
MaintenanceLigar/desligar modo manutenção (repo somente leitura)Manutenção global, com o repositório somente leitura
CapturePausePausar recepção de captura / fila de processamentoPausa da captura (recepção e processamento)
FaultsViewVer falhas de produção (outbox local)Ver o painel de falhas do sistema
BackupAdminAcessar o Backup Agent (backups/restauração)Acesso ao Backup Agent
PreservationAdminExecutar o batch de preservação (propriedades/resumo/assinatura)Preservação (lote, diária, reassinatura, estimativa de custo)
DocCleanVersionHistoryLimpar 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
DocCleanVersionHistoryAdminLimpar 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 / DocVerifyDownloadVerificar integridade (ver revisões) / Verificar integridade (baixar revisões)Abrir e baixar o verificador de versões
RolesAdminUsuários e gruposCriar e editar funções e atribuir capacidades, na tela Funções
CertificateAdminGestão de certificadosGerir 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:

AuditoriaO que registraOnde se vêCapacidades
Auditoria do Alfresco (trilha da guarda)Ações sobre documentos e configurações: conferência, classificação, descarte, bloqueio, sigilo, acesso, loginConsole, Auditoria de conteúdo, e página de auditoria do ShareAccessAudit (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 removidoCapture/Process, Capture AuditViewAllAudit (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çãoRótuloCapacidadesResponsabilidade
gcvd_managerGerente da guardaGcvdAdmin, RetentionAdmin, ClassificationAdmin, DossierView, PreservationAdmin, DocCleanVersionHistoryAdminDono 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_reviewerConferenteDocReviewConfere a legibilidade e a qualidade dos documentos na fila de conferência
gcvd_review_adminSupervisor de conferênciaDocReviewAdmin, DocReviewedEditAdministra 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_classifierClassificadorDocClassifyAplica a classe de guarda a documentos e pastas (ação manual)
gcvd_retention_editorEditor de temporalidadeDocRetentionEditAjusta prazo, data-base e destinação de um documento específico em guarda (não troca o conteúdo)
gcvd_dispose_requesterSolicitante de descarteDocDisposeRequestPede descarte prematuro
gcvd_dispose_approverAprovador de descarteDocDisposeApproveAprova ou recusa pedidos de descarte prematuro
gcvd_dispose_executorExecutor de descarteDocDisposeExecuta o descarte (vencidos ou prematuros já aprovados)
gcvd_hold_officerOficial de bloqueio (hold)DocHold, DocHoldReleaseAplica e libera bloqueio por litígio ou valor histórico
gcvd_confidentiality_officerOficial de sigiloConfidentialityAdmin, DocConfidentialityClassify, DocConfidentialityReclassify, DocConfidentialityDeclassifyClassifica, reclassifica e desclassifica sigilo; administra níveis, marcas e credenciais
gcvd_physical_discard_officerAutorizador de descarte físicoDocPhysicalDiscardAutoriza o descarte do papel original após a homologação digital
gcvd_auditorAuditor da guarda (só leitura)AccessAudit, AuditAdmin, ExportAudit, DocVerifyView, DocVerifyDownloadVê toda a trilha (de todos os usuários), exporta e verifica versões; não age sobre nenhum documento
gcvd_cert_adminAdministrador de certificados (fluxo e captura)CertificateAdminGere os templates de certificado A1 de Fluxo e captura. Não gere os da guarda: esses exigem GcvdAdmin
gcvd_native_importIntegração nato-digital (conta de serviço)DocImportNativeApenas 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çãoRótuloCapacidades
capture_designerDesigner de capturaScanDesigner
workflow_designerDesigner de fluxoWFDesigner
capture_operationsOperação de capturaViewAllAudit, ViewAllJobs, ViewAllLinks, ViewAllPauseds, CapturePause
workflow_operationsOperação de fluxosAllTasks, ClaimAll, FormAll, ReassignAll
system_maintenanceOperador de manutençãoMaintenance
backup_operatorOperador de backupBackupAdmin
faults_viewerVisualizador de falhasFaultsView
integrations_viewerAuditor de integrações 3rd-party3rdSMSViewAll, 3rdGeminiViewAll
portal_adminAdministrador de tenant (Portal)PortalAdmin
portal_super_adminSuper-administrador do PortalPortalSuperAdmin
access_control_adminAdministrador de controle de acessoRolesAdmin
audit_adminVer toda a auditoriaAuditAdmin

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 ACapacidade BPor que não juntar
DocDisposeRequestDocDisposeApproveQuem pede não pode aprovar o próprio pedido
DocDisposeRequest / DocDisposeApproveDocDisposeQuem decide não deveria executar a operação irreversível
GcvdAdmin (configuração)DocDisposeApproveQuem configura a régua de retenção não deveria aprovar exceções a ela
ConfidentialityAdminAccessAudit / AuditAdmin / ExportAuditQuem classifica sigilo não deveria auditar a si mesmo sem checagem externa
DocReviewDocReviewAdminNa 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.

Ver Bloqueio (hold) e Descarte controlado.