# jbarrasa/goingmeta architecture

> Architecture diagram of the GitHub repository jbarrasa/goingmeta, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jbarrasa/goingmeta
- Repository: https://github.com/jbarrasa/goingmeta

## Overview

GoingMeta is a curated collection of resources for a series of knowledge-graph sessions, not one deployable application. The principal user workflow is to browse the README’s session catalogue, select a topic, and use that session’s examples and materials. The graph highlights documented capabilities and two useful internal examples: ontology-to-model generation in session32 and ontology-guided graph construction in session35. Relationships are limited to README links and visible source calls; many session directories are represented only by their documented topics.

Main entry points: [`README.md`](https://github.com/jbarrasa/goingmeta/blob/main/README.md) (Session index), [`session32/python/DIModelBuilder.py`](https://github.com/jbarrasa/goingmeta/blob/main/session32/python/DIModelBuilder.py) (Model generator), [`session35/python/flow.py`](https://github.com/jbarrasa/goingmeta/blob/main/session35/python/flow.py) (Ontology selection flow), [`session32/python/RAGSchemaFromOnto.py`](https://github.com/jbarrasa/goingmeta/blob/main/session32/python/RAGSchemaFromOnto.py) (RAG schema)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Session catalogue"]
  node_catalogue["Session index<br/>[README.md]"]
end

subgraph group_graphs["Graph foundations"]
  node_s01["Cypher and SPARQL"]
  node_s02["Semantic search"]
  node_s03["SHACL quality"]
  node_s13["Virtual graphs"]
  node_s15["Semantic data app"]
  node_s18["Graph migration"]
end

subgraph group_ontology["Ontology workflows"]
  node_s05["Ontology KG build"]
  node_s07["Ontology language"]
  node_s29["Unstructured extraction"]
  node_s30["Blueprint extraction<br/>[extract_triples.py]"]
  node_s32["Model generator<br/>[DIModelBuilder.py]"]
  node_s32dim["Node definitions<br/>[DIMNodeDef.py]"]
  node_s32rag["RAG schema"]
end

subgraph group_rag["Search and RAG"]
  node_s21["Semantic retrieval"]
  node_s22["Knowledge graph RAG"]
  node_s23["Advanced RAG"]
  node_s31["Ontology GraphRAG<br/>[simple.py]"]
end

subgraph group_advanced["Advanced topics"]
  node_s35["Ontology selection flow<br/>[flow.py]"]
  node_s35onto["Ontology utilities<br/>[onto_utils.py]"]
  node_s42["Ontology evaluation<br/>[cceval.py]"]
  node_s45["Agent skills<br/>[run_kg_pipeline.py]"]
end

node_reader(("Learner"))

node_reader -->|"browses"| node_catalogue
node_catalogue -->|"lists resources"| node_s01
node_catalogue -->|"lists resources"| node_s02
node_catalogue -->|"lists resources"| node_s03
node_catalogue -->|"lists resources"| node_s05
node_catalogue -->|"lists resources"| node_s07
node_catalogue -->|"lists resources"| node_s13
node_catalogue -->|"lists resources"| node_s15
node_catalogue -->|"lists resources"| node_s18
node_catalogue -->|"lists resources"| node_s21
node_catalogue -->|"lists resources"| node_s22
node_catalogue -->|"lists resources"| node_s23
node_catalogue -->|"lists resources"| node_s29
node_catalogue -->|"lists resources"| node_s30
node_catalogue -->|"lists resources"| node_s31
node_catalogue -->|"lists resources"| node_s32
node_catalogue -->|"lists resources"| node_s35
node_catalogue -->|"lists resources"| node_s42
node_catalogue -->|"lists resources"| node_s45
node_s32 -->|"uses definitions"| node_s32dim
node_s32rag -.->|"complements modeling"| node_s32
node_s35 -->|"imports utilities"| node_s35onto

click node_catalogue "https://github.com/jbarrasa/goingmeta/blob/main/README.md"
click node_s01 "https://github.com/jbarrasa/goingmeta/tree/main/session01"
click node_s02 "https://github.com/jbarrasa/goingmeta/tree/main/session02"
click node_s03 "https://github.com/jbarrasa/goingmeta/tree/main/session03"
click node_s05 "https://github.com/jbarrasa/goingmeta/tree/main/session05"
click node_s07 "https://github.com/jbarrasa/goingmeta/tree/main/session07"
click node_s13 "https://github.com/jbarrasa/goingmeta/tree/main/session13"
click node_s15 "https://github.com/jbarrasa/goingmeta/tree/main/session15"
click node_s18 "https://github.com/jbarrasa/goingmeta/tree/main/session18"
click node_s21 "https://github.com/jbarrasa/goingmeta/tree/main/session21"
click node_s22 "https://github.com/jbarrasa/goingmeta/tree/main/session22"
click node_s23 "https://github.com/jbarrasa/goingmeta/tree/main/session23"
click node_s29 "https://github.com/jbarrasa/goingmeta/blob/main/session29/python/kgbuilder-openai.py"
click node_s30 "https://github.com/jbarrasa/goingmeta/blob/main/session30/python/extract_triples.py"
click node_s31 "https://github.com/jbarrasa/goingmeta/blob/main/session31/python/simple.py"
click node_s32 "https://github.com/jbarrasa/goingmeta/blob/main/session32/python/DIModelBuilder.py"
click node_s32dim "https://github.com/jbarrasa/goingmeta/blob/main/session32/python/DIMNodeDef.py"
click node_s32rag "https://github.com/jbarrasa/goingmeta/blob/main/session32/python/RAGSchemaFromOnto.py"
click node_s35 "https://github.com/jbarrasa/goingmeta/blob/main/session35/python/flow.py"
click node_s35onto "https://github.com/jbarrasa/goingmeta/blob/main/session35/python/onto_utils.py"
click node_s42 "https://github.com/jbarrasa/goingmeta/blob/main/session42/python/cceval.py"
click node_s45 "https://github.com/jbarrasa/goingmeta/blob/main/session45/python/run_kg_pipeline.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_catalogue toneBlue
class node_s01,node_s02,node_s03,node_s13,node_s15,node_s18 toneAmber
class node_s05,node_s07,node_s29,node_s30,node_s32,node_s32dim,node_s32rag toneMint
class node_s21,node_s22,node_s23,node_s31 toneRose
class node_s35,node_s35onto,node_s42,node_s45,node_reader toneIndigo
```

## Components

### Session catalogue

- [Session index](https://github.com/jbarrasa/goingmeta/blob/main/README.md): `README.md`

### Graph foundations

- [Cypher and SPARQL](https://github.com/jbarrasa/goingmeta/tree/main/session01): `session01`
- [Semantic search](https://github.com/jbarrasa/goingmeta/tree/main/session02): `session02`
- [SHACL quality](https://github.com/jbarrasa/goingmeta/tree/main/session03): `session03`
- [Virtual graphs](https://github.com/jbarrasa/goingmeta/tree/main/session13): `session13`
- [Semantic data app](https://github.com/jbarrasa/goingmeta/tree/main/session15): `session15`
- [Graph migration](https://github.com/jbarrasa/goingmeta/tree/main/session18): `session18`

### Ontology workflows

- [Ontology KG build](https://github.com/jbarrasa/goingmeta/tree/main/session05): `session05`
- [Ontology language](https://github.com/jbarrasa/goingmeta/tree/main/session07): `session07`
- [Unstructured extraction](https://github.com/jbarrasa/goingmeta/blob/main/session29/python/kgbuilder-openai.py): `session29/python/kgbuilder-openai.py`
- [Blueprint extraction](https://github.com/jbarrasa/goingmeta/blob/main/session30/python/extract_triples.py): `session30/python/extract_triples.py`
- [Model generator](https://github.com/jbarrasa/goingmeta/blob/main/session32/python/DIModelBuilder.py): `session32/python/DIModelBuilder.py`
- [Node definitions](https://github.com/jbarrasa/goingmeta/blob/main/session32/python/DIMNodeDef.py): `session32/python/DIMNodeDef.py`
- [RAG schema](https://github.com/jbarrasa/goingmeta/blob/main/session32/python/RAGSchemaFromOnto.py): `session32/python/RAGSchemaFromOnto.py`

### Search and RAG

- [Semantic retrieval](https://github.com/jbarrasa/goingmeta/tree/main/session21): `session21`
- [Knowledge graph RAG](https://github.com/jbarrasa/goingmeta/tree/main/session22): `session22`
- [Advanced RAG](https://github.com/jbarrasa/goingmeta/tree/main/session23): `session23`
- [Ontology GraphRAG](https://github.com/jbarrasa/goingmeta/blob/main/session31/python/simple.py): `session31/python/simple.py`

### Advanced topics

- [Ontology selection flow](https://github.com/jbarrasa/goingmeta/blob/main/session35/python/flow.py): `session35/python/flow.py`
- [Ontology utilities](https://github.com/jbarrasa/goingmeta/blob/main/session35/python/onto_utils.py): `session35/python/onto_utils.py`
- [Ontology evaluation](https://github.com/jbarrasa/goingmeta/blob/main/session42/python/cceval.py): `session42/python/cceval.py`
- [Agent skills](https://github.com/jbarrasa/goingmeta/blob/main/session45/python/run_kg_pipeline.py): `session45/python/run_kg_pipeline.py`

### Other components

- **Learner**

## Connections

- Learner → Session index: browses (evidence: `README.md`)
- Session index → Cypher and SPARQL: lists resources (evidence: `README.md`)
- Session index → Semantic search: lists resources (evidence: `README.md`)
- Session index → SHACL quality: lists resources (evidence: `README.md`)
- Session index → Ontology KG build: lists resources (evidence: `README.md`)
- Session index → Ontology language: lists resources (evidence: `README.md`)
- Session index → Virtual graphs: lists resources (evidence: `README.md`)
- Session index → Semantic data app: lists resources (evidence: `README.md`)
- Session index → Graph migration: lists resources (evidence: `README.md`)
- Session index → Semantic retrieval: lists resources (evidence: `README.md`)
- Session index → Knowledge graph RAG: lists resources (evidence: `README.md`)
- Session index → Advanced RAG: lists resources (evidence: `README.md`)
- Session index → Unstructured extraction: lists resources (evidence: `README.md`)
- Session index → Blueprint extraction: lists resources (evidence: `README.md`)
- Session index → Ontology GraphRAG: lists resources (evidence: `README.md`)
- Session index → Model generator: lists resources (evidence: `README.md`)
- Session index → Ontology selection flow: lists resources (evidence: `README.md`)
- Session index → Ontology evaluation: lists resources (evidence: `README.md`)
- Session index → Agent skills: lists resources (evidence: `README.md`)
- Model generator → Node definitions: uses definitions (evidence: `session32/python/DIModelBuilder.py`)
- RAG schema → Model generator: complements modeling
- Ontology selection flow → Ontology utilities: imports utilities (evidence: `session35/python/flow.py`)
