48 lines
2.4 KiB
Markdown
48 lines
2.4 KiB
Markdown
# 需求分析-2026-05-25-12-30-27
|
|
|
|
## 开始时间
|
|
|
|
2026-05-25-12-30-27
|
|
|
|
## 原始需求摘要
|
|
|
|
用户要求修改 `3. 代码汇总.docx`：不需要收录所有代码，选取约 10000 行左右即可；文档中的代码不能出现大量 `...` 省略占位，必须整理为无省略、连续、逻辑完整的源程序内容，函数体和类定义不能被 `...` 截断。
|
|
|
|
## 业务目标
|
|
|
|
生成符合软著源程序材料要求的代码汇总文档，使用项目真实源码的完整连续内容替换原有删减摘录，降低因省略号占位导致材料不合规的风险。
|
|
|
|
## 输入与输出
|
|
|
|
- 输入：现有 `3. 代码汇总.docx`、项目源码、既有工程分析文档。
|
|
- 输出：更新后的 `3. 代码汇总.docx`，本次需求分析、实现方案、测试方案，以及追加后的经验记录和备份 commit。
|
|
|
|
## 影响范围
|
|
|
|
- 主要影响 `3. 代码汇总.docx` 文档内容。
|
|
- 新增 `工程分析/需求分析-2026-05-25-12-30-27.md`、`工程分析/实现方案-2026-05-25-12-30-27.md`、`工程分析/测试方案-2026-05-25-12-30-27.md`。
|
|
- 完成后追加 `工程分析/经验记录.md`。
|
|
- 不修改 WebSite 业务源码。
|
|
|
|
## 关键约束
|
|
|
|
- 必须先遵守 `工程分析/代码编纂工作流.md`。
|
|
- 本次时间戳统一使用 `2026-05-25-12-30-27`。
|
|
- 选取约 10000 行真实源码，且不使用 `...` 作为省略占位。
|
|
- 尽量选完整文件，保证函数体、类型定义和模块逻辑连续完整。
|
|
- Git 提交只包含本次相关文档和明确修改文件，避免混入医学数据、运行态导出或无关改动。
|
|
- 修改完成后需执行构建、重新部署并验证服务。
|
|
|
|
## 风险点
|
|
|
|
- docx 是二进制文档，修改后需要确认能被 Word/LibreOffice 正常解析。
|
|
- TypeScript/React 源码本身可能存在合法的扩展运算符 `...`，需要区分“省略占位”和真实代码语法；若最终材料希望完全不出现三个点字符，应优先选取或转换不含该字符的代码来源。
|
|
- 文档行数过多会增大 docx 体积，但约 10000 行仍在可接受范围。
|
|
- 当前 `3. 代码汇总.docx` 在 Git 状态中为未跟踪文件，备份 commit 时需明确纳入。
|
|
|
|
## 待确认问题或默认假设
|
|
|
|
- 默认保留原文件名 `3. 代码汇总.docx`，直接覆盖其正文内容。
|
|
- 默认将“约 10000 行”理解为可在 9000 至 11000 行附近浮动，优先保证完整文件和无省略占位。
|
|
- 默认不额外改动项目功能源码。
|