Přeskočit na obsah

npm run report:evidence-plan — Evidenční plán práce

Evidenční plán práce: Generovaný přehled stavu evidence per dossier: kde je zdrojování nejslabší a co ho konkrétně posílí. npm skript, generování.

npm skript generování pipeline: build

Volání

npm run report:evidence-plan

Spustí node scripts/data/report-evidence-plan.mjs (čteno z package.json při buildu)

Zdroj: scripts/data/report-evidence-plan.mjs

Generovaný přehled stavu evidence per dossier: kde je zdrojování nejslabší a co ho konkrétně posílí. Čistá projekce kanonického modelu — nic si nepamatuje a nic nedopočítává mimo data.

Kdy ho spustit

Automaticky v data:build i v build. Ručně, když chceš aktuální plán práce; --json vypíše na stdout a nic nezapíše.

Co vynucuje

Nic — tenhle příkaz reportuje nebo generuje, ale sám o sobě nic neshazuje. Co selže při chybě, hlídají brány, které za ním v pipeline běží.

Co je potřeba vědět

  • Není hodnocení osob. Vysoké skóre znamená, že TENHLE web má u daného dossieru nejvíc nedodělané zdrojovací práce — je to metrika naší evidence, ne jednání subjektu.
  • Report neobsahuje čas běhu: stáří mezer se měří proti nejnovějšímu datu v datasetu, takže dva běhy nad stejnými daty dají bajt po bajtu stejný soubor. Horizont lze přepsat --as-of=RRRR-MM-DD.
  • Výstupy jdou do reports/ a data/generated/, nikdy do content/ — neroutují se a žádná stránka z nich nevzniká.

Vstupy a výstupy

Čte

  • data/dossiers/** (compiled model)
  • scripts/data/lib/source-independence.mjs

Zapisuje

  • reports/evidence-plan.md
  • data/generated/evidence-plan.json

Popis vychází z hlavičkového komentáře zdrojového souboru. Volání, zařazení do pipeline i členství v pre-commit hooku se dopočítávají při každém buildu ze samotného repozitáře.