project-schema.json: add lobbyingMeetings,Meetings,PublicOfficial obj…

docs/_static/i18n.csv

@@ -366,3 +366,24 @@ completion/finalValueDetails,Final value details,True,
 completion/finalScope,Final scope,True,
 completion/finalScopeDetails,Final scope details,True,
 language,Language,True,
+lobbyingMeetings,Lobbying meetings,False,
+lobbyingMeetings,Meeting,False,
+lobbyingMeetings/id,ID,True,
+lobbyingMeetings/date,Date,False,
+lobbyingMeetings/location,Location,False,
+lobbyingMeetings/location,Address,False,
+lobbyingMeetings/location/streetAddress,Street address,True,
+lobbyingMeetings/location/locality,Locality,True,
+lobbyingMeetings/location/region,Region,True,
+lobbyingMeetings/location/postalCode,Postal code,True,
+lobbyingMeetings/location/countryName,Country name,True,
+lobbyingMeetings/numberOfParticipants,Participant count,False,
+lobbyingMeetings/publicOfficial,Public official,False,
+lobbyingMeetings/publicOfficial,Public official,False,
+lobbyingMeetings/publicOfficial/person,Person.,False,
+lobbyingMeetings/publicOfficial/person/name,Name,True,
+lobbyingMeetings/publicOfficial/person/organization,Organization,False,
+lobbyingMeetings/publicOfficial/person/organization,Organization reference,False,
+lobbyingMeetings/publicOfficial/person/organization/name,Organization name,True,
+lobbyingMeetings/publicOfficial/person/organization/id,Organization ID,True,
+lobbyingMeetings/publicOfficial/jobTitle,Job title,True,

docs/examples/blank.json

@@ -416,5 +416,29 @@
     "finalValueDetails": "",
     "finalScope": "",
     "finalScopeDetails": ""
-  }
+  },
+  "lobbyingMeetings": [
+    {
+      "id": "string",
+      "location": {
+        "streetAddress": "string",
+        "locality": "string",
+        "region": "string",
+        "postalCode": "string",
+        "countryName": "string"
+      },
+      "date": "date-time",
+      "numberOfParticipants": "integer",
+      "publicOfficial": {
+        "person": {
+          "name": "string",
+          "organization": {
+            "id": "string",
+            "name": "string"
+          }
+        },
+        "jobTitle": "string"
+      }
+    }
+  ]
 }

docs/examples/example.json

@@ -959,7 +959,31 @@
         "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."
-      }
+      },
+      "lobbyingMeetings": [
+        {
+          "id": "1",
+          "date": "2024-01-01T00:00:00Z",
+          "location": {
+            "streetAddress": "1600 Amphitheatre Pkwy",
+            "locality": "London",
+            "region": "London",
+            "postalCode": "WC1 8HG",
+            "countryName": "United Kingdom"
+          },
+          "numberOfParticipants": 4,
+          "publicOfficial": {
+            "person": {
+              "name": "Brett Gliddon",
+              "organization": {
+                "name": "Motorways UK",
+                "id": "GB-GOR-XX1234"
+              }
+            },
+            "jobTitle": "Group General Manager Transport Services"
+          }
+        }
+      ]
     }
   ]
 }

docs/reference/changelog.md

@@ -28,6 +28,10 @@
   * `.transactions`
   * `.milestones`
   * `ContractingProcesses.milestones`
+* [#428](https://github.com/open-contracting/infrastructure/pull/428) - add objects:
+  * `Meeting`
+  * `lobbyingMeetings`
+  * `PublicOfficial`
 
 ### Codelists
 

docs/reference/schema.md

@@ -489,6 +489,7 @@ This sub-schema is referenced by the following properties:
 * [`BudgetBreakdown/sourceParty`](project-schema.json,/definitions/BudgetBreakdown,sourceParty)
 * [`Transaction/payer`](project-schema.json,/definitions/Transaction,payer)
 * [`Transaction/payee`](project-schema.json,/definitions/Transaction,payee)
+* [`PublicOfficial/person/organization`](project-schema.json,/definitions/PublicOfficial,person/organization)
 
 Each `OrganizationReference` has the following fields:
 
@@ -556,6 +557,11 @@ Each `OrganizationReference` has the following fields:
 :title: transactions/0/payee
 ```
 
+```{jsoninclude} ../../docs/examples/example.json
+:jsonpointer: /projects/0/lobbyingMeetings/0/publicOfficial/person/organization
+:title: lobbyingMeetings/0/publicOfficial/person/organization
+```
+
 ````
 
 `````
@@ -574,6 +580,7 @@ When working with data, users ought to be aware that addresses might not always
 This sub-schema is referenced by the following properties:
 * [`Location/address`](project-schema.json,/definitions/Location,address)
 * [`Organization/address`](project-schema.json,/definitions/Organization,address)
+* [`Meeting/location`](project-schema.json,/definitions/Meeting,location)
 
 Each `Address` has the following fields:
 
@@ -601,6 +608,11 @@ Each `Address` has the following fields:
 :title: parties/0/address
 ```
 
+```{jsoninclude} ../../docs/examples/example.json
+:jsonpointer: /projects/0/lobbyingMeetings/0/location
+:title: lobbyingMeetings/0/location
+```
+
 ````
 
 `````
@@ -1076,3 +1088,73 @@ Each `MilestoneReference` has the following fields:
 ````
 
 `````
+
+### Meeting
+
+`Meeting` is defined as:
+
+```{field-description} ../../build/current_lang/project-schema.json /definitions/Meeting
+```
+
+This sub-schema is referenced by the following properties:
+* [`lobbyingMeetings`](project-schema.json,,lobbyingMeetings)
+
+Each `Meeting` has the following fields:
+
+`````{tab-set}
+
+````{tab-item} Schema
+
+```{jsonschema} ../../build/current_lang/project-schema.json
+:pointer: /definitions/Meeting
+:collapse: id,date,location,numberOfParticipants,publicOfficial
+:addtargets:
+```
+
+````
+
+````{tab-item} Examples
+
+```{jsoninclude} ../../docs/examples/example.json
+:jsonpointer: /projects/0/lobbyingMeetings
+:title: lobbyingMeetings
+```
+
+````
+
+`````
+
+### PublicOfficial
+
+`PublicOfficial` is defined as:
+
+```{field-description} ../../build/current_lang/project-schema.json /definitions/PublicOfficial
+```
+
+This sub-schema is referenced by the following properties:
+* [`Meeting/publicOfficial`](project-schema.json,/definitions/Meeting,publicOfficial)
+
+Each `PublicOfficial` has the following fields:
+
+`````{tab-set}
+
+````{tab-item} Schema
+
+```{jsonschema} ../../build/current_lang/project-schema.json
+:pointer: /definitions/PublicOfficial
+:collapse: jobTitle
+:addtargets:
+```
+
+````
+
+````{tab-item} Examples
+
+```{jsoninclude} ../../docs/examples/example.json
+:jsonpointer: /projects/0/lobbyingMeetings/0/publicOfficial
+:title: lobbyingMeetings/0/publicOfficial
+```
+
+````
+
+`````

schema/project-level/codelists/documentType.csv

@@ -64,3 +64,4 @@ contractAmendment,Contract amendment,A legal document that changes or adds to th
 designReport,Project design report,"A record of the justification for the design approach adopted in the project, typically issued before the works start, by the consultant or firm that will supervise the works.",OC4IDS
 paymentCertificate,Payment certificate,A document certifying that the work specified on a supplier's estimate or invoice is complete and that payment to the supplier is approved.,OC4IDS
 escalationApproval,Escalation approval,Documentation of one or more approved escalations of the contract price during the project life-cycle.,OC4IDS
+minutes.lobbyingMeeting,Lobbying meeting minutes,"A record of the issues discussed, agreements reached and decisions taken at a lobbying meeting.",OC4IDS

schema/project-level/project-schema.json

@@ -296,6 +296,16 @@
       ],
       "default": "en",
       "minLength": 1
+    },
+    "lobbyingMeetings": {
+      "title": "Lobbying meetings",
+      "description": "Information about lobbying meetings in relation to the project. That is, meetings with public officials that are made, managed or directed with the purpose of influencing public decision-making in relation to the project, whether for private, public or collective ends, whether for compensation or without. Public decision-making is the creation and amendment of legislation or any other regulatory measures; the development, modification and implementation of public policies, strategies and programmes; and the awarding of government contracts or grants, administrative decisions or any other public spending decisions.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/Meeting"
+      },
+      "uniqueItems": true,
+      "minItems": 1
     }
   },
   "definitions": {
@@ -1998,6 +2008,76 @@
         }
       },
       "minProperties": 1
+    },
+    "Meeting": {
+      "title": "Meeting",
+      "description": "The details of a meeting.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "title": "ID",
+          "description": "A locally unique identifier for the meeting.",
+          "type": [
+            "string"
+          ]
+        },
+        "date": {
+          "title": "Date",
+          "description": "The date of the meeting.",
+          "type": [
+            "string"
+          ],
+          "format": "date-time"
+        },
+        "location": {
+          "title": "Location",
+          "description": "The location of the meeting.",
+          "$ref": "#/definitions/Address"
+        },
+        "numberOfParticipants": {
+          "title": "Participant count",
+          "description": "The number of people in attendance at the meeting.",
+          "type": "integer"
+        },
+        "publicOfficial": {
+          "title": "Public official",
+          "description": "A position held by a person (or advisor to a person) with decision-making powers, who is elected, appointed or employed within the executive or legislative branches of power at national, sub-national, or supra-national levels; within private bodies performing public functions; and within public international organizations domiciled or operational in the country concerned.",
+          "$ref": "#/definitions/PublicOfficial"
+        }
+      },
+      "required": [
+        "id"
+      ],
+      "minProperties": 1
+    },
+    "PublicOfficial": {
+      "title": "Public official",
+      "description": "A position held by a person (or advisor to a person) with decision-making powers, who is elected, appointed or employed within the executive or legislative branches of power at national, sub-national, or supra-national levels; within private bodies performing public functions; and within public international organizations domiciled or operational in the country concerned.",
+      "type": "object",
+      "properties": {
+        "person": {
+          "title": "Person.",
+          "description": "The person.",
+          "type": "object",
+          "properties": {
+            "name": {
+              "title": "Name",
+              "description": "The full name of the person.",
+              "type": "string"
+            },
+            "organization": {
+              "title": "Organization",
+              "description": "The organization in respect of which the person is a public official.",
+              "$ref": "#/definitions/OrganizationReference"
+            }
+          }
+        },
+        "jobTitle": {
+          "title": "Job title",
+          "description": "The job title of the person with respect to the organization.",
+          "type": "string"
+        }
+      }
     }
   },
   "minProperties": 1