make build for yaml schemas.

Author: RossBugginsNHS

docs/Makefile

@@ -1,7 +1,8 @@
 BASE_URL ?= "/"
 VERSION ?= ""
 SCHEMA_PATTERN = *.schema.json
-SCHEMA_INPUT_DIR = ../schemas
+SCHEMA_BASE_INPUT_DIR = ../schemas
+SCHEMA_INPUT_DIR = $(SCHEMA_BASE_INPUT_DIR)/output
 BASE_OUTPUT_DIR = _site
 SCHEMA_OUTPUT_DIR = $(BASE_OUTPUT_DIR)/schemas
 SHELL = /bin/bash
@@ -29,6 +30,7 @@ build-docs: version
 	npm run build $(baseurlparam)
 
 build-schemas: clean-schemas
+	(cd $(SCHEMA_BASE_INPUT_DIR) && make config && make build)
 	mkdir -p $(SCHEMA_OUTPUT_DIR)
 	@echo "Finding schema files..."
 	@find $(SCHEMA_INPUT_DIR) -name "$(SCHEMA_PATTERN)" -print

schemas/.gitignore

@@ -0,0 +1 @@
+output

schemas/2025-10/digital-letters-data.schema.json

@@ -0,0 +1,75 @@
+# Variables
+SCHEMA_SRC_DIR := src
+OUTPUT_DIR := output
+SCRIPTS_DIR := scripts
+YAML_TO_JSON_SCRIPT := $(SCRIPTS_DIR)/yaml_to_json.py
+YAML_SCHEMAS := $(shell find $(SCHEMA_SRC_DIR) -name "*.schema.yaml" -type f)
+JSON_OUTPUTS := $(patsubst $(SCHEMA_SRC_DIR)/%.schema.yaml,$(OUTPUT_DIR)/%.schema.json,$(YAML_SCHEMAS))
+
+# Default target
+.PHONY: all clean build convert-schemas config check-deps
+
+all: build
+
+# Create output directory
+$(OUTPUT_DIR):
+	@mkdir -p $(OUTPUT_DIR)
+
+# Setup dependencies
+config:
+	@echo "Setting up dependencies for YAML to JSON conversion..."
+	@echo "Checking Python installation..."
+	@python3 --version || (echo "Error: Python 3 is required" && exit 1)
+	@echo "Checking PyYAML installation..."
+	@python3 -c "import yaml; print('PyYAML is already installed')" 2>/dev/null || \
+		(echo "Installing PyYAML..." && pip install PyYAML)
+	@echo "Dependencies setup complete!"
+
+# Check dependencies before building
+check-deps:
+	@python3 -c "import yaml" 2>/dev/null || \
+		(echo "PyYAML not found. Run 'make config' to install dependencies." && exit 1)
+
+# Convert all YAML schemas to JSON
+convert-schemas: check-deps $(OUTPUT_DIR)
+	@echo "Converting YAML schemas to JSON..."
+	@for yaml_file in $(YAML_SCHEMAS); do \
+		relative_path=$${yaml_file#$(SCHEMA_SRC_DIR)/}; \
+		output_file="$(OUTPUT_DIR)/$${relative_path%.schema.yaml}.schema.json"; \
+		output_dir=$$(dirname "$$output_file"); \
+		mkdir -p "$$output_dir"; \
+		echo "Converting $$yaml_file to $$output_file"; \
+		python3 $(YAML_TO_JSON_SCRIPT) "$$yaml_file" "$$output_file"; \
+	done
+
+# Build all schemas
+build: convert-schemas
+	@echo "Building schemas complete!"
+	@echo "Found $(words $(YAML_SCHEMAS)) YAML schema(s):"
+	@for schema in $(YAML_SCHEMAS); do echo "  - $$schema"; done
+	@echo "Generated JSON schemas in $(OUTPUT_DIR)/"
+
+# Clean output directory
+clean:
+	@echo "Cleaning output directory..."
+	@rm -rf $(OUTPUT_DIR)
+	@echo "Clean complete!"
+
+# Show help
+help:
+	@echo "Available targets:"
+	@echo "  all     - Build all schemas (default)"
+	@echo "  config  - Setup dependencies (Python, PyYAML)"
+	@echo "  build   - Convert YAML schemas from src/ to JSON in output/ (preserving folder structure)"
+	@echo "  list    - List all YAML schema files that would be processed"
+	@echo "  clean   - Remove output directory"
+	@echo "  help    - Show this help message"
+	@echo ""
+	@echo "Source schemas are looked for in: $(SCHEMA_SRC_DIR)/"
+	@echo "Output JSON files are generated in: $(OUTPUT_DIR)/ (with preserved folder structure)"
+
+# List all YAML schema files
+list:
+	@echo "YAML schema files found:"
+	@for schema in $(YAML_SCHEMAS); do echo "  - $$schema"; done
+	@echo "Total: $(words $(YAML_SCHEMAS)) file(s)"

schemas/2025-10/digital-letters.schema.json

@@ -0,0 +1,21 @@
+# Schema Scripts
+
+This directory contains utility scripts for schema processing.
+
+## Files
+
+- `yaml_to_json.py` - Converts YAML schema files to JSON format using PyYAML
+
+## Usage
+
+The scripts are automatically used by the Makefile targets. You can also run them directly:
+
+```bash
+# Convert a single YAML file to JSON
+python3 scripts/yaml_to_json.py input.schema.yaml output.schema.json
+```
+
+## Dependencies
+
+- Python 3.x
+- PyYAML (automatically installed via `make config`)

schemas/2025-10/new-letter-from-customer-received-data.schema.json

@@ -0,0 +1,35 @@
+#!/usr/bin/env python3
+"""
+YAML to JSON converter for schema files using PyYAML.
+"""
+import yaml
+import json
+import sys
+
+def yaml_to_json(yaml_file, json_file):
+    """Convert YAML file to JSON file."""
+    try:
+        with open(yaml_file, 'r') as f:
+            data = yaml.safe_load(f)
+
+        with open(json_file, 'w') as f:
+            json.dump(data, f, indent=2)
+
+        return True
+    except Exception as e:
+        print(f"Error converting {yaml_file}: {e}")
+        return False
+
+if __name__ == "__main__":
+    if len(sys.argv) != 3:
+        print("Usage: python yaml_to_json.py <input.yaml> <output.json>")
+        sys.exit(1)
+
+    yaml_file = sys.argv[1]
+    json_file = sys.argv[2]
+
+    if yaml_to_json(yaml_file, json_file):
+        print(f"Converted {yaml_file} to {json_file}")
+    else:
+        print(f"Failed to convert {yaml_file}")
+        sys.exit(1)

schemas/2025-10/new-letter-from-customer-received.schema.json

@@ -0,0 +1,16 @@
+$id: https://notify.nhs.uk/schemas/events/digital-letters/2025-10/digital-letters-data.schema.json
+$schema: http://json-schema.org/draft-07/schema#
+
+additionalProperties: true
+
+properties:
+  digital-letter-id:
+    $comment: Corresponds to ....
+    description: The unique identifier for the digital letter.
+    format: uuid
+    type: string
+
+required:
+  - digital-letter-id
+
+type: object