承兑平台在线文档

Appearance

需求追踪与管理 ​

**本文引用的文件** - [AI沟通记录/2026-06-03-Chat.md](file://AI沟通记录/2026-06-03-Chat.md) - [AI沟通记录/2026-06-05-Chat.md](file://AI沟通记录/2026-06-05-Chat.md) - [AI沟通记录/2026-06-06_沟通记录.md](file://AI沟通记录/2026-06-06_沟通记录.md) - [AI沟通记录/2026-06-08_沟通记录.md](file://AI沟通记录/2026-06-08_沟通记录.md) - [提示词.txt](file://提示词.txt) - [待确认决策清单.md](file://待确认决策清单.md) - [决策变更清单.md](file://决策变更清单.md) - [任务和测试过程/Readme.md](file://任务和测试过程/Readme.md) - [文档/Readme.md](file://文档/Readme.md) - [rearrange_chapters.py](file://rearrange_chapters.py) - [rearrange_v2.py](file://rearrange_v2.py) - [rearrange_v3.py](file://rearrange_v3.py)

目录 ​

  1. 简介
  2. 项目结构
  3. 核心组件
  4. 架构总览
  5. 详细组件分析
  6. 依赖分析
  7. 性能考量
  8. 故障排查指南
  9. 结论
  10. 附录

简介 ​

本文件面向“承兑平台”的需求追踪与管理，基于AI沟通记录与决策清单，构建需求追踪矩阵（RTM），确保需求与设计、实现、测试的可追溯性。文档覆盖需求变更管理流程、版本控制、状态跟踪、基线管理、冲突解决与优先级调整机制，同时提供需求验证与确认方法、评审流程、文档管理规范，以及风险评估、质量度量与交付标准，并分析需求变更对项目进度与成本的影响。

项目结构 ​

项目围绕“需求—设计—实现—测试—交付”的闭环展开，关键支撑材料包括：

  • AI沟通记录：记录需求讨论的时间线与关键结论
  • 决策清单：明确待确认与已确认的决策项及其影响面
  • 文档与任务：用于沉淀需求分析、架构设计与测试任务
  • Python脚本：用于文档章节重排与规范化，辅助需求文档版本治理
mermaid
graph TB
subgraph "需求来源"
CHAT1["AI沟通记录/2026-06-03-Chat.md"]
CHAT2["AI沟通记录/2026-06-05-Chat.md"]
CHAT3["AI沟通记录/2026-06-06_沟通记录.md"]
CHAT4["AI沟通记录/2026-06-08_沟通记录.md"]
PROMPT["提示词.txt"]
end
subgraph "决策与基线"
DRAFT["待确认决策清单.md"]
CONFIRM["决策变更清单.md"]
end
subgraph "文档与任务"
DOC_README["文档/Readme.md"]
TASK_README["任务和测试过程/Readme.md"]
end
subgraph "版本治理"
R1["rearrange_chapters.py"]
R2["rearrange_v2.py"]
R3["rearrange_v3.py"]
end
CHAT1 --> DRAFT
CHAT2 --> DRAFT
CHAT3 --> DRAFT
CHAT4 --> DRAFT
PROMPT --> DRAFT
DRAFT --> CONFIRM
CONFIRM --> DOC_README
CONFIRM --> TASK_README
DOC_README --> R1
DOC_README --> R2
DOC_README --> R3

图表来源

  • [AI沟通记录/2026-06-03-Chat.md:1-6](file://AI沟通记录/2026-06-03-Chat.md#L1-L6)
  • [AI沟通记录/2026-06-05-Chat.md:1-33](file://AI沟通记录/2026-06-05-Chat.md#L1-L33)
  • [AI沟通记录/2026-06-06_沟通记录.md:1-52](file://AI沟通记录/2026-06-06_沟通记录.md#L1-L52)
  • [AI沟通记录/2026-06-08_沟通记录.md:1-10](file://AI沟通记录/2026-06-08_沟通记录.md#L1-L10)
  • [提示词.txt:1-144](file://提示词.txt#L1-L144)
  • [待确认决策清单.md:1-523](file://待确认决策清单.md#L1-L523)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)
  • [文档/Readme.md:1-3](file://文档/Readme.md#L1-L3)
  • [任务和测试过程/Readme.md:1-3](file://任务和测试过程/Readme.md#L1-L3)
  • [rearrange_chapters.py:1-89](file://rearrange_chapters.py#L1-L89)
  • [rearrange_v2.py:1-104](file://rearrange_v2.py#L1-L104)
  • [rearrange_v3.py:1-159](file://rearrange_v3.py#L1-L159)

章节来源

  • [AI沟通记录/2026-06-03-Chat.md:1-6](file://AI沟通记录/2026-06-03-Chat.md#L1-L6)
  • [AI沟通记录/2026-06-05-Chat.md:1-33](file://AI沟通记录/2026-06-05-Chat.md#L1-L33)
  • [AI沟通记录/2026-06-06_沟通记录.md:1-52](file://AI沟通记录/2026-06-06_沟通记录.md#L1-L52)
  • [AI沟通记录/2026-06-08_沟通记录.md:1-10](file://AI沟通记录/2026-06-08_沟通记录.md#L1-L10)
  • [提示词.txt:1-144](file://提示词.txt#L1-L144)
  • [待确认决策清单.md:1-523](file://待确认决策清单.md#L1-L523)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)
  • [文档/Readme.md:1-3](file://文档/Readme.md#L1-L3)
  • [任务和测试过程/Readme.md:1-3](file://任务和测试过程/Readme.md#L1-L3)
  • [rearrange_chapters.py:1-89](file://rearrange_chapters.py#L1-L89)
  • [rearrange_v2.py:1-104](file://rearrange_v2.py#L1-L104)
  • [rearrange_v3.py:1-159](file://rearrange_v3.py#L1-L159)

核心组件 ​

  • 需求来源与沟通记录：以AI沟通记录与提示词为需求输入，形成需求讨论的时间线与结论依据
  • 决策清单体系：待确认决策清单用于评审与决策，决策变更清单用于固化基线与传播
  • 文档与任务：需求分析与设计方案文档、任务与测试过程文档，承载需求到设计与测试的映射
  • 版本治理工具：Python脚本用于文档章节重排与规范化，支撑需求文档的版本控制与一致性

章节来源

  • [提示词.txt:1-144](file://提示词.txt#L1-L144)
  • [待确认决策清单.md:1-523](file://待确认决策清单.md#L1-L523)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)
  • [文档/Readme.md:1-3](file://文档/Readme.md#L1-L3)
  • [任务和测试过程/Readme.md:1-3](file://任务和测试过程/Readme.md#L1-L3)
  • [rearrange_chapters.py:1-89](file://rearrange_chapters.py#L1-L89)
  • [rearrange_v2.py:1-104](file://rearrange_v2.py#L1-L104)
  • [rearrange_v3.py:1-159](file://rearrange_v3.py#L1-L159)

架构总览 ​

需求追踪与管理的总体架构围绕“需求—决策—基线—文档—测试—版本治理”的闭环展开，确保需求在各阶段的可追溯性与一致性。

mermaid
graph TB
A["需求来源<br/>AI沟通记录 + 提示词"] --> B["决策评审<br/>待确认决策清单"]
B --> C["决策固化<br/>决策变更清单"]
C --> D["需求文档<br/>文档/Readme.md"]
C --> E["任务与测试<br/>任务和测试过程/Readme.md"]
D --> F["版本治理<br/>rearrange_* 脚本"]
E --> G["测试验证<br/>需求到测试用例映射"]
C -.-> H["基线管理<br/>变更控制委员会(CCB)"]
H --> C

图表来源

  • [AI沟通记录/2026-06-03-Chat.md:1-6](file://AI沟通记录/2026-06-03-Chat.md#L1-L6)
  • [AI沟通记录/2026-06-05-Chat.md:1-33](file://AI沟通记录/2026-06-05-Chat.md#L1-L33)
  • [AI沟通记录/2026-06-06_沟通记录.md:1-52](file://AI沟通记录/2026-06-06_沟通记录.md#L1-L52)
  • [AI沟通记录/2026-06-08_沟通记录.md:1-10](file://AI沟通记录/2026-06-08_沟通记录.md#L1-L10)
  • [提示词.txt:1-144](file://提示词.txt#L1-L144)
  • [待确认决策清单.md:1-523](file://待确认决策清单.md#L1-L523)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)
  • [文档/Readme.md:1-3](file://文档/Readme.md#L1-L3)
  • [任务和测试过程/Readme.md:1-3](file://任务和测试过程/Readme.md#L1-L3)
  • [rearrange_chapters.py:1-89](file://rearrange_chapters.py#L1-L89)
  • [rearrange_v2.py:1-104](file://rearrange_v2.py#L1-L104)
  • [rearrange_v3.py:1-159](file://rearrange_v3.py#L1-L159)

详细组件分析 ​

需求来源与沟通记录 ​

  • 作用：记录需求讨论的时间线、关键结论与分歧点，作为需求变更的原始依据
  • 关键点：
    • 2026-06-03：日常问候与承接上一阶段未确认的业务细节与核心流程设计
    • 2026-06-05：项目上传至GitHub、SSH密钥配置与推送流程
    • 2026-06-06：模型切换、提交与推送、提示词记录
    • 2026-06-08：继续讨论与沟通记录
mermaid
sequenceDiagram
participant U as "用户"
participant AI as "AI助手"
participant Repo as "Git仓库"
U->>AI : 提交需求/问题
AI-->>U : 记录沟通并给出建议
AI->>Repo : 检测本地变动并提交
AI->>Repo : 推送分支(main)
Repo-->>AI : 推送结果(成功/失败)
AI-->>U : 反馈推送状态与后续步骤

图表来源

  • [AI沟通记录/2026-06-05-Chat.md:1-33](file://AI沟通记录/2026-06-05-Chat.md#L1-L33)
  • [AI沟通记录/2026-06-06_沟通记录.md:1-52](file://AI沟通记录/2026-06-06_沟通记录.md#L1-L52)

章节来源

  • [AI沟通记录/2026-06-03-Chat.md:1-6](file://AI沟通记录/2026-06-03-Chat.md#L1-L6)
  • [AI沟通记录/2026-06-05-Chat.md:1-33](file://AI沟通记录/2026-06-05-Chat.md#L1-L33)
  • [AI沟通记录/2026-06-06_沟通记录.md:1-52](file://AI沟通记录/2026-06-06_沟通记录.md#L1-L52)
  • [AI沟通记录/2026-06-08_沟通记录.md:1-10](file://AI沟通记录/2026-06-08_沟通记录.md#L1-L10)

决策清单与基线管理 ​

  • 待确认决策清单：用于评审与决策，标注优先级（P0/P1/P2）、推荐方案与最终选择，形成需求变更的候选集
  • 决策变更清单：已确认的决策变更，作为需求基线，指导后续设计与实现
mermaid
flowchart TD
Start(["开始"]) --> Draft["收集待确认决策<br/>待确认决策清单.md"]
Draft --> Review["评审与决策<br/>P0/P1/P2 分类"]
Review --> Confirm["确认并固化<br/>决策变更清单.md"]
Confirm --> Baseline["形成需求基线"]
Baseline --> Propagate["传播与更新文档<br/>文档/Readme.md"]
Baseline --> Task["更新任务与测试<br/>任务和测试过程/Readme.md"]
Propagate --> Version["版本治理<br/>rearrange_* 脚本"]
Task --> Version
Version --> End(["结束"])

图表来源

  • [待确认决策清单.md:1-523](file://待确认决策清单.md#L1-L523)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)
  • [文档/Readme.md:1-3](file://文档/Readme.md#L1-L3)
  • [任务和测试过程/Readme.md:1-3](file://任务和测试过程/Readme.md#L1-L3)
  • [rearrange_chapters.py:1-89](file://rearrange_chapters.py#L1-L89)
  • [rearrange_v2.py:1-104](file://rearrange_v2.py#L1-L104)
  • [rearrange_v3.py:1-159](file://rearrange_v3.py#L1-L159)

章节来源

  • [待确认决策清单.md:1-523](file://待确认决策清单.md#L1-L523)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)

文档与任务管理 ​

  • 文档/Readme.md：存放需求分析、架构设计与API说明等文档，作为需求到设计的映射载体
  • 任务和测试过程/Readme.md：记录需求分析、原型设计、编码测试等各阶段任务与执行状态，支撑需求到测试的映射
mermaid
classDiagram
class 需求文档 {
+标题
+摘要
+章节
+版本
}
class 任务与测试 {
+任务清单
+执行状态
+测试用例
}
class 决策基线 {
+已确认决策
+变更影响
+传播范围
}
需求文档 --> 决策基线 : "映射到基线"
任务与测试 --> 决策基线 : "映射到基线"

图表来源

  • [文档/Readme.md:1-3](file://文档/Readme.md#L1-L3)
  • [任务和测试过程/Readme.md:1-3](file://任务和测试过程/Readme.md#L1-L3)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)

章节来源

  • [文档/Readme.md:1-3](file://文档/Readme.md#L1-L3)
  • [任务和测试过程/Readme.md:1-3](file://任务和测试过程/Readme.md#L1-L3)

版本治理与文档规范化 ​

  • Python脚本用于文档章节重排与规范化，确保需求文档的结构一致性与版本控制
  • 通过脚本实现“章节顺序校正、重复章节清理、段落边界规范化”，提升需求文档的可读性与可追溯性
mermaid
flowchart TD
A["读取文档内容"] --> B["识别章节标题与范围"]
B --> C{"存在重复章节?"}
C --> |是| D["删除重复章节段"]
C --> |否| E["保留原始段"]
D --> F["按正确顺序重组"]
E --> F
F --> G["写回文档并输出统计"]

图表来源

  • [rearrange_chapters.py:1-89](file://rearrange_chapters.py#L1-L89)
  • [rearrange_v2.py:1-104](file://rearrange_v2.py#L1-L104)
  • [rearrange_v3.py:1-159](file://rearrange_v3.py#L1-L159)

章节来源

  • [rearrange_chapters.py:1-89](file://rearrange_chapters.py#L1-L89)
  • [rearrange_v2.py:1-104](file://rearrange_v2.py#L1-L104)
  • [rearrange_v3.py:1-159](file://rearrange_v3.py#L1-L159)

依赖分析 ​

  • 需求来源依赖AI沟通记录与提示词，形成需求输入
  • 决策清单依赖需求输入，形成需求变更候选
  • 决策变更清单依赖评审结果，形成需求基线
  • 文档与任务依赖需求基线，形成设计与测试映射
  • 版本治理脚本依赖文档结构，确保文档一致性
mermaid
graph LR
CHAT["AI沟通记录"] --> DRAFT["待确认决策清单"]
PROMPT["提示词"] --> DRAFT
DRAFT --> CONFIRM["决策变更清单"]
CONFIRM --> DOC["文档/Readme.md"]
CONFIRM --> TASK["任务和测试过程/Readme.md"]
DOC --> REARR["rearrange_* 脚本"]
TASK --> REARR

图表来源

  • [AI沟通记录/2026-06-03-Chat.md:1-6](file://AI沟通记录/2026-06-03-Chat.md#L1-L6)
  • [AI沟通记录/2026-06-05-Chat.md:1-33](file://AI沟通记录/2026-06-05-Chat.md#L1-L33)
  • [AI沟通记录/2026-06-06_沟通记录.md:1-52](file://AI沟通记录/2026-06-06_沟通记录.md#L1-L52)
  • [AI沟通记录/2026-06-08_沟通记录.md:1-10](file://AI沟通记录/2026-06-08_沟通记录.md#L1-L10)
  • [提示词.txt:1-144](file://提示词.txt#L1-L144)
  • [待确认决策清单.md:1-523](file://待确认决策清单.md#L1-L523)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)
  • [文档/Readme.md:1-3](file://文档/Readme.md#L1-L3)
  • [任务和测试过程/Readme.md:1-3](file://任务和测试过程/Readme.md#L1-L3)
  • [rearrange_chapters.py:1-89](file://rearrange_chapters.py#L1-L89)
  • [rearrange_v2.py:1-104](file://rearrange_v2.py#L1-L104)
  • [rearrange_v3.py:1-159](file://rearrange_v3.py#L1-L159)

章节来源

  • [待确认决策清单.md:1-523](file://待确认决策清单.md#L1-L523)
  • [决策变更清单.md:1-235](file://决策变更清单.md#L1-L235)
  • [文档/Readme.md:1-3](file://文档/Readme.md#L1-L3)
  • [任务和测试过程/Readme.md:1-3](file://任务和测试过程/Readme.md#L1-L3)
  • [rearrange_chapters.py:1-89](file://rearrange_chapters.py#L1-L89)
  • [rearrange_v2.py:1-104](file://rearrange_v2.py#L1-L104)
  • [rearrange_v3.py:1-159](file://rearrange_v3.py#L1-L159)

性能考量 ​

  • 文档重排脚本的性能取决于文档行数与正则匹配复杂度，建议：
    • 控制单次重排文档规模，避免超大文件导致正则匹配耗时
    • 使用稳定的章节标题模式，减少误匹配与回溯
    • 在CI中定时运行重排脚本，避免频繁手工执行

[本节为通用建议，不直接分析具体文件]

故障排查指南 ​

  • Git推送失败（权限问题）：
    • 现象：推送时报错“Permission denied (publickey)”
    • 处理：生成SSH密钥并绑定至GitHub账号，保存后重新推送
  • 文档章节顺序异常：
    • 现象：章节顺序错乱或重复
    • 处理：使用重排脚本清理重复章节并按正确顺序重组

章节来源

  • [AI沟通记录/2026-06-05-Chat.md:1-33](file://AI沟通记录/2026-06-05-Chat.md#L1-L33)
  • [AI沟通记录/2026-06-06_沟通记录.md:1-52](file://AI沟通记录/2026-06-06_沟通记录.md#L1-L52)
  • [rearrange_chapters.py:1-89](file://rearrange_chapters.py#L1-L89)
  • [rearrange_v2.py:1-104](file://rearrange_v2.py#L1-L104)
  • [rearrange_v3.py:1-159](file://rearrange_v3.py#L1-L159)

结论 ​

通过AI沟通记录与决策清单的协同，结合需求文档与任务测试的映射，以及版本治理脚本的规范化，承兑平台实现了从需求输入到交付验证的全流程可追溯。建议持续完善CCB机制与变更影响评估，确保需求变更对进度与成本的影响可控，并通过基线管理与评审流程保障需求质量与一致性。

[本节为总结性内容，不直接分析具体文件]

附录 ​

需求追踪矩阵（RTM）模板 ​

  • 需求ID：来自决策清单中的编号（如D1、D2…）
  • 需求描述：对应决策项的问题与方案
  • 来源：AI沟通记录/提示词
  • 优先级：P0/P1/P2
  • 状态：待评审/已评审/已确认/已实现/已验证
  • 设计映射：文档/Readme.md中的对应章节
  • 测试映射：任务和测试过程/Readme.md中的测试用例
  • 基线版本：决策变更清单的版本号
  • 变更记录：变更原因、影响范围、责任人

[本节为模板说明，不直接分析具体文件]

需求变更管理流程 ​

  • 提交流程：AI沟通记录与提示词作为输入，形成变更请求
  • 评审流程：待确认决策清单评审，P0阻塞性问题优先处理
  • 批准与基线：CCB批准后固化为决策变更清单，形成需求基线
  • 传播与更新：更新文档与任务，执行版本治理脚本
  • 验证与关闭：测试验证通过后关闭变更
mermaid
sequenceDiagram
participant U as "用户/提出者"
participant AI as "AI助手"
participant CCB as "变更控制委员会"
participant DOC as "文档/任务"
participant VER as "测试验证"
U->>AI : 提出需求变更
AI-->>U : 记录并纳入待确认清单
AI->>CCB : 提交评审
CCB-->>AI : 评审结果(批准/拒绝/修订)
AI->>DOC : 更新文档与任务
AI->>VER : 执行测试验证
VER-->>AI : 验证结果(通过/不通过)
AI-->>U : 变更关闭/进入下一周期

[本图为概念流程，不直接映射具体文件]