Merge pull request #136 from Software-Hardware-Integration-Lab/LAB-1711-update-open-api-spec-to-align-with-latest-schema-version-5-0-14

LAB-1711:- Inline nullable schemas and add examples

Author: JagdishKhunti

specs/Data-Gateway.json

@@ -2492,12 +2492,12 @@
                 "properties": {
                     "value": {
                         "type": [
-                            "number",
+                            "string",
                             "null"
                         ],
-                        "description": "Numeric assessment value for this year phase (e.g., score/percentage) or null.",
+                        "description": "Assessment value label for this year phase (for example, \"Full\") or null.",
                         "examples": [
-                            1.0,
+                            "Full",
                             null
                         ]
                     },
@@ -2531,7 +2531,8 @@
                         ],
                         "description": "Alternate product, if any, or null.",
                         "examples": [
-                            "Other Product"
+                            "Other Product",
+                            null
                         ]
                     },
                     "publisher": {
@@ -2577,7 +2578,7 @@
                 "additionalProperties": false,
                 "examples": [
                     {
-                        "value": 1.0,
+                        "value": "Full",
                         "userProfileIds": [
                             "0d8e0c84-c0b4-4459-8b23-11ccff5ae319"
                         ],
@@ -2601,8 +2602,16 @@
                         ]
                     },
                     "breakoutId": {
-                        "$ref": "#/components/schemas/NullableUuid",
-                        "description": "Optional breakout identifier, may be null."
+                        "type": [
+                            "string",
+                            "null"
+                        ],
+                        "format": "uuid",
+                        "description": "Optional breakout identifier, may be null.",
+                        "examples": [
+                            "fd9a6a53-594d-41aa-950a-b21ff41d4688",
+                            null
+                        ]
                     },
                     "category": {
                         "type": "string",
@@ -3114,8 +3123,16 @@
                         ]
                     },
                     "expiryDate": {
-                        "$ref": "#/components/schemas/NullableDateTimeStringType",
-                        "description": "Contract expiry date string."
+                        "type": [
+                            "string",
+                            "null"
+                        ],
+                        "format": "date-time",
+                        "examples": [
+                            "2026-01-01T00:00:00Z",
+                            null
+                        ],
+                        "description": "Contract expiry date as an ISO 8601 date-time string, or null."
                     }
                 },
                 "required": [
@@ -3194,8 +3211,16 @@
                                 ]
                             },
                             "replacementDate": {
-                                "$ref": "#/components/schemas/NullableDateTimeStringType",
-                                "description": "Planned replacement date string."
+                                "type": [
+                                    "string",
+                                    "null"
+                                ],
+                                "format": "date-time",
+                                "examples": [
+                                    "2026-01-01T00:00:00Z",
+                                    null
+                                ],
+                                "description": "Planned replacement date as an ISO 8601 date-time string, or null."
                             }
                         },
                         "required": [
@@ -3304,7 +3329,15 @@
                         ]
                     },
                     "discoveryDate": {
-                        "$ref": "#/components/schemas/NullableDateTimeStringType",
+                        "type": [
+                            "string",
+                            "null"
+                        ],
+                        "format": "date-time",
+                        "examples": [
+                            "2026-01-01T00:00:00Z",
+                            null
+                        ],
                         "description": "Date the discovery occurred (string); Default: null."
                     },
                     "accountManager": {
@@ -3374,11 +3407,27 @@
                         ]
                     },
                     "createdDate": {
-                        "$ref": "#/components/schemas/NullableDateTimeStringType",
+                        "type": [
+                            "string",
+                            "null"
+                        ],
+                        "format": "date-time",
+                        "examples": [
+                            "2026-01-01T00:00:00Z",
+                            null
+                        ],
                         "description": "ISO 8601 date-time string when created; Default: null."
                     },
                     "modifiedDate": {
-                        "$ref": "#/components/schemas/NullableDateTimeStringType",
+                        "type": [
+                            "string",
+                            "null"
+                        ],
+                        "format": "date-time",
+                        "examples": [
+                            "2026-01-01T00:00:00Z",
+                            null
+                        ],
                         "description": "ISO 8601 date-time string when last modified; Default: null."
                     },
                     "primaryPublisher": {
@@ -3904,8 +3953,15 @@
                         ]
                     },
                     "breakoutId": {
-                        "$ref": "#/components/schemas/NullableUuid",
-                        "description": "Breakout identifier or null."
+                        "type": [
+                            "string",
+                            "null"
+                        ],
+                        "description": "Breakout identifier or null.",
+                        "examples": [
+                            "fd9a6a53-594d-41aa-950a-b21ff41d4688",
+                            null
+                        ]
                     },
                     "breakoutName": {
                         "type": [