Reference · Deutsch

RDFS-Schema

knowmind nutzt ein vollständig RDF/RDFS-fundiertes Schema. Jeder Knoten und jede Kante hat eine definierte semantische Rolle — keine wahllosen Tags, keine impliziten Bedeutungen.

Standards-Stack

knowmind aligniert sich an etablierte W3C- und Community-Vokabularien:foaf:Person,schema:Organization,prov:Activity,bibo:Document,org:Membership,dqv:QualityMeasurement,odrl:Policy,skos:Concept. So lassen sich knowmind-Daten ohne Schema-Migration in andere Triple-Stores oder semantische Such-Stacks übertragen.

Pro Knoten werden mehrere RDF-Klassen-Labels gleichzeitig gesetzt — z. B. ein Person-Knoten ist gleichzeitig :Person, :foaf_Person, :schema_Person, :prov_Person und :prov_Agent.

IRI-Namespace

Jede Ressource bekommt eine stabile, tenant-prefixed IRI:

https://kg.knowmind.de/t/<tenant-uuid>/<segment>/<slug>

Beispiele:
https://kg.knowmind.de/t/{tenant}/memory/onboarding-handbuch
https://kg.knowmind.de/t/{tenant}/chunk/onboarding-handbuch/0003
https://kg.knowmind.de/t/{tenant}/emb/onboarding-handbuch/0003
https://kg.knowmind.de/t/{tenant}/person/anna-mueller
https://kg.knowmind.de/t/{tenant}/policy/internal-confidential

Tenant-UUID ist Pflicht-Segment — keine Cross-Tenant-IRIs erlaubt.

Klassen

26 Kern-Klassen, jeweils mit Alignment zu W3C-Standards. Sie können eigene Sub-Klassen per Tag oder per type-Property ergänzen — knowmind macht daraus automatisch ein rdfs:subClassOf-Verhältnis.

KlasseStandard-MappingZweck
Personfoaf:Person, schema:Person, prov:Person, prov:AgentEine natürliche Person — Anwender, Ansprechpartner, Autor.
PseudonymizedPersonPerson + pseudonymisiertPseudonymisierte Person, wenn Klarname nicht persistiert werden darf (DSGVO).
Organizationorg:Organization, schema:Organization, prov:AgentFirma, Behörde, Verein, Gruppe.
ClientOrganization + Kunden-RolleEine Organisation, mit der Sie eine Geschäftsbeziehung haben.
SupplierOrganization + Lieferanten-RolleEin externer Dienstleister oder Lieferant.
Roleorg:Role, skos:ConceptEine fachliche Rolle (CTO, Projektleiter, Berater …).
Skillskos:ConceptFertigkeit oder Kompetenz, einer Person oder Rolle zugeordnet.
ProjectEin zeitlich begrenztes Vorhaben mit klaren Zielen.
Meetingschema:EventTermin, Besprechung — verknüpft Personen, Projekte, Dokumente.
Documentschema:DigitalDocument, bibo:DocumentEin Wissens-Artefakt: Notiz, Memo, Spec, Whitepaper.
DocumentVersionbibo:Document, prov:EntityKonkrete Version eines Dokuments — versioniert über die Zeit.
Contractbibo:LegalDocumentEin Vertrag — Sonderform von Document mit zusätzlichen Pflichtfeldern (Parteien, Laufzeit).
Chunkprov:EntityInhaltlicher Teilabschnitt einer DocumentVersion — die Recall-Einheit.
Embeddingprov:EntityVektor-Repräsentation eines Chunks — Foundation des semantischen Recall.
Toolschema:SoftwareApplicationSoftware, die als Werkzeug eingesetzt wird (Claude Code, Cursor, ChatGPT).
Applicationschema:SoftwareApplicationAnwendungs-Software, die wir selbst nutzen oder bauen.
Productschema:ProductEin Produkt im Portfolio — eigenes oder fremdes.
Serviceschema:ServiceEine angebotene Dienstleistung.
DataSourceprov:EntityEine Datenquelle — Mailbox, S3-Bucket, API, Importpfad.
PipelineRunprov:ActivityEin Pipeline-Lauf (Import, Embedding, Migration) — provenance-relevant.
QualityMetricdqv:MetricEine Qualitätsmetrik (z. B. Recall@5).
QualityMeasurementdqv:QualityMeasurementEine einzelne Messung einer QualityMetric mit Wert und Zeitstempel.
AccessPolicyodrl:PolicyZugriffsrichtlinie (public, internal, internal-confidential, restricted).
ConsentRecordDatenschutz-Einwilligung — wer hat wann zu was Ja gesagt.
TombstoneMarkierung für gelöschte Inhalte — DSGVO-orientiert, aber provenance-erhaltend.
DeletionEventprov:ActivityDas Lösch-Ereignis selbst — wer, wann, warum.

Edge-Typen

knowmind kennt 21 semantisch typisierte Edge-Klassen. Jede hat eine definierte Domain, einen Range und — bei Bidirektionalität — einen automatisch materialisierten Inverse-Edge. Beim Anlegen einer Vorwärts-Edge entsteht der inverse Edge sofort, mit derselben Tenant-ID.

RelationVonNachInverseSemantik
HAS_EMPLOYEEOrganizationPersonIS_EMPLOYEE_OFDie Person ist bei der Organisation angestellt.
IS_LED_BYOrganizationPersonLEADS_ORGANIZATIONDie Person leitet die Organisation.
OWNSPerson | OrganizationTool | Product | DataSourceOWNED_BYEigentumsverhältnis.
HAS_SKILLPerson | RoleSkillDiese Skill ist der Person oder Rolle zugewiesen.
WORKS_ONPerson | RoleProjectMitwirkung in einem Projekt.
FOR_CLIENTProject | DocumentClientDas Projekt oder Dokument gehört zum Mandat eines Kunden.
HAS_VERSIONDocumentDocumentVersionIS_VERSION_OFDokument hat diese Version.
HAS_CHUNKDocumentVersionChunkCHUNK_OFDocumentVersion ist in diesen Chunk zerlegt.
HAS_EMBEDDINGChunkEmbeddingEMBEDDING_OFChunk hat dieses Embedding.
INDEXED_INEmbeddingVectorIndexEmbedding liegt in diesem ANN-Index.
REFERENCES_ENTITYDocument | ChunkPerson | Organization | Project | Product …REFERENCED_BYInhaltlicher Bezug — diese Person/Sache wird im Dokument erwähnt.
PRODUCESTool | ServiceDocument | ProductPRODUCED_BYErgebnis aus einer Aktivität.
DEPENDS_ON**ENABLESAbhängigkeit — A funktioniert nur, wenn B existiert.
APPLIES_TOQualityMeasurement | AccessPolicy*HAS_RULERegel oder Messung bezieht sich auf die Ziel-Ressource.
REFERENCESDocumentDocumentREFERENCED_BYDokument zitiert oder referenziert ein anderes Dokument.
SUPERSEDESDocument | DocumentVersionDocument | DocumentVersionSUPERSEDED_BYEine neuere Version ersetzt eine ältere.
WAS_GENERATED_BY*PipelineRun | DeletionEventGENERATEDPROV-O — diese Ressource wurde von einem Lauf erzeugt.
USEDPipelineRun*USED_BYPROV-O — Lauf hat diese Ressource konsumiert.
WAS_DERIVED_FROM**DERIVATION_TARGET_OFPROV-O — Inhalt ist aus einem anderen Inhalt abgeleitet.
WAS_ASSOCIATED_WITHPipelineRun | DeletionEventPerson | ToolPROV-O — Akteur, der den Lauf ausgelöst hat.
MEASURED_METRICQualityMeasurementQualityMetricDQV — diese Messung gehört zu jener Metrik.

Wie Sie als Kunde Beziehungen pflegen

Drei Wege, eine Edge anzulegen:

  1. Implizit beim Speichern — wenn Sie in einem Memory Tags wie @projekt-helios oder [[ada-lovelace]] nutzen, erzeugt knowmind automatisch eine REFERENCES_ENTITY-Edge.
  2. Über die API — POST /api/graph/relations mit { fromId, toId, relType, properties }. Die typed Edge wird angelegt, der Inverse-Edge automatisch materialisiert.
  3. Im Dashboard — auf jeder Memory-Detail-Seite gibt es den Bereich „Beziehungen", in dem Sie aus den 21 Edge-Typen wählen und die Ziel-Ressource auswählen können.

Validierung: SHACL-Constraints prüfen Domain/Range. Bei Verletzung wird die Edge mit klarer Fehlermeldung abgelehnt — keine kaputten Beziehungen im Graphen.

Beispiel — Beratungs-Mandat

(Anna Müller :Person)
    -[:HAS_SKILL]-> (KI-Strategie :Skill)
    -[:IS_EMPLOYEE_OF]-> (Acme Beratung :Organization)
    -[:WORKS_ON]-> (Projekt Helios :Project)
                    -[:FOR_CLIENT]-> (Müller Maschinenbau :Client)
                    -[:HAS_DOCUMENT]-> (Workshop-Memo 2026-03-12 :Document)
                                        -[:HAS_VERSION]-> (Workshop-Memo v1 :DocumentVersion)
                                                            -[:HAS_CHUNK]-> (Chunk 0001 :Chunk)
                                                                              -[:HAS_EMBEDDING]-> (Embedding :Embedding)
                                                                                                    -[:INDEXED_IN]-> (sc-internal-idx :VectorIndex)
                    -[:GOVERNED_BY]-> (internal-confidential :AccessPolicy)

Verwandt: Memory-Konzept · API-Referenz · English version