feat(series-studio): initial implementation of unified series studio engine (PDF & DOCX)

This commit is contained in:
bolbol committed 2026-11-10 00:10:05 +00:00
commit 03d9922066
20 files changed
+7082

No files matched your search

+79
View File
@@ -0,0 +1,79 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
validator.py
Validateur JSON pour series-studio avec erreurs précises et localisées
(chemin du champ, cause de l'erreur, correction attendue).
"""
import json
import os
import jsonschema
SCHEMA_PATH = os.path.join(os.path.dirname(__file__), "schema.json")
def load_schema():
with open(SCHEMA_PATH, "r", encoding="utf-8") as f:
return json.load(f)
_SCHEMA = load_schema()
_VALIDATOR = jsonschema.Draft7Validator(_SCHEMA)
def format_error(err: jsonschema.ValidationError):
"""Formate une erreur jsonschema en dictionnaire clair et localisé."""
path = ".".join(str(p) for p in err.path)
if not path:
if err.validator == "required":
# Le message indique quelle propriété manque
prop = err.message.split("'")[1] if "'" in err.message else "champ_requis"
path = prop
else:
path = "source"
cause = err.message
fix = f"Vérifier le champ '{path}' : respecter la structure spécifiée dans schema.json."
if err.validator == "type":
fix = f"Le champ '{path}' doit être de type '{err.validator_value}' au lieu de '{type(err.instance).__name__}'."
elif err.validator == "required":
fix = f"Ajouter le champ manquant requis : '{path}'."
elif err.validator == "enum":
fix = f"La valeur pour '{path}' doit être parmi {err.validator_value}."
elif err.validator == "minimum":
fix = f"La valeur de '{path}' doit être supérieure ou égale à {err.validator_value}."
return {
"path": path,
"field": path,
"cause": cause,
"fix": fix
}
def validate_source(source):
"""Valide une source JSON complète et renvoie un dictionnaire de résultat."""
if not isinstance(source, dict):
return {
"valid": False,
"errors": [
{
"path": "source",
"field": "source",
"cause": "Le document racine doit être un objet JSON (dict)",
"fix": "Fournir un objet JSON avec schema_version, cartouche, exercices, etc."
}
]
}
errors = []
for err in _VALIDATOR.iter_errors(source):
errors.append(format_error(err))
if errors:
return {
"valid": False,
"errors": errors
}
return {
"valid": True,
"errors": []
}