# 交付验收清单

更新时间：2026-07-08

本清单记录当前作品集 MVP 的验收状态。自动化验收命令为：

```powershell
python scripts\run_acceptance.py
```

最近一次运行结果：通过。覆盖静态页面结构、UTF-8 编码、JSON 资产、Python 单元测试、数据可靠性 pipeline、CSV schema、图片索引、发布包生成和交付审计。

## 产品体验

- [x] 首页能展示工作台、当前作物、面积、生长阶段和风险等级。
- [x] 土地资源评估能生成种植计划草案。
- [x] 修改作物档案后，工作台摘要和施肥计划能同步变化。
- [x] 作物档案更新后能展示明确反馈。
- [x] 农业小课堂能展示平台原创内容和可信外部链接。
- [x] 上传图片后能显示图片预览。
- [x] 切换缺氮、缺磷、缺钾、病害、水分胁迫后，诊断结果能同步变化。
- [x] 施肥计划能根据面积计算总量。
- [x] 农事任务能展示复查、施肥、巡田等行动。
- [x] 售粮指南能按地区和作物筛选。
- [x] 数据可信模块能解释采集、评级、验证、审核、呈现流程。

## 数据可靠性

- [x] A/B 级可信来源可进入候选知识库。
- [x] C 级来源不进入核心建议。
- [x] 缺少来源 URL 或发布日期的数据会被标记为需要补充来源。
- [x] 同一主张两个可信来源支持时标记为推荐建议。
- [x] 冲突内容标记为需人工审核。
- [x] `provenance.json` 记录处理步骤和统计结果。
- [x] 图片数据可通过 `index_images.py` 生成索引表。
- [x] CSV 数据能通过 `validate_data_schema.py` 校验。

## 作品集材料

- [x] README 能说明项目背景、功能、部署方式和简历表达。
- [x] GitHub 小白部署教程能指导新手上传仓库并开启 Pages。
- [x] 简历项目经历最终版可直接放入简历。
- [x] 面试逐字稿和面试准备背书可用于面试前背诵。
- [x] 需求追踪矩阵能把原始需求、实现证据和验收证据对应起来。
- [x] PRD 能说明用户、痛点和 MVP 范围。
- [x] 用户研究方案能说明访谈对象、问题清单、可用性任务和验证指标。
- [x] Figma 原型说明能指导绘制页面。
- [x] 项目案例能用于作品集展示。
- [x] 面试讲述稿能覆盖 30 秒和 2 分钟版本。
- [x] 指标体系与埋点方案能说明北极星指标、核心漏斗和事件 schema。
- [x] 用户手册能指导完整体验路径。
- [x] 维护手册能指导后续数据、图片、版本和发布维护。
- [x] 隐私与风险治理说明能覆盖图片、AI、用户数据和高风险农技建议边界。
- [x] 安全说明能覆盖 API key、敏感图片、隐私和高风险农技内容报告方式。

## 发布准备

- [x] `python scripts\run_acceptance.py` 通过。
- [x] `python scripts\check_text_encoding.py` 通过。
- [x] 项目根目录包含 `.nojekyll`。
- [x] 项目根目录包含 `404.html`。
- [x] 仓库包含 `.github/workflows/ci.yml`。
- [x] 仓库包含 `.github/workflows/pages.yml`。
- [x] 仓库包含 Bug、Feature 和 Data source Issue 模板。
- [x] 发布包生成到 `dist/`，并写入 `release_manifest.json`。

## 外部待完成

- [ ] 将项目推送到 GitHub。
- [ ] 在 GitHub Pages 中选择 GitHub Actions 或 `main` 分支根目录部署。
- [ ] 如需正式 Figma 文件，在 Figma 中按 `docs/FIGMA_PROTOTYPE_SPEC.md` 和 `docs/prototype.html` 绘制。
- [ ] 补充更多真实 A/B 级农技来源、售粮公告和授权图片。

这些外部项需要账号、平台设置或真实数据输入，不影响当前本地作品集 MVP 的可展示交付。