Skip to content

docs: document synthetic data provenance and boundaries - #16

Merged
Akaliup merged 1 commit into
masterfrom
feat/rag-hybrid-retrieval
Nov 6, 2026
Merged

Akaliup merged 1 commit into
masterfrom
feat/rag-hybrid-retrieval

Conversation

@Akaliup

@Akaliup Akaliup commented Nov 6, 2026

Copy link
Copy Markdown
Owner

变更摘要

新增 docs/DATA_PROVENANCE.md,集中说明合成数据清单、真实执行范围、能支撑/不能支撑的结论,以及接入真实数据的路径;同时删除 README 中「真实经营账本」的误导表述,并在演示验证章节注明账本来自确定性合成种子。

本 PR 仅文档变更,不改变代码、契约或运行时行为。

关联任务

无。

实际验证

本 PR 仅修改 README.md 与 docs/DATA_PROVENANCE.md,未执行代码测试。

  • python -m pytest backend/tests -q(未执行)
  • npm --prefix frontend test(未执行)
  • npm --prefix frontend run build(未执行)
  • python scripts/smoke.py(未执行)
  • docker compose config --quiet(不涉及 Compose)
  • 真实 LLM 调用(不涉及)
  • 未执行项已在下文明确标注

验证结果:

本 PR 仅文档变更,本轮未执行测试。
同一代码树在 PR #15 中已记录:
npm --prefix frontend test        17 passed
npm --prefix frontend run build   通过(Vite 6.4.5)
npm --prefix frontend run test:e2e 7 passed
python scripts/smoke.py           15/15 passed
端到端演示                         29/29 检查通过

上述结果不因本 PR 的文档修改而失效,但本轮未重新执行。

安全与边界

  • 未提交 .env、API Key、数据库、缓存、构建产物或本机运行数据
  • 所有执行仍为 simulation,没有真实广告、采购、支付或外部系统副作用
  • 金额仍以 USD 整数美分存储和传输
  • 服务端仍决定角色,未信任客户端角色请求头
  • 审批与执行仍依赖条件更新、事务和唯一约束
  • 未在自动 CI 中调用真实 LLM

契约与文档

  • 契约变更已同步 docs/CONTRACT.md、后端测试和前端类型(本 PR 无契约变更)
  • 涉及评测的变更已同步 docs/EVALUATION.md(本 PR 无评测变更)
  • 新增限制或未验证项已写入相关文档(docs/DATA_PROVENANCE.md)

审查提示

请核对 docs/DATA_PROVENANCE.md 中的数据规模与来源是否与 backend/app/seed.py、backend/app/knowledge.py、backend/evals/ 一致,以及 README 是否仍有未标注的绝对化表述。自动审查工具的评论只是辅助,不替代人工审查。

🤖 Generated with Claude Code

Add docs/DATA_PROVENANCE.md with the data inventory, real-execution scope, supported/unsupported conclusions and the path to real data. Remove the misleading 'real ledger' wording and disclose the synthetic seed data in the demo section.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 6, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-06T21:57:05.471985Z 570a6fa PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@Akaliup
Akaliup merged commit ad1a85d into master Nov 6, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant