specpress

{ "$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 }