# sharptoolbox/ontology_modeling_framework architecture

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

- Interactive diagram: https://gitdiagram.com/sharptoolbox/ontology_modeling_framework
- Repository: https://github.com/sharptoolbox/ontology_modeling_framework

## Overview

This repository is a documentation-only ontology-driven modeling framework, not an executable application. Its principal workflow is to turn requirements into traceable YAML models that guide design and code generation. The graph captures the documented v6 model dependencies and the v9 synchronous subset; relationships are specification dependencies, not runtime calls. Source excerpts were unavailable, so edges rely on the README, and the individual specifications’ internal details are not inferred.

Main entry points: [`ontology_modeling_framework_v6.md`](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md) (Behaviors M2), [`ontology_modeling_framework_v5.md`](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v5.md) (Expanded v4–v5), [`ontology_modeling_framework_v2.md`](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v2.md) (Foundations v1–v2), [`ontology_modeling_framework_v9.md`](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v9.md) (Synchronous v9)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_versions["Framework versions"]
  node_v6["Full framework v6"]
  node_v9["Synchronous v9"]
  node_v1v2["Foundations v1–v2"]
  node_v4v5["Expanded v4–v5"]
end

subgraph group_domain["Core domain models"]
  node_m1["Objects M1"]
  node_m2["Behaviors M2"]
  node_m3["Rules M3"]
  node_m5["Actors M5"]
end

subgraph group_coordination["Coordination models"]
  node_me["Events ME"]
  node_m4["Scenarios M4"]
  node_m6["Processes M6"]
  node_m7["Queries M7"]
  node_mu["UI MU"]
end

subgraph group_extensions["Boundary and persistence"]
  node_mm["Data mapping MM"]
  node_mi["Interfaces MI"]
end

node_designer(("System modeler"))
node_requirements["Requirements"]
node_design["System design"]
node_code["Generated code"]

node_designer -->|"models"| node_requirements
node_requirements -->|"specifies with"| node_v6
node_v6 -->|"guides"| node_design
node_design -->|"traces to"| node_code
node_v1v2 -->|"evolves into"| node_v4v5
node_v4v5 -->|"extends to"| node_v6
node_v6 -->|"trims into"| node_v9
node_m2 -->|"acts on"| node_m1
node_m2 -->|"uses rules"| node_m3
node_m2 -->|"subject to"| node_m5
node_me -->|"depends on"| node_m2
node_me -->|"depends on"| node_m3
node_m4 -->|"depends on"| node_m1
node_m4 -->|"depends on"| node_m2
node_m4 -->|"depends on"| node_m3
node_m4 -->|"depends on"| node_me
node_m6 -->|"depends on"| node_m4
node_m6 -->|"depends on"| node_m5
node_m7 -->|"queries"| node_m1
node_m7 -->|"binds query"| node_m2
node_mu -->|"maps screens"| node_m6
node_mm -->|"maps objects"| node_m1
node_mm -->|"supports SQL"| node_m7
node_mi -->|"binds calls"| node_m2
node_mi -->|"supports events"| node_me
node_mi -->|"aligns contracts"| node_m5

click node_v6 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_v9 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v9.md"
click node_v1v2 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v2.md"
click node_v4v5 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v5.md"
click node_m1 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_m2 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_m3 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_m5 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_me "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_m4 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_m6 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_m7 "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_mu "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_mm "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"
click node_mi "https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md"

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_v6,node_v9,node_v1v2,node_v4v5 toneBlue
class node_m1,node_m2,node_m3,node_m5 toneAmber
class node_me,node_m4,node_m6,node_m7,node_mu toneMint
class node_mm,node_mi toneRose
class node_designer,node_requirements,node_design,node_code toneIndigo
```

## Components

### Framework versions

- [Full framework v6](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`
- [Synchronous v9](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v9.md): `ontology_modeling_framework_v9.md`
- [Foundations v1–v2](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v2.md): `ontology_modeling_framework_v2.md`
- [Expanded v4–v5](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v5.md): `ontology_modeling_framework_v5.md`

### Core domain models

- [Objects M1](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`
- [Behaviors M2](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`
- [Rules M3](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`
- [Actors M5](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`

### Coordination models

- [Events ME](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`
- [Scenarios M4](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`
- [Processes M6](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`
- [Queries M7](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`
- [UI MU](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`

### Boundary and persistence

- [Data mapping MM](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`
- [Interfaces MI](https://github.com/sharptoolbox/ontology_modeling_framework/blob/main/ontology_modeling_framework_v6.md): `ontology_modeling_framework_v6.md`

### Other components

- **System modeler**
- **Requirements**
- **System design**
- **Generated code**

## Connections

- System modeler → Requirements: models (evidence: `README.md`)
- Requirements → Full framework v6: specifies with (evidence: `README.md`)
- Full framework v6 → System design: guides (evidence: `README.md`)
- System design → Generated code: traces to (evidence: `README.md`)
- Foundations v1–v2 → Expanded v4–v5: evolves into (evidence: `README.md`)
- Expanded v4–v5 → Full framework v6: extends to (evidence: `README.md`)
- Full framework v6 → Synchronous v9: trims into (evidence: `README.md`)
- Behaviors M2 → Objects M1: acts on (evidence: `README.md`)
- Behaviors M2 → Rules M3: uses rules (evidence: `README.md`)
- Behaviors M2 → Actors M5: subject to (evidence: `README.md`)
- Events ME → Behaviors M2: depends on (evidence: `README.md`)
- Events ME → Rules M3: depends on (evidence: `README.md`)
- Scenarios M4 → Objects M1: depends on (evidence: `README.md`)
- Scenarios M4 → Behaviors M2: depends on (evidence: `README.md`)
- Scenarios M4 → Rules M3: depends on (evidence: `README.md`)
- Scenarios M4 → Events ME: depends on (evidence: `README.md`)
- Processes M6 → Scenarios M4: depends on (evidence: `README.md`)
- Processes M6 → Actors M5: depends on (evidence: `README.md`)
- Queries M7 → Objects M1: queries (evidence: `README.md`)
- Queries M7 → Behaviors M2: binds query (evidence: `README.md`)
- UI MU → Processes M6: maps screens (evidence: `README.md`)
- Data mapping MM → Objects M1: maps objects (evidence: `README.md`)
- Data mapping MM → Queries M7: supports SQL (evidence: `README.md`)
- Interfaces MI → Behaviors M2: binds calls (evidence: `README.md`)
- Interfaces MI → Events ME: supports events (evidence: `README.md`)
- Interfaces MI → Actors M5: aligns contracts (evidence: `README.md`)
