{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://github.com/Ericsson/specpress/schemas/crCoverPage.json",
  "title": "3GPP Change Request Cover Page",
  "description": "Schema for 3GPP Change Request (CR) cover page",
  "type": "object",
  "required": [
    "Specification",
    "Current version",
    "Title",
    "Source to TSG",
    "Work item code",
    "Date",
    "Category",
    "Release",
    "Reason for change",
    "Summary of change",
    "Consequences if not approved",
    "Clauses affected"
  ],
  "properties": {
    "TDoc Number": {
      "type": "string",
      "description": "Document number indicating the group and a running number that starts with the year (e.g., 'RP-240123', 'R3-1234567', 'SP-263456')",
      "pattern": "^[CSR][P1-6]-[0-9]{6,7}$",
      "examples": [
        "RP-240123",
        "R3-1234567",
        "SP-263456",
        "C4-0012345"
      ]
    },
    "Specification": {
      "type": "string",
      "description": "Technical Specification or Report number (e.g., '38.413', '21.905', '38.101-1')",
      "pattern": "^[0-9]{2}\\.[0-9]{3}(-[0-9])?$",
      "examples": [
        "38.413",
        "21.905",
        "38.101-1"
      ]
    },
    "CR": {
      "type": "integer",
      "description": "Change Request number (0 to 9999)",
      "minimum": 1,
      "maximum": 9999,
      "examples": [
        123,
        1234,
        42
      ]
    },
    "rev": {
      "type": "integer",
      "description": "Revision number of the CR (0 to 99). Omit or use 0 for initial submission",
      "minimum": 1,
      "maximum": 99,
      "examples": [
        1,
        2,
        10
      ]
    },
    "Current version": {
      "type": "string",
      "description": "Current version of the specification (e.g., '17.5.0')",
      "pattern": "^[0-9]{1,2}\\.[0-9]{1,2}\\.[0-9]{1,2}$",
      "examples": [
        "17.5.0",
        "18.0.0"
      ]
    },
    "Release": {
      "type": "integer",
      "description": "3GPP Release number targeted by this CR (e.g., 17, 18, 19). Will be displayed as 'Rel-N' in the output.",
      "minimum": 8,
      "examples": [
        19,
        20,
        21
      ]
    },
    "Affected": {
      "type": "object",
      "description": "Indicates which network elements are affected by this change",
      "properties": {
        "UICC": {
          "type": "boolean",
          "description": "Universal Integrated Circuit Card (SIM card) is affected",
          "default": false
        },
        "ME": {
          "type": "boolean",
          "description": "Mobile Equipment (UE/device) is affected",
          "default": false
        },
        "Radio Access Network": {
          "type": "boolean",
          "description": "Radio Access Network (base stations) is affected",
          "default": false
        },
        "Core Network": {
          "type": "boolean",
          "description": "Core Network is affected",
          "default": false
        }
      },
      "additionalProperties": false
    },
    "Title": {
      "type": "string",
      "description": "Short descriptive title of the change request",
      "minLength": 1,
      "maxLength": 250,
      "examples": [
        "Correction to handover procedure",
        "Addition of new IE"
      ]
    },
    "Source to WG": {
      "type": "array",
      "description": "Source company/companies when submitting to Working Group. It should be absent when the CR is submitted directly to the TSG.",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "examples": [
        [
          "Ericsson"
        ],
        [
          "Nokia",
          "Samsung"
        ]
      ]
    },
    "Source to TSG": {
      "type": "array",
      "description": "Source company/companies when submitting to Technical Specification Group",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "examples": [
        [
          "RAN2"
        ],
        [
          "Ericsson"
        ],
        [
          "Nokia",
          "Samsung"
        ]
      ]
    },
    "Work item code": {
      "type": "array",
      "description": "Related work item code(s). Common 6G work items:\n- FS_6GSpecs: Study on Modernization of Specification Format and Procedures for 6G\n- FS_6G_REQ: Study on 6G Use Cases and Service Requirements\n- FS_6G_RAN_Scen_Req: Study on 6G Scenarios and Requirements\n- FS_6G_ARC: Study on Architecture for 6G System\n- FS_6G_Radio: Study on 6G Radio\n- FS_6G_APP: Study on 6G Application Enablement\n- FS_6G_SEC: Study on Security for the 6G System\n- FS_6G_MED: Study on Media Aspects for 6G System\n- FS_6G_CH: Study on Charging Aspects of 6G System\n- FS_6G_OAM: Study on 6G Management and Orchestration\n- FS_6G_LI: Study on Lawful Interception for 6G\n- FS_6G_CPCN_CT: Study on Control Plane Protocols in Core Network of the 6G System\n- FS_6G_UPCN_CT: Study on Protocol aspects for User Plane in Core Network of 6G System\n- FS_6G_ResRel_CT: Study on Resilience and Reliability in Core Network of the 6G System\n- FS_6G_NAS_CT: Study on NAS protocol for 6G System\n- TEI: Technical Enhancements and Improvements\nOther work item codes are also allowed.",
      "items": {
        "type": "string",
        "minLength": 1,
        "examples": [
          "FS_6GSpecs",
          "FS_6G_REQ",
          "FS_6G_RAN_Scen_Req",
          "FS_6G_ARC",
          "FS_6G_Radio",
          "FS_6G_APP",
          "FS_6G_SEC",
          "FS_6G_MED",
          "FS_6G_CH",
          "FS_6G_OAM",
          "FS_6G_LI",
          "FS_6G_CPCN_CT",
          "FS_6G_UPCN_CT",
          "FS_6G_ResRel_CT",
          "FS_6G_NAS_CT",
          "TEI"
        ]
      },
      "minItems": 1
    },
    "Date": {
      "type": "string",
      "description": "Date when the CR was submitted (YYYY-MM-DD format)",
      "format": "date",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "examples": [
        "2024-03-15",
        "2025-01-20"
      ]
    },
    "Category": {
      "type": "string",
      "description": "CR category: A=Correction, B=Addition, C=Functional modification, D=Editorial, F=Correction (not affecting implementations)",
      "enum": [
        "A",
        "B",
        "C",
        "D",
        "F"
      ],
      "examples": [
        "A",
        "B"
      ]
    },
    "Reason for change": {
      "type": "string",
      "description": "Detailed explanation of why this change is needed",
      "minLength": 1,
      "examples": [
        "The current specification is ambiguous regarding...",
        "A new feature is required to support..."
      ]
    },
    "Summary of change": {
      "type": "string",
      "description": "Concise summary of what is being changed",
      "minLength": 1,
      "examples": [
        "Add clarification text in section 5.2.3",
        "Introduce new procedure for..."
      ]
    },
    "Impact analysis": {
      "type": "object",
      "description": "Analysis of implementation impact, e.g., if only one side implements the change. This information, if provided, will be added to the 'Summary of change' section.",
      "properties": {
        "UE implements - RAN does not": {
          "type": "string",
          "description": "Impact if UE implements but RAN does not",
          "default": ""
        },
        "RAN implements - UE does not": {
          "type": "string",
          "description": "Impact if RAN implements but UE does not",
          "default": ""
        }
      },
      "additionalProperties": false
    },
    "Consequences if not approved": {
      "type": "string",
      "description": "What happens if this CR is not approved",
      "default": "",
      "examples": [
        "Ambiguity remains in the specification, which may lead to...",
        "Feature cannot be deployed"
      ]
    },
    "Clauses affected": {
      "type": "array",
      "description": "List of specification clauses (sections) affected by this change",
      "items": {
        "type": "string"
      },
      "minItems": 0,
      "examples": [
        [
          "5.2.3",
          "7.1.2"
        ],
        [
          "3.1",
          "4.2.1",
          "Annex A"
        ]
      ]
    },
    "Other specs affected": {
      "type": "object",
      "description": "Other specifications that are affected by this change",
      "properties": {
        "Other core specifications": {
          "type": "array",
          "description": "List of other core specifications affected (format: 'TS/TR number' and 'CR number')",
          "items": {
            "type": "string"
          },
          "minItems": 0,
          "examples": [
            [
              "38.331 CR0248",
              "38.321 CR1234"
            ]
          ]
        },
        "Test specifications": {
          "type": "array",
          "description": "List of test specifications affected (format: 'TS/TR number' and 'CR number')",
          "items": {
            "type": "string"
          },
          "minItems": 0,
          "examples": [
            [
              "38.523-1 CR0789",
              "36.521 CR3658r1"
            ]
          ]
        },
        "O&M Specifications": {
          "type": "array",
          "description": "List of Operations & Maintenance specifications affected (format: 'TS/TR number' and 'CR number')",
          "items": {
            "type": "string"
          },
          "minItems": 0,
          "examples": [
            [
              "32.422 CR0012"
            ]
          ]
        }
      },
      "additionalProperties": false
    },
    "Other comments": {
      "type": "string",
      "description": "Any additional comments or notes",
      "default": ""
    }
  },
  "additionalProperties": false
}