🍱 Add ER Diagram

This changes adds automatic overall ER Diagram generation to the project. It should work seamlessly for local and github deployments. It's possible there could be a naming conflict with other generated text, eg, if there was a slot called "erdiagram".

Author: RobertJCarroll

docs/schema/include_access_model.yaml

@@ -1754,5 +1754,5 @@ metamodel_version: 1.7.0
 source_file: include_access_model.yaml
 source_file_date: '2025-11-12T10:52:41'
 source_file_size: 24481
-generation_date: '2025-11-12T18:16:29'
+generation_date: '2025-11-12T18:29:57'
 

justfile

@@ -94,9 +94,14 @@ lint:
 
 # Generate md documentation for the schema
 [group('model development')]
-gen-doc: _gen-yaml
+gen-doc: _gen-yaml _gen-erd
   uv run gen-doc {{gen_doc_args}} -d {{docdir}} {{source_schema_path}}
 
+# Generate erd for the overall schema and add it to the docs
+[group('model development')]
+_gen-erd:
+  uv run gen-erdiagram {{source_schema_path}} > {{docdir}}/erdiagram.md
+
 # Build docs and run test server
 [group('model development')]
 testdoc: gen-doc _serve

mkdocs.yml

@@ -25,8 +25,9 @@ watch:
   - src/include_access_model/schema
 
 nav:
-  - Home: index.md
+#  - Home: index.md
   - Schema: elements/index.md
+  - ER Diagram: elements/erdiagram.md
   - About: about.md
 
 exclude_docs: |

src/include_access_model/datamodel/include_access_model.py

@@ -1,5 +1,5 @@
 # Auto generated from include_access_model.yaml by pythongen.py version: 0.0.1
-# Generation date: 2025-11-12T18:15:09
+# Generation date: 2025-11-12T18:36:02
 # Schema: include-access-model
 #
 # id: https://includedcc.org/include-access-model