Add documentation for self-referencing relationships and include related image

Author: dandrejvv

Modules/Intent.Modules.EntityFrameworkCore/Intent.EntityFrameworkCore.imodspec

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <package>
   <id>Intent.EntityFrameworkCore</id>
-  <version>5.0.32-pre.2</version>
+  <version>5.0.32-pre.3</version>
   <supportedClientVersions>[4.5.0-a, 5.0.0-a)</supportedClientVersions>
   <summary>Provides the Entity Framework Core, Object Relational Mapper framework</summary>
   <description>Provides the Entity Framework Core, Object Relational Mapper framework</description>

Modules/Intent.Modules.EntityFrameworkCore/Intent.Metadata/Module Builder/Intent.EntityFrameworkCore/Elements/Module Documentation/f9e7d2cd-0a4f-413d-8917-d4f64eac580a.xml

@@ -113,7 +113,7 @@
             <property name="207e8583-2ba5-4ea3-84aa-2f65cd5915ca" display="Href" value="https://docs.intentarchitect.com/articles/modules-dotnet/intent-entityframeworkcore/intent-entityframeworkcore.html#many-to-many-relationship-modeling" isActive="true" />
             <property name="21d13790-2910-475c-b58f-9d350f2e13c6" display="Designers" value="[&quot;6ab29b31-27af-4f56-a67c-986d82097d63&quot;]" isActive="true" />
             <property name="8642b1d1-93f9-4f5f-b5ae-ad5fc20d7a46" display="Elements" value="[]" isActive="true" />
-            <property name="f55a1f0c-40dd-48b4-b985-8360933e6a47" display="Tags" value="ef entityframework relationship association many manytomany" isActive="true" />
+            <property name="f55a1f0c-40dd-48b4-b985-8360933e6a47" display="Tags" value="ef entityframework relationship association many manytomany join bridge" isActive="true" />
           </properties>
         </stereotype>
       </stereotypes>
@@ -147,5 +147,32 @@
       <metadata />
       <childElements />
     </childElement>
+    <childElement id="ff069e64-ed21-41b9-9171-8396c3ed1306" type="Documentation Topic" typeId="5cc56ebc-6b61-41a6-a452-8efd9382da6f">
+      <name>Self-Referencing Relationships</name>
+      <display>Self-Referencing Relationships</display>
+      <isAbstract>false</isAbstract>
+      <genericTypes />
+      <isMapped>false</isMapped>
+      <parentFolderId>f9e7d2cd-0a4f-413d-8917-d4f64eac580a</parentFolderId>
+      <packageId>a9d2a398-04e4-4300-9fbb-768568c65f9e</packageId>
+      <packageName>Intent.EntityFrameworkCore</packageName>
+      <stereotypes>
+        <stereotype stereotypeDefinitionId="83dfd8ae-5086-4e41-94c2-7110d5a49b4c" name="Settings">
+          <addedByDefault>true</addedByDefault>
+          <definitionPackageName>Intent.ModuleBuilder</definitionPackageName>
+          <definitionPackageId>9972b2a9-b749-4bba-b5c8-824bf694c6ef</definitionPackageId>
+          <properties>
+            <property name="2792ad9a-2afd-4350-bac6-bdcf4b701ff1" display="Description" value="How to modeling a self-referencing relationship." isActive="true" />
+            <property name="4fa553d3-1b96-4f63-bdb9-3237eca31f6b" display="Icon" value="{&quot;type&quot;:0,&quot;source&quot;:&quot;data:image/png;base64,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&quot;}" isActive="true" />
+            <property name="207e8583-2ba5-4ea3-84aa-2f65cd5915ca" display="Href" value="https://docs.intentarchitect.com/articles/modules-dotnet/intent-entityframeworkcore/intent-entityframeworkcore.html#self-referencing-relationships" isActive="true" />
+            <property name="21d13790-2910-475c-b58f-9d350f2e13c6" display="Designers" value="[&quot;6ab29b31-27af-4f56-a67c-986d82097d63&quot;]" isActive="true" />
+            <property name="8642b1d1-93f9-4f5f-b5ae-ad5fc20d7a46" display="Elements" value="[]" isActive="true" />
+            <property name="f55a1f0c-40dd-48b4-b985-8360933e6a47" display="Tags" value="ef entityframework relationship association many self reference" isActive="true" />
+          </properties>
+        </stereotype>
+      </stereotypes>
+      <metadata />
+      <childElements />
+    </childElement>
   </childElements>
 </class>

Modules/Intent.Modules.EntityFrameworkCore/Intent.Metadata/Module Builder/Intent.EntityFrameworkCore/Intent.EntityFrameworkCore.pkg.config

@@ -36,7 +36,7 @@
       <definitionPackageName>Intent.ModuleBuilder</definitionPackageName>
       <definitionPackageId>9972b2a9-b749-4bba-b5c8-824bf694c6ef</definitionPackageId>
       <properties>
-        <property name="4bb9695b-6004-46e1-acea-c48c60c5f8ce" display="Version" value="5.0.32-pre.0" isActive="true" />
+        <property name="4bb9695b-6004-46e1-acea-c48c60c5f8ce" display="Version" value="5.0.32-pre.3" isActive="true" />
         <property name="177a2415-e749-46e7-8257-440e19ecfb5e" display="API Namespace" isActive="true" />
         <property name="0d2ae582-090e-42d6-a7d6-689144433254" display="NuGet Package Id" isActive="true" />
         <property name="27cf6544-a9a2-4992-9fef-51d0ed49e66e" display="NuGet Package Version" value="" isActive="true" />

Modules/Intent.Modules.EntityFrameworkCore/Intent.Modules.EntityFrameworkCore.application.deviations.log.xml

@@ -12,7 +12,7 @@
       <approvedByDisplayName>Joel Turner</approvedByDisplayName>
       <approvedAt>2024-08-20T12:20:32.9304346Z</approvedAt>
       <deviationsHash>39EE393C508E9C7968649C7A3F882D996EDD9A91F7CD1434E12117323525C767</deviationsHash>
-      <fileHash>BBBAEE749B5C01EEB912E4968BCC1F78155632645527CACC0257299D0B1DE9F2</fileHash>
+      <fileHash>AB918E8B2D4E8151C18E5CC135B3D45AD9F7257D54CD4CBF495CDCEF3CBC04A3</fileHash>
     </file>
     <file>
       <correlationId>Intent.ModuleBuilder.TemplateRegistration.FilePerModel#96f7b6e6-79da-4f5e-b095-3d603777968b</correlationId>
@@ -51,7 +51,7 @@
       <approvedByDisplayName>Joel Turner</approvedByDisplayName>
       <approvedAt>2024-08-20T12:20:32.9394616Z</approvedAt>
       <deviationsHash>67712BBD9D92F06392D23CA6C17AC8ED892D2D68519E998F62B6442BF57A4B39</deviationsHash>
-      <fileHash>59C8AAEFDAEE3F4B10A4DE06CD2886710F73BCBF93ACA92C7B00FB54B158A049</fileHash>
+      <fileHash>735EC8EF3317AED2CD8856EF79C0C50E19A257920D9A9C42D5218400790AED9A</fileHash>
     </file>
     <file>
       <correlationId>Intent.ModuleBuilder.TemplateRegistration.FilePerModel#aba7dad6-c66b-4476-9470-0ab8786b5b4d</correlationId>

Modules/Intent.Modules.EntityFrameworkCore/docs/README.md

@@ -191,6 +191,19 @@ When using an implicit many-to-many relationship, you can still customize the ge
 
 > For more information on configuring the join table using the `Join Table` stereotype, refer to the [Intent.Metadata.RDBMS module documentation](https://docs.intentarchitect.com/articles/modules-common/intent-metadata-rdbms/intent-metadata-rdbms.html#create-join-table-constraint).
 
+### Self-Referencing Relationships
+
+When modeling parent-child hierarchies, you may need to create a self-referencing association where an entity has a relationship to itself. This is common for organizational structures, category hierarchies, file systems, and similar scenarios.
+
+![Self reference association](images/many-to-one-self-reference.png)
+
+When creating a self-referencing relationship in Intent Architect, it is important to use an **Aggregational relationship** (indicated by a white diamond) rather than a Compositional relationship (black diamond). 
+
+- **Many-to-One self-reference**: Create a `New Association → Many to One` relationship from the entity to itself.
+- **Optional self-reference**: Create a `New Association → Many to Zero-or-One` relationship if the relationship is optional.
+
+
+
 ### Modeling Inheritance
 
 In Entity Framework Core there are 3 ways to model inheritance, namely:

Modules/Intent.Modules.EntityFrameworkCore/docs/images/many-to-one-self-reference.png

@@ -2,6 +2,7 @@
 
 - Improvement: Added support for singular DBSet names
 - Improvement: Updated NuGet package versions.
+- Improvement: Doc on self-referencing.
 
 ### Version 5.0.31