facilita.ops · ciclo completo · Benjamin

Do rascunho à evidência clausular: documento que se controla sozinho.

POP, política, protocolo, vivos, com versão vigente, Benjamin lendo estrutura e conteúdo antes da aprovação, diff semântico entre versões classificando o que importa, revisor externo por token, acuse de leitura por colaborador, alerta de vencimento e vínculo automático com cláusula da norma. ISO 9001 7.5 cumprida no nível que normalmente só auditor sênior consegue exigir.

1. Cria + classifica2. Benjamin lê estrutura + conteúdo3. Workflow + revisor externo4. Diff semântico v_old → v_new5. Acuse + vencimento + cláusula
Benjamin
Benjamin
facilita.ops · estrutura, conteúdo, ciclo

Stage 1 · Criação · 10 tipos canônicos, não "upload de arquivo"

Cada tipo tem template, seções obrigatórias e cláusulas que ele cobre. Escopo define quem precisa ler.

1
10 tipos canônicos · escopo · confidencialidade
POL-QUA-007 v2.0 · Procedimento de calibração de equipamentos
Política, regimento, manual, procedimento, POP, instrução de trabalho, formulário, norma interna, plano, protocolo clínico. Cada tipo tem checklist de seções obrigatórias e cláusulas padrão que ele cobre. Escopo (corporativo, setorial, processual, cargo) define quem precisa ler. O autor sobe a versão em rascunho e o sistema cria o DocumentVersion com status draft.
Política
Regimento
Manual
POP
Procedimento
Inst. Trabalho
Formulário
Norma Interna
Plano
Protocolo

POL-QUA-007 · Procedimento de calibração de equipamentos

Indústria Plastel · Responsável: Eng. Paulo Tavares · v2.0 submetida
Procedimento Setorial · Engenharia Interna v2.0 draft Revisão a cada 12 meses
Versão draft submetida · Benjamin acionado · Stage 2

Stage 2 · Benjamin lê estrutura e conteúdo · gera análise documental do Benjamin

1:1 com a versão. Sumário, controles, papéis, KPIs, riscos, cláusulas citadas, gaps. IA aponta, autor decide.

2
análise documental do Benjamin 1:1 com a DocumentVersion · campos jsonb
Benjamin lê o texto inteiro e estrutura o que importa
Quando a versão draft é submetida, Benjamin lê o conteúdo e popula os campos do análise documental do Benjamin: executive_summary, key_controls, responsible_roles, kpis_mentioned, process_steps, covered_risks, cited_standards e gaps_identified. É 1:1: uma versão tem um insight, sem duplicar. Alimenta o contexto consultável de Sebastian e Benjamin via Assistants::ClientContext.
Benjamin
Benjamin · análise de estrutura + conteúdo
"Li o documento. Estruturei sumário, controles, papéis, KPIs e cláusulas citadas. Encontrei 3 gaps que recomendo tratar antes da aprovação."
Sumário executivo · estrutura do documento
Procedimento define rotina de calibração para equipamentos de medição críticos (paquímetros, dinamômetros, balanças analíticas). Periodicidade trimestral, responsabilidade da Engenharia de Qualidade. Inclui critério de aceitação e tratamento de equipamento fora de tolerância.
Controles-chave (conteúdo)
Etiqueta de calibração com validade visível no equipamento
Bloqueio automático no MES quando fora de tolerância
Registro com retenção 5 anos
Papéis responsáveis (estrutura)
Eng. de Qualidade · executor
Supervisor de Produção · acionado em desvio
Gestor de Qualidade · aprovador
KPIs mencionados (conteúdo)
% calibrações no prazo (meta ≥ 95%)
N° de NCs de calibração por trimestre
Cláusulas citadas (conteúdo)
ISO 9001 7.1.5.2 ISO 9001 8.5.4 IATF 16949 7.1.5.2.1
Salvas em cited_standards (jsonb)
Gaps identificados · Benjamin recomenda tratar antes da aprovação
Periodicidade trimestral mencionada, falta justificativa técnica (recomendação fabricante? histórico de desvio?). ISO 9001 7.1.5.2 pede justificativa.
Não há definição de "equipamento de medição crítico", qual o critério? Risco de operador interpretar de forma diferente.
Procedimento não cita o que fazer com produtos fabricados desde a última calibração quando equipamento é encontrado fora de tolerância (rastreabilidade reversa).
Aceito · ajusto agora
Incluo justificativa técnica da periodicidade trimestral (referência fabricante) na seção 3.1.
Adiado · próxima revisão
Definição de "crítico" precisa de discussão com engenharia de produto. Abro tarefa pra próxima versão.
Recusado · justificado
Rastreabilidade reversa é coberta pelo POP-QUA-012 (referenciado na seção 6). Não é gap deste documento.
IA não substitui revisor humano. O análise documental do Benjamin é assistência: estrutura o conteúdo, aponta gaps, sugere ajustes. A norma exige revisão humana antes da aprovação. Benjamin acelera, não elimina.
Gaps tratados · versão pra aprovação · Stage 3

Stage 3 · Workflow draft → revisão → aprovação · revisor externo por token

Revisores internos por papel (técnico, jurídico, qualidade). Parecerista externo recebe link tokenizado, sem cadastro. Decisão idempotente, audit log.

3
Workflow · revisores internos + revisor externo (DocumentExternalReview)
3 revisores internos · 1 jurídico externo via token URL-safe
Quando todos os aprovadores dizem sim (internos + externos), a versão é promovida pelo ApprovalConsolidator. Revisor externo recebe convite com token SecureRandom.urlsafe_base64(32), expiração padrão de 7 dias, decisão idempotente (não dá pra mudar de ideia depois de submeter). IP e user-agent gravados.
Etapa 1
Rascunho
Paulo criou · 03/abr
Etapa 2
Insight gerado
Gaps tratados pelo autor
Etapa 3 · agora
Aprovação · 1 pendente
Aguardando aprovador externo
Etapa 4
Vigente · v2.0
v1.4 marcada obsoleta
PT
Paulo Tavares · author · Engenharia
submeteu
RP
Renata Pinto · technical_reviewer · Qualidade
aprovou em 08/mai
JL
Juliana Lobo · technical_reviewer · Manutenção
aprovou em 09/mai
MS
Dra. Mariana Sá · external_approver · jurídico (sem login)
link enviado · expira 5d 14h
Convite externo (DocumentExternalReview): token URL-safe de 32 bytes, expira em 7 dias por padrão, decisão idempotente. A Dra. Mariana recebe e-mail com link direto, abre o documento na seção comentada (ancorada em DocumentSection), submete approved ou rejected com parecer. Segunda tentativa explode com "Já decidido".
https://ia.facilita.etc.br/r/aHR0cHM6Ly9pYS5mYWNpbGl…
Versão nova aprovada · agora compara contra a antiga · Stage 4

Stage 4 · Diff semântico entre versões · não é linha-a-linha, é interpretação

Benjamin compara v_old vs v_new e classifica em critical, important, minor. Auditor entende em segundos o que mudou na governança.

4
DocumentDiff · semantic_changes (jsonb) · 3 severidades
"Letrinha trocada" fica fora · "controle apagado" fica destacado
Quando a versão nova é submetida, Benjamin compara contra a anterior e popula semantic_changes. Severidades: critical (controle removido, responsável apagado, cláusula deixou de ser citada), important (ambiguidade introduzida, periodicidade alterada) e minor (ortografia, ajuste de redação). Auditor lê e entende impacto sem voltar ao documento.
Versão antiga
v1.4
12/jan/2026 · 9 seções
Versão nova
v2.0
13/mai/2026 · 8 seções
1
Critical
3
Important
1
Minor
CriticalControle removido
Validação cruzada de calibração com 2º instrumento deixou de constar
Seção 5.3 da v1.4 exigia validação cruzada com um segundo paquímetro calibrado. A v2.0 omite. ISO 9001 7.1.5.2 espera confirmação metrológica, sem validação cruzada o controle enfraquece. Confirmar se foi tirado por engano ou se migrou pra outro POP.
ImportantPeriodicidade alterada
Calibração semestral substituiu trimestral em paquímetros
Periodicidade dobrou. v2.0 cita "recomendação Mitutoyo", mas não anexa documento técnico. Auditor vai pedir a referência. Recomendo anexar carta do fabricante no DocumentVersion#attachments.
Parecer Benjamin · overall_assessment
"A v2.0 introduz 1 risco real (Critical) ao remover validação cruzada e 3 Important que pedem ajuste antes da promoção. Minor 1 é linguagem inclusiva, neutro regulatório. Recomendo voltar pra revisão técnica antes da aprovação final."
Versão aprovada · publicada · ciclo de vida ativo · Stage 5

Stage 5 · Acuse, vencimento e evidência clausular

Quem leu, quando vence e qual cláusula ele cobre. Auditor pede prova, abre 1 tela.

5
Acuse de recebimento · alerta de vencimento · auditoria de leitura
"Eu publiquei no SharePoint" não é resposta. Agora você prova quem leu.
Cada colaborador do escopo recebe o link, abre o documento e o sistema registra o aceite (timestamp + IP). Auditor pede "me mostre os 14 engenheiros que leram o POP atualizado", você abre a tela e mostra. Documento a 30 dias do vencimento dispara alerta automático pro responsável.
87%
Leram
8
Pendentes
2.1 dias
Tempo médio
Engenharia QA
12/12
Produção · A
11/12
Manutenção
17/21
Produção · B
13/20
Política POL-RH-003 · Privacidade de Dados vence em 23 dias. Benjamin já abriu tarefa pro responsável revisar; sem revisão, vira não-conformidade automática no audit log.
6
Documento aprovado vira candidato a evidência clausular
Benjamin sugere as cláusulas que este POP pode satisfazer · 1 clique vincula
Quando a versão é promovida, o módulo de evidência clausular consulta tipo + tags + conteúdo (lido pelo análise documental do Benjamin no Stage 2) e sugere quais cláusulas das normas adotadas podem ser cobertas. O responsável aceita em 1 clique e ClauseEvidence é criada ligando o documento à cláusula. Auditor abre a cláusula no dossiê (showcase de cobertura normativa) e o documento está lá como evidência vigente.
Versão aprovada · POL-QUA-007 v2.0
"Procedimento de calibração de equipamentos · paquímetros, dinamômetros, balanças · trimestral"
Cláusulas sugeridas · aceite com 1 clique
Benjamin propõe vincular a 3 cláusulas:
ISO 9001 · 7.1.5.2 ISO 9001 · 8.5.4 IATF 16949 · 7.1.5.2.1
O responsável revisa e aprova. Sem aprovação humana, nada vira evidência ativa.

Documento aprovado deixa de ser arquivo no drive. Vira contexto vivo, lido pela IA, controlado pelo humano.

A pasta da qualidade vira gargalo na primeira auditoria: ninguém sabe qual é a versão vigente, dois POPs com o mesmo nome, colaborador alega que nunca recebeu o documento atualizado. No facilita.ia cada documento tem ciclo de vida, Benjamin lê estrutura e conteúdo gerando insight 1:1, diff semântico entre versões classifica o que importa, revisor externo opina sem cadastro, leitura registrada por colaborador, vencimento monitorado e a aprovação já vira candidata a evidência da cláusula. Auditor pede prova: você abre 1 tela.

Sem facilita.ia
47 arquivos · 0 controle · 0 leitura
SharePoint cheio de _v3_FINAL, ninguém sabe qual é o vigente, leitura é "presumida", diff entre versões é leitura linha-a-linha, parecer externo vem em PDF anexo sem rastro, revisão atrasa 18 meses, vira NC no certificado.
Com Benjamin · ciclo completo
análise documental do Benjamin · diff semântico · token · acuse · cláusula
Tipo canônico + escopo. Benjamin lê estrutura e conteúdo (sumário, controles, KPIs, cláusulas, gaps). Workflow com revisor externo por token URL-safe. Diff semântico entre versões classifica critical/important/minor. Acuse de leitura, alerta de vencimento, vira candidata a evidência da cláusula. Audit log completo.

Organizar minha documentação