Skip to content

MEM-SPARQL-Konsistenz-Runbook

Generated artifact. Do not edit manually.

Generated by: scripts/build_compendia.py Regenerate with: python3 scripts/build_compendia.py --compendium qa-ci-lanes --web-and-tex Source of truth: docs/qa-ci/lanes-source/

Sprache / Language: Deutsch (DE) · English (EN) | PDF: Deutsches PDF · English PDF

Kompendium: §1 CI-Architektur · §2 Qualitätsdashboard · §3 Mapping-Workbench · §4 Paketbereitschaft · §5 Release-Modell-Konformität · §6 Duale Release-Verträge · §7 Relationsprüfungen · §8 Atomizitäts-Review · §9 Voraussetzungs-Review · §10 Menschliche Review-Gates · §11 MEM-SPARQL-Audit · §12 MEM-SPARQL-Runbook · §13 Quellenbegründungen-Runbook · §14 Abi-2026-DeepLink-QA

12. MEM-SPARQL-Konsistenz-Runbook

Dieses Runbook bildet die operative Checkliste zur Ausführung und Triage des in 11 spezifizierten MEM-SPARQL-Konsistenzaudits (Erstprotokoll siehe MEM-SPARQL-PoC vom 01.06.2026).

12.1. Audit ausführen und Queue inspizieren

cd app
npm run quality:mem-sparql-consistency
cd ..
node - <<'NODE'
const q = require('./docs/qa-ci/status/mem-sparql-consistency-review-issues.json')
console.log(q.summary)
console.log(q.reviewLedger)
console.log(q.highestSignalChecks.map((i) => ({
  id: i.id, status: i.status, category: i.category,
  side: i.side, mem: i.memText, local: i.localText,
})))
NODE

Zur menschlichen Durchsicht dienen mem-sparql-consistency-review-issues.md (Queue) und mem-sparql-consistency-audit.md (Länderabdeckung und Zähler).

12.2. Entscheidungen eintragen, Diagnostik deuten und lokal verifizieren

  1. Eintrag aus highestSignalChecks oder textTriageQueue wählen und id sowie itemFingerprint übernehmen.
  2. memText/memRef, localText/localRef, rationale und ggf. reviewNote abgleichen; lokale Extraktionsfehler direkt im source-extraction-Artefakt beheben.
  3. Status wählen (not_an_issue, local_extraction_fix_needed, mem_feedback_candidate, source_version_gap, deferred), als einzeiliges JSONL-Objekt an curricula/DE/Gymnasium/quality/mem-sparql-consistency/canonical-math-poc.review.jsonl anhängen und das Audit erneut starten.

Bedeutung von reviewLedger.diagnostics (vor einem MEM-Feedback-Durchgang bereinigen; Testdaten nur unter tmp/ anlegen):

  • stale_review: Eintrag existiert weiterhin, aber der Evidenz-Fingerprint hat sich geändert \(\to\) neu prüfen.
  • unknownItemRecords: Ledger verweist auf eine nicht mehr in der aktuellen Queue enthaltene itemId.
  • duplicateItemRecords: Mehrere Zeilen zur selben itemId (die letzte gewinnt; Mehrdeutigkeit entfernen).

Lokale Verifikation nach Änderungen an Generator, Konfiguration, Extraktion oder Dokumentation:

cd app
npx eslint scripts/generateMemSparqlConsistencyAudit.ts
npm run quality:source-coverage-audit:check
cd ..
git diff --check
MEM_CFG=curricula/DE/Gymnasium/quality/mem-sparql-consistency
node -e "for (const f of [
  '$MEM_CFG/canonical-math-poc.config.json',
  'docs/qa-ci/status/mem-sparql-consistency-audit.json',
  'docs/qa-ci/status/mem-sparql-consistency-review-issues.json'
]) JSON.parse(require('fs').readFileSync(f, 'utf8')); console.log('json ok')"