docs: add documentation to add policies and attributes

* adjust documentation structure to align with TRG1
* add documentation to add policies and policy attributes

Refs: #178 #197

.github/pull_request_template.md

@@ -14,7 +14,7 @@ Link to Github issue.
 
 Please delete options that are not relevant.
 
-- [ ] I have followed the [contributing guidelines](https://github.com/eclipse-tractusx/policy-hub/blob/main/docs/technical-documentation/dev-process/How%20to%20contribute.md)
+- [ ] I have followed the [contributing guidelines](https://github.com/eclipse-tractusx/policy-hub/blob/main/docs/admin/dev-process/How%20to%20contribute.md)
 - [ ] I have performed [IP checks](https://eclipse-tractusx.github.io/docs/release/trg-7/trg-7-04#checking-libraries-using-the-eclipse-dash-license-tool) for added or updated 3rd party libraries
 - [ ] I have created and linked IP issues or requested their creation by a committer
 - [ ] I have performed a self-review of my own code

README.md

@@ -2,7 +2,7 @@
 
 This repository contains the backend code for the Policy-Hub written in C#.
 
-For **information about the policy hub**, please refer to the documentation, especially the context and scope section in the [architecture documentation](./docs/technical-documentation/architecture).
+For **information about the policy hub**, please refer to the documentation, especially the context and scope section in the [architecture documentation](./docs/architecture).
 
 For **installation** details, please refer to the [README.md](./charts/policy-hub/README.md) of the provided helm chart.
 
@@ -25,7 +25,7 @@ dotnet run
 
 ## Known Issues and Limitations
 
-See [Known Knowns](/docs/technical-documentation/known-knowns/known-issues-and-limitations.md).
+See [Known Knowns](/docs/known-knowns/known-issues-and-limitations.md).
 
 ## Notice for Docker image
 

charts/policy-hub/README.md

@@ -2,7 +2,7 @@
 
 This helm chart installs the Catena-X Policy Hub application.
 
-For further information please refer to [Technical Documentation](../../docs/technical-documentation/).
+For further information please refer to [Technical Documentation](../../docs/admin/).
 
 The referenced container images are for demonstration purposes only.
 

charts/policy-hub/README.md.gotmpl

@@ -2,7 +2,7 @@
 
 This helm chart installs the Catena-X Policy Hub application.
 
-For further information please refer to [Technical Documentation](../../docs/technical-documentation/).
+For further information please refer to [Technical Documentation](../../docs/admin/).
 
 The referenced container images are for demonstration purposes only.
 

docs/admin/add-data-process/index.md

@@ -0,0 +1,142 @@
+# Summary
+
+The following documentation gives an overview of how to add additional data to the Policy Hub.
+
+## Adding new Policies
+
+To add new policies the following steps must be executed:
+
+### Add Policy
+
+To add new Attributes you need to add an entry to the [policies](/src/database/PolicyHub.Migrations/Seeder/Data/policies.json) Seeding file.
+
+The entry should look like the following:
+
+```json
+  {
+    "id": "uuid for the policy, this is needed in the process later on",
+    "kind_id": "one of the policy kinds mentioned below (as number)",
+    "technical_key": "the technical key which is used to query it later in the process",
+    "description": "a description of the policy",
+    "is_active": "either true if the attribute should be active or false if the attribute shouldn't be active",
+    "attribute_key_id": "one of the attribute keys mentioned below (as number)",
+  },
+```
+
+**PolicyKindId**
+
+```c#
+public enum PolicyKindId
+{
+    BusinessPartnerNumber = 1,
+    Membership = 2,
+    Framework = 3,
+    Purpose = 4,
+    Dismantler = 5,
+    ContractReference = 6
+}
+```
+
+**Attribute Keys**
+
+```c#
+public enum AttributeKeyId
+{
+    Regex = 1,
+    Static = 2,
+    DynamicValue = 3,
+    Brands = 4,
+    Version = 5
+}
+```
+
+### Assign policy to type
+
+The created policy must be assigned to at least one policy type. To assign the policy to a type you need to add an entry to the [policy_assigned_types](/src/database/PolicyHub.Migrations/Seeder/Data/policy_assigned_types.json) Seeding file.
+
+The entry should look like the following:
+
+```json
+{
+  "policy_id": "value of the id column of the newly added policy",
+  "policy_type_id": "one of the policy type ids mentioned below (as number)",
+  "is_active": "either true if the attribute should be active or false if the attribute shouldn't be active"
+}
+```
+
+**PolicyTypeId**
+
+```c#
+public enum PolicyTypeId
+{
+    Access = 1,
+    Usage = 2
+}
+```
+
+### Assign policy to use case
+
+The created policy must be assigned to at least one use case. To assign the policy to a use case you need to add an entry to the [policy_assigned_use_cases](/src/database/PolicyHub.Migrations/Seeder/Data/policy_assigned_use_cases.json) Seeding file.
+
+The entry should look like the following:
+
+```json
+{
+  "policy_id": "value of the id column of the newly added policy",
+  "use_case_id": "one of the use case ids mentioned below (as number)",
+  "is_active": "either true if the attribute should be active or false if the attribute shouldn't be active"
+}
+```
+
+**UseCaseId**
+
+```c#
+public enum UseCaseId
+{
+    Traceability = 1,
+    Quality = 2,
+    PCF = 3,
+    Behavioraltwin = 4,
+    Businesspartner = 5,
+    CircularEconomy = 6,
+    DemandCapacity = 7
+}
+```
+
+## Adding new Attributes
+
+To add new Attributes you need to add an entry to the [policy_attributes](/src/database/PolicyHub.Migrations/Seeder/Data/policy_attributes.json) Seeding file.
+
+The entry should look like the following:
+
+```json
+{
+  "id": "uuid",
+  "policy_id": "id of an policy you want to link the attribute to",
+  "key": "one of the attribute keys mentioned above (as number)",
+  "attribute_value": "the specific value of the attribute you want to set",
+  "is_active": "either true if the attribute should be active or false if the attribute shouldn't be active"
+}
+```
+
+Depending on the attribute key which is set the output will slightly change. A regex Attribute will check the set value of a policy if it matches the regex. A dynamic value will take the user input of the value field. If non is set by the user `{dynamicValue}` is taken. For `Static`, `Brands` and `Version` Attributes the value will just render the content of the `attribute_value` column.
+
+To make a Attribute available it must be set to `is_active` = `true` and a link to a use case must be added. For that a new entry in the [policy_attribute_assigned_use_cases](/src/database/PolicyHub.Migrations/Seeder/Data/policy_attribute_assigned_use_cases.json) must be added. The entry should look like the following:
+
+```json
+{
+  "attribute_id": "value of the id column of the newly added policy_attribute",
+  "use_case_id": "one of the use case ids mentioned above (as number)",
+  "is_active": "either true if the attribute should be active or false if the attribute shouldn't be active"
+}
+```
+
+It is possible to link an attribute to multiple UseCases.
+
+## NOTICE
+
+This work is licensed under the [Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0).
+
+- SPDX-License-Identifier: Apache-2.0
+- SPDX-FileCopyrightText: 2024 Contributors to the Eclipse Foundation
+- Source URL: https://github.com/eclipse-tractusx/policy-hub

docs/technical-documentation/release-process/Release Process.md → docs/admin/release-process/Release Process.md

@@ -33,7 +33,7 @@ Be aware that migrations coming release branches for release candidates or from
 
 The version needs to be updated in the `src` directory within the 'Directory.Build.props' file.
 
-Also, bump the chart and app version in the [Chart.yaml](../../../charts/policy-hub/Chart.yaml) and the version of the images in the [values.yaml](../../../charts/policy-hub/values.yaml).
+Also, bump the chart and app version in the [Chart.yaml](../../../charts/policy-hub/Chart.yaml) and the version of the images in the [values.yaml](../../../charts/charts/policy-hub/values.yaml).
 
 _Consortia relevant:  Update the version of the targetRevision tag in the [argocd-app-templates](../../../consortia/argocd-app-templates/), used for consortia-environments._
 

docs/technical-documentation/requests/example-requests.md → docs/api/requests/example-requests.md

@@ -217,7 +217,7 @@ Multiple constrains example:
 
 ```
 
-If you want to try it out, check the [postman collection](/docs/developer/Technical-Documentation/requests/policy-hub.postman_collection.json)
+If you want to try it out, check the [postman collection](./policy-hub.postman_collection.json)
 
 ## NOTICE
 

docs/technical-documentation/architecture/Development Concept.md → docs/architecture/Development Concept.md

@@ -2,7 +2,7 @@
 
 ## Build, test, deploy
 
-Details to the build, test and deploy process can get found under the following md file: [Release Process](/docs/technical-documentation/release-process/Release%20Process.md)
+Details to the build, test and deploy process can get found under the following md file: [Release Process](/docs/admin/release-process/Release%20Process.md)
 
 ## Development Guidelines