---
description: 复杂业务/判断逻辑必须同步写入 PRD 与 .spec Markdown，并同步标注目录
alwaysApply: true
---

# 业务逻辑文档化（全局强制）

实现或修改**复杂判断逻辑**时，代码与文档**同一轮交付**。完整指南：`rules/business-logic-documentation-guide.md`。

## 触发条件（满足任一即必须文档化）

多步判定链、跨模块校验、状态/公式推导、导入保存规则、权限分支、一键修复建议值。

## 必须更新的文件

1. **`src/prototypes/<name>/.spec/<topic>.md`** — 完整规则（判定顺序、数据源、边界、代码路径）
2. **`src/prototypes/<name>/.spec/requirements-prd.md`** — 摘要表 + §验收项 + 链接到规格全文
3. **`annotation-source.json`** — 运行 `sync-annotation-directory.mjs` 同步目录/字段标注
4. 字段级：`columnHeaderTips.ts` 或对应 `annotationText`（如有）

## 规格文最低要求

- 判定**优先级顺序**（表格）
- **前置条件**（何时不校验）
- **数据源**（种子 JSON / 哪几个模块）
- 用户可见结果（通过/警告文案、是否可替换）
- 标明原型本地种子 vs 未接真实 API

## 禁止

- 只改 `utils/*.ts` 不更新 PRD / `.spec`
- 口头解释替代 Markdown
- 验收通过时 PRD 与页面行为不一致

## 范例

`lease-business-detail`：`.spec/field-checks.md` + PRD §5 单元格系统校验 + 目录「单元格系统校验」