用途:把一项 GIS 分析整理成他人无需对话即可执行的可检查项目,保留用户选定的算法与技术栈。除非不能满足明确需求,否则不擅自替换;重大变更需先说明,不得用便捷代理指标替代所需度量。
主要能力:确定分析目标、权威输入、语义过滤、度量 CRS、算法、输出与未决假设;固定不可变数据源,将修正与情景表示为带来源的显式数据;声明唯一规范可执行流水线与有序可解析步骤;新项目记录 delivery.schema: openmapstack-delivery/v1,默认使用内置仪表板;从流水线与清单派生所选视图,避免独立展示逻辑悄悄改变分析。
使用方式:参考 references/project-workflow.md、project-spec.md,以本地 templates/ 与 examples/tartu-development/ 作结构示例。先检查 openmapstack CLI 是否安装(openmapstack --version 或 python3 -m openmapstack --version,择可用者统一使用),然后运行 openmapstack validate,最后执行 openmapstack verify project.yaml --rerun 作为收尾步骤,未通过不得交付。重跑须能生成 data/derived 下全部文件、所选交付物、运行记录及清单中的 runs.latest 与 project.status,不能靠一次性脚本或手工修改。
适用场景:有 dlt、Dagster、dbt、QGIS 或 Observable 时,参考 references/established-stack.md 界定职责与集成边界,保留其工具,不重复其 SQL、摄取或调度定义。
限制:缺失工具或未知数据语义应作为可见限制保留;仅表示要校验不等于已校验。不得伪造缺失几何或覆盖数据源以通过校验。QGIS 与 Observable 为可选目标;不含 delivery 的旧清单在显式迁移前保持旧行为。具体安装与运行要求见 references/installation.md。