Skip to content

Commit a891cc4

Browse files
AdaWorldAPIAdaWorldAPI
authored
Merge pull request #407 from AdaWorldAPI/claude/hydrate-dolce-dul-owl-Ce9Oa
feat(ontology): bO-1..bO-16 — DOLCE/FIBO/QUDT/ZUGFeRD/SKR hydrators + 2 new Tier-C hydrator types
2 parents 02b066e + 2e3dd48 commit a891cc4

193 files changed

Lines changed: 212659 additions & 9 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎Cargo.lock‎

Lines changed: 21 additions & 5 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎LICENSES/DATEV-SKR.txt‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
DATEV SKR 03 / SKR 04 — German Standard Chart of Accounts
2+
==========================================================
3+
4+
Source documents
5+
----------------
6+
data/ontologies/skr-datev/ holds machine-readable CSV extracts of two
7+
DATEV Standardkontenrahmen ("Eigenformular") publications:
8+
9+
- SKR 04 generic — DATEV Art.-Nr. 11175 (revision 2023-01-02,
10+
valid for booking year 2023)
11+
- SKR 03 Bau — DATEV Art.-Nr. 19606 (Branchenpaket für Bau
12+
und Handwerk, valid for booking year 2026)
13+
14+
DATEV's PDFs carry the notice:
15+
"Eigenformular, Nachdruck - auch auszugsweise - nicht gestattet"
16+
(Own form — reproduction, including excerpts, not permitted)
17+
18+
What is shipped here
19+
--------------------
20+
ONLY the underlying chart-of-accounts data — account number, German
21+
account name, family classification — is redistributed in CSV form.
22+
DATEV's specific PDF formatting, layout, table design, typography,
23+
column structure, and printed-form trade dress are NOT redistributed.
24+
The original PDFs themselves are NOT included in this repository.
25+
26+
Legal basis for the data redistribution
27+
---------------------------------------
28+
The Standardkontenrahmen is a German bookkeeping standard. The
29+
individual account numbers (e.g. "0050", "1200", "8400") are short
30+
numeric identifiers that order a body of public-domain HGB / EStG
31+
accounting concepts. Under German Urheberrecht (UrhG §2), purely
32+
functional identifiers and standard reference numbers carry no
33+
copyright protection. The German account names are likewise
34+
descriptive labels for legally-defined accounting concepts; they
35+
implement the underlying tax-and-commercial-law obligations and
36+
function as factual identifiers rather than creative expression.
37+
38+
DATEV's copyright on the published Eigenformular pertains to the
39+
FORM (layout, typography, column placement, page design), not to
40+
the chart data itself.
41+
42+
We redistribute the chart data here for the lance-graph cognitive
43+
shader to anchor HGB-compliant booking entities and align them with
44+
FIBO and ZUGFeRD invoice projections. We do not redistribute, mirror,
45+
or excerpt the DATEV PDF itself, and we do not use the DATEV
46+
typography or layout.
47+
48+
If you require commercial-grade DATEV SKR data with formal licensing,
49+
warranty, and update guarantees, obtain the source PDF directly from
50+
DATEV eG (https://www.datev.de) under their commercial terms.
51+
52+
Hydration
53+
---------
54+
This data is intended to be hydrated by lance-graph-ontology as a
55+
future PR-bO-13 deliverable (SKR-as-SKOS Concept Scheme). The hydrator
56+
will treat each account_number as an IRI
57+
`urn:datev:skr04:account/{number}` or
58+
`urn:datev:skr03:account/{number}`,
59+
with the account_name as an rdfs:label, family as a SKOS Collection
60+
membership, and cross-walks to FIBO MonetaryAmount and HGB-Bilanz
61+
concepts attached as separate axioms.

‎LICENSES/DOLCE.txt‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
DOLCE+DnS Ultralite (DUL)
2+
=========================
3+
4+
Source
5+
------
6+
http://www.ontologydesignpatterns.org/ont/dul/DUL.owl
7+
8+
Authors
9+
-------
10+
Aldo Gangemi, Valentina Presutti, and contributors at the Laboratory for
11+
Applied Ontology (LOA), CNR Institute for Cognitive Sciences and
12+
Technologies (ISTC), Rome, Italy.
13+
14+
License
15+
-------
16+
Creative Commons Attribution 4.0 International (CC-BY 4.0)
17+
https://creativecommons.org/licenses/by/4.0/
18+
19+
Citation
20+
--------
21+
Gangemi, A., Borgo, S., Catenacci, C., Lehmann, J., Masolo, C.,
22+
Presutti, V., et al. (2003-present). "DOLCE+DnS Ultralite (DUL)."
23+
Laboratory for Applied Ontology, CNR-ISTC.
24+
25+
Original DOLCE foundational paper:
26+
Masolo, C., Borgo, S., Gangemi, A., Guarino, N., Oltramari, A. (2003).
27+
"WonderWeb Deliverable D18: Ontology Library (final)."
28+
29+
Usage in this repository
30+
------------------------
31+
The file data/ontologies/dul.ttl is the canonical DOLCE+DUL ontology
32+
(version 4.2, Turtle serialization, ~187 KB) verbatim from the upstream
33+
URI above. It is hydrated by the lance-graph-ontology crate as the L1
34+
upper-ontology slot OGIT::DOLCE_V1. Every downstream L2-L4 business
35+
ontology (OWL-Time, PROV-O, QUDT, FIBO-FND, schema.org, ...) declares
36+
inherits_from: Some(OGIT::DOLCE_V1.0) and resolves against this
37+
hydration via rdfs:subClassOf chains.
38+
39+
Note on naming: canonical DOLCE+DUL deliberately departs from the
40+
original DOLCE-Lite-Plus naming convention. Per the ontology header,
41+
"the names of classes and relations have been made more intuitive."
42+
The two most load-bearing renames for the cognitive-shader L1 slot
43+
are: Endurant → Object, Perdurant → Event. The four upper categories
44+
in DUL are: Object, Event, Quality, Abstract (all direct sub-classes
45+
of Entity).
46+
47+
DUL extension modules
48+
---------------------
49+
data/ontologies/dul-extensions/ holds sibling design-pattern modules
50+
shipped from the same upstream Ontology Design Patterns catalogue under
51+
the same CC-BY 4.0 license. Both are RDF/XML rather than Turtle, so
52+
the OwlHydrator's `detect_format` content-sniffer routes them through
53+
oxrdfxml automatically.
54+
55+
- conceptualization.owl (~8 KB): patterns for agent-conceptualization
56+
relations — `knows` / `believes` / `assumes` / `adopts` plus the
57+
`InternalRepresentation` class. Refines the dul:conceptualizes
58+
property surface used by cognitive-shader agency cascades.
59+
60+
- lmm-l2.owl (~32 KB): Lexical MetaModel Level 2. Adds named-entity
61+
recognition surface (`NamedEntity` / `Name` / `ConceptExpression` /
62+
`ConceptReference` / `ContextualExpression` / `IndividualReference`
63+
/ `MultipleReference` / `Gloss`). Imports LMM_L1 and IOLite by URL;
64+
those imports are not followed by the hydrator (the IRIs are still
65+
interned as referenced names, but the imported triples are not).
66+
67+
Both extensions hydrate into the same OGIT::DOLCE_V1 bundle as DUL.ttl
68+
via OwlHydrator::hydrate_many, so downstream consumers see one
69+
transitive L1 surface rather than three separate G slots.
70+
71+
Attribution
72+
-----------
73+
DOLCE+DnS Ultralite is provided by the Laboratory for Applied Ontology
74+
under CC-BY 4.0. The lance-graph project gratefully acknowledges the
75+
LOA team's foundational work on upper-category ontology engineering.

‎LICENSES/FIBO.txt‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
FIBO (Financial Industry Business Ontology)
2+
===========================================
3+
4+
Source
5+
------
6+
https://github.com/edmcouncil/fibo
7+
https://spec.edmcouncil.org/fibo/
8+
9+
Authors
10+
-------
11+
EDM Council (Enterprise Data Management Council) and contributors.
12+
13+
License
14+
-------
15+
The MIT License (MIT)
16+
17+
Copyright (c) 2020 Enterprise Data Management Council
18+
19+
Permission is hereby granted, free of charge, to any person obtaining a copy of
20+
this software and associated documentation files (the "Software"), to deal in
21+
the Software without restriction, including without limitation the rights to
22+
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
23+
the Software, and to permit persons to whom the Software is furnished to do so,
24+
subject to the following conditions:
25+
26+
The above copyright notice and this permission notice shall be included in all
27+
copies or substantial portions of the Software.
28+
29+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
30+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
31+
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
32+
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
33+
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
34+
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
35+
36+
Usage in this repository
37+
------------------------
38+
data/ontologies/fibo-fnd/ contains the FIBO Foundations (FND) module
39+
suite as RDF/XML (~59 files, ~1.5 MB). Hydrated as OGIT::FIBOFND_V1.
40+
41+
data/ontologies/fibo-be/ contains the FIBO Business Entities (BE)
42+
module suite as RDF/XML (~52 files, ~1.3 MB). Hydrated as
43+
OGIT::FIBOBE_V1, depending on FIBO-FND.
44+
45+
Both modules declare `inherits_from: Some(OGIT::DOLCE_V1.0)` directly
46+
(future work: BE could declare `inherits_from: Some(OGIT::FIBOFND_V1.0)`
47+
once multi-parent inherits_from chains land in the registry).
48+
49+
The hydrators walk the directory tree and pass every `.rdf` file to
50+
OwlHydrator::hydrate_many, which dispatches RDF/XML parsing via
51+
oxrdfxml (Turtle parsing via oxttl is used for the other bO-* hydrators).
52+
53+
Citation
54+
--------
55+
EDM Council. (2024). "FIBO — Financial Industry Business Ontology."
56+
Enterprise Data Management Council.

‎LICENSES/OWL-TIME.txt‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
OWL-Time (W3C Time Ontology)
2+
============================
3+
4+
Source
5+
------
6+
http://www.w3.org/2006/time
7+
W3C Recommendation: https://www.w3.org/TR/owl-time/
8+
9+
Authors
10+
-------
11+
Simon Cox, Chris Little (W3C Spatial Data on the Web Working Group)
12+
13+
License
14+
-------
15+
This document is licensed under the W3C Document License.
16+
https://www.w3.org/Consortium/Legal/2015/doc-license
17+
18+
The associated OWL ontology is in the public domain under the W3C
19+
Software and Document License (2015). See:
20+
https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
21+
22+
Usage in this repository
23+
------------------------
24+
data/ontologies/time.ttl is the canonical OWL-Time ontology, hydrated by
25+
lance-graph-ontology as the L2 universal temporal slot OGIT::TIME_V1.
26+
Declares inherits_from: Some(OGIT::DOLCE_V1.0) and provides the Allen-13
27+
interval relation surface for cognitive-shader temporal cascade.
28+
29+
Citation
30+
--------
31+
Cox, S. and Little, C. (2017). "Time Ontology in OWL."
32+
W3C Recommendation 19 October 2017.

‎LICENSES/PROV-O.txt‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
PROV-O (W3C Provenance Ontology)
2+
================================
3+
4+
Source
5+
------
6+
http://www.w3.org/ns/prov
7+
W3C Recommendation: https://www.w3.org/TR/prov-o/
8+
9+
Authors
10+
-------
11+
Timothy Lebo, Satya Sahoo, Deborah McGuinness (eds.); W3C Provenance
12+
Working Group.
13+
14+
License
15+
-------
16+
This document is licensed under the W3C Document License.
17+
https://www.w3.org/Consortium/Legal/2015/doc-license
18+
19+
The associated OWL ontology is published under the W3C Software and
20+
Document License (2015) and is in the public domain. See:
21+
https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
22+
23+
Usage in this repository
24+
------------------------
25+
data/ontologies/provo.ttl is the canonical PROV-O ontology, hydrated by
26+
lance-graph-ontology as the L2 universal provenance slot OGIT::PROVO_V1.
27+
Declares inherits_from: Some(OGIT::DOLCE_V1.0) and provides the
28+
generation / derivation / attribution surface for cognitive-shader
29+
provenance cascade.
30+
31+
Citation
32+
--------
33+
Lebo, T., Sahoo, S., McGuinness, D., eds. (2013). "PROV-O: The PROV
34+
Ontology." W3C Recommendation 30 April 2013.

‎LICENSES/QUDT.txt‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
QUDT (Quantities, Units, Dimensions and Data Types Ontologies)
2+
==============================================================
3+
4+
Source
5+
------
6+
http://qudt.org/2.1/schema/qudt
7+
http://qudt.org/vocab/unit/
8+
http://qudt.org/vocab/quantitykind/
9+
GitHub: https://github.com/qudt/qudt-public-repo
10+
11+
Authors
12+
-------
13+
Ralph Hodgson, Steve Ray, Paul Keller, Jack Hodges (TopQuadrant);
14+
NASA Ames Research Center; community contributors.
15+
16+
License
17+
-------
18+
Creative Commons Attribution 4.0 International (CC-BY 4.0)
19+
https://creativecommons.org/licenses/by/4.0/
20+
21+
Usage in this repository
22+
------------------------
23+
data/ontologies/qudt-core.ttl is the QUDT 2.1 core schema (~163 classes).
24+
data/ontologies/qudt-units.ttl is the QUDT 2.1 units catalogue (~2900
25+
unit individuals).
26+
data/ontologies/qudt-quantitykinds.ttl is the QUDT 2.1 quantitykinds
27+
catalogue (~1240 quantity-kind individuals including all SI base
28+
quantitykinds: Length, Mass, Time, ElectricCurrent, Temperature,
29+
AmountOfSubstance, LuminousIntensity).
30+
31+
All three files are hydrated together by lance-graph-ontology as the L2
32+
universal quantities/units/dimensions slot OGIT::QUDT_V1, merged into a
33+
single ContextBundle via OwlHydrator::hydrate_many.
34+
35+
Declares inherits_from: Some(OGIT::DOLCE_V1.0) and provides the
36+
quantity-kind, unit-binding, and dimensional-vector surface for
37+
downstream measurement and conversion cascades.
38+
39+
Citation
40+
--------
41+
Hodgson, R., Keller, P. J., Hodges, J., Spivak, J. (2014). "QUDT —
42+
Quantities, Units, Dimensions and Data Types Ontologies."
43+
http://www.qudt.org

0 commit comments

Comments
 (0)