Mathias STRASSER
b7dc27f2a5
Les enseignants ont besoin de moyennes à jour immédiatement après la publication ou modification des notes, sans attendre un batch nocturne. Le système recalcule via Domain Events synchrones : statistiques d'évaluation (min/max/moyenne/médiane), moyennes matières pondérées (normalisation /20), et moyenne générale par élève. Les résultats sont stockés dans des tables dénormalisées avec cache Redis (TTL 5 min). Trois endpoints API exposent les données avec contrôle d'accès par rôle. Une commande console permet le backfill des données historiques au déploiement.
125 lines
3.9 KiB
Python
125 lines
3.9 KiB
Python
#!/usr/bin/env python3
|
|
# /// script
|
|
# requires-python = ">=3.10"
|
|
# ///
|
|
"""Scaffold a BMad module setup skill from template.
|
|
|
|
Copies the setup-skill-template into the target directory as bmad-{code}-setup/,
|
|
then writes the generated module.yaml and module-help.csv into the assets folder
|
|
and updates the SKILL.md frontmatter with the module's identity.
|
|
"""
|
|
|
|
import argparse
|
|
import json
|
|
import shutil
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
|
|
def main() -> int:
|
|
parser = argparse.ArgumentParser(
|
|
description="Scaffold a BMad module setup skill from template"
|
|
)
|
|
parser.add_argument(
|
|
"--target-dir",
|
|
required=True,
|
|
help="Directory to create the setup skill in (the user's skills folder)",
|
|
)
|
|
parser.add_argument(
|
|
"--module-code",
|
|
required=True,
|
|
help="Module code (2-4 letter abbreviation, e.g. 'cis')",
|
|
)
|
|
parser.add_argument(
|
|
"--module-name",
|
|
required=True,
|
|
help="Module display name (e.g. 'Creative Intelligence Suite')",
|
|
)
|
|
parser.add_argument(
|
|
"--module-yaml",
|
|
required=True,
|
|
help="Path to the generated module.yaml content file",
|
|
)
|
|
parser.add_argument(
|
|
"--module-csv",
|
|
required=True,
|
|
help="Path to the generated module-help.csv content file",
|
|
)
|
|
parser.add_argument(
|
|
"--verbose", action="store_true", help="Print progress to stderr"
|
|
)
|
|
args = parser.parse_args()
|
|
|
|
template_dir = Path(__file__).resolve().parent.parent / "assets" / "setup-skill-template"
|
|
setup_skill_name = f"bmad-{args.module_code}-setup"
|
|
target = Path(args.target_dir) / setup_skill_name
|
|
|
|
if not template_dir.is_dir():
|
|
print(
|
|
json.dumps({"status": "error", "message": f"Template not found: {template_dir}"}),
|
|
file=sys.stdout,
|
|
)
|
|
return 2
|
|
|
|
for source_path in [args.module_yaml, args.module_csv]:
|
|
if not Path(source_path).is_file():
|
|
print(
|
|
json.dumps({"status": "error", "message": f"Source file not found: {source_path}"}),
|
|
file=sys.stdout,
|
|
)
|
|
return 2
|
|
|
|
target_dir = Path(args.target_dir)
|
|
if not target_dir.is_dir():
|
|
print(
|
|
json.dumps({"status": "error", "message": f"Target directory not found: {target_dir}"}),
|
|
file=sys.stdout,
|
|
)
|
|
return 2
|
|
|
|
# Remove existing setup skill if present (anti-zombie)
|
|
if target.exists():
|
|
if args.verbose:
|
|
print(f"Removing existing {setup_skill_name}/", file=sys.stderr)
|
|
shutil.rmtree(target)
|
|
|
|
# Copy template
|
|
if args.verbose:
|
|
print(f"Copying template to {target}", file=sys.stderr)
|
|
shutil.copytree(template_dir, target)
|
|
|
|
# Update SKILL.md frontmatter placeholders
|
|
skill_md = target / "SKILL.md"
|
|
content = skill_md.read_text(encoding="utf-8")
|
|
content = content.replace("{setup-skill-name}", setup_skill_name)
|
|
content = content.replace("{module-name}", args.module_name)
|
|
content = content.replace("{module-code}", args.module_code)
|
|
skill_md.write_text(content, encoding="utf-8")
|
|
|
|
# Write generated module.yaml
|
|
yaml_content = Path(args.module_yaml).read_text(encoding="utf-8")
|
|
(target / "assets" / "module.yaml").write_text(yaml_content, encoding="utf-8")
|
|
|
|
# Write generated module-help.csv
|
|
csv_content = Path(args.module_csv).read_text(encoding="utf-8")
|
|
(target / "assets" / "module-help.csv").write_text(csv_content, encoding="utf-8")
|
|
|
|
# Collect file list
|
|
files_created = sorted(
|
|
str(p.relative_to(target)) for p in target.rglob("*") if p.is_file()
|
|
)
|
|
|
|
result = {
|
|
"status": "success",
|
|
"setup_skill": setup_skill_name,
|
|
"location": str(target),
|
|
"files_created": files_created,
|
|
"files_count": len(files_created),
|
|
}
|
|
print(json.dumps(result, indent=2))
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(main())
|