add .summary.social and laborObligations codelist

open-contracting · Nov 16, 2023 · 6ebe566 · 6ebe566
1 parent 51e9c4f
commit 6ebe566
Show file tree

Hide file tree

Showing 8 changed files with 141 additions and 6 deletions.
diff --git a/docs/_static/i18n.csv b/docs/_static/i18n.csv
@@ -329,6 +329,15 @@ contractingProcesses/summary/milestones/dueDate,Due date,False,
 contractingProcesses/summary/milestones/dateMet,Date met,False,
 contractingProcesses/summary/milestones/dateModified,Date modified,False,
 contractingProcesses/summary/milestones/status,Status,False,
+contractingProcesses/summary/social,Social,False,
+contractingProcesses/summary/social/laborBudget,Labor budget,False,
+contractingProcesses/summary/social/laborBudget,Value,False,
+contractingProcesses/summary/social/laborBudget/amount,Amount,False,
+contractingProcesses/summary/social/laborBudget/currency,Currency,False,
+contractingProcesses/summary/social/laborObligations,Labor obligations,False,
+contractingProcesses/summary/social/laborObligations,Labor obligations,False,
+contractingProcesses/summary/social/laborObligations/obligations,Obligations,False,
+contractingProcesses/summary/social/laborObligations/description,Description,True,
 contractingProcesses/releases,Linked releases,False,
 contractingProcesses/releases,Release,False,
 contractingProcesses/releases/id,ID,True,

diff --git a/docs/cost/ids/sustainability.md b/docs/cost/ids/sustainability.md
@@ -2265,7 +2265,7 @@ Publish the signed contract that includes labor obligations:  Add a document to
           "laborObligations": {
             "obligations": [
               "minimumWage",
-              "overtime"
+              "paidOvertime"
             ],
             "description": "The contract's labor obligations include a minimum wage of $20 per hour and an overtime limit of 10 hours per week."
           }
@@ -2307,7 +2307,7 @@ Disclose the amount allocated by the main contractor to cover for labour costs (
 :columns: 8
 OC4IDS mapping
 ^^^
-Contract level: Publish the amount and currency of the labor budget in `.summary.social.laborBudget`.
+Contracting process level: Publish the amount and currency of the labor budget in `.summary.social.laborBudget`.
 ```json
 {
   "contractingProcesses": [

diff --git a/docs/examples/blank.json b/docs/examples/blank.json
@@ -349,7 +349,19 @@
               "title": "title"
             }
           }
-        ]
+        ],
+        "social": {
+          "laborBudget": {
+            "amount": "number",
+            "currency": "string from currency codelist"
+          },
+          "laborObligations": {
+            "obligations": [
+              "string from laborObligations codelist"
+            ],
+            "description": "string"
+          }
+        }
       },
       "releases": [
         {

diff --git a/docs/examples/example.json b/docs/examples/example.json
@@ -684,7 +684,19 @@
                   "currency": "GBP"
                 }
               }
-            ]
+            ],
+            "social": {
+              "laborBudget": {
+                "amount": "150000",
+                "currency": "USD"
+              },
+              "laborObligations": {
+                "obligations": [
+                  "minimumWage"
+                ],
+                "description": "The local minimum wage will be paid to all contracted workers."
+              }
+            }
           },
           "releases": [
             {

diff --git a/docs/reference/schema.md b/docs/reference/schema.md
@@ -362,6 +362,7 @@ This sub-schema is referenced by the following properties:
 * [`ContractingProcessSummary/tender/costEstimate`](project-schema.json,/definitions/ContractingProcessSummary,tender/costEstimate)
 * [`ContractingProcessSummary/contractValue`](project-schema.json,/definitions/ContractingProcessSummary,contractValue)
 * [`ContractingProcessSummary/finalValue`](project-schema.json,/definitions/ContractingProcessSummary,finalValue)
+* [`ContractingProcessSummary/social/laborBudget`](project-schema.json,/definitions/ContractingProcessSummary,social/laborBudget)
 * [`Modification/oldContractValue`](project-schema.json,/definitions/Modification,oldContractValue)
 * [`Modification/newContractValue`](project-schema.json,/definitions/Modification,newContractValue)
 * [`BudgetBreakdown/amount`](project-schema.json,/definitions/BudgetBreakdown,amount)
@@ -424,6 +425,11 @@ Each `Value` has the following fields:
 :title: contractingProcesses/0/summary/transactions/0/value
 ```
 
+```{jsoninclude} ../../docs/examples/example.json
+:jsonpointer: /projects/0/contractingProcesses/0/summary/social/laborBudget
+:title: contractingProcesses/0/summary/social/laborBudget
+```
+
 ```{jsoninclude} ../../docs/examples/example.json
 :jsonpointer: /projects/0/transactions/0/value
 :title: transactions/0/value
@@ -1079,3 +1085,38 @@ Each `MilestoneReference` has the following fields:
 ````
 
 `````
+
+### LaborObligations
+
+`LaborObligations` is defined as:
+
+```{field-description} ../../build/current_lang/project-schema.json /definitions/LaborObligations
+```
+
+This sub-schema is referenced by the following properties:
+* [`ContractingProcessSummary/social/laborObligations`](project-schema.json,/definitions/ContractingProcessSummary,social/laborObligations)
+
+Each `LaborObligations` has the following fields:
+
+`````{tab-set}
+
+````{tab-item} Schema
+
+```{jsonschema} ../../build/current_lang/project-schema.json
+:pointer: /definitions/LaborObligations
+:collapse: obligations,description
+:addtargets:
+```
+
+````
+
+````{tab-item} Examples
+
+```{jsoninclude} ../../docs/examples/example.json
+:jsonpointer: /projects/0/contractingProcesses/0/summary/social/laborObligations
+:title: contractingProcesses/0/summary/social/laborObligations
+```
+
+````
+
+`````
diff --git a/mapping/sustainability.yaml b/mapping/sustainability.yaml
@@ -1309,7 +1309,7 @@
                   "laborObligations": {
                     "obligations": [
                       "minimumWage",
-                      "overtime"
+                      "paidOvertime"
                     ],
                     "description": "The contract's labor obligations include a minimum wage of $20 per hour and an overtime limit of 10 hours per week."
                   }
@@ -1335,7 +1335,7 @@
     module: Social
     indicator: Labour compliance
     disclosure format: Disclose the amount allocated by the main contractor to cover for labour costs (E.g. \[value\]).
-    mapping: 'Contract level: Publish the amount and currency of the labor budget in `.summary.social.laborBudget`.'
+    mapping: 'Contracting process level: Publish the amount and currency of the labor budget in `.summary.social.laborBudget`.'
     example: |-
         {
           "contractingProcesses": [

diff --git a/schema/project-level/codelists/laborObligations.csv b/schema/project-level/codelists/laborObligations.csv
@@ -0,0 +1,16 @@
+Code,Title,Description,Source
+minimumWage,Minimum wage,"A minimum wage that an employer needs to pay their labor force for work performed, which cannot be reduced by collective or individual agreements or contracts.",OC4IDS
+paidOvertime,Paid overtime,Agreement that hours worked in addition to regular working hours need to be paid at an specified level.,OC4IDS
+weeklyRestProtection,Weekly rest protection,Regular working hours and voluntary overtime are both capped to protect a minimum level of weekly rest.,OC4IDS
+forcedLaborProhibition,Prohibition of forced labor,The project needs to comply with all applicable national and international laws regarding forced or compulsory labor and not resort to any form of forced labor.,OC4IDS
+childLaborProhibition,Prohibition of child labor,The project needs to comply with all applicable national and international laws regarding employment of minors and not resort to any form of child labor.,OC4IDS
+equalOpportunities,Equal opportunities,Employment opportunities need to not be based on personal characteristics unrelated to job requirements.,OC4IDS
+nondiscrimination,Non-discrimination,"The project needs to not discriminate against any employees with respect to any aspects of employment, such as hiring, wages, access to training, job assignment, promotion, or termination of employment.",OC4IDS
+grievanceMechanism,Grievance mechanism,The project needs to provide accessible and transparent grievance mechanisms to enable all workers to raise workplace concernts.,OC4IDS
+workingAtHeight,Working at height,Adequate fall prevention and protection measures needs to be implemented wherever workers are expected to work at height.,OC4IDS
+undergroundWork,Underground work,"The project needs to provide adequate occupational health and safety equipment, information and services appropriate for underground and excavation work such as drilling, blasting, rock bolting and soft soil work.",OC4IDS
+materialsEquipmentHandling,Handling of materials/equipment,The project needs to ensure that all workers engaged in handling of materials or equipment as part of their employment will receive at no cost to themselves adequate training and appropriate protective equipment.,OC4IDS
+accidentMonitoring,Monitoring of accidents,"The project needs to monitor, document and report on all occupational accidents, diseases and incidents.",OC4IDS
+trafficManagement,Traffic management,The project needs to adopt road safety initiatives proportional to its scope and nature that are protective of project workers and other road users.,OC4IDS
+accommodation,Accommodation,"The project needs to provide accommodation services to workers that accommodate their physical, social and cultural needs and protect and promote their health, safety and well-being.",OC4IDS
+protectivePersonalEquipment,Protective personal equipment,"The project needs to provide access to, training in, and maintenance of appropriate personal protective equipment at no additional cost to its workers.",OC4IDS
diff --git a/schema/project-level/project-schema.json b/schema/project-level/project-schema.json
@@ -520,6 +520,24 @@
           },
           "minItems": 1,
           "uniqueItems": true
+        },
+        "social": {
+          "title": "Social",
+          "description": "Information about the social impact of the project and actions the project will take to mitigate potentially negative impacts on adjacent populations and project workers.",
+          "type": "object",
+          "properties": {
+            "laborBudget": {
+              "title": "Labor budget",
+              "description": "The budget allocated in the contract for labor costs.",
+              "$ref": "#/definitions/Value"
+            },
+            "laborObligations": {
+              "title": "Labor obligations",
+              "description": "Information about labor obligations stipulated in the construction contract(s).",
+              "$ref": "#/definitions/LaborObligations"
+            }
+          },
+          "minProperties": 1
         }
       },
       "minProperties": 1
@@ -2311,6 +2329,33 @@
         }
       },
       "minProperties": 1
+    },
+    "LaborObligations": {
+      "title": "Labor obligations",
+      "description": "Information about labor obligations stipulated in the construction contract(s).",
+      "type": "object",
+      "properties": {
+        "obligations": {
+          "title": "Obligations",
+          "description": "The labor obligations stipulated in the construction contract(s), using the open laborObligations codelist.",
+          "type": [
+            "array"
+          ],
+          "items": {
+            "type": "string"
+          },
+          "codelist": "laborObligations.csv",
+          "openCodelist": true,
+          "minItems": 1
+        },
+        "description": {
+          "title": "Description",
+          "description": "A short description of the labor obligations.",
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "minProperties": 1
     }
   },
   "minProperties": 1