Scenario tackling online disinformation create organization

domains/tackling-online-disinformation/README.md

@@ -0,0 +1,4 @@
+# Tackling Online Disinformation Domain
+
+## Overview
+The Tackling Online Disinformation domain is illustrated using the example of a multi-agent system where autonomous agents collaborate with each other to curate and label information on the Web towards tackling online disinformation. 

domains/tackling-online-disinformation/create-organization/README.md

@@ -0,0 +1,61 @@
+# Create an Organization
+
+## Description
+Alice has experience working as a journalist in a reputable news organization, the DPr Network. 
+Throughout her career, she has witnessed the growing problem of online disinformation and the negative impact it has on society. 
+Motivated to combat these issues on a broader scale, she decides to enact her own organization dedicated to tackling online disinformation, the TOD organization. 
+Inspired by her experience at the DPr Network, Alice intends to use the News Network organization model based on which the DPr Network organization has been enacted, as reference to organize the TOD organization.
+
+Alice is contained in the News Network workspace, a shared space for news network members, including members of the DPr Network. The workspace also contains a repository artifact that is used for storing and managing organization models. Alice interacts with the repository artifact to retrieve the News Network organization models. 
+
+To ensure the effectiveness of the upcoming TOD organization, she conducts a comparative analysis between the News Network organization model and and other similar organization models, as well as theoretical organization models proposed by experts in the field. She concludes that the News Network organization model provides a solid foundation for the enactment of the TOD organization.
+
+Any organization enacted based on the News Network organization model is characterized by the following properties:
+
++ The organization has the following organizational values:
+  + _Accountability_: Accompany information evaluations with details about who contributed to the tackling disinformation process, e.g. which agents evaluated the information. 
+  + _Transparency_: Accompany information evaluations with details about how one contributed to the tackling disinformation process, e.g. what external services were used to evaluate the information.
+
++ The organization provides the following roles with their responsibilities:
+  1. _Active user_: Evaluate online information or consume the aggregated evaluation of prior active users.
+  2. _Journalist_: Evaluate online information (a type of active user).
+  3. _General evaluator_: Annotate online information based on the general impression of the information (a type of journalist).
+  4. _General investigator_: Annotate online information based on the credibility rating of the information, publishers, authors etc. (a type of journalist).
+  5. _Media investigator_: Annotate online information based on the original sources of its images (a type of journalist).
+  7. _Admin_: Ensure the functionality of the system, e.g. by assigning missions to groups of agents.
+  8. _Aggregator_: Annotate online information based on aggregated evaluations to give a summarized overview of the evaluation results (a type of admin).
+  9. _Control_: Control the functionality of the system, e.g. by ensuring that community guidelines are met.
+
++ The organization proposes the following facility that members of the organization can use to achieve organizational goals:
+  + _News network annotating service_: Agents can interact with the facility to search for the original sources of images and annotate online information with the discovered sources.
+
+## Competency Questions
+
+| ID | Question in Natural Language | Example |
+|----|------------------------------|---------|
+| q1 | What are the available organization models that can be used to enact a new organization? | What are the available organization models that can be used by Alice to enact the TOD organization? `ex:NewsNetwork`, `ex:Manufacturing`    |
+| q2 | What are the elements composing a given organization model?  | What are the elements composing the News Network organization model? `ex:ActiveUser`, `ex:Journalist`, `ex:GeneralEvaluator`, `ex:GeneralInvestigator`, `ex:MediaInvestigator`, `ex:Admin`, `ex:Aggregator`, `ex:Control`, `ex:ContentEvaluationMission`, `ex:ArticleCredibilityMission`, `ex:MediaProvenanceMission`, `ex:SystemFunctionalityMission`, `ex:ControlMission`, `ex:NewsNetworkAnnotatingService`       |
+| q2 | What are the organizational values of an organization that is enacted based on a given organization model?  | What are the organizational values of an organization that is enacted based on the News Network organization model? `ex:Accountability`, `ex:Transparency`   |
+| q4 | What are the roles provided by an organization that is enacted based on a given organization model?  | What are the roles provided by an organization that is enacted based on the News Network organization model? `ex:ActiveUser`, `ex:Journalist`, `ex:GeneralEvaluator`, `ex:GeneralInvestigator`, `ex:MediaInvestigator`, `ex:Admin`, `ex:Aggregator`, `ex:Control` |
+| q5 | What are the missions proposed by an organization that is enacted based on a given organization model?     | What are the missions proposed by an organization that is enacted based on the News Network organization model? `ex:ContentEvaluationMission`, `ex:ArticleCredibilityMission`, `ex:ImageProvenanceMission`, `ex:SystemFunctionalityMission`, `ex:ControlMission`                                                   |
+| q6 | What are the facilities proposed by an organization that is enacted based on a given organization model?   | What are the facilities proposed by an organization that is enacted based on the News Network organization model? `ex:NewsNetworkAnnotatingService`                                     |
+
+## Glossary
+
+* **Organization Enactment**: [TBA]
+* **Organization Model**: see [Create an Organization](https://github.com/HyperAgents/ns.hyperagents.org/tree/master/domains/logistics/create-organization/README.md) scenario.
+* **Organizational Value**: see [Create an Organization](https://github.com/HyperAgents/ns.hyperagents.org/tree/master/domains/logistics/create-organization/README.md) scenario.
+* **Role**: see [Create an Organization](https://github.com/HyperAgents/ns.hyperagents.org/tree/master/domains/logistics/create-organization/README.md) scenario.
+* **Mission**: see [Create an Organization](https://github.com/HyperAgents/ns.hyperagents.org/tree/master/domains/logistics/create-organization/README.md) scenario.
+* **Facility**: see [Create an Organization](https://github.com/HyperAgents/ns.hyperagents.org/tree/master/domains/logistics/create-organization/README.md) scenario.
+* **Organization**: see [Discover Organizations, their Members and Materials in Hypermedia Environments](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/domains/manufacturing-environments/discover-organization/README.md) scenario.
+* **Agent**: see [Discovery of Workspaces, Agents, and Artifacts in Hypermedia Environments](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/domains/manufacturing-environments/discover-core/README.md) scenario.
+* **Artifact**: see [Discovery of Workspaces, Agents, and Artifacts in Hypermedia Environments](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/domains/manufacturing-environments/discover-core/README.md) scenario.
+* **Workspace**: see [Discovery of Workspaces, Agents, and Artifacts in Hypermedia Environments](https://github.com/HyperAgents/ns.hyperagents.org/blob/master/domains/manufacturing-environments/discover-core/README.md) scenario.
+
+## Recommendations
+
+In the hypermedia environment, agents can discover organization models in order to examine the modeling choices of existing organizations or create new organizations using the discovered organization models. This can be achieved through various methods, including:
+- Interacting with shared artifacts that offer the possibility to retrieve, store, and manage organization models. 
+- Interacting with artifacts that are materials of organizations themselves, and they offer the possibility to retrieve, store, and manage the organization models of their associated organizations.
+- Discovering organization models through the resource profiles of the organizations that are enacted based on these models. 

domains/tackling-online-disinformation/create-organization/dataset.ttl

@@ -0,0 +1,252 @@
+a@prefix ex: <http://example.org/> .
+@prefix hmas: <https://purl.org/hmas/> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix sh: <http://www.w3.org/ns/shacl#> .
+
+#################################################################
+#    Core Ontology
+#################################################################
+
+## Workspace
+ex:NewsNetworkWS a hmas:Workspace ;
+    hmas:contains ex:John, ex:Alice, ex:Bob, ex:Carol, ex:David, ex:Elton, ex:Walter, ex:AnnotatingService.
+
+## Agents
+ex:John a hmas:Agent ;
+    hmas:isContainedIn ex:NewsNetworkWS ;
+    hmas:isMemberOf ex:DPr_Network .
+ex:Alice a hmas:Agent ;
+    hmas:isContainedIn ex:NewsNetworkWS ;
+    hmas:isMemberOf ex:DPr_Network .
+ex:Bob a hmas:Agent ;
+    hmas:isContainedIn ex:NewsNetworkWS ;
+    hmas:isMemberOf ex:DPr_Network .
+ex:Carol a hmas:Agent ;
+    hmas:isContainedIn ex:NewsNetworkWS ;
+    hmas:isMemberOf ex:DPr_Network .
+ex:David a hmas:Agent ;
+    hmas:isContainedIn ex:NewsNetworkWS ;
+    hmas:isMemberOf ex:DPr_Network .
+ex:Elton a hmas:Agent ;
+    hmas:isContainedIn ex:NewsNetworkWS ;
+    hmas:isMemberOf ex:DPr_Network .
+ex:Walter a hmas:Agent ;
+    hmas:isContainedIn ex:NewsNetworkWS ;
+    hmas:isMemberOf ex:DPr_Network .
+
+## Artifacts
+ex:AnnotatingService a hmas:Artifact ;
+    hmas:isContainedIn ex:NewsNetworkWS ;
+    hmas:isMaterialOf ex:DPr_Network .
+
+#################################################################
+#    Regulation Ontology
+#################################################################
+
+# SPECIFICATION
+
+## NOTE: Regulation entities' specification can be represented
+##       using implicit or explicit Target Class SHACL. Here we
+##       decided to use implicit Target Class SHACL because we
+##       do not expect any extensions for this scenario and we
+##       wanted to avoid extra labels.
+
+## Organization Specification
+ex:NewsNetwork a sh:NodeShape ;
+    rdfs:subClassOf hmas:Organization ;
+    sh:property [
+        sh:path hmas:hasOrganizationalValue ;
+        sh:qualifiedValueShape [ sh:class ex:Accountability ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:hasOrganizationalValue ;
+        sh:qualifiedValueShape [ sh:class ex:Transparency ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:providesRole ;
+        sh:qualifiedValueShape [ sh:class ex:ActiveUser ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:providesRole ;
+        sh:qualifiedValueShape [ sh:class ex:Journalist ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:providesRole ;
+        sh:qualifiedValueShape [ sh:class ex:GeneralEvaluator ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:providesRole ;
+        sh:qualifiedValueShape [ sh:class ex:GeneralInvestigator ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:providesRole ;
+        sh:qualifiedValueShape [ sh:class ex:MediaInvestigator ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:providesRole ;
+        sh:qualifiedValueShape [ sh:class ex:Admin ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;        
+        ] ;
+    sh:property [
+        sh:path hmas:providesRole ;
+        sh:qualifiedValueShape [ sh:class ex:Aggregator ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;        
+        ] ;
+	sh:property [
+        sh:path hmas:providesRole ;
+        sh:qualifiedValueShape [ sh:class ex:Control ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;        
+        ] ;
+    sh:property [
+        sh:path hmas:proposesMission ;
+        sh:qualifiedValueShape [ sh:class ex:ContentEvaluationMission ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:proposesMission ;
+        sh:qualifiedValueShape [ sh:class ex:ArticleCredibilityMission ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:proposesMission ;
+        sh:qualifiedValueShape [ sh:class ex:ImageProvenanceMission ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:proposesMission ;
+        sh:qualifiedValueShape [ sh:class ex:SystemFunctionalityMission ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:proposesMission ;
+        sh:qualifiedValueShape [ sh:class ex:ControlMission ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] ;
+    sh:property [
+        sh:path hmas:proposesFacility ;
+        sh:qualifiedValueShape [ sh:class ex:NewsNetworkAnnotatingService ] ;
+        sh:qualifiedMinCount 1 ;
+        sh:qualifiedMaxCount 1 ;
+        ] .
+
+ex:Manufacturing a sh:NodeShape ;
+    rdfs:subClassOf hmas:Organization .
+
+## Organizational Values
+ex:Accountability a sh:NodeShape ;
+    rdfs:subClassOf hmas:OrganizationalValue ;
+    rdfs:comment "Accompany information evaluations with details about who contributed to the tackling disinformation process, e.g. which agents evaluated the information."@en ;
+    rdfs:label "accountability"@en, "responsabilité"@fr .
+
+ex:Transparency a sh:NodeShape ;
+    rdfs:subClassOf hmas:OrganizationalValue ;
+    rdfs:comment "Accompany information evaluations with details about how one contributed to the tackling disinformation process, e.g. what external services were used to evaluate the information."@en ;
+    rdfs:label "transparency"@en, "transparence"@fr .
+
+## Roles
+ex:ActiveUser a sh:NodeShape ;
+    rdfs:subClassOf hmas:Role .
+ex:Journalist a sh:NodeShape ;
+    rdfs:subClassOf hmas:ActiveUser .
+ex:GeneralEvaluator a sh:NodeShape ;
+    rdfs:subClassOf hmas:Journalist .
+ex:GeneralInvestigator a sh:NodeShape ;
+    rdfs:subClassOf hmas:Journalist .
+ex:MediaInvestigator a sh:NodeShape ;
+    rdfs:subClassOf hmas:Journalist .
+ex:Admin a sh:NodeShape ;
+    rdfs:subClassOf hmas:Role .
+ex:Agreegator a sh:NodeShape ;
+    rdfs:subClassOf hmas:Admin .
+ex:Control a sh:NodeShape ;
+    rdfs:subClassOf hmas:Role .
+
+## Missions
+ex:ContentEvaluationMission a sh:NodeShape ;
+    rdfs:subClassOf hmas:Mission .
+ex:ArticleCredibilityMission a sh:NodeShape ;
+    rdfs:subClassOf hmas:Mission .
+ex:ImageProvenanceMission a sh:NodeShape ;
+    rdfs:subClassOf hmas:Mission .
+ex:SystemFunctionalityMission a sh:NodeShape ;
+    rdfs:subClassOf hmas:Mission .
+ex:ControlMission a sh:NodeShape ;
+    rdfs:subClassOf hmas:Mission .
+
+## Facilities
+ex:NewsNetworkAnnotatingService a sh:NodeShape ;
+    rdfs:subClassOf hmas:Facility .
+
+# INSTANTIATION
+
+## Organizational Values
+ex:DPr_Accountability a ex:Accountability .
+ex:DPr_Transparency a ex:Transparency .
+
+## Roles
+ex:DPr_ActiveUser a ex:ActiveUser .
+ex:DPr_Journalist a ex:Journalist .
+ex:DPr_GeneralEvaluator a ex:GeneralEvaluator .
+ex:DPr_GeneralInvestigator a ex:GeneralInvestigator .
+ex:DPr_MediaInvestigator a ex:MediaInvestigator .
+ex:DPr_Admin a ex:Admin .
+ex:DPr_Aggregator a ex:Aggregator .
+ex:DPr_Control a ex:Control .
+
+## Missions
+ex:DPr_ContentEvaluationMission a ex:ContentEvaluationMission .
+ex:DPr_ArticleCredibilityMission a ex:ArticleCredibilityMission .
+ex:DPr_ImageProvenanceMission a ex:ImageProvenanceMission .
+ex:DPr_SystemFunctionalityMission a ex:SystemFunctionalityMission .
+ex:DPr_ControlMission a ex:ControlMission .
+
+## Facility
+ex:DPr_NewsNetworkAnnotatingService a ex:NewsNetworkAnnotatingService.
+
+## Organizations
+ex:DPr_NetworkProfile a hmas:ResourceProfile; 
+    hmas:isProfileOf DPr_Network.
+
+ex:DPr_Network a ex:NewsNetwork ;
+    hmas:hasProfile ex:DPr_NetworkProfile ;
+    hmas:hasOrganizationalValue ex:DPr_Accountability, ex:DPr_Transparency ;
+    hmas:providesRole ex:DPr_ActiveUser, ex:DPr_Journalist, ex:DPr_GeneralEvaluator, ex:DPr_GeneralInvestigator, ex:DPr_MediaInvestigator, ex:DPr_Admin, ex:DPr_Aggregator, ex:DPr_Contol;
+    hmas:proposesMission ex:DPr_ContentEvaluationMission, ex:DPr_ArticleCredibilityMission, ex:DPr_ImageProvenanceMission, ex:DPr_SystemFunctionalityMission, ex:DPr_ControlMission ;
+    hmas:proposesFacility DPr_NewsNetworkAnnotatingService .
+
+ex:GG_NetworkProfile a hmas:ResourceProfile .
+
+ex:GG_Network a ex:NewsNetwork ;
+    hmas:hasProfile ex:GG_NetworkProfile .
+
+ex:HSG_FactoryProfile a hmas:ResourceProfile .
+
+ex:HSG_Factory a ex:Manufacturing ;
+    hmas:hasProfile ex:HSG_FactoryProfile .
+
+ex:ITM_FactoryProfile a hmas:ResourceProfile .
+
+ex:ITM_Factory a ex:Manufacturing ;
+    hmas:hasProfile ex:ITM_FactoryProfile .