One YAML File for a Town Archive's Condition Calls

说明与用途

创建了一个统一的 YAML 模型，用于对小型档案中的项目进行分类，消除了不同笔记本之间的不一致，并提供了评估状况、数字化和风险的统一规则集。

问题

Multiple notebooks for a town archive disagreed on how to classify items, leading to inconsistent treatment, digitization, and risk decisions.

结果

Consistent, rule‑driven classification of archive items, a 50% treatment rate, seven items flagged for digitization, two pull risks, and a clear, reproducible workflow.

工作流

• Define fact grain as Item
• Define dimensions: Collection, Location, Format
• Define properties: condition_score, digitized, pull_count, note
• Define metrics/judgments: NeedsTreatment, Stable, DigitizeNext, PullRisk
• Write rules in YAML with clear boundaries (e.g., score <=2 for treatment)
• Load YAML with PyYAML and validate with ontology.py
• Bind items to dimensions with bind.py
• Score items with metrics.py
• Generate report via build_report in main.py
• Expose report through FastAPI GET /api/brief
• Render chart with Matplotlib
• Run tests with pytest to ensure rule boundaries and error handling

证据

I kept three notebooks for a fake town archive and they would not agree on a single object.

来源

The semantic model is schema/archive.yaml. The fact grain is Item.

来源

Python main.py prints that table. FastAPI serves the same build_report function.

来源