Merge pull request #431 from open-contracting/415_climate_objectives

add environment.goals and environmentalGoal.csv
open-contracting · Nov 21, 2023 · 60b9fd0 · 60b9fd0
2 parents 51e9c4f + c763a4b
commit 60b9fd0
Show file tree

Hide file tree

Showing 9 changed files with 55 additions and 6 deletions.
diff --git a/docs/_static/i18n.csv b/docs/_static/i18n.csv
@@ -405,3 +405,5 @@ completion/finalValueDetails,Final value details,True,
 completion/finalScope,Final scope,True,
 completion/finalScopeDetails,Final scope details,True,
 language,Language,True,
+environment,Environment,False,
+environment/goals,Environmental goals,False,
diff --git a/docs/cost/ids/sustainability.md b/docs/cost/ids/sustainability.md
@@ -837,12 +837,12 @@ Eg:
 :columns: 8
 OC4IDS mapping
 ^^^
-Project level: Add the relevant code from the climateChangeGoal codelist to the `environment.climateChangeGoal` array
+Project level: Add the relevant code from the environmentalGoal codelist to the `environment.goals` array
 ```json
 {
   "environment": {
-    "climateChangeGoals": [
-      "mitigation"
+    "goals": [
+      "climateChangeMitigation"
     ]
   }
 }

diff --git a/docs/examples/blank.json b/docs/examples/blank.json
@@ -439,5 +439,10 @@
     "finalValueDetails": "",
     "finalScope": "",
     "finalScopeDetails": ""
+  },
+  "environment": {
+    "goals": [
+      "string"
+    ]
   }
 }
diff --git a/docs/examples/example.json b/docs/examples/example.json
@@ -982,6 +982,11 @@
         "finalValueDetails": "Budget increase due to construction delay.",
         "finalScope": "Upgrade of Junctions 4 and 5 and repairs to the watercourse at Junction 5.",
         "finalScopeDetails": "Scope was expanded to include repairs to a watercourse damaged during construction excavation."
+      },
+      "environment": {
+        "goals": [
+          "climateChangeMitigation"
+        ]
       }
     }
   ]

diff --git a/docs/reference/changelog.md b/docs/reference/changelog.md
@@ -28,12 +28,14 @@
   * `.transactions`
   * `.milestones`
   * `ContractingProcesses.milestones`
+* [#431](https://github.com/open-contracting/infrastructure/pull/431) - add `environment.goals`.
 * [#427](https://github.com/open-contracting/infrastructure/pull/427) - add `Organization.beneficialOwners`
 
 ### Codelists
 
 * [#355](https://github.com/open-contracting/infrastructure/pull/355) - use correct normative and non-normative keywords codelist descriptions.
 * [#377](https://github.com/open-contracting/infrastructure/pull/377) - clarify business logic in contractingProcessStatus codelist.
+* [#431](https://github.com/open-contracting/infrastructure/pull/431) - add environmentalGoal codelist.
 * add codelists:
   * [#369](https://github.com/open-contracting/infrastructure/pull/369) - classificationScheme
   * [#427](https://github.com/open-contracting/infrastructure/pull/427) - country

diff --git a/docs/reference/codelists.md b/docs/reference/codelists.md
@@ -67,6 +67,13 @@ Projects with a `status` of 'completed' may be displayed in a list of archived p
 :file: ../../build/current_lang/codelists/milestoneType.csv
 ```
 
+### EnvironmentalGoal
+
+```{csv-table-no-translate}
+:header-rows: 1
+:file: ../../build/current_lang/codelists/environmentalGoal.csv
+```
+
 ### country
 
 ```{csv-table-no-translate}

diff --git a/mapping/sustainability.yaml b/mapping/sustainability.yaml
@@ -486,12 +486,12 @@
         - mitigation
         - adaptation
         - cross-cutting
-    mapping: 'Project level: Add the relevant code from the climateChangeGoal codelist to the `environment.climateChangeGoal` array'
+    mapping: 'Project level: Add the relevant codes from the environmentalGoal codelist to the `environment.goals` array'
     example: |-
         {
           "environment": {
-            "climateChangeGoals": [
-              "mitigation"
+            "goals": [
+              "climateChangeMitigation"
             ]
           }
         }

diff --git a/schema/project-level/codelists/environmentalGoal.csv b/schema/project-level/codelists/environmentalGoal.csv
@@ -0,0 +1,3 @@
+Code,Title,Description,Source
+climateChangeAdaptation,Climate change adaptation,"Adjustment to actual or expected climate and its effects, in order to moderate harm or exploit beneficial opportunities.",OC4IDS
+climateChangeMitigation,Climate change mitigation,Reduction of emissions or enhancement of the sinks of greenhouse gases.,OC4IDS
diff --git a/schema/project-level/project-schema.json b/schema/project-level/project-schema.json
@@ -296,6 +296,31 @@
       ],
       "default": "en",
       "minLength": 1
+    },
+    "environment": {
+      "title": "Environment",
+      "description": "Information about the environmental and climate impacts of the project and the actions the project will take to mitigate potentially negative impacts on adjacent populations and habitats.",
+      "type": "object",
+      "properties": {
+        "goals": {
+          "title": "Environmental goals",
+          "description": "The environmental goals pursued, using the closed [environmentalGoal](https://standard.open-contracting.org/infrastructure/{{version}}/{{lang}}/reference/codelists/#environmentalgoal) codelist.",
+          "type": [
+            "array"
+          ],
+          "items": {
+            "type": "string",
+            "enum": [
+              "climateChangeAdaptation",
+              "climateChangeMitigation"
+            ]
+          },
+          "codelist": "environmentalGoal.csv",
+          "openCodelist": false,
+          "minItems": 1
+        }
+      },
+      "minProperties": 1
     }
   },
   "definitions": {