Master ontology for HERO AI — imports BFO 2020, CCO v2.0, IOF (Core + Maintenance), Hero Causal Layer (N-ary CausalLink pattern per W3C ODP), 21 domain modules, Task Ontology, and 21 per-domain causal-links files. Conformant with ONTOLOGY-STANDARD v4.2 §40-59 (incl. §57 Empirical-vs-Analytic, §58 N-ary CausalLink Pattern, §59 Normative Basis).
Ontologia master do HERO AI — importa BFO 2020, CCO v2.0, IOF (Core + Maintenance), Camada Causal Hero (padrao N-ario CausalLink per W3C ODP), 21 modulos de dominio, Task Ontology, e 21 arquivos causal-links por dominio. Conforme ONTOLOGY-STANDARD v4.2 §40-59 (incl. §57 Empirico-vs-Analitico, §58 Padrao CausalLink N-ario, §59 Base Normativa).
Ero Copper - Technology Directorate
Copyright (c) 2024-2026 Ero Copper Corp. All rights reserved.
HERO AI Intelligence Ontology
Ontologia HERO AI Intelligence
Methodology: NeOn + LOT + Guarino (1998). Stack: BFO 2020 (ISO 21838-2) -> CCO v2.0 -> IOF (Core + Maintenance) -> Ero domains. Conforms to ONTOLOGY-STANDARD v4.2 (canonical) §40-59: §40-50 BFO/CCO patterns, §51 IOF anchoring, §52 Brazilian Localization (bz-loc:), §53 Meaning-First Protocol, §54 Cost Axis, §55 ISA-95 Equipment Hierarchy, §56 Causal Governance 4-tuple, §57 Empirical-vs-Analytic distinction, §58 N-ary CausalLink pattern (W3C ODP / Noy & Rector 2006) replacing reified owl:Axiom, §59 Normative Basis taxonomy.
alternative label
rotulo alternativo
definicao
definition
preferred label
rotulo preferido
Used by enrichment campaigns (P9, RV-Q-3, REFORMA-FINAL, STUB elimination) to attach a structured audit trail to every entity touched. The referenced blank node carries the six enrich* properties below. Distinct from heroNs:RemediationRecord which is reserved for destructive remediation (KILL, REPARENT) and from heroNs:editorialNote which carries free-form notes only.
Utilizado por campanhas de enriquecimento (P9, RV-Q-3, REFORMA-FINAL, eliminacao de STUB) para anexar uma trilha de auditoria estruturada a cada entidade tocada. O no em branco referenciado carrega as seis propriedades enrich* abaixo. Distinto de heroNs:RemediationRecord (reservado a remediacao destrutiva como KILL e REPARENT) e de heroNs:editorialNote (nota livre).
Enrichment Record
Registro de Enriquecimento
An annotation property whose value is an IRI or blank-node reference to an information content entity recording the full provenance of an enrichment operation applied to an ontology entity; the genus is owl:AnnotationProperty and the differentia is that the referenced node aggregates heroNs:enrichCode, heroNs:enrichDate, heroNs:enrichOperation, heroNs:enrichEvidence, heroNs:enrichSubphase and heroNs:enrichReference as a single audit bundle.
Propriedade de anotacao cujo valor e referencia IRI ou no em branco para uma entidade de conteudo informacional que registra a procedencia completa de uma operacao de enriquecimento aplicada a uma entidade da ontologia; o genero e owl:AnnotationProperty e a diferenca especifica e que o no referenciado agrega heroNs:enrichCode, heroNs:enrichDate, heroNs:enrichOperation, heroNs:enrichEvidence, heroNs:enrichSubphase e heroNs:enrichReference como um pacote unico de auditoria.
## OntoClean -R (the property may apply to an entity at one point in its lifecycle and not at another; the bundle is contingent on the campaign). ## USE Attach to any class or property mutated by an enrichment campaign as the value of heroNs:enrichmentLog on the affected entity. ## DO NOT Confuse with heroNs:RemediationRecord (destructive remediation) or with heroNs:editorialNote (free-form note without structured fields). ## KEY RELATIONSHIPS Aggregates heroNs:enrichCode, heroNs:enrichDate, heroNs:enrichOperation, heroNs:enrichEvidence, heroNs:enrichSubphase, heroNs:enrichReference. ## PARAMS owl:AnnotationProperty range; value is a blank-node or IRI carrying the six fields. ## ERO CONTEXT Used pervasively in Hero campaign artifacts at all sites and the corporate level; audit-grade evidence for SOX retrospective review. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4 Custom Hero Annotations; W3C OWL 2 Annotation Properties (Structural Specification §10).
Hero ONTOLOGY-STANDARD v4.1 Section 4; W3C OWL 2 Structural Spec §10
Used by remediation campaigns to attach a structured audit trail to any destructive change made to the TBox. Required by SOX retrospective review on any class deletion, parent change, or label rename. Distinct from heroNs:EnrichmentRecord which logs enrichment (additive) actions.
Utilizado por campanhas de remediacao para anexar trilha de auditoria estruturada a qualquer mudanca destrutiva no TBox. Requerido pela revisao retrospectiva SOX em deleção de classe, mudanca de parent ou renomeacao. Distinto de heroNs:EnrichmentRecord (acoes aditivas).
Registro de Remediacao
Remediation Record
An annotation property whose value is an IRI or blank-node reference to an information content entity recording a destructive remediation action (KILL, REPARENT, MERGE, RENAME) applied to an ontology entity; the genus is owl:AnnotationProperty and the differentia is that the referenced node aggregates heroNs:remediationId, heroNs:affectedEntity, heroNs:reason and heroNs:status as the audit bundle for irreversible changes.
Propriedade de anotacao cujo valor e referencia IRI ou no em branco para uma entidade de conteudo informacional que registra uma acao de remediacao destrutiva (KILL, REPARENT, MERGE, RENAME) aplicada a uma entidade da ontologia; o genero e owl:AnnotationProperty e a diferenca especifica e que o no referenciado agrega heroNs:remediationId, heroNs:affectedEntity, heroNs:reason e heroNs:status como pacote de auditoria para mudancas irreversiveis.
## OntoClean -R (contingent: an entity may have zero or many remediation records over its lifecycle). ## USE Attach to any class or property altered by a destructive remediation as the value of a remediation reference on the affected entity. ## DO NOT Confuse with heroNs:EnrichmentRecord (additive) or with heroNs:editorialNote. ## KEY RELATIONSHIPS Aggregates heroNs:remediationId, heroNs:affectedEntity, heroNs:reason, heroNs:status. ## PARAMS owl:AnnotationProperty range; value is a blank-node or IRI carrying the four fields. ## ERO CONTEXT Applied during REFORMA-FINAL campaign (2026-05-06) and STUB elimination (2026-05-19). ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4; SOX 404 retrospective change traceability (PCAOB AS 2201).
Hero ONTOLOGY-STANDARD v4.1 Section 4; PCAOB AS 2201
Aponta de uma classe localizada específica de jurisdição de volta ao seu pai abstrato neutro no TBox de domínio. Permite que a camada de localização mapeie, por exemplo, fin:NFe (nota fiscal eletrônica brasileira) para fin:FiscalDocument (abstrato). Usado por ontologias de aplicação (L3) para resolver qual classe localizada concreta instancia o conceito abstrato para uma unidade empresarial.
Points from a jurisdiction-specific localized class back to its jurisdiction-neutral abstract parent in the domain TBox. Enables the localization layer to map, for example, fin:NFe (Brazilian electronic invoice) to fin:FiscalDocument (abstract). Used by application ontologies (L3) to resolve which concrete localized class instantiates the abstract concept for a given enterprise unit.
abstract equivalent
equivalente abstrato
ABox Lakehouse Future Schema
Esquema Futuro Lakehouse do ABox
Onde este individuo ABox ira morar no datalake apos migracao. Range: xsd:string. Formato: '<sistema>: <tabela/view> WHERE <condicao>'. Usado para gerar o contrato Bronze->Silver->Gold que substitui este ABox quando o sistema-fonte conectar.
Where this ABox individual will live in the datalake post-migration. Range: xsd:string. Format: '<system>: <table/view> WHERE <condition>'. Used to generate the Bronze->Silver->Gold contract that replaces this ABox once the source system connects.
abxLakehouseFutureSchema
Annotation property — xsd:string. USE on operational_snapshot/bridge ABox individuals to specify migration target. DO NOT use on canonical (they never migrate). KEY RELATIONSHIPS: paired with abxRetentionTier; consumed by datalake design tool. PARAMS: format = '<system>: <table_or_view> WHERE <condition>'. ERO CONTEXT: example 'SAP S/4HANA Cloud (post Dec/2026): I_Equipment WHERE Manufacturer=EPIROC AND ModelNumber=MT-65'. SOURCE: Hero v4.1 plan + ULTIMA-REFORMA decision (Cost Axis DDR).
Hero v4.1 implementation plan 2026-05-07; ULTIMA-REFORMA Cost Axis DDR R-1D.
ABox Migration Status
Status de Migracao do ABox
Migration lifecycle status of an ABox individual. Range: xsd:string with controlled vocabulary {pending_source_system, migrated, superseded_by_lake}.
Status do ciclo de vida de migracao de um individuo ABox. Range: xsd:string com vocabulario controlado {pending_source_system, migrated, superseded_by_lake}.
abxMigrationStatus
Annotation property — xsd:string CV. USE to track migration lifecycle of operational_snapshot/bridge ABox. DO NOT use on canonical. KEY VALUES: pending_source_system (waiting for SAP/MOM/PI/Coupa to connect); migrated (now lives in lake; this ABox can be deprecated); superseded_by_lake (ABox kept for audit trail only, queries hit lake). PARAMS: paired with abxRetentionTier. ERO CONTEXT: most current items at 'pending_source_system' until Dec/2026 (SAP) or per MCP integration ETA. SOURCE: Hero v4.1 plan.
Hero v4.1 implementation plan 2026-05-07.
Controlled vocabulary: canonical, operational_snapshot, bridge, derived. See ONTOLOGY-STANDARD §X.Y (proposed 2026-05-07).
ABox Retention Tier
Categoria de Retencao do Individuo ABox
Discrimina individuos ABox por ciclo de vida: se permanecem permanentes, migram para o datalake quando sistemas-fonte conectarem, sao instancias-ponte transitorias, ou sao derivados de agregacoes do datalake. Obrigatorio em todo NamedIndividual em arquivos instances/.
Discriminates ABox individuals by lifecycle: whether they remain in the ontology permanently, migrate to the datalake when source systems connect, are transitional bridge instances, or are derived from datalake aggregates. Required on every NamedIndividual in instances/ files.
abxRetentionTier
Annotation property (no rigidity). USE on every ABox NamedIndividual to classify lifecycle. DO NOT confuse with axiomStatus (governance lifecycle of the axiom, not the individual). KEY VALUES (CV): canonical (permanent named entity); operational_snapshot (snapshot manual now, migrates to lake when source system connects); bridge (transitional manual until system go-live); derived (computed from lake aggregates, re-derived periodically). PARAMS: pair with abxSnapshotDate, abxSnapshotSource, abxLakehouseFutureSchema for traceability. ERO CONTEXT: canonical = sites + TSFs + board members + GL accounts + permits + top contracts; operational_snapshot = fleet, employee positions, vendor master; bridge = monthly DF until SAP FI go-live Dec/2026; derived = cost variance, OEE aggregates. SOURCE: docs/abox-ao-implementation-plan-2026-05-07.md §0 + §2.
Hero v4.1 implementation plan 2026-05-07; decision Marcelo Santos.
ABox Snapshot Date
Data do Snapshot ABox
Data em que o snapshot deste individuo ABox foi capturado. Range: xsd:date. Obrigatorio quando abxRetentionTier em (operational_snapshot, bridge, derived).
Date when this ABox individual snapshot was captured. Range: xsd:date. Mandatory when abxRetentionTier in (operational_snapshot, bridge, derived).
abxSnapshotDate
Annotation property — xsd:date. USE to record when a snapshot ABox individual was captured. DO NOT use on canonical individuals (they are timeless). KEY RELATIONSHIPS: paired with abxRetentionTier + abxSnapshotSource. PARAMS: ISO 8601 date e.g. 2026-05-07. ERO CONTEXT: refresh cycle typically monthly for fleet/financial bridges; quarterly for HR positions. SOURCE: Hero v4.1 plan.
ABox Snapshot Source
Fonte do Snapshot ABox
Document or system that generated this ABox snapshot. Range: xsd:string. Format: '<file_path_relative_to_GroundSupportDocumentation> [<section_or_slide_or_sheet_or_row>]'.
Documento ou sistema que gerou este snapshot ABox. Range: xsd:string. Formato: '<caminho_arquivo_relativo_GroundSupportDocumentation> [<secao_ou_slide_ou_sheet_ou_linha>]'.
abxSnapshotSource
Annotation property — xsd:string. USE to record exact provenance of snapshot ABox individuals. DO NOT confuse with sourceReference (TBox grounding) — this is for INSTANCE provenance. KEY RELATIONSHIPS: paired with abxRetentionTier + abxSnapshotDate. PARAMS: format = file path + bracketed locator. ERO CONTEXT: example 'FROTAS ERO CARAIBA.xlsx [PILAR row 5]'; 'Email YCOA V8 Master Guide v7.2 attachment Sheet GL-Accounts row 234'. SOURCE: Hero v4.1 plan.
Used inside RemediationRecord and EnrichmentRecord blank nodes to point to the class, property or instance the audit trail concerns. Multiple values allowed when a single remediation affects multiple entities (e.g., a KILL with parent rewire). Distinct from rdfs:isDefinedBy (which points to the defining ontology) and from heroNs:affectedClass (a stricter variant restricted to owl:Class subjects).
Utilizado dentro de nos RemediationRecord e EnrichmentRecord para apontar a classe, propriedade ou instancia a qual a trilha de auditoria se refere. Valores multiplos permitidos quando uma remediacao afeta varias entidades (p.ex. KILL com rewire de parent). Distinto de rdfs:isDefinedBy (que aponta a ontologia definidora) e de uma futura variante restrita a owl:Class.
Affected Entity Reference
Referencia a Entidade Afetada
An annotation property that carries an IRI reference to the ontology entity that is the target of a remediation or enrichment operation; the genus is owl:AnnotationProperty and the differentia is that its value MUST be an IRI of an entity declared elsewhere in the Hero TBox (class, property or instance) and is interpreted as the foreign key of the remediation/enrichment record.
Propriedade de anotacao que carrega uma referencia IRI a entidade da ontologia que e alvo de operacao de remediacao ou enriquecimento; o genero e owl:AnnotationProperty e a diferenca especifica e que seu valor DEVE ser um IRI de entidade declarada em outro lugar do TBox Hero (classe, propriedade ou instancia) e e interpretado como chave estrangeira do registro de remediacao/enriquecimento.
## OntoClean -R (the relation is contingent on a specific remediation/enrichment event). ## USE Attach inside RemediationRecord / EnrichmentRecord blank nodes pointing to the affected IRI. ## DO NOT Confuse with rdfs:isDefinedBy or with rdfs:seeAlso. ## KEY RELATIONSHIPS Used inside heroNs:RemediationRecord, heroNs:EnrichmentRecord, heroNs:enrichmentLog blank nodes; its value is the target IRI. ## PARAMS Value: xsd:anyURI or an IRI reference. ## ERO CONTEXT Pervasively used across Hero remediation/enrichment campaigns. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Categorical confidence level of the consolidating AI judge (Claude Opus 4.7 by TOC-SG v1.0 default). Values: HIGH (panel unanimous + verifiable evidence), MEDIUM (panel consensus but evidence partial), LOW (divergent panel or thin evidence — must be parked). Populated on every subject that carries heroNs:aiJudgeDecision.
Nível categórico de confiança do juiz IA consolidador (Claude Opus 4.7 por padrão do TOC-SG v1.0). Valores: HIGH (painel unânime + evidência verificável), MEDIUM (consenso do painel mas evidência parcial), LOW (painel divergente ou evidência fraca — deve ser parqueado). Populado em todo sujeito que carrega heroNs:aiJudgeDecision.
AI judge confidence
confiança do juiz IA
Categorical confidence level assigned by the AI judge at the moment of consolidating opiner outputs into a single decision under the TOC-SG v1.0 framework.
Nível categórico de confiança atribuído pelo juiz IA no momento da consolidação das saídas dos opinadores em uma decisão única sob o framework TOC-SG v1.0.
Populate on every subject carrying heroNs:aiJudgeDecision. Literal xsd:string from enum {HIGH, MEDIUM, LOW}. Governed by AIJudgeGovernanceShape SHACL. Values other than HIGH/MEDIUM/LOW are invalid under the TOC-SG v1.0 contract. LOW confidence MUST pair with aiJudgeDecision = DIVERGENT_PARKED.
Hero AI TOC-SG (Triple-Opinion Consensus + SHACL Gate) v1.0 framework, 2026-04-18.
Consolidated decision label emitted by the AI judge (Claude Opus 4.7) after reviewing opiner outputs from Gemini 3.1 Pro (terceira_opiniao) and GPT-5 Pro (segunda_opiniao). Values: CONSENSUS_COMMIT (both opiners converged, evidence solid — commit to TBox); DIVERGENT_PARKED (opiners diverged OR one responded UNSURE/NOT_FOUND — park for human review, P10-generated retained); REJECT_HALLUCINATION (judge detected hallucination signal — reject outright, do not commit and do not park).
Rótulo de decisão consolidada emitido pelo juiz IA (Claude Opus 4.7) após revisar as saídas dos opinadores Gemini 3.1 Pro (terceira_opiniao) e GPT-5 Pro (segunda_opiniao). Valores: CONSENSUS_COMMIT (opinadores convergiram, evidência sólida — commit no TBox); DIVERGENT_PARKED (opinadores divergiram OU um respondeu UNSURE/NOT_FOUND — parqueado para revisão humana, P10-generated mantido); REJECT_HALLUCINATION (juiz detectou sinal de alucinação — rejeitar sem commit nem park).
AI judge decision
decisão do juiz IA
Rótulo de governança tri-valorado — CONSENSUS_COMMIT, DIVERGENT_PARKED ou REJECT_HALLUCINATION — emitido pelo juiz Claude Opus 4.7 no momento da consolidação das saídas do painel de opinadores sob o framework TOC-SG v1.0.
Tri-valued governance label — CONSENSUS_COMMIT, DIVERGENT_PARKED, or REJECT_HALLUCINATION — emitted by the Claude Opus 4.7 judge at the moment of consolidating opiner panel outputs under the TOC-SG v1.0 framework.
Core governance carrier for TOC-SG v1.0. Populate on EVERY subject passing through the pipeline. Literal xsd:string from enum {CONSENSUS_COMMIT, DIVERGENT_PARKED, REJECT_HALLUCINATION}. Presence triggers the AIJudgeGovernanceShape SHACL which requires aiJudgePanel + aiJudgeTimestamp + aiJudgeEvidence + aiJudgeConfidence (all four siblings present). The diff-provider rule MUST hold: judge model identity differs from both opiner model identities.
Hero AI TOC-SG (Triple-Opinion Consensus + SHACL Gate) v1.0 framework, 2026-04-18; grounded in Zheng et al. 2023 (LLM-as-a-Judge, arXiv:2306.05685) and Guo et al. 2024 (Multi-Agent Consensus, arXiv:2311.08692).
Ponteiro de caminho relativo para o arquivo JSONL de evidência que registra a trilha completa de auditória para uma decisão TOC-SG. Formato canônico: 'docs/ai-judge/{gap}/{itemid}.json'. O arquivo contém: JSON bruto do opinador-A, JSON bruto do opinador-B, raciocínio de consolidação do juiz, resultado de válidação pydantic, resultado do gate SHACL. Não vazio para todo sujeito que carregue heroNs:aiJudgeDecision.
Relative path pointer to the evidence JSONL file that records the full audit trail for a TOC-SG decision. Canonical format: 'docs/ai-judge/{gap}/{itemid}.json'. The file contains: opiner-A raw JSON, opiner-B raw JSON, judge consolidation reasoning, pydantic validation result, SHACL gate result. Non-empty for every subject carrying heroNs:aiJudgeDecision.
AI judge evidence
evidência do juiz IA
Ponteiro de caminho relativo do sistema de arquivos para o JSONL de trilha de auditória por-item contendo todas as saídas dos opinadores, raciocínio do juiz e resultados de válidação para uma decisão TOC-SG.
Relative filesystem path pointer to the per-item audit-trail JSONL containing all opiner outputs, judge reasoning, and validation results for a TOC-SG decision.
Populate on every subject carrying heroNs:aiJudgeDecision. Literal xsd:string relative to project root. MUST point to an existing file under docs/ai-judge/. In higher maturity levels the SHA-256 of the JSONL file SHOULD be appended as '#sha256=<hex>' for tamper-evidence.
Compact string identifying the exact model versions that participated in the TOC-SG decision. Canonical format: 'opiner-A=<model>; opiner-B=<model>; judge=<model>'. Example: 'opiner-A=gemini-3.1-pro; opiner-B=gpt-5-pro; judge=claude-opus-4.7'. Captures provenance for reproducibility and future audit of model-specific bias. The diff-provider rule requires that judge model identity differs from both opiner model identities.
String compacta identificando as versões exatas de modelos que participaram da decisão TOC-SG. Formato canônico: 'opiner-A=<modelo>; opiner-B=<modelo>; judge=<modelo>'. Exemplo: 'opiner-A=gemini-3.1-pro; opiner-B=gpt-5-pro; judge=claude-opus-4.7'. Captura proveniência para reprodutibilidade e auditória futura de viés por modelo. A regra de provedor distinto exige que o modelo do juiz seja diferente dos dois opinadores.
AI judge panel
painel do juiz IA
String estruturada identificando as versões específicas dos modelos dos dois opinadores e do único juiz que participaram da produção de uma decisão TOC-SG.
Structured string identifying the specific model versions of the two opiners and the single judge that participated in producing a TOC-SG decision.
Populate on every subject carrying heroNs:aiJudgeDecision. Literal xsd:string following canonical format 'opiner-A=<model>; opiner-B=<model>; judge=<model>'. Judge model MUST differ from both opiner models (diff-provider rule — enforces architectural diversity to reduce correlated bias). Model identifiers SHOULD match exactly the strings used by the external-model-router skill.
Carimbo de tempo ISO-8601 UTC registrando o momento exato em que o juiz IA emitiu sua decisão consolidada. Formato: 'YYYY-MM-DDTHH:MM:SSZ'. Usado para replay, análise de deriva e correlação com eventos externos (ex.: atualizações de versão de modelo).
ISO-8601 UTC timestamp recording the exact moment the AI judge emitted its consolidated decision. Format: 'YYYY-MM-DDTHH:MM:SSZ'. Used for replay, drift analysis, and correlation with external events (e.g., model version updates).
AI judge timestamp
carimbo de tempo do juiz IA
Carimbo de tempo ISO-8601 UTC marcando o momento exato em que o juiz Claude Opus 4.7 finalizou sua consolidação das saídas dos opinadores para uma decisão TOC-SG.
ISO-8601 UTC timestamp marking the exact moment the Claude Opus 4.7 judge finalised its consolidation of opiner outputs for a TOC-SG decision.
Populate on every subject carrying heroNs:aiJudgeDecision. Literal xsd:dateTime (preferred) or xsd:string following strict ISO-8601 UTC format 'YYYY-MM-DDTHH:MM:SSZ'. MUST be the wall-clock time of the judge call completion, not the SHACL gate completion nor the TTL commit time.
Hero AI TOC-SG (Triple-Opinion Consensus + SHACL Gate) v1.0 framework, 2026-04-18; ISO-8601:2019 Date and time representations for information interchange.
Aplicar em classes representando ativos físicos, plantas, áreas, sites, componentes ou modos de falha. O valor DEVE ser um de "Enterprise", "Site", "Area", "ProcessCell", "Unit", "Equipment", "Component", "FailureMode".
Apply on classes representing physical assets, plants, areas, sites, components, or failure modes. Value MUST be one of "Enterprise", "Site", "Area", "ProcessCell", "Unit", "Equipment", "Component", "FailureMode". For mnt:FailureMode use "FailureMode".
APM asset hierarchy level
Nível de hierarquia de ativos APM
Annotation that classifies a class according to Gartner Asset Performance Management asset hierarchy — controlled vocabulary: Enterprise, Site, Area, ProcessCell, Unit, Equipment, Component, FailureMode. Aligns with ISA-95 EquipmentHierarchy and enables RCM (Reliability-Centered Maintenance), RCFA (Root Cause Failure Analysis), and PdM (Predictive Maintenance) scoping.
Anotação que classifica uma classe de acordo com a hierarquia de ativos da Gestão de Desempenho de Ativos (APM) Gartner — vocabulário controlado: Enterprise, Site, Area, ProcessCell, Unit, Equipment, Component, FailureMode. Alinha-se com a EquipmentHierarchy ISA-95 e habilita escopo de RCM (Manutenção Centrada em Confiabilidade), RCFA (Análise de Causa Raiz de Falha) e PdM (Manutenção Preditiva).
USE: declare on asset/plant/component classes for APM tooling integration (Aveva APM, Bentley AssetWise, GE APM, IBM Maximo APM). DO NOT: confuse with isa95Level (ISA-95 is functional layer; APM hierarchy is structural decomposition). KEY RELATIONSHIPS: aligns with ast:EquipmentHierarchyLevel taxonomy already in Hero (Enterprise/Area/OperationalUnit/Subsystem/EquipmentTag) — the APM annotation makes the alignment explicit. PARAMS: literal value (xsd:string). ERO CONTEXT: required for Asset Master Data integration with SAP PM and Functional Location hierarchy. SOURCE: Gartner Magic Quadrant for Asset Performance Management (2024); ISO 14224:2016 (Petroleum, petrochemical and natural gas industries — Reliability and maintenance data); IEC 62264 EquipmentHierarchy.
Gartner Magic Quadrant for APM (2024); ISO 14224:2016; IEC 62264-1:2013
Used to trace a TBox class or property back to the human-readable design decision that justifies its presence. The value is typed as a plain string and follows the ADR convention introduced by Michael Nygard in 'Documenting Architecture Decisions' (2011). Distinct from heroNs:designDecision (free-form design rationale without ADR registry) and from heroNs:sourceReference (normative external grounding).
Utilizado para rastrear uma classe ou propriedade TBox ate a decisao de design legivel por humanos que justifica sua presenca. O valor e tipado como string simples e segue a convencao ADR introduzida por Michael Nygard em 'Documenting Architecture Decisions' (2011). Distinto de heroNs:designDecision (justificativa livre sem registro ADR) e de heroNs:sourceReference (grounding normativo externo).
Architecture Decision Record Reference
Referencia ao Registro de Decisao de Arquitetura
An annotation property that carries an identifier and short summary of an Architecture Decision Record (ADR) that documents an architectural decision affecting the entity; the genus is owl:AnnotationProperty and the differentia is that the literal value follows the ADR-NNN pattern (Nygard 2011) and points to a Markdown ADR file in the Hero repository docs.
Propriedade de anotacao que carrega um identificador e resumo curto de um Architecture Decision Record (ADR) documentando decisao arquitetural que afeta a entidade; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor literal segue o padrao ADR-NNN (Nygard 2011) e aponta a um arquivo Markdown ADR no repositorio docs do Hero.
## OntoClean -R (the relation is contingent on the existence of an ADR documenting the design). ## USE Tag classes or properties introduced or modified by a documented ADR (e.g., 'ADR-042 Adopt IOF Maintenance as canonical equipment-fault hierarchy'). ## DO NOT Confuse with heroNs:designDecision or heroNs:sourceReference. ## KEY RELATIONSHIPS Value points to a docs/adr/ADR-NNN-*.md file inside the Hero repository. ## PARAMS Value: xsd:string (e.g., 'ADR-042: Adopt iof-maint:* as canonical maintenance anchor'). ## ERO CONTEXT Used across all 21 Ero domains whenever a non-trivial TBox decision is taken. ## SOURCE Nygard 2011 'Documenting Architecture Decisions'; Hero ONTOLOGY-STANDARD v4.1 Section 4.
Nygard 2011; Hero ONTOLOGY-STANDARD v4.1 Section 4
Person who approved the axiom for production use.
Pessoa que aprovou o axioma para uso em produção.
Approved By
Aprovado Por
Data em que o axioma foi aprovado para produção.
Date when the axiom was approved for production.
Approved Date
Data de Aprovação
Categorical classification: local, cross_domain, canonical_rule, definition, requirement.
Classificação categorica: local, cross_domain, canonical_rule, definition, requirement.
Axiom Category
Categória do Axioma
Epistemic certainty level of the causal relationship asserted by this axiom, independent of business impact (axiomSeverity) and bibliographic provenance (axiomSource). Controlled vocabulary: empirical_validated (field data from Ero Copper sites confirms the relationship — e.g., Caraíba concentrator recovery vs. ore hardness correlation from 3+ years of PI System data), empirical_literature (published peer-reviewed studies confirm the relationship in comparable mining contexts — e.g., Bond's Third Theory for comminution energy, Folkard & Akerstedt 2004 for shift fatigue), theoretical (first-principles physics, chemistry, or engineering mechanics predict the relationship — e.g., Darcy's law for groundwater flow, Fick's law for diffusion in leaching), expert_consensus (domain experts agree based on professional experience but limited quantitative data — e.g., blast damage propagation patterns in Caraíba's marble host rock), analogical (inferred from analogous deposits, operations, or industries — relationship not directly observed at Ero sites — e.g., magmatic fluid pathways from IOCG deposit analogs). Hierarchical confidence: empirical_validated > empirical_literature > theoretical > expert_consensus > analogical.
Nível de certeza epistêmica da relação causal afirmada por este axioma, independente do impacto nos negócios (axiomSeverity) e da proveniência bibliográfica (axiomSource). Vocabulário controlado: empirical_validated (dados de campo dos sites da Ero Copper confirmam a relação — e.g., correlação recuperação do concentrador Caraíba vs. dureza do minério de 3+ anos de dados do PI System), empirical_literature (estudos publicados revisados por pares confirmam a relação em contextos de mineração comparáveis — e.g., Terceira Teoria de Bond para energia de cominuição, Folkard & Akerstedt 2004 para fadiga de turno), theoretical (princípios fundamentais de física, química ou mecânica de engenharia preveem a relação — e.g., Lei de Darcy para fluxo de águas subterrâneas, Lei de Fick para difusão em lixiviação), expert_consensus (especialistas do domínio concordam com base em experiência profissional mas dados quantitativos limitados — e.g., padrões de propagação de dano de detonação no mármore hospedeiro de Caraíba), analogical (inferido de depósitos, operações ou indústrias análogas — relação não observada diretamente em sites Ero — e.g., caminhos de fluidos magmáticos de análogos de depósitos IOCG). Hierarquia de confiança: empirical_validated > empirical_literature > theoretical > expert_consensus > analogical.
axiom confidence
confiança do axioma
Anotação de certeza epistêmica capturando quão bem evidenciada é uma relação causal, em uma escala categórica de cinco níveis de validado em campo a inferência analógica. Permite raciocínio ponderado por confiança e priorização dos esforços de validação de axiomas.
Epistemic certainty annotation capturing how well-evidenced a causal relationship is, on a five-level categorical scale from field-validated to analogical inference. Enables confidence-weighted reasoning and prioritization of axiom validation efforts.
Person or system that created the axiom (e.g., 'LLM:Claude_Opus_4.6').
Pessoa ou sistema que criou o axioma (e.g., 'LLM:Claude_Opus_4.6').
Created By
Criado Por
Identificador da pessoa ou sistema automatizado que originalmente redigiu este axioma.
Identifier of the person or automated system that originally authored this axiom.
Data em que o axioma foi criado pela primeira vez, no formato xsd:date.
Date when the axiom was first created, in xsd:date format.
Created Date
Data de Criação
Calendar date (xsd:date) when this axiom was originally authored.
Data do calendário (xsd:date) em que este axioma foi originalmente redigido.
Código do dominio-alvo para axiomas cross-domain (MAIUSCULO).
Target domain code for cross-domain axioms (UPPERCASE).
Cross-Domain Target
Dominio-Alvo Cross-Domain
Código de dominio de tres letras MAIUSCULAS identificando o dominio-alvo para axiomas cross-domain. Somente populado em axiomas com prefixo AX.
Three-letter UPPERCASE domain code identifying the target domain for cross-domain axioms. Only populated on AX-prefixed axiom IDs.
Explanation of why the axiom was deprecated -- bilingual recommended.
Explicação de por que o axioma foi deprecado -- bilingue recomendado.
Deprecation Reason
Motivo da Deprecação
Código do dominio que possui este axioma (MAIUSCULO, e.g., MNT).
Domain code that owns this axiom (UPPERCASE, e.g., MNT).
Dominio Primário
Primary Domain
Código de dominio de tres letras MAIUSCULAS identificando o dominio primário que possui este axioma.
Three-letter UPPERCASE domain code identifying the primary domain that owns this axiom.
Calendar date (xsd:date) from which this axiom is considered valid. For regulatory axioms, this is the date the underlying legislation or regulation entered into force (e.g., Lei 13.540/2017 for CFEM rates, LC 214/2025 for tax reform). For empirical axioms, this is the date the supporting evidence was collected or published. When absent, the axiom is assumed to be valid since the ontology's creation date.
Data do calendário (xsd:date) a partir da qual este axioma é considerado válido. Para axiomas regulatórios, esta é a data em que a legislação ou regulamento subjacente entrou em vigor (e.g., Lei 13.540/2017 para alíquotas CFEM, LC 214/2025 para reforma tributária). Para axiomas empíricos, esta é a data em que a evidência de suporte foi coletada ou publicada. Quando ausente, o axioma é assumido como válido desde a data de criação da ontologia.
effective from
vigente a partir de
Calendar date (xsd:date) marking the beginning of the temporal validity window for this axiom. Enables time-aware reasoning over regulatory changes, scientific updates, and operational condition shifts.
Data do calendário (xsd:date) marcando o início da janela de validade temporal deste axioma. Permite raciocínio temporal sobre mudanças regulatórias, atualizações científicas e alterações nas condições operacionais.
Calendar date (xsd:date) until which this axiom is considered valid. When populated, the axiom is considered expired after this date (e.g., a tax rate replaced by new legislation, a causal relationship invalidated by updated scientific evidence). When absent, the axiom is considered currently valid (open-ended). Should be populated simultaneously with axiomStatus = 'deprecated' and axiomSupersededBy when the axiom is replaced.
Data do calendário (xsd:date) até a qual este axioma é considerado válido. Quando populado, o axioma é considerado expirado após esta data (e.g., alíquota tributária substituída por nova legislação, relação causal invalidada por evidência científica atualizada). Quando ausente, o axioma é considerado atualmente válido (prazo aberto). Deve ser populado simultaneamente com axiomStatus = 'deprecated' e axiomSupersededBy quando o axioma é substituído.
effective to
vigente até
Calendar date (xsd:date) marking the end of the temporal validity window for this axiom. Enables sunset detection and regulatory transition tracking.
Data do calendário (xsd:date) marcando o fim da janela de validade temporal deste axioma. Permite detecção de expiração e rastreamento de transições regulatórias.
ID da SHACL shape que implementa este axioma como restrição.
SHACL shape ID that implements this axiom as a constraint.
Aplicado pela Shape SHACL
Enforced By SHACL Shape
Identificador único para rastreabilidade de axiomas reificados. Formato: {TIPO}-{DOMÍNIO_ORIGEM}[-{DOMÍNIO_ALVO}]-{SEQUENCIAL:3}. Tipos: AL (local), AX (cross-domínio), RC (regra canônica), DF (definição), RQ (de CQ).
Unique identifier for traceability of reified axioms. Format: {TYPE}-{DOMAIN_SOURCE}[-{DOMAIN_TARGET}]-{SEQUENTIAL:3}. Types: AL (local), AX (cross-domain), RC (canonical rule), DF (definition), RQ (from CQ).
ID do axioma
axiom ID
CSV of UPPERCASE domain codes affected if this axiom changes.
Lista CSV de códigos MAIUSCULOS de dominios afetados se este axioma mudar.
Impacta Dominios
Impacts Domains
Instruction for HERO AI agents: when to check, what to flag, what to recommend if violated.
Instrução para agentes HERO AI: quando verificar, o que sinalizar, o que recomendar se violado.
Axiom LLM Instruction
Instrução LLM do Axioma
Avaliação categórica de se a relação causal descrita por este axioma pode ser monitorada usando a infraestrutura de dados existente da Ero Copper. Vocabulário controlado: instrumented (sinal direto de sensor/PLC existe no PI System, SCADA ou AVEVA MOM — e.g., potência do moinho, nível da célula de flotação, fluxo de ar de ventilação), calculated (derivável de dados de sistemas existentes via fórmula ou junção — e.g., custo C1 de caixa do SAP FI/CO + dados de produção MES, OEE de tempo de parada + throughput), estimated (requer entrada manual, julgamento de especialista ou amostragem periódica — e.g., RQD geotécnico de testemunho de sondagem, estado de fadiga de avaliação subjetiva), unobservable (variável latente sem caminho de medição direto ou indireto na infraestrutura atual — e.g., campo de tensão in-situ, continuidade do corpo de minério entre furos de sondagem, nível de engajamento do empregado). Usado por agentes de IA e engenheiros de dados para avaliar quais cadeias causais podem ser operacionalizadas em dashboards e alertas vs. quais requerem nova instrumentação ou indicadores proxy.
Categorical assessment of whether the causal relationship described by this axiom can be monitored using Ero Copper's existing data infrastructure. Controlled vocabulary: instrumented (direct sensor/PLC signal exists in PI System, SCADA, or AVEVA MOM — e.g., mill power draw, flotation cell level, ventilation airflow), calculated (derivable from existing system data via formula or join — e.g., C1 cash cost from SAP FI/CO + MES production data, OEE from downtime + throughput), estimated (requires manual input, expert judgment, or periodic sampling — e.g., geotechnical RQD from drill core logging, fatigue state from subjective assessment), unobservable (latent variable with no direct or indirect measurement path in current infrastructure — e.g., in-situ stress field, ore body continuity between drill holes, employee engagement level). Used by AI agents and data engineers to assess which causal chains can be operationalized in dashboards and alerts vs. which require new instrumentation or proxy indicators.
observabilidade
observability
Anotação categórica avaliando a prontidão da infraestrutura de dados para monitorar uma relação causal. Conecta a ontologia à arquitetura de data lakehouse da Ero Copper indicando se existe sinal em tempo real, calculado, estimado ou nenhum para cada elo causal.
Categorical annotation assessing data infrastructure readiness for monitoring a causal relationship. Bridges the ontology to the Ero Copper data lakehouse architecture by indicating whether real-time, calculated, estimated, or no signal exists for each causal link.
Qual arquivo de prompt originou este axioma durante a construção.
Which prompt file originated this axiom during construction.
Prompt Source
Prompt de Origem
Bilingual (en-US, pt-BR) explanation of WHY the axiom exists. A justified axiom is a founded decision; an unjustified axiom is an arbitrary rule. One sentence per language explaining business need or logical foundation.
Explicação bilíngue (en-US, pt-BR) do POR QUE o axioma existe. Um axioma justificado é uma decisão fundamentada; um axioma não-justificado é uma regra arbitrária. Uma frase por idioma explicando necessidade de negócio ou fundação lógica.
axiom rationale
justificativa do axioma
CQ ID that validates this axiom via SPARQL.
ID da CQ que válida este axioma via SPARQL.
Questao de Competência Relacionada
Related Competency Question
Person who reviewed the axiom.
Pessoa que revisou o axioma.
Reviewed By
Revisado Por
Data em que o axioma foi revisado.
Date when the axiom was reviewed.
Data de Revisao
Reviewed Date
Classificação de impacto de violação de axioma: CRITICAL (inconsistência lógica, risco de segurança, não-conformidade — ABox rejeitado), IMPORTANT (degradação de qualidade de dados — alerta, correção em 30 dias), RECOMMENDED (perda de info complementar — aviso).
Impact classification of axiom violation: CRITICAL (logical inconsistency, safety risk, non-compliance — ABox rejected), IMPORTANT (data quality degradation — alert, 30-day correction), RECOMMENDED (loss of complementary info — warning).
axiom severity
severidade do axioma
Comma-separated list of Ero Copper site codes to which this axiom applies. Controlled vocabulary: CAR (Caraíba), TUC (Tucumã), XAV (Xavantina), FUR (Furnas), ALL (all sites). When absent, the axiom is assumed to apply to ALL sites. Site-specific axioms arise from geological conditions (ore type, mineralogy), processing configurations (SAG vs. ball mill, CIL vs. flotation), regulatory jurisdictions (TFRM-PA applies to TUC+FUR but not CAR+XAV), and operational phase (FUR is development, others are producing).
Lista separada por vírgulas dos códigos de sites da Ero Copper aos quais este axioma se aplica. Vocabulário controlado: CAR (Caraíba), TUC (Tucumã), XAV (Xavantina), FUR (Furnas), ALL (todos os sites). Quando ausente, o axioma é assumido como aplicável a TODOS os sites. Axiomas site-específicos surgem de condições geológicas (tipo de minério, mineralogia), configurações de processamento (SAG vs. moinho de bolas, CIL vs. flotação), jurisdições regulatórias (TFRM-PA aplica-se a TUC+FUR mas não a CAR+XAV), e fase operacional (FUR está em desenvolvimento, demais em produção).
escopo de site
site scope
Anotação de vocabulário controlado restringindo a aplicabilidade de um axioma a sites de mineração específicos da Ero Copper. Permite raciocínio causal filtrado por site e previne supergeneralização de relações site-específicas.
Controlled-vocabulary annotation restricting the applicability of an axiom to specific Ero Copper mining sites. Enables site-filtered causal reasoning and prevents overgeneralization of site-specific relationships.
Grounding normativo do axioma. Mesma lógica de sourceReference mas para axiomas ao invés de classes. Referência ISO, regulação brasileira, frameworks, políticas internas, literatura acadêmica, documentação de fornecedor.
Normative grounding of the axiom. Same logic as sourceReference but for axioms instead of classes. References ISO, Brazilian regulation, frameworks, internal policies, academic literature, vendor documentation.
axiom source
fonte do axioma
Número de pagina, intervalo de paginas, ou localizador de citação que identifica onde na fonte a passagem citada aparece (ex.: 'pp. 123-125' ou 'Secao 4.2').
Page number, page range, or locator citation identifying where in the source the quoted passage appears (e.g., 'pp. 123-125' or 'Section 4.2').
axiomSourcePage
Axiom Source Page
Fonte do Axioma -- Page
Use axiomSourcePage to attach verbatim-quote provenance to reified owl:Axiom instances per the R6.5 COMPLIANCE-GATE rule. Stub values marked or require P10 reviewer verification.
P10.6 R6.5 FOG verbatim-quote governance rule
Texto literal citado da fonte que fundamenta o axioma. Valores provisórios carregam o prefixo [P10-generated-FOG-QUOTE] ate que um revisor humano verifique o texto contra a copia física.
Verbatim text quoted from the source that grounds the axiom. Stub values carry the [P10-generated-FOG-QUOTE] prefix until a human reviewer verifies the text against the physical source copy.
axiomSourceQuote
Axiom Source Quote
Fonte do Axioma -- Quote
Use axiomSourceQuote to attach verbatim-quote provenance to reified owl:Axiom instances per the R6.5 COMPLIANCE-GATE rule. Stub values marked or require P10 reviewer verification.
Lifecycle status of axiom: draft (proposed, pending review), approved (reviewed and approved by domain steward), deprecated (marked for removal, kept for traceability).
Status de ciclo de vida do axioma: draft (proposto, aguardando revisão), approved (revisado e aprovado pelo responsável do domínio), deprecated (marcado para remoção, mantido para rastreabilidade).
axiom status
status do axioma
ID do axioma substituto quando este e substituido.
ID of the replacement axiom when this one is superseded.
Substituido Por
Superseded By
Axiom ID (heroNs:axiomID value) of the replacement axiom that supersedes this one. Populated when axiomStatus transitions to 'deprecated' due to regulatory change, scientific update, or ontological refactoring. Enables forward-chaining from deprecated axioms to their current replacements, maintaining audit trail continuity for SOX compliance. Should be populated simultaneously with axiomEffectiveTo and axiomStatus = 'deprecated'.
ID do axioma (valor de heroNs:axiomID) do axioma substituto que sucede este. Populado quando axiomStatus transiciona para 'deprecated' devido a mudança regulatória, atualização científica ou refatoração ontológica. Permite encadeamento direto de axiomas deprecados para seus substitutos atuais, mantendo a continuidade da trilha de auditoria para conformidade SOX. Deve ser populado simultaneamente com axiomEffectiveTo e axiomStatus = 'deprecated'.
Semantic version (MAJOR.MINOR).
Versao semantica (MAJOR.MINOR).
Axiom Version
Versao do Axioma
Número de versao semantica rastreando a evolução de um axioma específico, usando formato MAJOR.MINOR.
Semantic version number tracking the evolution of a specific axiom, using MAJOR.MINOR format.
Requerido (per v4.1 §32 Quantification Governance) em qualquer axioma reificado ou MeasurementICE que carrega valor numerico estimado, calculado ou modelado, de modo que a metodologia seja rastreavel a uma formula ou procedimento normativo (p.ex. NI 43-101 estimacao de reservas, simulacao MetSim de flowsheet, IFRS 9 perda esperada). Distinto de heroNs:requiredInputVariable (entrada) e heroNs:requiredDataset (fonte).
Required (per v4.1 §32 Quantification Governance) on any reified axiom or MeasurementICE that carries an estimated, calculated or modelled numeric value, so that the methodology is traceable back to a normative formula or procedure (e.g., NI 43-101 reserve estimation, MetSim flowsheet simulation, IFRS 9 expected credit loss). Distinct from heroNs:requiredInputVariable (input side) and heroNs:requiredDataset (data source side).
Calculation Method Reference
Referencia ao Metodo de Calculo
An annotation property that carries an IRI reference to a Hero class representing the calculation or estimation method that produces a given quality, KPI or financial value; the genus is owl:AnnotationProperty (Group F.2 of v4.1 §32 Quantification Governance) and the differentia is that its value MUST be an IRI of a Method or Procedure class (cco:DirectiveICE or descendant) declared elsewhere in the Hero TBox.
Propriedade de anotacao que carrega referencia IRI a classe Hero que representa o metodo de calculo ou estimativa que produz uma qualidade, KPI ou valor financeiro; o genero e owl:AnnotationProperty (Grupo F.2 da v4.1 §32 Quantification Governance) e a diferenca especifica e que seu valor DEVE ser IRI de uma classe Method ou Procedure (cco:DirectiveICE ou descendente) declarada em outro lugar no TBox Hero.
## OntoClean -R (contingent: the relation holds only if the entity is the output of a documented calculation method). ## USE Tag any quantified axiom or MeasurementICE with the IRI of the calculating method. ## DO NOT Confuse with heroNs:requiredInputVariable (input axis) or heroNs:requiredDataset (dataset axis). ## KEY RELATIONSHIPS Pairs with heroNs:requiredInputVariable, heroNs:requiredDataset, heroNs:quantificationStatus, heroNs:estimateUncertainty in the Quantification Governance bundle of §32. ## PARAMS Value: xsd:anyURI / IRI of a Method or Procedure class. ## ERO CONTEXT Examples: cco:DirectiveICE for NI 43-101 reserve estimation; prc:MetSimSimulation; fin:DCFValuationMethod; geo:KrigingEstimationMethod. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 32 Quantification Governance.
Categorical estimate of the time delay between cause activation and effect manifestation for a single causal link. Controlled vocabulary: immediate (seconds to minutes — e.g., blast detonation to ground vibration), shift (hours within a single shift — e.g., fatigue accumulation to incident risk), operational (days to weeks — e.g., reagent dosage change to flotation recovery trend), financial (months — e.g., CFEM accrual to cash disbursement, inventory buildup to working capital impact), strategic (quarters to years — e.g., ore reserve depletion to mine life, regulatory change to operational compliance). Grounded in operational mining practice: immediate aligns with SCADA/PLC response times, shift with NR-22 shift duration constraints, operational with MES production cycles, financial with SAP FI posting periods, strategic with NI 43-101 reserve reporting cycles.
Estimativa categórica do atraso temporal entre a ativação da causa e a manifestação do efeito para um único elo causal. Vocabulário controlado: immediate (segundos a minutos — e.g., detonação de explosivo para vibração do terreno), shift (horas dentro de um turno — e.g., acúmulo de fadiga para risco de incidente), operational (dias a semanas — e.g., mudança de dosagem de reagente para tendência de recuperação na flotação), financial (meses — e.g., provisionamento CFEM para desembolso de caixa, acúmulo de estoque para impacto no capital de giro), strategic (trimestres a anos — e.g., depleção de reserva de minério para vida útil da mina, mudança regulatória para conformidade operacional). Fundamentado na prática operacional de mineração: immediate alinha com tempos de resposta SCADA/PLC, shift com restrições de duração de turno NR-22, operational com ciclos de produção MES, financial com períodos de lançamento SAP FI, strategic com ciclos de reporte de reservas NI 43-101.
causal temporal lag
defasagem temporal causal
Anotação categórica capturando o atraso temporal característico entre causa e efeito em um único elo causal. Permite raciocínio priorizado por urgência e alinhamento com os horizontes de planejamento operacional, financeiro e estratégico da Ero Copper.
Categorical annotation capturing the characteristic time delay between cause and effect in a single causal link. Enables urgency-prioritized reasoning and alignment with Ero Copper's operational, financial, and strategic planning horizons.
Used to bidirectionally link a TBox class or property to the Competency Questions that exercise it, providing a regression-test channel for the ontology. Per Hero NeOn / LOT methodology any new class must declare which CQs it satisfies before merge. Distinct from heroNs:llmInstruction (LLM-facing usage guide).
Utilizado para vincular bidirecionalmente uma classe ou propriedade TBox as Questoes de Competencia que a exercitam, fornecendo canal de teste de regressao para a ontologia. Conforme metodologia Hero NeOn / LOT toda classe nova precisa declarar quais CQs satisfaz antes de merge. Distinto de heroNs:llmInstruction (guia de uso para LLM).
Competency Question Identifier
Identificador de Questao de Competencia
An annotation property that carries a CQ-NNN identifier of a Competency Question (in the NeOn / LOT sense) that the entity must satisfy; the genus is owl:AnnotationProperty and the differentia is that the literal value follows the CQ-NNN pattern and points to a SPARQL query stored under cqs/ in the Hero repository.
Propriedade de anotacao que carrega identificador CQ-NNN de uma Questao de Competencia (sentido NeOn / LOT) que a entidade deve satisfazer; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor literal segue o padrao CQ-NNN e aponta a uma consulta SPARQL armazenada em cqs/ no repositorio Hero.
## OntoClean -R (the relation is contingent on the existence of a CQ that exercises the entity). ## USE Tag a TBox entity with the IDs of every CQ that touches it. ## DO NOT Confuse with heroNs:llmInstruction or rdfs:seeAlso. ## KEY RELATIONSHIPS Value points to cqs/CQ-NNN-*.sparql in the Hero repository. ## PARAMS Value: xsd:string (e.g., 'CQ-028: inverseOf coverage'). ## ERO CONTEXT Used across all 21 domains; CQs cover the value chain end-to-end (geo to fin). ## SOURCE Suarez-Figueroa et al. 2012 NeOn Methodology; Hero ONTOLOGY-STANDARD v4.1 Section 19.
NeOn Methodology 2012; Hero ONTOLOGY-STANDARD v4.1 Section 19
Used by the ontology engineer to document why a parent class either receives an owl:DisjointUnion axiom (children are exhaustive and mutually exclusive) or declines it (open class, ongoing taxonomy discovery, future-proofing). Mandatory whenever owl:DisjointUnion is asserted or explicitly declined. Distinct from heroNs:designDecision (broader scope).
Utilizado pelo engenheiro de ontologia para documentar por que uma classe pai recebe (filhos exaustivos e mutuamente exclusivos) ou recusa (classe aberta, descoberta taxonomica em curso, preparacao para futuro) o axioma owl:DisjointUnion. Obrigatoria sempre que owl:DisjointUnion e asserido ou explicitamente recusado. Distinto de heroNs:designDecision (escopo mais amplo).
Decisao de Cobertura para owl:DisjointUnion
DisjointUnion Covering Decision
An annotation property that carries a natural-language explanation of why an owl:DisjointUnion (covering axiom) was or was not applied to a parent class; the genus is owl:AnnotationProperty and the differentia is that the value is a bilingual explanatory string interpreted as the rationale tag on the parent class of a candidate disjoint union (whether asserted or declined).
Propriedade de anotacao que carrega explicacao em linguagem natural sobre por que um owl:DisjointUnion (axioma de cobertura) foi ou nao aplicado a uma classe pai; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor e uma string explicativa bilingue interpretada como tag de justificativa na classe pai de uma uniao disjunta candidata (aplicada ou recusada).
## OntoClean -R (the relation is contingent on a covering-decision review event). ## USE Attach to any class that is a parent of a candidate disjoint union with the rationale string. ## DO NOT Confuse with heroNs:designDecision or rdfs:comment. ## KEY RELATIONSHIPS Documents owl:DisjointUnion presence/absence on parent classes. ## PARAMS Value: xsd:string bilingual rationale ('Covering: yes -- 4 exhaustive children per ISO X' OR 'Covering: no -- new lithology variants under discovery'). ## ERO CONTEXT Used across geo / prc / ops / scm taxonomies where the question 'is the children list closed?' is non-trivial. ## SOURCE OWL 2 Structural Specification §9.1.4; Hero ONTOLOGY-STANDARD v4.1 Section 12.
W3C OWL 2 Structural Spec §9.1.4; Hero ONTOLOGY-STANDARD v4.1 Section 12
Used on reified cross-domain causal axioms (in causal/*.ttl) to mark which domain is the source of the causal link. Pairs with heroNs:axiomID which encodes the same information in the AX-{ORIGIN}-{TARGET}-{SEQ} pattern; crossDomainSource is the queryable normalized form. Distinct from rdfs:isDefinedBy (which points to the ontology, not a domain code).
Utilizado em axiomas causais cross-domain reificados (em causal/*.ttl) para marcar qual e o dominio de origem do vinculo causal. Pareia com heroNs:axiomID que codifica a mesma informacao no padrao AX-{ORIGIN}-{TARGET}-{SEQ}; crossDomainSource e a forma normalizada consultavel. Distinto de rdfs:isDefinedBy (que aponta a ontologia, nao um codigo de dominio).
Codigo de Dominio de Origem Cross-Domain
Cross-Domain Source Code
An annotation property that carries a short three-letter code identifying the source domain in a cross-domain bridge axiom (e.g., CYB, FIN, OPS); the genus is owl:AnnotationProperty and the differentia is that the literal value MUST be one of the 21 Hero domain codes (ast, aut, caf, com, cross, cyb, esg, fin, geo, hr, lgc, mnt, ops, pln, prc, prj, psec, rsk, scm, str, tec).
Propriedade de anotacao que carrega codigo curto de tres letras identificando o dominio de origem em axioma de ponte cross-domain (p.ex. CYB, FIN, OPS); o genero e owl:AnnotationProperty e a diferenca especifica e que o valor literal DEVE ser um dos 21 codigos de dominio Hero (ast, aut, caf, com, cross, cyb, esg, fin, geo, hr, lgc, mnt, ops, pln, prc, prj, psec, rsk, scm, str, tec).
## OntoClean +R (the property rigidly identifies the source domain of a cross-domain bridge). ## USE Tag any reified cross-domain causal owl:Axiom with the source-domain code. ## DO NOT Confuse with rdfs:isDefinedBy (which points to the defining ontology) or with heroNs:axiomID. ## KEY RELATIONSHIPS Pairs with axiomID, heroNs:relationshipSemanticType, heroNs:axiomTargetDomain (planned). ## PARAMS Value: xsd:string from the 21-element CV listed above. ## ERO CONTEXT Pervasive across the 4,003 causal chains; underpins the domain heatmap (CQ-040). ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4 / Section 13.
Hero ONTOLOGY-STANDARD v4.1 Sections 4 + 13
Identifica a fonte operacional ou estado de proveniência de um NamedIndividual no ABox. Utilizado para marcar se uma instância foi extraída de um sistema fonte real (por exemplo, 'Extração de Produção Protheus/RM 2026-05-03'), um TEMPLATE_SEED aguardando substituição operacional, ou um fixture sintético de teste. Distinto de heroNs:datalakeHint (que descreve o alvo conceitual de mapeamento) e de heroNs:sourceReference (que cita o embasamento normativo). Obrigatório em todas as instâncias marcadas como sementes ilustrativas.
Identifies the operational source or provenance state of an ABox NamedIndividual. Used to mark whether an instance was extracted from a real source system (e.g., 'Protheus/RM Production Extract 2026-05-03'), a TEMPLATE_SEED awaiting operational replacement, or a synthetic test fixture. Distinct from heroNs:datalakeHint (which describes the conceptual mapping target) and heroNs:sourceReference (which cites normative grounding). Mandatory on all instances flagged as illustrative seeds.
data source
fonte de dados
An annotation property that records the operational provenance state of an ABox individual, distinguishing real-system extracts, template seeds, and synthetic fixtures.
Uma propriedade de anotação que registra o estado de proveniência operacional de um indivíduo no ABox, distinguindo extrações de sistemas reais, sementes-template e fixtures sintéticas.
Hero AI Intelligence governance — Task #94 B.5 fiscal/customs ABox seed pattern (2026-05-03)
Mapeia uma classe ontológica à sua fonte de dados física no lakehouse Ero Copper. Formato: {Sistema}: {tabela/tag/transação} ({campos principais}). Conecta modelos conceitual (ontologia) e físico (tabelas/colunas). Guia engenheiros de dados no design de camadas silver/gold.
Maps an ontology class to its physical data source in the Ero Copper lakehouse. Format: {System}: {table/tag/transaction} ({main fields}). Bridges conceptual (ontology) and physical (tables/columns) models. Guides data engineers on silver/gold layer design.
datalake hint
dica de datalake
Documenta uma escolha deliberada de design ontológico onde a modelagem difere da intuição ingenua. Marcado com prefixo [DESIGN-DECISION]. Registra a justificativa BFO/CCO e referências normativas explicando por que uma determinada subsumption ou equivalência Não foi declarada.
Documents a deliberate ontological design choice where the modelling differs from naive intuition. Tagged with [DESIGN-DECISION] prefix. Records the BFO/CCO rationale and normative references justifying why a particular subsumption or equivalence was NOT asserted.
decisao de design
design decision
Used during steward review cycles to flag context, partial-knowledge or pending-decision notes on a class or property without affecting reasoning. Stripped from production reports by default. Distinct from rdfs:comment (operational context for any audience), heroNs:llmInstruction (LLM operational guide) and skos:editorialNote (which Hero aliases via this property for consistency with §4 Custom Hero Annotations).
Utilizada durante ciclos de revisao steward para sinalizar contexto, conhecimento parcial ou decisao pendente em uma classe ou propriedade sem afetar raciocinio. Removida de relatorios de producao por padrao. Distinta de rdfs:comment (contexto operacional para qualquer publico), heroNs:llmInstruction (guia operacional para LLM) e skos:editorialNote (aliasada pela Hero via esta propriedade para consistencia com §4).
Editorial Note
Nota Editorial
An annotation property that carries a free-form steward editorial note attached to an entity describing manual review actions, deferred decisions or contextual remarks; the genus is owl:AnnotationProperty (semantically aligned with skos:editorialNote) and the differentia is that the value is plain prose intended for human reviewers, not for SHACL/SPARQL validation.
Propriedade de anotacao que carrega nota editorial livre do administrador de dados anexada a uma entidade descrevendo acoes manuais de revisao, decisoes adiadas ou comentarios contextuais; o genero e owl:AnnotationProperty (alinhada semanticamente com skos:editorialNote) e a diferenca especifica e que o valor e prosa simples para revisores humanos, nao para validacao SHACL/SPARQL.
## OntoClean -R (the relation is contingent on a steward making a note). ## USE Attach steward review notes that should not appear in production rdfs:comment (public-facing). ## DO NOT Confuse with rdfs:comment (public-facing) or heroNs:llmInstruction (LLM operational). ## KEY RELATIONSHIPS Side-channel annotation for human reviewers; bypassed by LLM and SHACL gates. ## PARAMS Value: xsd:string (free-form prose). ## ERO CONTEXT Used by stewards during RV-Q-N triage, STUB elimination and v4.1 amendment passes. ## SOURCE SKOS Reference §4.1; Hero ONTOLOGY-STANDARD v4.1 Section 4.
W3C SKOS Reference §4.1; Hero ONTOLOGY-STANDARD v4.1 Section 4
Used as the key of an EnrichmentRecord bundle. Convention: {STEP}-{ACTION}-{TARGET-TOKEN}. Distinct from heroNs:remediationId (which uses the REM-NNN pattern) and from heroNs:axiomID (AX-* pattern).
Utilizado como chave do pacote EnrichmentRecord. Convencao: {ETAPA}-{ACAO}-{TOKEN-ALVO}. Distinto de heroNs:remediationId (padrao REM-NNN) e heroNs:axiomID (padrao AX-*).
Codigo de Operacao de Enriquecimento
Enrichment Operation Code
An annotation property that carries a short symbolic identifier of an enrichment or remediation operation applied to an ontology entity, used as a primary key in the enrichment audit trail (e.g., STEP2-KILL-ACTUALPRODUCTION); the genus is owl:AnnotationProperty and the differentia is that its value MUST be a campaign-issued opaque token unique within the enrichment campaign scope.
Propriedade de anotacao que carrega identificador simbolico curto de uma operacao de enriquecimento ou remediacao aplicada a uma entidade da ontologia, usado como chave primaria na trilha de auditoria (p.ex. STEP2-KILL-ACTUALPRODUCTION); o genero e owl:AnnotationProperty e a diferenca especifica e que o valor DEVE ser token opaco emitido pela campanha unico dentro do escopo da campanha.
## OntoClean +R (the code rigidly identifies the enrichment operation across runs). ## USE Tag EnrichmentRecord blank nodes with the operation code. ## DO NOT Confuse with heroNs:remediationId or heroNs:axiomID. ## KEY RELATIONSHIPS Primary key of the EnrichmentRecord bundle; paired with affectedEntity + enrichDate. ## PARAMS Value: xsd:string (campaign-issued opaque token). ## ERO CONTEXT Used by every Hero enrichment campaign at all 21 domains. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Member of the EnrichmentRecord bundle providing temporal traceability. Use UTC (Z) to avoid timezone ambiguity across the Brazil-Vancouver org chart. Distinct from dcterms:created (entity creation) and from heroNs:promotionDate (phase-promotion event).
Membro do pacote EnrichmentRecord fornecendo rastreabilidade temporal. Use UTC (Z) para evitar ambiguidade de timezone entre Brasil e Vancouver. Distinto de dcterms:created (criacao da entidade) e heroNs:promotionDate (promocao entre fases).
Carimbo de Tempo do Enriquecimento
Enrichment Timestamp
An annotation property that carries an ISO-8601 datetime stamp marking when an enrichment or remediation operation was performed; the genus is owl:AnnotationProperty and the differentia is that its value MUST be a valid xsd:dateTime literal interpreted as the moment the enrichment was applied.
Propriedade de anotacao que carrega carimbo de tempo ISO-8601 marcando quando uma operacao de enriquecimento ou remediacao foi realizada; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor DEVE ser um literal xsd:dateTime valido interpretado como o momento em que o enriquecimento foi aplicado.
## OntoClean +R (rigidly identifies the timestamp of the enrichment). ## USE Tag EnrichmentRecord blank nodes with the operation timestamp. ## DO NOT Confuse with dcterms:created or heroNs:promotionDate. ## KEY RELATIONSHIPS Paired with heroNs:enrichCode, heroNs:enrichOperation, heroNs:affectedEntity in the EnrichmentRecord bundle. ## PARAMS Value: xsd:dateTime in UTC. ## ERO CONTEXT Used in every Hero enrichment / remediation log entry. ## SOURCE ISO 8601:2019; Hero ONTOLOGY-STANDARD v4.1 Section 4.
ISO 8601:2019; Hero ONTOLOGY-STANDARD v4.1 Section 4
Member of the EnrichmentRecord bundle providing forensic evidence for the change. Useful for SOX auditors and steward retrospective review. Distinct from heroNs:enrichOperation (what was done) and heroNs:enrichReference (normative reference cited).
Membro do pacote EnrichmentRecord fornecendo evidencia forense da mudanca. Util para auditores SOX e revisao retrospectiva do steward. Distinto de heroNs:enrichOperation (o que foi feito) e heroNs:enrichReference (referencia normativa citada).
Enrichment Evidence Note
Nota de Evidencia de Enriquecimento
An annotation property that carries a short evidence string supporting an enrichment or remediation operation, typically describing structural metrics observed before the change; the genus is owl:AnnotationProperty and the differentia is that the value cites quantitative or qualitative evidence (triple count delta, SHACL violations, parse-error message) that justified the operation.
Propriedade de anotacao que carrega texto curto de evidencia sustentando uma operacao de enriquecimento ou remediacao, tipicamente descrevendo metricas estruturais observadas antes da mudanca; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor cita evidencia quantitativa ou qualitativa (delta de triplas, violacoes SHACL, mensagem de erro de parsing) que justificou a operacao.
## OntoClean -R (the relation is contingent on the existence of an enrichment event). ## USE Tag EnrichmentRecord blank nodes with the evidence string. ## DO NOT Confuse with heroNs:enrichOperation (action) or heroNs:enrichReference (citation). ## KEY RELATIONSHIPS Paired with enrichCode, enrichOperation, enrichDate, enrichReference, enrichSubphase. ## PARAMS Value: xsd:string (free-form evidence prose with metrics). ## ERO CONTEXT Used across all Hero enrichment campaigns. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Member of the EnrichmentRecord bundle naming the operation. Pair with heroNs:enrichEvidence (what was observed before) and heroNs:enrichReference (why it was needed).
Membro do pacote EnrichmentRecord nomeando a operacao. Pareie com heroNs:enrichEvidence (o que foi observado antes) e heroNs:enrichReference (por que era necessario).
Descricao da Operacao de Enriquecimento
Enrichment Operation Description
An annotation property that carries a natural-language description of what an enrichment or remediation operation did to an ontology entity (deletion, rewire, label fix, parent migration, etc.); the genus is owl:AnnotationProperty and the differentia is that the value names the verb of the operation (DELETE, MERGE, RENAME, REPARENT, ENRICH) and its scope.
Propriedade de anotacao que carrega descricao em linguagem natural do que uma operacao de enriquecimento ou remediacao fez a uma entidade da ontologia (deletion, rewire, correcao de label, migracao de parent, etc.); o genero e owl:AnnotationProperty e a diferenca especifica e que o valor nomeia o verbo da operacao (DELETE, MERGE, RENAME, REPARENT, ENRICH) e seu escopo.
## OntoClean -R. ## USE Tag EnrichmentRecord blank nodes with the description. ## DO NOT Confuse with heroNs:enrichEvidence or heroNs:enrichReference. ## KEY RELATIONSHIPS Paired with the other five enrich* annotations in the EnrichmentRecord bundle. ## PARAMS Value: xsd:string (verb + scope). ## ERO CONTEXT Used across all Hero enrichment campaigns. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Member of the EnrichmentRecord bundle providing the authorization basis. Distinct from heroNs:enrichmentReference (which is a richer normative reference) and from heroNs:sourceReference (which sits at the entity level rather than the operation level).
Membro do pacote EnrichmentRecord fornecendo a base de autorizacao. Distinto de heroNs:enrichmentReference (referencia normativa mais rica) e heroNs:sourceReference (que esta no nivel da entidade, nao da operacao).
Enrichment Policy Reference
Referencia de Politica de Enriquecimento
An annotation property that carries a bibliographic or policy citation justifying an enrichment or remediation operation; the genus is owl:AnnotationProperty and the differentia is that the value cites the normative basis (ISO standard, NR, IFRS, Hero standard section, ADR identifier) under which the operation was authorized.
Propriedade de anotacao que carrega citacao bibliografica ou de politica justificando uma operacao de enriquecimento ou remediacao; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor cita a base normativa (norma ISO, NR, IFRS, secao do standard Hero, identificador ADR) sob a qual a operacao foi autorizada.
## OntoClean -R. ## USE Tag EnrichmentRecord blank nodes with the policy citation. ## DO NOT Confuse with heroNs:enrichmentReference (broader) or heroNs:sourceReference (entity-level). ## KEY RELATIONSHIPS Paired with the other five enrich* annotations. ## PARAMS Value: xsd:string (citation). ## ERO CONTEXT Used across all Hero enrichment campaigns. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Member of the EnrichmentRecord bundle providing campaign-cohort traceability. Useful for bisecting which campaign introduced a specific characteristic.
Membro do pacote EnrichmentRecord fornecendo rastreabilidade por coorte de campanha. Util para bissecionar qual campanha introduziu uma caracteristica.
Enrichment Subphase Identifier
Identificador da Subfase de Enriquecimento
An annotation property that carries a version-like identifier of the enrichment campaign subphase that produced a given change (e.g., v3.4c, RV-Q-3-W2, REFORMA-R-3); the genus is owl:AnnotationProperty and the differentia is that the literal value MUST match the Hero campaign-versioning convention (Campaign-Wave-SubWave).
Propriedade de anotacao que carrega identificador semelhante a versao da subfase de campanha de enriquecimento que produziu uma mudanca (p.ex. v3.4c, RV-Q-3-W2, REFORMA-R-3); o genero e owl:AnnotationProperty e a diferenca especifica e que o valor literal DEVE seguir a convencao de versionamento de campanha Hero (Campanha-Onda-SubOnda).
## OntoClean +R (rigidly identifies the campaign subphase). ## USE Tag EnrichmentRecord blank nodes with the campaign-subphase id. ## DO NOT Confuse with heroNs:phaseApplied (which is a coarser identifier). ## KEY RELATIONSHIPS Paired with the other five enrich* annotations. ## PARAMS Value: xsd:string. ## ERO CONTEXT Used across all Hero campaigns. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Used as the property that hangs the bundle on the affected entity. Multiple enrichmentLog values allowed when the entity has been enriched in multiple campaigns.
Utilizada como propriedade que pendura o pacote na entidade afetada. Multiplos valores enrichmentLog permitidos quando a entidade foi enriquecida em varias campanhas.
Enrichment Log Node
No de Log de Enriquecimento
An annotation property whose value is a reference to a blank-node reification of the full enrichment record bundle; the genus is owl:AnnotationProperty and the differentia is that the referenced node carries heroNs:enrichCode, heroNs:enrichDate, heroNs:enrichOperation, heroNs:enrichEvidence, heroNs:enrichReference and heroNs:enrichSubphase as a complete audit-trail wrapper.
Propriedade de anotacao cujo valor e referencia a no em branco que reifica o registro completo de enriquecimento; o genero e owl:AnnotationProperty e a diferenca especifica e que o no referenciado carrega heroNs:enrichCode, heroNs:enrichDate, heroNs:enrichOperation, heroNs:enrichEvidence, heroNs:enrichReference e heroNs:enrichSubphase como wrapper completo de trilha de auditoria.
## OntoClean -R. ## USE Attach to any entity touched by enrichment; value is the bundle blank-node. ## DO NOT Confuse with heroNs:enrichCode (which is one field of the bundle, not the bundle). ## KEY RELATIONSHIPS Wraps the six enrich* annotation properties. ## PARAMS Value: IRI or blank-node carrying the six fields. ## ERO CONTEXT Used across all Hero campaigns. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Distinct from heroNs:enrichReference (which is the procedural policy authorizing the operation) -- this is the substantive normative basis (e.g., ISO standard text, regulatory clause).
Distinto de heroNs:enrichReference (politica procedural autorizando a operacao) -- este e a base normativa substantiva (p.ex. texto de norma ISO, clausula regulatoria).
Enrichment Normative Reference
Referencia Normativa de Enriquecimento
An annotation property that carries a bibliographic citation of the foundational source used to justify a specific enrichment; the genus is owl:AnnotationProperty and the differentia is that the value cites an external standard, peer-reviewed paper or regulation that constitutes the substantive (not merely procedural) basis of the enrichment.
Propriedade de anotacao que carrega citacao bibliografica da fonte fundamental usada para justificar um enriquecimento especifico; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor cita norma externa, artigo revisado por pares ou regulacao que constitui a base substantiva (nao meramente procedural) do enriquecimento.
## OntoClean -R. ## USE Tag EnrichmentRecord blank nodes with the substantive normative citation. ## DO NOT Confuse with heroNs:enrichReference (procedural). ## KEY RELATIONSHIPS Member of the EnrichmentRecord bundle, substantive citation channel. ## PARAMS Value: xsd:string (citation). ## ERO CONTEXT Used across all Hero campaigns. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Mandatory on any reified axiom that carries an estimateValue per v4.1 §32. Format example: '+/- 10% (95% CI per NI 43-101 reserve report 2024)'. Without estimateUncertainty an estimateValue is treated as false precision and rejected by the No-False-Precision shape.
Obrigatoria em qualquer axioma reificado que carrega estimateValue conforme v4.1 §32. Exemplo de formato: '+/- 10% (IC 95% per NI 43-101 relatorio de reservas 2024)'. Sem estimateUncertainty um estimateValue e tratado como falsa precisao e rejeitado pelo shape No-False-Precision.
Banda de Incerteza da Estimativa
Estimate Uncertainty Band
An annotation property that carries a textual representation of the uncertainty range of an estimate value, typically in plus-minus percentage form with bibliographic source; the genus is owl:AnnotationProperty (Group F.2 of v4.1 §32) and the differentia is that the value reports the empirical or analytical confidence interval that accompanies a quantified estimate, mandatory under v4.1 §35 No-False-Precision Policy.
Propriedade de anotacao que carrega representacao textual da faixa de incerteza de um valor estimado, tipicamente em forma de mais-ou-menos percentual com fonte bibliografica; o genero e owl:AnnotationProperty (Grupo F.2 da v4.1 §32) e a diferenca especifica e que o valor reporta o intervalo de confianca empirico ou analitico que acompanha uma estimativa quantificada, obrigatorio sob a politica v4.1 §35 No-False-Precision.
## OntoClean -R (the uncertainty is contingent on the measurement / estimation method). ## USE Tag any reified axiom carrying an estimateValue. ## DO NOT Confuse with measurementUncertainty (raw measurement) or with calibrationStatus. ## KEY RELATIONSHIPS Paired with heroNs:estimateValue, heroNs:estimateUnit, heroNs:estimateContext, heroNs:calculationMethodReference in the §32 bundle. ## PARAMS Value: xsd:string ('+/- N% (CI per source)'). ## ERO CONTEXT Used across reserves, recovery, cost, demand, ESG quantified axioms. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Sections 32 + 35.
Hero ONTOLOGY-STANDARD v4.1 Sections 32 + 35
Used at the owl:Ontology header level to declare which canonical stack the module was authored against, enabling future migration auditing when the stack evolves (BFO 2020 to 2030, CCO 2024-11 to 2025-MM).
Utilizada no header owl:Ontology para declarar contra qual pilha canonica o modulo foi escrito, permitindo auditoria de migracao futura quando a pilha evoluir (BFO 2020 para 2030, CCO 2024-11 para 2025-MM).
Foundational Ontology Stack
Pilha de Ontologias Fundamentais
An annotation property that carries a textual identifier of the foundational ontology stack version under which an entity is grounded (e.g., BFO 2020 + CCO v2.0 + IOF Core/Maintenance 2026.01); the genus is owl:AnnotationProperty and the differentia is that the value names the import stack as a parsed version string.
Propriedade de anotacao que carrega identificador textual da versao da pilha de ontologias fundamentais sob a qual a entidade esta fundamentada (p.ex. BFO 2020 + CCO v2.0 + IOF Core/Maintenance 2026.01); o genero e owl:AnnotationProperty e a diferenca especifica e que o valor nomeia a pilha de imports como string de versao parseavel.
## OntoClean +R (rigidly identifies the foundational stack baseline of the module). ## USE Tag at the owl:Ontology header level with the stack version string. ## DO NOT Confuse with owl:versionIRI (which is the IRI of this version of the ontology). ## KEY RELATIONSHIPS Sits at the ontology level, not at the class level. ## PARAMS Value: xsd:string ('BFO 2020 + CCO v2.0 + IOF Core 2026.01 + IOF Maintenance 2026.01'). ## ERO CONTEXT Used in the hero.ttl header and all 21 domain headers. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 1 + Section 20.
Hero ONTOLOGY-STANDARD v4.1 Sections 1 + 20
Anotação em texto livre que registra a justificativa regulatória, normativa ou operacional que ancora uma instância específica ao seu referente do mundo real. Cita tipicamente o instrumento legislativo (por exemplo, 'Ajuste SINIEF 07/2005', 'IN RFB 2.090/2022'), a convenção CFOP aplicada, o contexto de site/rota, ou o tipo de documento SAP/Protheus do qual o padrão-semente foi derivado. Distinto de heroNs:sourceReference (que reside no nível de classe/propriedade) e de heroNs:legalReference (que se restringe a legislação promulgada). Recomendado em todas as instâncias-semente do ABox.
Free-text annotation that records the regulatory, normative or operational rationale anchoring a specific instance to its real-world referent. Typically cites the legislative instrument (e.g., 'Ajuste SINIEF 07/2005', 'IN RFB 2.090/2022'), the CFOP convention applied, the site/route context, or the SAP/Protheus document type from which the seed pattern was derived. Distinct from heroNs:sourceReference (which sits at the class/property level) and heroNs:legalReference (which restricts to enacted legislation). Recommended on all ABox seed instances.
grounding note
nota de embasamento
An annotation property carrying the regulatory and operational rationale that anchors an ABox seed instance to its real-world referent.
Uma propriedade de anotação que carrega a justificativa regulatória e operacional que ancora uma instância-semente do ABox ao seu referente do mundo real.
Aplicar em classes de equipamento, classes de processo, classes de sistema de controle, artefatos de planejamento e entidades de reporte. O valor string DEVE ser um de: "L0", "L1", "L2", "L3", "L4". Uma classe pode pertencer a múltiplos níveis apenas quando é genuinamente híbrida (raro); preferir o nível mais baixo (mais físico).
Apply on equipment classes, process classes, control system classes, planning artifacts, and reporting entities. The string value MUST be one of: "L0", "L1", "L2", "L3", "L4". A class may belong to multiple levels only when it is genuinely a hybrid (rare); prefer the lowest (most physical) level.
ISA-95 functional level
Nível funcional ISA-95
Annotation that classifies a class according to the IEC 62264 (ISA-95) functional hierarchy of operations management — controlled vocabulary: L0 (physical process), L1 (sensing/actuation), L2 (supervisory control / SCADA / DCS), L3 (manufacturing operations management / MES), L4 (business planning & logistics / ERP). Used to enable OT/IT segmentation, security perimeters, and digital-twin tier classification.
Anotação que classifica uma classe de acordo com a hierarquia funcional de gestão de operações IEC 62264 (ISA-95) — vocabulário controlado: L0 (processo físico), L1 (sensoriamento/atuação), L2 (controle supervisório / SCADA / DCS), L3 (gestão de operações de manufatura / MES), L4 (planejamento de negócios e logística / ERP). Usada para habilitar segmentação OT/IT, perímetros de segurança e classificação de gêmeos digitais.
USE: declare on every owl:Class that represents an equipment, control system, process, planning artifact, or reporting entity. Use string values from the controlled vocabulary {"L0","L1","L2","L3","L4"}. DO NOT: assign multiple levels casually; do not use levels outside vocabulary; do not abbreviate ("Level 0" is wrong, use "L0"). KEY RELATIONSHIPS: complements heroNs:apmHierarchyLevel (asset structure) and heroNs:paceLayer (system role). Together they enable Gartner OT Reference Architecture queries. PARAMS: literal value (xsd:string). ERO CONTEXT: required for all equipment classes from Caraiba/Tucuma/Xavantina/Furnas; required for SAP integration scope; required for Cybersecurity OT segmentation per IEC 62443. SOURCE: IEC 62264-1:2013 (ISA-95 Part 1: Models and terminology); ANSI/ISA-95.00.01-2010; Gartner Reference Architecture for Industrial Knowledge Graphs (2024).
IEC 62264-1:2013 §5; ANSI/ISA-95.00.01-2010; Gartner OT Reference Architecture (2024)
Código ISO 3166 identificando a jurisdição cuja legislação fundamenta uma classe ou propriedade localizada. Usado pela camada de localização (L2) para anotar entidades do TBox de domínio que possuem semântica jurisdicional — ex.: 'BR' para documentos fiscais brasileiros, 'BR-BA' para impostos do estado da Bahia. Quando ausente, a entidade é jurisdicionalmente neutra.
ISO 3166 code identifying the jurisdiction whose legislation grounds a localized class or property. Used by the localization layer (L2) to tag domain TBox entities that carry jurisdiction-specific semantics — e.g., 'BR' for Brazilian fiscal documents, 'BR-BA' for Bahia state taxes. When absent, the entity is jurisdiction-neutral.
escopo jurisdicional
jurisdiction scope
Citação formal do instrumento legislativo que fundamenta uma classe localizada — ex.: 'Ajuste SINIEF 07/2005' para NF-e, 'Lei Complementar 214/2025' para reforma tributária CBS/IBS, 'NR-22 (Portaria 2.037/1999)' para segurança em mineração subterrânea. Complementa heroNs:sourceReference (que cobre fontes normativas amplamente) sendo restrito a legislação promulgada, regulamentações e instruções normativas.
Formal citation of the legislative instrument that grounds a localized class — e.g., 'Ajuste SINIEF 07/2005' for NF-e, 'Lei Complementar 214/2025' for CBS/IBS tax reform, 'NR-22 (Portaria 2.037/1999)' for underground mining safety. Complements heroNs:sourceReference (which covers normative sources broadly) by being restricted to enacted legislation, regulations, and normative instructions.
fonte legislativa
legislative source
Stable URL to the full text of the legislative instrument cited in heroNs:legislativeSource. Preferably from official government gazette portals (planalto.gov.br, normas.receita.fazenda.gov.br, confaz.fazenda.gov.br). Used by stewards and AI agents to verify localization grounding against the primary source.
URL estável para o texto integral do instrumento legislativo citado em heroNs:legislativeSource. Preferencialmente de portais oficiais de diários (planalto.gov.br, normas.receita.fazenda.gov.br, confaz.fazenda.gov.br). Usada por stewards e agentes de IA para verificar o embasamento da localização contra a fonte primária.
URL legislativa
legislative URL
Used to sort lifecycle-phase classes deterministically in dashboards and reports. The position alone has no semantic meaning -- it is purely a convenience for visualization and report-ordering. Distinct from heroNs:phaseApplied (which is the campaign-phase identifier).
Utilizada para ordenar classes de fase do ciclo de vida deterministicamente em dashboards e relatorios. A posicao por si so nao tem significado semantico -- e apenas conveniencia para visualizacao e ordenacao de relatorios. Distinta de heroNs:phaseApplied (identificador de fase de campanha).
Lifecycle Sequence Position
Posicao na Sequencia de Ciclo de Vida
An annotation property that carries an integer indicating the ordinal position of an entity within a defined lifecycle sequence; the genus is owl:AnnotationProperty and the differentia is that the literal value MUST be a non-negative xsd:integer ordering the entity within a named lifecycle (e.g., exploration->development->commissioning->operation->care-and-maintenance->decommissioning).
Propriedade de anotacao que carrega inteiro indicando a posicao ordinal de uma entidade dentro de uma sequencia de ciclo de vida definida; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor literal DEVE ser xsd:integer nao-negativo ordenando a entidade dentro de um ciclo de vida nomeado (p.ex. exploracao->desenvolvimento->comissionamento->operacao->care-and-maintenance->descomissionamento).
## OntoClean +R (rigidly fixes the ordinal position). ## USE Tag lifecycle-phase classes (Project, Operation, Closure) with their ordinal. ## DO NOT Confuse with heroNs:phaseApplied (campaign-phase id) or with heroNs:lifecycleStage (stage as a class). ## KEY RELATIONSHIPS Used for sorted dashboard listings only. ## PARAMS Value: xsd:integer (>=0). ## ERO CONTEXT Applied across prj / ast / ops lifecycle hierarchies at Caraiba (mature operation), Tucuma (commercial ops), Xavantina (operation), Furnas (development). ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Instruction for AI agents (Claude, GPT) on WHEN to use a class, HOW to instantiate it, and WHAT relationships are mandatory. Structured in 7 sections: OntoClean classification, USE, DO NOT confuse with, KEY RELATIONSHIPS, PARAMS, ERO CONTEXT, SOURCE.
Instrução para agentes de IA (Claude, GPT) sobre QUANDO usar uma classe, COMO instanciá-la, e QUAIS relacionamentos são obrigatórios. Estruturada em 7 seções: classificação OntoClean, USE, DO NOT confuse with, KEY RELATIONSHIPS, PARAMS, ERO CONTEXT, SOURCE.
LLM instruction
instrução para LLM
Declared in construct-prefix-sweep restoration (2026-05-17). Definition derived from actual usage analysis across ast/mnt TBox files.
cenário neon
neon scenario
Annotation tagging the application scenario in which a NEON (Network of Excellence in Ontologies) reference pattern was applied to a Hero class. Used to trace which NEON methodology scenario (e.g., reuse-as-is, reuse-by-specialization, merge) shaped the class's design.
Anotação que indica o cenário de aplicação em que um padrão de referência da NEON (Network of Excellence in Ontologies) foi aplicado a uma classe do Hero. Utilizado para rastrear qual cenário metodológico da NEON (ex.: reuso como está, reuso por especialização, fusão) moldou o desenho da classe.
NEON scenario
cenário NEON
Meta-propriedade OntoClean classificando rigidez de classe per Guarino & Welty 2002: +R (rígido: necessariamente da classe), -R (não-rígido: contingentemente da classe), ~R (anti-rígido: contingentemente da classe). Permite auditória automática de violações de hierarquia.
OntoClean meta-property classifying class rigidity per Guarino & Welty 2002: +R (rigid: necessarily of class), -R (non-rigid: contingently of class), ~R (anti-rigid: contingently of class). Enables automated auditing of hierarchy violations.
OntoClean rigidity
rigidez OntoClean
Aplicar em classes que representam capacidades, processos ou funções de sistema onde a taxa de mudança e a natureza do trabalho importam para decisões de investimento de TI. O valor DEVE ser um de "SoR", "SoD", "SoI".
Apply on classes that represent capabilities, processes, or system functions where the rate of change and nature of the work matter for IT investment decisions. Value MUST be one of "SoR", "SoD", "SoI".
Classificação Pace Layer Gartner
Gartner Pace Layer classification
Annotation that classifies a class according to Gartner Pace-Layered Application Strategy — controlled vocabulary: SoR (Systems of Record — stable, regulated, low rate of change), SoD (Systems of Differentiation — unique processes that confer competitive advantage, moderate rate of change), SoI (Systems of Innovation — experimental, high rate of change). Used to drive composability roadmaps, investment prioritization, and architectural governance decisions.
Anotação que classifica uma classe de acordo com a Estratégia Pace-Layered de Aplicações da Gartner — vocabulário controlado: SoR (Sistemas de Registro — estáveis, regulados, baixa taxa de mudança), SoD (Sistemas de Diferenciação — processos únicos que conferem vantagem competitiva, taxa moderada de mudança), SoI (Sistemas de Inovação — experimentais, alta taxa de mudança). Usada para guiar roadmaps de composability, priorização de investimento e decisões de governança arquitetural.
USE: declare on capability/process/function classes whose strategic IT classification matters. Examples: fin: classes are predominantly SoR; pln: pit optimization is SoD; tec:DigitalTwinProgram is SoI. DO NOT: assign casually to atomic equipment classes (paceLayer applies at capability level, not nut-and-bolt level). KEY RELATIONSHIPS: complements heroNs:isa95Level. SoR usually overlaps L4 (ERP); SoI often L3+ (MES/Cloud). PARAMS: literal value (xsd:string). ERO CONTEXT: SAP integration scope = SoR; mining method optimization = SoD; AI agent platform = SoI. SOURCE: Gartner "Pace-Layered Application Strategy" (foundational framework, Mary Mesaglio et al., multi-year).
Gartner Pace-Layered Application Strategy framework
Used to surface technical debt explicitly. Visible to stewards in audit dashboards. Distinct from heroNs:phase3Pending (which targets a specific phase) -- parkingLot is open-ended.
Utilizada para tornar visivel divida tecnica de forma explicita. Visivel em dashboards de auditoria. Distinta de heroNs:phase3Pending (que mira uma fase especifica) -- parkingLot e aberta.
Item Adiado para Parking Lot
Parking-Lot Deferred Item
An annotation property that carries a free-form note documenting a known issue, decision or requirement that has been intentionally deferred to a future enrichment cycle; the genus is owl:AnnotationProperty and the differentia is that the value records (a) what was deferred, (b) why, and (c) the trigger that would un-defer it.
Propriedade de anotacao que carrega nota livre documentando questao conhecida, decisao ou requisito intencionalmente adiado para ciclo futuro de enriquecimento; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor registra (a) o que foi adiado, (b) por que, e (c) o gatilho que reativaria o item.
## OntoClean -R. ## USE Tag any entity with deferred decisions. ## DO NOT Confuse with heroNs:phase3Pending (which targets a specific phase). ## KEY RELATIONSHIPS Steward-facing audit channel. ## PARAMS Value: xsd:string (free-form deferral note). ## ERO CONTEXT Used across all 21 domains as steward triage signal. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Used as a tighter variant of parkingLot scoped to the Phase 3 enrichment cohort. Stripped from production reports.
Utilizada como variante mais restrita de parkingLot escopada a coorte de Fase 3 de enriquecimento. Removida de relatorios de producao.
Acao Pendente da Fase 3
Phase 3 Pending Action
An annotation property that carries a natural-language description of a steward action deferred to a future Phase 3 enrichment campaign; the genus is owl:AnnotationProperty and the differentia is that the value scopes the deferral to the Phase 3 cohort (as opposed to the general heroNs:parkingLot).
Propriedade de anotacao que carrega descricao em linguagem natural de uma acao do steward adiada para uma futura campanha de Fase 3 de enriquecimento; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor restringe o adiamento a coorte de Fase 3 (em oposicao ao geral heroNs:parkingLot).
## OntoClean -R. ## USE Tag entities awaiting Phase 3 action. ## DO NOT Confuse with heroNs:parkingLot (open-ended). ## KEY RELATIONSHIPS Steward-facing audit channel scoped to Phase 3. ## PARAMS Value: xsd:string. ## ERO CONTEXT Used across Hero domains during P9 ramp-up. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Used as the coarse cohort tag complementing heroNs:enrichSubphase. Useful for plotting domain coverage across phases.
Utilizada como tag de coorte grossa complementando heroNs:enrichSubphase. Util para plotar cobertura por dominio entre fases.
Identificador da Fase Aplicada
Phase Applied Identifier
An annotation property that carries a short identifier of the enrichment phase that produced an entity's current state; the genus is owl:AnnotationProperty and the differentia is that the value names the coarse phase (P0, P1, ..., P10) as a single token, distinct from heroNs:enrichSubphase which carries the fine-grained subphase.
Propriedade de anotacao que carrega identificador curto da fase de enriquecimento que produziu o estado atual da entidade; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor nomeia a fase grossa (P0, P1, ..., P10) como token unico, distinto de heroNs:enrichSubphase que carrega a subfase fina.
## OntoClean +R (rigidly identifies the coarse phase). ## USE Tag any entity touched by a phase with the phase id. ## DO NOT Confuse with heroNs:enrichSubphase (fine). ## KEY RELATIONSHIPS Pairs with heroNs:enrichSubphase. ## PARAMS Value: xsd:string ('P5', 'P9', 'REFORMA-R-3'). ## ERO CONTEXT Used across all 21 domains. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Used to capture the moment a class transitions through the steward governance workflow (draft->approved->locked). Pairs with heroNs:axiomStatus on reified axioms.
Utilizada para capturar o momento em que uma classe transiciona pelo workflow de governanca (draft->approved->locked). Pareia com heroNs:axiomStatus em axiomas reificados.
Data de Promocao
Promotion Date
An annotation property that carries an ISO-8601 datetime stamp marking when an entity was promoted from a lower lifecycle phase to a higher one (e.g., from draft to approved, from staging to production); the genus is owl:AnnotationProperty and the differentia is that the value records a promotion event in the steward governance workflow.
Propriedade de anotacao que carrega carimbo de tempo ISO-8601 marcando quando uma entidade foi promovida de fase inferior do ciclo de vida para superior (p.ex. de draft para approved, de staging para producao); o genero e owl:AnnotationProperty e a diferenca especifica e que o valor registra um evento de promocao no workflow de governanca do steward.
## OntoClean +R (rigidly identifies the promotion event timestamp). ## USE Tag entities that have transitioned through the governance workflow. ## DO NOT Confuse with heroNs:enrichDate (which is the enrichment campaign timestamp). ## KEY RELATIONSHIPS Sits next to heroNs:axiomStatus on reified axioms. ## PARAMS Value: xsd:dateTime in UTC. ## ERO CONTEXT Used as the governance-history channel. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4 + Section 13.
Used to enable deterministic sorting of sibling classes in dashboards (e.g., risk register, KPI hierarchy). Distinct from heroNs:lifecycleSequencePosition (which orders lifecycle phases, not priorities).
Utilizada para permitir ordenacao deterministica de classes irmas em dashboards (p.ex. registro de risco, hierarquia de KPI). Distinta de heroNs:lifecycleSequencePosition (que ordena fases de ciclo de vida, nao prioridades).
Rank Value
Valor de Ranking
An annotation property that carries an integer ranking score used to order entities in a relative priority comparison; the genus is owl:AnnotationProperty and the differentia is that the value MUST be a non-negative xsd:integer interpreted as an ordinal rank within a sibling set (lower rank = higher priority).
Propriedade de anotacao que carrega pontuacao inteira de ranking usada para ordenar entidades em comparacao de prioridade relativa; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor DEVE ser xsd:integer nao-negativo interpretado como rank ordinal dentro de um conjunto irmao (rank menor = prioridade maior).
## OntoClean +R. ## USE Tag siblings that need a deterministic priority order. ## DO NOT Confuse with heroNs:lifecycleSequencePosition (lifecycle order, not priority). ## KEY RELATIONSHIPS Convenience for visualization. ## PARAMS Value: xsd:integer (>=0; lower = higher priority). ## ERO CONTEXT Used in rsk / str / esg priority hierarchies. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Member of the RemediationRecord bundle. Distinct from heroNs:enrichEvidence (which describes what was observed) -- reason describes why action was warranted.
Membro do pacote RemediationRecord. Distinto de heroNs:enrichEvidence (que descreve o que foi observado) -- reason descreve por que a acao foi necessaria.
Motivo da Remediacao
Remediation Reason
An annotation property that carries a natural-language explanation of why a remediation operation was needed for a given entity; the genus is owl:AnnotationProperty and the differentia is that the value names the cause (label violation, ghost class, missing parent, SHACL constraint failure) that triggered the remediation.
Propriedade de anotacao que carrega explicacao em linguagem natural do motivo pelo qual uma remediacao foi necessaria; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor nomeia a causa (violacao de label, classe fantasma, parent ausente, falha de constraint SHACL) que disparou a remediacao.
## OntoClean -R. ## USE Tag RemediationRecord blank nodes with the cause. ## DO NOT Confuse with heroNs:enrichEvidence (observed evidence). ## KEY RELATIONSHIPS Member of RemediationRecord bundle. ## PARAMS Value: xsd:string. ## ERO CONTEXT Used across Hero remediation campaigns. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Declared in construct-prefix-sweep restoration (2026-05-17). Definition derived from actual usage analysis across ast/com/mnt/prc TBox files.
indicador de remediação
remediation flag
A boolean or enum flag marking a class, property, or axiom as requiring remediation review. Used to triage TBox elements that came in through automated cascade restoration and need steward attention.
Indicador booleano ou enum que marca uma classe, propriedade ou axioma como requerendo revisão de remediação. Utilizado para triagem de elementos TBox introduzidos via restauração em cascata automatizada que precisam de atenção de steward.
Member of the RemediationRecord bundle providing the audit primary key. Distinct from heroNs:enrichCode (which targets enrichment, not remediation) and from heroNs:axiomID.
Membro do pacote RemediationRecord fornecendo a chave primaria de auditoria. Distinto de heroNs:enrichCode (que mira enriquecimento, nao remediacao) e heroNs:axiomID.
Identificador de Remediacao
Remediation Identifier
An annotation property that carries a unique identifier of a remediation action following the REM-NNN pattern; the genus is owl:AnnotationProperty and the differentia is that the value MUST match ^REM-[0-9]+$ and is the primary key of the RemediationRecord bundle.
Propriedade de anotacao que carrega identificador unico de acao de remediacao seguindo o padrao REM-NNN; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor DEVE casar ^REM-[0-9]+$ e e a chave primaria do pacote RemediationRecord.
## OntoClean +R (rigidly identifies the remediation event). ## USE Tag RemediationRecord blank nodes with REM-NNN id. ## DO NOT Confuse with heroNs:enrichCode or heroNs:axiomID. ## KEY RELATIONSHIPS Primary key of RemediationRecord; paired with heroNs:affectedEntity, heroNs:reason, heroNs:status. ## PARAMS Value: xsd:string matching ^REM-[0-9]+$. ## ERO CONTEXT Used across Hero remediation campaigns. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 4.
Used inside the Quantification Governance bundle of §32 alongside heroNs:requiredInputVariable and heroNs:calculationMethodReference. Multiple values allowed for multi-source methods. Distinct from heroNs:datalakeHint (class-level mapping hint, not method-input).
Utilizada dentro do pacote de Quantification Governance do §32 ao lado de heroNs:requiredInputVariable e heroNs:calculationMethodReference. Multiplos valores permitidos para metodos multi-fonte. Distinta de heroNs:datalakeHint (dica de mapeamento por classe, nao entrada de metodo).
Nome do Dataset Requerido
Required Dataset Name
An annotation property that carries the lakehouse table or dataset name required as input by a calculation or estimation method; the genus is owl:AnnotationProperty (Group F.2 of v4.1 §32) and the differentia is that the value names a physical artifact in the Ero Copper lakehouse (e.g., 'silver.sap.bsis', 'gold.prc.flotation_recovery_daily').
Propriedade de anotacao que carrega o nome da tabela ou dataset do lakehouse requerido como entrada por metodo de calculo ou estimativa; o genero e owl:AnnotationProperty (Grupo F.2 da v4.1 §32) e a diferenca especifica e que o valor nomeia um artefato fisico no lakehouse Ero Copper (p.ex. 'silver.sap.bsis', 'gold.prc.flotation_recovery_daily').
## OntoClean -R. ## USE Tag quantified axioms with the dataset name(s). ## DO NOT Confuse with heroNs:datalakeHint (class-level mapping). ## KEY RELATIONSHIPS Paired with heroNs:requiredInputVariable, heroNs:calculationMethodReference. ## PARAMS Value: xsd:string (dataset name). ## ERO CONTEXT Examples: SAP CO postings, AVEVA MOM flotation tags, geo:DrillholeAssay. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 32.
Used inside the Quantification Governance bundle of §32 to wire methods to their conceptual inputs (independent variables) while heroNs:requiredDataset wires them to physical data. Multiple values allowed for multi-input methods.
Utilizada dentro do pacote de Quantification Governance do §32 para conectar metodos as suas entradas conceituais (variaveis independentes) enquanto heroNs:requiredDataset conecta as fontes fisicas. Multiplos valores permitidos para metodos multi-entrada.
Required Input Variable
Variavel de Entrada Requerida
An annotation property that carries an IRI reference to a Hero domain class or property representing an input variable required by a calculation or estimation method; the genus is owl:AnnotationProperty (Group F.2 of v4.1 §32) and the differentia is that the value MUST be the IRI of an existing Hero class or property treated as the input port of the method.
Propriedade de anotacao que carrega referencia IRI a classe ou propriedade Hero que representa variavel de entrada requerida por metodo de calculo ou estimativa; o genero e owl:AnnotationProperty (Grupo F.2 da v4.1 §32) e a diferenca especifica e que o valor DEVE ser IRI de classe ou propriedade Hero existente tratada como porta de entrada do metodo.
## OntoClean -R. ## USE Tag quantified axioms with the input variable IRI(s). ## DO NOT Confuse with heroNs:requiredDataset (physical) or heroNs:datalakeHint. ## KEY RELATIONSHIPS Paired with heroNs:requiredDataset, heroNs:calculationMethodReference. ## PARAMS Value: xsd:anyURI / IRI. ## ERO CONTEXT Used across reserves, recovery, cost, demand, ESG quantified axioms. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Section 32.
Used as a steward triage flag for entities whose rigidity (+R/-R/~R) was auto-assigned by a script and needs human review. Removed once validated. Distinct from heroNs:ontoCleanRigidity (the rigidity value itself).
Utilizada como marcador de triagem do steward para entidades cuja rigidez (+R/-R/~R) foi atribuida automaticamente por script e precisa de revisao humana. Removida apos validacao. Distinta de heroNs:ontoCleanRigidity (o proprio valor de rigidez).
Marcador de Rigidez Nao-Validada
Rigidity Validation Pending Flag
An annotation property that carries a boolean flag indicating that the heroNs:ontoCleanRigidity value has not yet been validated by a steward; the genus is owl:AnnotationProperty and the differentia is that the value is the xsd:boolean literal 'true' until a steward confirms the rigidity is correct, at which point the property is removed (not flipped to 'false').
Propriedade de anotacao que carrega marcador booleano indicando que o valor de heroNs:ontoCleanRigidity ainda nao foi validado por um steward; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor e o literal xsd:boolean 'true' ate que um steward confirme a rigidez como correta, momento em que a propriedade e removida (nao invertida para 'false').
## OntoClean ~R (the flag is transient and disappears on validation). ## USE Tag classes whose rigidity needs steward verification. ## DO NOT Confuse with heroNs:ontoCleanRigidity (the value being flagged). ## KEY RELATIONSHIPS Removed on validation. ## PARAMS Value: xsd:boolean 'true' (presence is the signal). ## ERO CONTEXT Used by automated rigidity inference scripts during enrichment campaigns. ## SOURCE Guarino & Welty 2002 OntoClean; Hero ONTOLOGY-STANDARD v4.1 Section 4.
Guarino & Welty 2002; Hero ONTOLOGY-STANDARD v4.1 Section 4
Grounding normativo de uma classe em fontes autoritativas — normas ISO, regulações brasileiras, frameworks internacionais, literatura acadêmica, SOPs internas Ero. Hierarquia: ISO/IEC > regulação brasileira > frameworks > docs internas > academia > docs fornecedor.
Normative grounding of a class in authoritative sources — ISO standards, Brazilian regulations, international frameworks, academic literature, internal Ero SOPs. Hierarchy: ISO/IEC > Brazilian regulation > frameworks > internal docs > academia > vendor docs.
referência normativa
source reference
Used by RemediationRecord and EnrichmentRecord bundles to track lifecycle state of the audit entry itself. Distinct from heroNs:axiomStatus (which sits on reified axioms) and from heroNs:translationStatus (which sits on label translations).
Utilizada por pacotes RemediationRecord e EnrichmentRecord para rastrear estado de ciclo de vida da propria entrada de auditoria. Distinta de heroNs:axiomStatus (que esta em axiomas reificados) e de heroNs:translationStatus (que esta em traducoes de label).
Status de Fluxo de Trabalho
Workflow Status
An annotation property that carries a short workflow state token for an entity in a steward, promotion or remediation pipeline; the genus is owl:AnnotationProperty and the differentia is that the value MUST come from the controlled vocabulary {draft, in_review, approved, locked, deprecated, superseded} matching heroNs:axiomStatus semantics extended to non-axiom entities.
Propriedade de anotacao que carrega token curto de estado de workflow para uma entidade em pipeline de steward, promocao ou remediacao; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor DEVE vir do vocabulario controlado {draft, in_review, approved, locked, deprecated, superseded} casando a semantica de heroNs:axiomStatus estendida a entidades nao-axiomaticas.
## OntoClean -R (workflow state is contingent). ## USE Tag RemediationRecord / EnrichmentRecord blank nodes with the workflow state. ## DO NOT Confuse with heroNs:axiomStatus (reified-axiom scope) or heroNs:translationStatus. ## KEY RELATIONSHIPS Used inside RemediationRecord / EnrichmentRecord bundles. ## PARAMS Value: xsd:string from CV {draft|in_review|approved|locked|deprecated|superseded}. ## ERO CONTEXT Used pervasively across Hero governance. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Sections 4 + 13.
Used during PT-BR translation passes to record exceptions to literal translation (e.g., 'Stope' kept as 'Realce' per ABM glossary; 'Pillar' as 'Pilar'; 'Drift' as 'Galeria'). Distinct from skos:editorialNote (broader scope) and heroNs:translationStatus (workflow state).
Utilizada durante passes de traducao PT-BR para registrar excecoes a traducao literal (p.ex. 'Stope' mantido como 'Realce' conforme glossario ABM; 'Pillar' como 'Pilar'; 'Drift' como 'Galeria'). Distinta de skos:editorialNote (escopo mais amplo) e heroNs:translationStatus (estado de workflow).
Racional da Traducao
Translation Rationale
An annotation property that carries a natural-language explanation of why a particular term is left untranslated (loanword) or translated in a specific way; the genus is owl:AnnotationProperty and the differentia is that the value cites the linguistic, regulatory or industry-vocabulary basis (NR-22, ABM/IBRAM glossary, MCSA SOP) for the translation decision in the @pt-BR label or definition.
Propriedade de anotacao que carrega explicacao em linguagem natural do motivo pelo qual um termo e mantido sem traducao (estrangeirismo) ou traduzido de uma forma especifica; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor cita a base linguistica, regulatoria ou de vocabulario da industria (NR-22, glossario ABM/IBRAM, SOP MCSA) para a decisao de traducao no label ou definicao @pt-BR.
## OntoClean -R. ## USE Tag classes/properties whose PT-BR translation diverges from literal mapping. ## DO NOT Confuse with skos:editorialNote (broader) or heroNs:translationStatus (workflow). ## KEY RELATIONSHIPS Steward + linguistic-reviewer channel. ## PARAMS Value: xsd:string. ## ERO CONTEXT Used per Hero §53.8 PT-BR Translation Review protocol. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Sections 23 + 53.8.
Hero ONTOLOGY-STANDARD v4.1 Sections 23 + 53.8
Used to track PT-BR translation maturity per Hero §53.8 (mining-vocabulary alignment with ABM/IBRAM glossaries). Distinct from heroNs:status (general workflow) and heroNs:translationRationale (rationale, not workflow).
Utilizada para rastrear maturidade de traducao PT-BR conforme Hero §53.8 (alinhamento de vocabulario mineiro com glossarios ABM/IBRAM). Distinta de heroNs:status (workflow geral) e heroNs:translationRationale (justificativa, nao workflow).
Status do Fluxo de Traducao
Translation Workflow Status
An annotation property that carries a workflow state token for the bilingual translation lifecycle of an entity label; the genus is owl:AnnotationProperty and the differentia is that the value MUST come from the controlled vocabulary {raw_machine, draft_human, peer_reviewed, mining_steward_approved} reflecting the translation review stage.
Propriedade de anotacao que carrega token de estado de workflow para o ciclo de vida da traducao bilingue do label de uma entidade; o genero e owl:AnnotationProperty e a diferenca especifica e que o valor DEVE vir do vocabulario controlado {raw_machine, draft_human, peer_reviewed, mining_steward_approved} refletindo a etapa de revisao da traducao.
## OntoClean -R. ## USE Tag classes/properties with current translation review stage. ## DO NOT Confuse with heroNs:status or heroNs:translationRationale. ## KEY RELATIONSHIPS Steward + linguistic-reviewer channel. ## PARAMS Value: xsd:string from CV. ## ERO CONTEXT Used in PT-BR translation review passes. ## SOURCE Hero ONTOLOGY-STANDARD v4.1 Sections 23 + 53.8.
Object property declared to resolve ABox dangling predicate reference. Requires enrichment.
Propriedade de objeto declarada para resolver referência pendente do ABox. Requer enriquecimento.
has Automation System
has Automation System relaciona entidades no domínio HERONS.
has Automation System relates entities in the HERONS domain.
DEPRECATED 2026-05-06 (LT-PATCH14). Use ast:hasAutomationSystem (Asset Management domain canonical ObjectProperty). All ABox uses migrated in instances/caraiba/abox.ttl this session. heroNs: namespace is reserved for custom annotation properties only — domain ObjectProperties live in their domain TTL per CLAUDE.md §2 + §6. Bridge retained for graph backward-compatibility; remove in next minor release after dual-residency window.
DEPRECIADO 2026-05-06 (LT-PATCH14). Usar ast:hasAutomationSystem (ObjectProperty canonical do domínio Asset Management). Todos os usos do ABox migrados em instances/caraiba/abox.ttl nesta sessão. Namespace heroNs: é reservado apenas para propriedades de anotação customizadas — ObjectProperties de domínio vão no TTL do domínio conforme CLAUDE.md §2 + §6. Ponte retida para compatibilidade do grafo; remover na próxima minor release após a janela de dupla residência.
== USE: Use hasAutomationSystem to assert has automation system on domain instances. == == DO NOT: Do not use outside the HERO domain scope without cross-domain bridging. == == KEY RELATIONSHIPS: See related classes and properties in hero.ttl. == == ERO CONTEXT: Hero AI Intelligence is the enterprise knowledge graph of Ero Copper, built on BFO 2020 / CCO / IOF foundations, covering 21 mining domains. == == SOURCE: BFO 2020 (Arp et al.); CCO (CUBRC); IOF Core (Industrial Ontology Foundry) ==
BFO 2020 (Arp et al.); CCO (CUBRC); IOF Core (Industrial Ontology Foundry)
has Cost Center
has Cost Center relaciona entidades no domínio HERONS.
has Cost Center relates entities in the HERONS domain.
DEPRECATED 2026-05-06 (LT-PATCH15). Use fin:chargedToCostCenter (Finance domain canonical ObjectProperty; subject = transaction/expense/process being charged, object = CostCenter). All ABox uses migrated in instances/caraiba/abox.ttl this session. heroNs: namespace is reserved for custom annotation properties only — domain ObjectProperties live in their domain TTL per CLAUDE.md §2 + §6. Bridge retained for graph backward-compatibility; remove in next minor release after dual-residency window.
DEPRECIADO 2026-05-06 (LT-PATCH15). Usar fin:chargedToCostCenter (ObjectProperty canonical do domínio Finance; sujeito = transação/despesa/processo debitado, objeto = CostCenter). Todos os usos do ABox migrados em instances/caraiba/abox.ttl nesta sessão. Namespace heroNs: é reservado apenas para propriedades de anotação customizadas — ObjectProperties de domínio vão no TTL do domínio conforme CLAUDE.md §2 + §6. Ponte retida para compatibilidade do grafo; remover na próxima minor release após a janela de dupla residência.
Hero-internal stub for the design-intent relation between an artifact/equipment and its intended use. Declared in F8c (2026-05-17) because IOF Core+Maintenance 2026.01 does not include this property (only construct:designatedBy and construct:designates exist).
has designed use
tem uso projetado
Object property relating a designed artifact or piece of equipment to the use it was designed for. Used to express engineering design intent independent of actual deployment.
Propriedade de objeto que relaciona um artefato projetado ou equipamento ao uso para o qual foi projetado. Usada para expressar a intenção de projeto de engenharia independentemente da implantação real.
has Equipment Type in Operation
tem Tipo de Equipamento em Operacao
Relacionamento ao nivel do site afirmando quais TIPOS de EquipmentModel (W2 +R Subkinds) sao operados em um Site dado. Dominio: bfo:Site ou subclasse; Range: classe TBox ast:EquipmentModel (via punning OWL 2). Usado para capturar o conhecimento estavel do conjunto de tipos de equipamento por site sem enumerar unidades individuais da frota (essas vivem no datalake).
Site-level relationship asserting which EquipmentModel TYPES (W2 +R Subkinds) are operated at a given Site. Domain: bfo:Site or subclass; Range: ast:EquipmentModel TBox class (via OWL 2 punning). Used to capture stable knowledge of equipment-type set per site without enumerating individual fleet units (those live in the datalake).
hasEquipmentTypeInOperation
Object property — Site (NamedIndividual) → EquipmentModel (Class via punning). USE on Site_X individuals to declare set of EquipmentModel TYPES operated. Repeat the property for each type. DO NOT use to track individual physical units (those are datalake facts via SAP I_Equipment). KEY RELATIONSHIPS: paired with W2 EquipmentModel TBox classes (38 classes); enables compatibility queries via type-level joining. PARAMS: range is class IRI (e.g., ast:EpirocMT65DumpTruck), not equipment instance. ERO CONTEXT: at Pilar/Vermelhos: ~25 unique types each per FROTAS XLSX type extract; at NX Gold: ~10 types per Layout HTML. SOURCE: docs/abox-ao-implementation-plan-2026-05-07.md §CORR.1 (post Marcelo directive 2026-05-08).
Decision Marcelo Santos 2026-05-08; CORR.1 fleet pattern correction; supersedes individual-NI fleet ABox (deprecated).
has design use
Declaracao local Hero aguardando adocao em CCO 3.0. Conforme BFO 2020, intencao de design de um artefato para a funcao que pretende ter.
Local Hero declaration awaiting CCO 3.0 adoption. Per BFO 2020, an artifact's design intent for a function it is intended to bear.
v4.0 IRI Errata 2026-05-05; v4.0 ONTOLOGY-STANDARD §49 Artifact Pattern
has function
tem funcao
Declaracao local Hero de has_function. Equivalente a iof-constr:hasFunction. Substitui cco:has_function (depreciado em CCO 2.0).
Local Hero declaration of has_function. Equivalent to iof-constr:hasFunction. Substitutes the deprecated cco:has_function which CCO 2.0 has moved to BFO 2020.
v4.0 IRI Errata 2026-05-05; IOF Construct Ontology
Hero-internal stub for the semantic regulation relation. Declared in F8c (2026-05-17) to replace legacy cco:regulates references whose canonical IRI was not found in CCO 2024-11-06 imports.
regula
regulates
Object property relating a directive or regulation entity to the process, agent, or activity it constrains. Used in compliance, governance, and legal domains.
Propriedade de objeto que relaciona uma entidade diretiva ou regulamentar ao processo, agente ou atividade que ela restringe. Utilizada nos domínios de compliance, governança e legal.
A fórmula química de uma espécie mineral expressa em notação padrão (ex.: CuFeS2 para calcopirita). Obrigatória para todas as subclasses de geo:MineralSpecies.
The chemical formula of a mineral species expressed in standard notation (e.g., CuFeS2 for chalcopyrite). Mandatory for all geo:MineralSpecies subclasses.
Chemical Formula
Fórmula Química
A datatype property that captures the chemical formula of a mineral species using standard chemical notation, enabling programmatic lookup and metallurgical behavior inference.
Uma propriedade de dados que captura a fórmula química de uma espécie mineral usando notação química padrão, permitindo consulta programática e inferência de comportamento metalúrgico.
== USE: Assert the chemical formula on every geo:MineralSpecies subclass instance or class annotation. Examples: CuFeS2 (chalcopyrite), Cu2S (chalcocite), FeS2 (pyrite), Au (native gold). == == DO NOT: Use for molecular formulas of non-mineral compounds or for chemical equations. == == SOURCE: IMA/CNMNC nomenclature; Strunz & Nickel 2001; Klein & Dutrow 2007. ==
IMA/CNMNC mineral nomenclature; Strunz & Nickel 2001
Datatype property declared to resolve ABox dangling predicate reference. Requires enrichment.
Propriedade de dados declarada para resolver referência pendente do ABox. Requer enriquecimento.
source System
source System captura um valor de dado no domínio HERONS.
source System captures a data value in the HERONS domain.
== USE: Use sourceSystem to assert source system on domain instances. == == DO NOT: Do not use outside the HERO domain scope without cross-domain bridging. == == KEY RELATIONSHIPS: See related classes and properties in hero.ttl. == == ERO CONTEXT: Hero AI Intelligence is the enterprise knowledge graph of Ero Copper, built on BFO 2020 / CCO / IOF foundations, covering 21 mining domains. == == SOURCE: BFO 2020 (Arp et al.); CCO (CUBRC); IOF Core (Industrial Ontology Foundry) ==
Specific typing applied to owl:Axiom reifications whose purpose is to record the outcome of an OntoClean swap test (bridgeJustification + guarinoLayer). Allows SHACL NodeShapes targeting owl:Axiom (cross/local axiom governance) to explicitly exclude these records via SPARQLTarget, avoiding false positives on axiomID/axiomSeverity/axiomStatus/axiomSource.
Tipagem específica aplicada a reificações owl:Axiom cuja finalidade é registrar o resultado de um swap test OntoClean (bridgeJustification + guarinoLayer). Permite que SHACL NodeShapes direcionadas a owl:Axiom (governança de axiomas cross/locais) excluam explicitamente esses registros via SPARQLTarget, evitando falsos positivos em axiomID/axiomSeverity/axiomStatus/axiomSource.
OntoClean swap test
teste de swap OntoClean
A reified OWL axiom that documents a Guarino/OntoClean swap test between a Domain Ontology (DO) class and a Task Ontology (TO) class, asserting that swapping the two collapses the modelling intent and therefore justifies keeping them as parallel layers.
Axioma OWL reificado que documenta um teste de swap Guarino/OntoClean entre uma classe de Ontologia de Domínio (DO) e uma classe de Ontologia de Tarefa (TO), demonstrando que a troca entre as duas colapsa a intenção de modelagem e portanto justifica mantê-las como camadas paralelas.
OntoClean: rigid class (+R). USE: Type any owl:Axiom reification that carries heroNs:bridgeJustification and heroNs:guarinoLayer (the canonical OntoClean swap-test annotations). Instances live in instances/reference/task-swap-tests.ttl. DO NOT confuse with: generic reified causal axioms (causalChainMembership / causalDirection / causalLinkOrder); those target cross-domain governance, not swap tests. DO NOT use for regular domain axioms even if they carry axiomID. KEY RELATIONSHIPS: each instance is an owl:Axiom that uses owl:annotatedSource / owl:annotatedProperty / owl:annotatedTarget to reify a DO-vs-TO subsumption swap; carries heroNs:bridgeJustification (text) and heroNs:guarinoLayer (\"Task\" or \"Domain\"). PARAMS: none — populated by swap-test harness. ERO CONTEXT: enables governance SHACL shapes to exclude swap-tests from axiomID regex / severity / status enforcement while still counting them as valid reified axioms under owl:Axiom. SOURCE: Guarino 1998, Guarino & Welty 2002; Hero AI Audit 2026-04-17, FASE 3d §7.8.
Guarino 1998 (Formal Ontology and Information Systems); Guarino & Welty 2002 (Evaluating ontological decisions with OntoClean); Hero AI Audit 2026-04-17, FASE 3d.
An information-content entity that records the rationale, alternatives considered, trade-offs, and decision criteria for an architectural or ontological choice in the Hero AI Intelligence enterprise knowledge graph. Used in shapes/sites/*-shapes.ttl as the dr: prefix for tracing why a particular SHACL constraint, axiom or class was chosen over alternatives.
Uma entidade de conteudo informacional que registra a justificativa, alternativas consideradas, trade-offs e criterios de decisao para uma escolha arquitetural ou ontologica no grafo de conhecimento corporativo Hero AI Intelligence. Utilizada em shapes/sites/*-shapes.ttl com o prefixo dr: para rastrear por que uma restricao SHACL, axioma ou classe particular foi escolhida em vez de alternativas.
Design Rationale
Justificativa de Projeto
A design rationale is an information content entity (genus: cco:InformationContentEntity) that documents the reasoning behind an architectural, ontological, or modelling decision in the Hero ontology, including alternatives considered and the criteria used to select the chosen option, distinguished from generic documentation by its explicit decision-trace structure (decision context, options, criteria, chosen option, consequences). [Source: ISO/IEC/IEEE 42010:2022 Architecture Description; Lee 1997 'Design Rationale: Concepts, Techniques and Use'].
Uma entidade de conteudo informacional (genero: cco:InformationContentEntity) que documenta o raciocinio por tras de uma decisao arquitetural, ontologica ou de modelagem na ontologia Hero, incluindo alternativas consideradas e os criterios usados para selecionar a opcao escolhida, distinguida de documentacao generica por sua estrutura explicita de rastreamento de decisao (contexto, opcoes, criterios, opcao escolhida, consequencias). [Fonte: ISO/IEC/IEEE 42010:2022 Architecture Description; Lee 1997].
## OntoClean -R — ICE; identity via authorship + decision context. Non-rigid (a rationale can be revised, superseded, or merged when re-evaluation occurs). ## USE Reference dr:DesignRationale when annotating an architectural/ontological decision: the class to be modelled, the alternatives considered, the trade-off matrix, and the chosen option. Used by site-specific SHACL shape files (shapes/sites/*-shapes.ttl) under the dr: prefix. ## DO NOT Do not conflate with: (a) generic cco:InformationContentEntity (broader); (b) lgc:Decision (legal/governance decision, distinct lifecycle); (c) heroNs:axiomRationale (axiom-level rationale, finer granularity). ## KEY RELATIONSHIPS - has_decision_context (text or IRI) - considers_alternative (multiple) - selects_option (singular) - has_consequence (multiple) - references some heroNs:axiomID or owl:Class ## PARAMS hasRationaleAuthor, hasRationaleDate (xsd:date), hasRationaleVersion. SHACL: see hero-shapes.ttl rationale shape. ## ERO CONTEXT All sites; meta-level annotation across the knowledge graph. Lakehouse mapping: design_rationale registry. ## SOURCE ISO/IEC/IEEE 42010:2022 Architecture Description; Lee 1997 'Design Rationale: Concepts, Techniques and Use'; Kunz & Rittel 1970 IBIS.
ISO/IEC/IEEE 42010:2022; Lee 1997 Design Rationale; Kunz & Rittel 1970 IBIS
Used as the literal range for any datatype property that carries a CNPJ value anywhere in the Hero ABox (supplier master data, customer master, fiscal documents, intercompany agreements). Replaces ad-hoc xsd:string for tax-ID fields so that downstream SHACL shapes and SPARQL queries can validate the 14-digit pattern centrally. Distinct from heroNs:CPFString (individual taxpayer, 11 digits) and from heroNs:ChaveAcessoString (NFe access key, 44 digits). All Ero Copper entities operating in Brazil (MCSA matrix and filials) carry a CNPJ; the corporate parent Ero Copper Corp (Vancouver) does not.
Utilizado como faixa literal para qualquer propriedade de dado que carrega um valor CNPJ no ABox Hero (cadastro de fornecedores, clientes, documentos fiscais, contratos intercompany). Substitui o uso ad-hoc de xsd:string em campos de identificador fiscal de modo que SHACL shapes e consultas SPARQL validem o padrao 14 digitos de forma centralizada. Distinto de heroNs:CPFString (pessoa fisica, 11 digitos) e de heroNs:ChaveAcessoString (chave de acesso NFe, 44 digitos). Todas as entidades juridicas Ero Copper no Brasil (matriz MCSA e filiais) possuem CNPJ; a matriz Ero Copper Corp (Vancouver) nao.
CNPJ String
String CNPJ
A literal datatype that constrains the value to a 14-digit numeric string representing a Brazilian corporate taxpayer identifier (CNPJ); the genus is rdfs:Datatype derived from xsd:string and the differentia is the exact length 14, all numeric characters, and validation via the modulo-11 verifier digits per Receita Federal IN RFB 1.863/2018.
Tipo de dado literal que restringe o valor a uma string numerica de 14 digitos que identifica o contribuinte pessoa juridica brasileiro (CNPJ); o genero e rdfs:Datatype derivado de xsd:string e a diferenca especifica e o comprimento exato 14, todos caracteres numericos, e validacao por digitos verificadores modulo-11 conforme IN RFB 1.863/2018 da Receita Federal.
## OntoClean +R (the datatype rigidly classifies its literal values; any literal that matches the 14-digit numeric pattern is necessarily of this datatype). ## USE Tag any owl:DatatypeProperty whose range is a Brazilian corporate tax identifier (e.g., scm:supplierCnpj, fin:emitterCnpj on NF-e blocks). ## DO NOT Confuse with heroNs:CPFString (11-digit individual tax id) or with the raw xsd:string datatype which performs no pattern validation. Also do not use for foreign corporate identifiers (those go in their own datatype, e.g., a future US EIN datatype). ## KEY RELATIONSHIPS Range of fiscal/legal/SCM datatype properties; consumed by SHACL pattern shapes that enforce ^[0-9]{14}$ and (optionally) the modulo-11 verifier-digit rule. ## PARAMS owl:withRestrictions: xsd:length 14; xsd:pattern '^[0-9]{14}$'. ## ERO CONTEXT Caraiba (MCSA matrix CNPJ 09.625.466/0001-95), Tucuma (MCSA Filial Tucuma), Xavantina (MCSA Filial Xavantina), Furnas (MBES), SP Shared Services (MCSA Filial SP), BH Technical Office and any Brazilian counterparty all carry CNPJ; Vancouver HQ does not. ## SOURCE Receita Federal Instrucao Normativa RFB 1.863/2018 (cadastro CNPJ); ABNT NBR 9050 not applicable; Hero ONTOLOGY-STANDARD v4.1 Section 52 Brazilian Localization.
Receita Federal IN RFB 1.863/2018; Hero ONTOLOGY-STANDARD v4.1 Section 52
Used as the literal range for any datatype property that carries an individual taxpayer identifier in the Hero ABox (employee master data, individual supplier/contractor master, payroll, eSocial integration). Replaces ad-hoc xsd:string so that SHACL shapes and SPARQL queries can validate the 11-digit pattern centrally. Distinct from heroNs:CPFString's corporate counterpart heroNs:CNPJString (14 digits). All Ero Copper employees, third-party contractors, board members and other natural-person counterparties operating in Brazil are identified by CPF in eSocial, INSS and IRRF filings.
Utilizado como faixa literal para qualquer propriedade de dado que carrega identificador de pessoa fisica no ABox Hero (cadastro de empregados, fornecedores e contratados pessoa fisica, folha de pagamento, integracao eSocial). Substitui o uso ad-hoc de xsd:string para que SHACL shapes e consultas SPARQL validem o padrao 11 digitos centralmente. Distinto de heroNs:CNPJString (pessoa juridica, 14 digitos). Todos os empregados Ero Copper, contratados, conselheiros e outras contrapartes pessoa fisica no Brasil sao identificados por CPF em eSocial, INSS e IRRF.
CPF String
String CPF
A literal datatype that constrains the value to an 11-digit numeric string representing a Brazilian individual taxpayer identifier (CPF); the genus is rdfs:Datatype derived from xsd:string and the differentia is the exact length 11, all numeric characters, and validation via the modulo-11 verifier digits per Receita Federal IN RFB 1.548/2015.
Tipo de dado literal que restringe o valor a uma string numerica de 11 digitos que identifica o contribuinte pessoa fisica brasileiro (CPF); o genero e rdfs:Datatype derivado de xsd:string e a diferenca especifica e o comprimento exato 11, todos caracteres numericos, e validacao por digitos verificadores modulo-11 conforme IN RFB 1.548/2015 da Receita Federal.
## OntoClean +R (the datatype rigidly classifies its literal values). ## USE Tag any owl:DatatypeProperty whose range is a Brazilian individual tax identifier (e.g., hr:employeeCpf, fin:beneficiaryCpf). ## DO NOT Confuse with heroNs:CNPJString (14-digit corporate id) or with raw xsd:string. Do not use for foreign individuals (those need their own jurisdiction datatype, e.g., US SSN). ## KEY RELATIONSHIPS Range of HR / payroll / scm individual-contractor datatype properties; consumed by SHACL pattern shapes enforcing ^[0-9]{11}$ and the modulo-11 verifier-digit rule. ## PARAMS owl:withRestrictions: xsd:length 11; xsd:pattern '^[0-9]{11}$'. ## ERO CONTEXT All Brazilian-resident employees and individual contractors at Caraiba (Pilar, Surubim, Vermelhos, Concentrator), Tucuma open-pit, Xavantina (Santo Antonio vein), Furnas (development), SP and BH offices carry CPF; Vancouver HQ does not. ## SOURCE Receita Federal IN RFB 1.548/2015; eSocial Manual de Orientacao (S-1.2); Hero ONTOLOGY-STANDARD v4.1 Section 52 Brazilian Localization.
Receita Federal IN RFB 1.548/2015; eSocial S-1.2; Hero ONTOLOGY-STANDARD v4.1 Section 52
Used as the literal range for any datatype property that carries an electronic fiscal-document access key in the Hero ABox (inbound NF-e on supplier invoices, outbound NF-e on concentrate shipments, CT-e on transport, MDF-e on the multi-modal manifest, NFS-e on services). Pattern-validated by SHACL. Distinct from the document number alone (numero) and from the protocol number (protNFe). Every Hero fiscal document at MCSA matrix and filials must persist this key for SEFAZ traceability and SOX auditability.
Utilizado como faixa literal para qualquer propriedade de dado que carrega chave de acesso de documento fiscal eletronico no ABox Hero (NF-e de entrada em faturas de fornecedor, NF-e de saida em embarques de concentrado, CT-e de transporte, MDF-e de manifesto multimodal, NFS-e de servicos). Validada por SHACL. Distinta do numero do documento (numero) e do numero do protocolo (protNFe). Todo documento fiscal Hero na matriz MCSA e filiais precisa persistir esta chave para rastreabilidade SEFAZ e auditabilidade SOX.
NF-e Access Key String
String Chave de Acesso NF-e
A literal datatype that constrains the value to a 44-digit numeric string that uniquely identifies a Brazilian electronic fiscal document (NF-e, NFC-e, CT-e, MDF-e, NFS-e) per Ajuste SINIEF 07/2005 and downstream amendments; the genus is rdfs:Datatype derived from xsd:string and the differentia is the structural decomposition (UF + AAMM + CNPJ + modelo + serie + numero + tpEmis + cNF + cDV) and the modulo-11 verifier digit (cDV) at position 44.
Tipo de dado literal que restringe o valor a uma string numerica de 44 digitos que identifica univocamente um documento fiscal eletronico brasileiro (NF-e, NFC-e, CT-e, MDF-e, NFS-e) conforme Ajuste SINIEF 07/2005 e alteracoes; o genero e rdfs:Datatype derivado de xsd:string e a diferenca especifica e a decomposicao estrutural (UF + AAMM + CNPJ + modelo + serie + numero + tpEmis + cNF + cDV) e o digito verificador modulo-11 (cDV) na posicao 44.
## OntoClean +R (the datatype rigidly classifies its literal values). ## USE Tag any owl:DatatypeProperty whose range is an NF-e / NFC-e / CT-e / MDF-e / NFS-e access key (e.g., fin:nfeChaveAcesso, fin:cteChaveAcesso). ## DO NOT Confuse with the document number alone (which is just the cNF section of the key) or with the protocol number returned by SEFAZ after authorization (protNFe). ## KEY RELATIONSHIPS Range of fiscal datatype properties on subclasses of fin:NotaFiscalEletronica, fin:CTe, fin:MDFe, fin:NFSe; consumed by SHACL pattern shapes enforcing ^[0-9]{44}$ and the modulo-11 verifier-digit rule at position 44. ## PARAMS owl:withRestrictions: xsd:length 44; xsd:pattern '^[0-9]{44}$'. ## ERO CONTEXT Applied across all Brazilian Ero Copper fiscal operations: Caraiba (concentrate outbound via TEMIB Aracaju), Tucuma (concentrate outbound via Vila do Conde Barcarena), Xavantina (gold dore outbound), Furnas (project capex inbound), SP / BH offices (services NFS-e). ## SOURCE Ajuste SINIEF 07/2005; Manual de Orientacao do Contribuinte (MOC) 7.0; IN RFB 1.702/2017; Hero ONTOLOGY-STANDARD v4.1 Section 52 Brazilian Localization.
Ajuste SINIEF 07/2005; MOC NFe 7.0; Hero ONTOLOGY-STANDARD v4.1 Section 52
Used as a precise literal range for quantities that cannot logically take negative values (mass in kilograms, volume in cubic meters, count of head, physical tonnage). Distinct from heroNs:PositiveDecimal which excludes zero (use it when zero would itself be a quality violation, e.g., a non-zero ore grade). Replaces ad-hoc xsd:decimal so that downstream SHACL shapes validate the sign constraint centrally.
Utilizado como faixa literal precisa para quantidades que logicamente nao podem assumir valores negativos (massa em quilogramas, volume em metros cubicos, tonelagem fisica). Distinto de heroNs:PositiveDecimal que exclui zero (use PositiveDecimal quando zero representa violacao de qualidade, p.ex. teor de minerio diferente de zero). Substitui xsd:decimal ad-hoc para que SHACL shapes validem a restricao de sinal centralmente.
Decimal Nao-Negativo
Non-Negative Decimal
A literal datatype derived from xsd:decimal that restricts the value to be greater than or equal to zero; the genus is rdfs:Datatype derived from xsd:decimal and the differentia is xsd:minInclusive 0.
Tipo de dado literal derivado de xsd:decimal que restringe o valor a ser maior ou igual a zero; o genero e rdfs:Datatype derivado de xsd:decimal e a diferenca especifica e xsd:minInclusive 0.
## OntoClean +R (the datatype rigidly classifies its literal values). ## USE Tag datatype properties whose range admits zero but never negatives (e.g., ops:tonnesHauled). ## DO NOT Confuse with heroNs:PositiveDecimal (zero excluded) or with heroNs:PercentageValue (0..100 bounded). ## KEY RELATIONSHIPS Range of physical-quantity datatype properties across ops/prc/scm/ast. ## PARAMS owl:withRestrictions: xsd:minInclusive 0. ## ERO CONTEXT Tonnage, volume, count, distance, energy quantities at any Ero site. ## SOURCE W3C XML Schema 1.1 Part 2 Datatypes; Hero ONTOLOGY-STANDARD v4.1 Section 9 Datatype Restrictions.
W3C XSD 1.1 Part 2 Datatypes; Hero ONTOLOGY-STANDARD v4.1 Section 9
Used as the literal range for any datatype property that carries a pH measurement (flotation pulp pH, mine water pH, tailings pH, ARD monitoring, leach pH at hydromet operations). Replaces ad-hoc xsd:decimal so SHACL shapes can validate the [0, 14] bound centrally. The IUPAC convention is the closed interval; values outside are physically meaningless within standard activity.
Utilizado como faixa literal para qualquer propriedade de dado que carrega medicao de pH (pH de polpa de flotacao, pH de agua de mina, pH de rejeito, monitoramento DAR, pH de lixiviacao em operacoes hidrometalurgicas). Substitui xsd:decimal ad-hoc para que SHACL shapes validem o intervalo [0, 14] centralmente. A convencao IUPAC e o intervalo fechado; valores fora sao fisicamente sem significado dentro de atividade padrao.
Valor de pH
pH Value
A literal datatype derived from xsd:decimal that restricts the value to the closed interval [0, 14] representing the pH (potential of hydrogen) scale; the genus is rdfs:Datatype derived from xsd:decimal and the differentia is xsd:minInclusive 0 and xsd:maxInclusive 14.
Tipo de dado literal derivado de xsd:decimal que restringe o valor ao intervalo fechado [0, 14] representando a escala de pH (potencial de hidrogenio); o genero e rdfs:Datatype derivado de xsd:decimal e a diferenca especifica e xsd:minInclusive 0 e xsd:maxInclusive 14.
## OntoClean +R (the datatype rigidly classifies its literal values). ## USE Tag any datatype property whose range is a pH measurement (e.g., prc:pulpPh, esg:mineWaterPh, esg:tailingsPh). ## DO NOT Confuse with raw xsd:decimal or with pOH (-log[OH-]) which uses a different scale. ## KEY RELATIONSHIPS Range of prc / esg / aut datatype properties on flotation tanks, leach circuits, tailings dams, water-treatment skids. ## PARAMS owl:withRestrictions: xsd:minInclusive 0; xsd:maxInclusive 14. ## ERO CONTEXT Caraiba flotation pulp pH ~10.5-11.5 (lime addition for pyrite depression); Xavantina CIL pH ~10.5 (cyanide stability); ARD-prone waste-rock dump pH <4 triggers neutralization. ## SOURCE IUPAC Compendium of Chemical Terminology (Gold Book) 2019; ISO 10523:2008 water-quality pH; Hero ONTOLOGY-STANDARD v4.1 Section 9.
IUPAC Gold Book 2019; ISO 10523:2008; Hero ONTOLOGY-STANDARD v4.1 Section 9
Used as the literal range for any datatype property that carries a percentage value (metallurgical recovery, moisture content, availability, utilization, ROI, gross margin). Replaces ad-hoc xsd:decimal so SHACL shapes can validate the [0, 100] bound centrally. Distinct from heroNs:NonNegativeDecimal which is unbounded above.
Utilizado como faixa literal para qualquer propriedade de dado que carrega valor percentual (recuperacao metalurgica, umidade, disponibilidade, utilizacao, ROI, margem bruta). Substitui xsd:decimal ad-hoc para que SHACL shapes validem o intervalo [0, 100] centralmente. Distinto de heroNs:NonNegativeDecimal que nao tem limite superior.
Percentage Value
Valor Percentual
A literal datatype derived from xsd:decimal that restricts the value to the closed interval [0, 100] representing a percentage; the genus is rdfs:Datatype derived from xsd:decimal and the differentia is xsd:minInclusive 0 and xsd:maxInclusive 100.
Tipo de dado literal derivado de xsd:decimal que restringe o valor ao intervalo fechado [0, 100] representando uma porcentagem; o genero e rdfs:Datatype derivado de xsd:decimal e a diferenca especifica e xsd:minInclusive 0 e xsd:maxInclusive 100.
## OntoClean +R (the datatype rigidly classifies its literal values). ## USE Tag any datatype property whose range is a percentage (e.g., prc:recoveryPct, ast:availabilityPct, fin:grossMarginPct). ## DO NOT Confuse with heroNs:NonNegativeDecimal (unbounded above) or with mass-fraction expressed as 0-1 instead of 0-100 (use a separate datatype if 0-1 fraction is needed). ## KEY RELATIONSHIPS Range of percentage datatype properties across prc, ast, fin, esg. ## PARAMS owl:withRestrictions: xsd:minInclusive 0; xsd:maxInclusive 100. ## ERO CONTEXT Cu recovery ~88-95% at Caraiba flotation; Au recovery ~93-96% at Xavantina CIL; availability targets ~88-92% on primary mobile fleet. ## SOURCE W3C XSD 1.1 Part 2; ISO 80000-1 quantities; Hero ONTOLOGY-STANDARD v4.1 Section 9.
W3C XSD 1.1 Part 2; ISO 80000-1; Hero ONTOLOGY-STANDARD v4.1 Section 9
Used as a precise literal range for quantities that cannot logically take zero or negative values (a non-zero head-grade in geology, a non-zero recovery factor in processing, a non-zero throughput per hour). Distinct from heroNs:NonNegativeDecimal which admits zero. Centralized validation enables ABox quality checks to flag impossible zero values.
Utilizado como faixa literal precisa para quantidades que logicamente nao podem ser zero nem negativas (teor de cabeca diferente de zero em geologia, fator de recuperacao diferente de zero no processamento, throughput por hora diferente de zero). Distinto de heroNs:NonNegativeDecimal que admite zero. Validacao centralizada permite verificar valores zero impossiveis no ABox.
Decimal Positivo
Positive Decimal
A literal datatype derived from xsd:decimal that restricts the value to be strictly greater than zero; the genus is rdfs:Datatype derived from xsd:decimal and the differentia is xsd:minExclusive 0.
Tipo de dado literal derivado de xsd:decimal que restringe o valor a ser estritamente maior que zero; o genero e rdfs:Datatype derivado de xsd:decimal e a diferenca especifica e xsd:minExclusive 0.
## OntoClean +R (the datatype rigidly classifies its literal values). ## USE Tag datatype properties whose range excludes zero (e.g., geo:headGradePct, prc:recoveryFactor). ## DO NOT Confuse with heroNs:NonNegativeDecimal (zero admitted). ## KEY RELATIONSHIPS Range of geo/prc/ops quality and KPI datatype properties. ## PARAMS owl:withRestrictions: xsd:minExclusive 0. ## ERO CONTEXT Caraiba head-grade ~0.8-1.5% Cu; Xavantina head-grade ~5-15 g/t Au; non-zero by geological definition. ## SOURCE W3C XML Schema 1.1 Part 2 Datatypes; Hero ONTOLOGY-STANDARD v4.1 Section 9.
Used as the literal range for any datatype property that carries a Celsius temperature reading (ambient at mine portal, bearing temperature on critical rotating equipment, exhaust on diesel engines, slurry temperature on leach circuits, electrolyte temperature on emergency power batteries). Replaces ad-hoc xsd:decimal so SHACL shapes can flag the impossible sub-absolute-zero values.
Utilizado como faixa literal para qualquer propriedade de dado que carrega leitura de temperatura em Celsius (ambiente em portal de mina, temperatura de rolamento em equipamento rotativo critico, gases de escape de motores diesel, temperatura de polpa em circuitos de lixiviacao, temperatura de eletrolito em baterias de potencia de emergencia). Substitui xsd:decimal ad-hoc para que SHACL shapes detectem valores impossiveis abaixo do zero absoluto.
Temperatura em Celsius
Temperature in Celsius
A literal datatype derived from xsd:decimal that restricts the value to be greater than or equal to -273.15 representing a temperature in degrees Celsius; the genus is rdfs:Datatype derived from xsd:decimal and the differentia is xsd:minInclusive -273.15 (absolute zero in the Celsius scale).
Tipo de dado literal derivado de xsd:decimal que restringe o valor a ser maior ou igual a -273.15 representando uma temperatura em graus Celsius; o genero e rdfs:Datatype derivado de xsd:decimal e a diferenca especifica e xsd:minInclusive -273.15 (zero absoluto na escala Celsius).
## OntoClean +R (the datatype rigidly classifies its literal values). ## USE Tag any datatype property whose range is a Celsius temperature (e.g., aut:bearingTempC, prc:leachSlurryTempC). ## DO NOT Confuse with Kelvin (absolute) or Fahrenheit; do not store an offset from a baseline. ## KEY RELATIONSHIPS Range of automation / processing / asset datatype properties on temperature-bearing qualities; consumed by SHACL minInclusive -273.15. ## PARAMS owl:withRestrictions: xsd:minInclusive -273.15. ## ERO CONTEXT Caraiba underground ambient ~28-34 deg C (Pilar deep workings); Tucuma open-pit ambient ~22-38 deg C; Caraiba flash dryer outlet ~95-105 deg C; Xavantina CIL slurry ~25-30 deg C. ## SOURCE ISO 80000-5:2019 quantities-thermodynamics; ITS-90 temperature scale; Hero ONTOLOGY-STANDARD v4.1 Section 9.
ISO 80000-5:2019; ITS-90; Hero ONTOLOGY-STANDARD v4.1 Section 9
Email da pessoa responsável pela governança de um domínio. Aplicado ao header owl:Ontology em arquivos TTL de domínio. Um responsável por domínio — todas as classes do domínio compartilham o mesmo responsável.
Email of the person responsible for governance of a domain. Applied to owl:Ontology header in domain TTL files. One steward per domain — all classes in domain share same steward.
domain steward
responsável pelo domínio