Files
SPHLite/todo.md
T
2026-07-03 23:25:36 +08:00

246 lines
13 KiB
Markdown

# SPHLite TODO
当前目标版本:0.7.0
本文档面向用户指定的 `docs/v7.0_development_plan.md`。当前仓库中暂未检出该计划文件;待 `docs/v7.0_development_plan.md` 补入后,应先复核本文档。本清单暂按已发布的 0.6.1、01-06 号文档、`docs/v6.1_development_plan.md` 中的 0.7.0 后续路线拆分。0.7.0 暂定位为水-气-结构局部爆炸 smoke 起点,覆盖小型 Water/Gas/Explosive/Solid/Shell 链路。
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。0.7.0 不交付真实工程级水下接触爆炸响应,不交付真实 FEM-SPH 接触耦合或连续体耦合,不交付工程级船舱破坏 benchmark,不交付复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。
执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端。
## 阶段 A:版本基线、范围声明与 0.7.0 样例
- [x] 确认当前 git 状态并记录已有未提交内容。
- [x] 确认 `v0.6.1` 标签和远端发布提交可作为 0.7.0 开发基线。
- [x] 复核 `docs/v7.0_development_plan.md` 是否已补入仓库。
- [x] 若 `docs/v7.0_development_plan.md` 缺失,在 todo 顶部保留复核提示。
- [x] 将核心软件版本更新为 `0.7.0`。
- [x] 将 CMake 项目版本更新为 `0.7.0`。
- [x] 更新 Fortran smoke 测试中的版本期望。
- [x] 更新 C API 测试中的版本期望。
- [x] 更新 C++ API 测试中的版本期望。
- [x] 更新 Python debug 测试中的版本期望。
- [x] 更新 CLI `--version` 和 inspect 版本期望。
- [x] 在 README 中记录 0.7.0 水-气-结构局部爆炸 smoke 定位。
- [x] 在 README 中明确 0.7.0 不交付工程级爆炸响应。
- [x] 在 README 中明确 0.7.0 不交付真实 FEM-SPH 耦合。
- [x] 创建 Water/Gas/Explosive/Solid 最小混合输入样例。
- [x] 创建 Water/Gas/Explosive/Shell 最小混合输入样例。
- [x] 创建 Water/Gas/Explosive/Solid/Shell 混合输入样例。
- [x] 创建无结构粒子的局部爆炸 smoke 输入样例。
- [x] 创建无水粒子的 Gas/Explosive/Structure 错误或 warning 样例。
- [x] 创建无 Gas product material 的 Explosive 错误输入样例。
- [x] 创建结构载荷目标 set 缺失错误输入样例。
- [x] 创建结构载荷半径非法错误输入样例。
- [x] 创建结构载荷比例系数非有限错误输入样例。
- [x] 创建 Shell-only 受控爆炸载荷诊断样例。
- [x] 创建 Solid-only 受控爆炸载荷诊断样例。
- [x] 创建 Solid/Shell 混合载荷隔离样例。
- [x] 运行 0.6.1 完整 gate 并记录基线结果。
- [x] 准备阶段 A 本地提交说明。
## 阶段 B:0.7.0 输入控制、结构目标和局部爆炸区域
- [x] 设计 0.7.0 局部爆炸 smoke 的输入关键词边界。
- [x] 优先复用既有 Abaqus 子集表达材料、section、set 和 element 信息。
- [x] 定义 SPHLite 调试扩展关键词的最小集合。
- [x] 设计局部爆炸区域名称、中心和半径字段。
- [x] 设计结构载荷目标 set 或 elset 字段。
- [x] 设计结构载荷源 phase 过滤字段。
- [x] 设计结构载荷目标 phase 过滤字段。
- [x] 设计压力载荷比例系数字段。
- [x] 设计冲量或时间窗口控制字段。
- [x] 设计载荷投影模式字段。
- [x] 设计 Solid 和 Shell 目标共用的输入约定。
- [x] 支持读取局部爆炸区域控制参数。
- [x] 支持读取结构载荷目标集合名称。
- [x] 支持读取源相过滤参数。
- [x] 支持读取目标相过滤参数。
- [x] 支持读取载荷比例系数。
- [x] 支持读取载荷时间窗口。
- [x] 支持读取载荷投影模式。
- [x] 校验局部爆炸区域半径为正有限值。
- [x] 校验载荷比例系数为有限值。
- [x] 校验时间窗口为非负有限值。
- [x] 校验源 phase 名称合法。
- [x] 校验目标 phase 名称合法。
- [x] 校验目标 set 存在。
- [x] 对未被使用的局部爆炸控制项报 warning。
- [x] 对 active 结构粒子缺失载荷控制保持 no-op。
- [x] 新增 `input_blast_region` 测试。
- [x] 新增 `input_blast_errors` 测试。
- [x] 将输入控制测试接入 CTest。
- [x] 准备阶段 B 本地提交说明。
## 阶段 C:局部爆炸源项快照和载荷候选筛选
- [x] 设计局部爆炸源项快照数据结构。
- [x] 设计源粒子到结构粒子的邻域筛选规则。
- [x] 设计载荷候选计数诊断。
- [x] 设计载荷源相质量诊断。
- [x] 设计载荷源相能量诊断。
- [x] 设计载荷源相平均压力诊断。
- [x] 设计局部爆炸区域内 Gas 体积诊断。
- [x] 设计局部爆炸区域内 Explosive 反应进度诊断。
- [x] 设计局部爆炸区域内 Water 压力范围诊断。
- [x] 设计局部爆炸区域内结构目标数量诊断。
- [x] 在显式步前刷新 Water 压力快照。
- [x] 在显式步前刷新 Gas 压力快照。
- [x] 在 Explosive 更新后刷新 Gas 源项贡献快照。
- [x] 在载荷构造前刷新结构目标 active 状态。
- [x] 对非 active 源粒子执行跳过规则。
- [x] 对 failed 结构粒子执行受控跳过或保留规则。
- [x] 对非目标 set 结构粒子执行跳过规则。
- [x] 对局部爆炸区域外源粒子执行跳过规则。
- [x] 对局部爆炸区域外目标粒子执行跳过规则。
- [x] 确认无源粒子时返回安全默认诊断。
- [x] 确认无目标粒子时返回安全默认诊断。
- [x] 确认 Water-only 模型不进入结构载荷路径。
- [x] 确认 Gas-only 模型不进入结构载荷路径。
- [x] 确认 Explosive-only 模型不进入结构载荷路径。
- [x] 确认 Solid-only 模型不读取 Gas 源项。
- [x] 确认 Shell-only 模型不读取 Gas 源项。
- [x] 新增 `blast_source_snapshot` 测试。
- [x] 新增 `blast_target_filter` 测试。
- [x] 将源项快照测试接入 CTest。
- [x] 准备阶段 C 本地提交说明。
## 阶段 D:结构外载荷缓存、投影和守恒诊断
- [x] 设计结构外载荷缓存数组布局。
- [x] 设计 Solid 外载荷缓存字段。
- [x] 设计 Shell 外载荷缓存字段。
- [x] 设计载荷投影的方向约定。
- [x] 设计载荷投影的权重归一化约定。
- [x] 设计压力到力的面积或体积尺度约定。
- [x] 设计载荷做功诊断。
- [x] 设计载荷冲量诊断。
- [x] 设计载荷动量输入诊断。
- [x] 设计载荷能量输入诊断。
- [x] 初始化结构外载荷缓存默认值。
- [x] 在每个显式步开始前清零结构外载荷缓存。
- [x] 将局部 Water 压力贡献映射到候选结构目标。
- [x] 将局部 Gas 压力贡献映射到候选结构目标。
- [x] 将 Explosive release 诊断贡献映射到载荷统计。
- [x] 对 Solid 目标累加外力贡献。
- [x] 对 Shell 目标累加外力贡献。
- [x] 对 Shell 目标累加等效外力矩占位诊断。
- [x] 对权重和为零的候选对报 warning 或跳过。
- [x] 检查外载荷有限性。
- [x] 检查外载荷缓存不污染 Water 粒子。
- [x] 检查外载荷缓存不污染 Gas 粒子。
- [x] 检查外载荷缓存不污染 Explosive 粒子。
- [x] 检查 Solid/Shell 目标之间载荷隔离。
- [x] 检查无 active 结构目标时载荷统计为零。
- [x] 检查无局部爆炸源时载荷统计为零。
- [x] 新增 `blast_load_accumulator` 测试。
- [x] 新增 `blast_load_conservation` 测试。
- [x] 将结构外载荷测试接入 CTest。
- [x] 准备阶段 D 本地提交说明。
## 阶段 E:显式推进接入、Solid/Shell 响应和隔离规则
- [x] 设计局部爆炸载荷在 Velocity-Verlet 中的调用顺序。
- [x] 确认 Explosive 更新早于爆炸载荷投影。
- [x] 确认 Gas 源项应用早于结构载荷诊断。
- [x] 确认 Water/Gas 压力更新早于结构载荷投影。
- [x] 将 Solid 外载荷并入 Solid 加速度或外力入口。
- [x] 将 Shell 外载荷并入 Shell 受控外力入口。
- [x] 对尚未完成的 Shell 内力路径保持受控 no-op 或诊断占位。
- [x] 确认 Shell 外载荷不宣称完整 Shell 动力学闭环。
- [x] 确认 Solid 外载荷不改变既有 Solid-only gate 结果。
- [x] 确认 Shell 外载荷不改变既有 Shell 运动学 gate 结果。
- [x] 确认 Water-only 显式步结果保持稳定。
- [x] 确认 Gas-only 显式步结果保持稳定。
- [x] 确认 Explosive-Gas 显式步结果保持稳定。
- [x] 确认 Solid-only 显式步结果保持稳定。
- [x] 确认无载荷控制时完整显式步行为不变。
- [x] 添加局部爆炸载荷启用开关。
- [x] 添加局部爆炸载荷禁用路径测试。
- [x] 添加单步载荷施加测试。
- [x] 添加多步载荷累积测试。
- [x] 添加载荷时间窗口结束后清零测试。
- [x] 添加结构加速度方向检查测试。
- [x] 添加 Shell director 不被外载荷路径非法修改的测试。
- [x] 添加 failed Solid 目标处理测试。
- [x] 添加 failed Shell 目标处理测试。
- [x] 新增 `blast_solver_order` 测试。
- [x] 新增 `blast_solid_response` 测试。
- [x] 新增 `blast_shell_response` 测试。
- [x] 新增 `blast_noop_regression` 测试。
- [x] 将显式推进接入测试接入 CTest。
- [x] 准备阶段 E 本地提交说明。
## 阶段 F:诊断、输出、restart 占位和公开接口边界
- [ ] 设计 0.7.0 局部爆炸 summary 诊断结构。
- [ ] 记录局部爆炸区域 active 源粒子数。
- [ ] 记录局部爆炸区域 active 目标粒子数。
- [ ] 记录 Water 压力贡献统计。
- [ ] 记录 Gas 压力贡献统计。
- [ ] 记录 Explosive release 贡献统计。
- [ ] 记录 Solid 接收总载荷。
- [ ] 记录 Shell 接收总载荷。
- [ ] 记录结构载荷总冲量。
- [ ] 记录结构载荷总做功。
- [ ] 记录结构载荷最大粒子力。
- [ ] 记录结构载荷最大粒子加速度贡献。
- [ ] 记录被跳过源粒子数量。
- [ ] 记录被跳过目标粒子数量。
- [ ] 设计 summary CSV 的 0.7.0 调试字段。
- [ ] 将局部爆炸 summary 写入 summary CSV。
- [ ] 设计粒子 CSV 的 0.7.0 调试字段。
- [ ] 将结构外载荷字段写入粒子 CSV。
- [ ] 确认默认输出不开启时不生成临时结果。
- [ ] 设计 restart 中 0.7.0 状态边界。
- [ ] 明确 0.7.0 是否写入正式 `STATE_0_7`。
- [ ] 若写入 restart,保存局部爆炸控制和诊断状态。
- [ ] 若不写入 restart,在文档中明确为非交付范围。
- [ ] 保持 0.6.1 restart 兼容读入路径稳定。
- [ ] 设计 Fortran 内部诊断查询入口。
- [ ] 明确 C ABI 是否暴露 0.7.0 调试字段。
- [ ] 若暴露 C ABI,补齐小容量和空指针错误路径。
- [ ] 若不暴露 C ABI,在文档中明确为非交付范围。
- [ ] 新增 `blast_summary` 测试。
- [ ] 新增 `blast_output` 测试。
- [ ] 新增 `blast_restart_boundary` 测试。
- [ ] 将诊断输出测试接入 CTest。
- [ ] 准备阶段 F 本地提交说明。
## 阶段 G:局部爆炸 smoke、回归 gate 和文档发布准备
- [ ] 设计 0.7.0 局部爆炸 smoke 的最小物理链路。
- [ ] 设计 Water/Gas/Explosive/Solid smoke 验收指标。
- [ ] 设计 Water/Gas/Explosive/Shell smoke 验收指标。
- [ ] 设计 Water/Gas/Explosive/Solid/Shell smoke 验收指标。
- [ ] 实现单步局部爆炸 smoke 测试。
- [ ] 实现多步局部爆炸 smoke 测试。
- [ ] 检查 smoke 中 Gas 体积或压力统计方向。
- [ ] 检查 smoke 中 Explosive 反应进度单调性。
- [ ] 检查 smoke 中 Solid/Shell 载荷方向。
- [ ] 检查 smoke 中载荷冲量非负或受控。
- [ ] 检查 smoke 中能量诊断有限性。
- [ ] 检查 smoke 中所有粒子状态有限性。
- [ ] 运行 Water 回归 gate。
- [ ] 运行 Gas 回归 gate。
- [ ] 运行 Explosive 回归 gate。
- [ ] 运行 Solid 回归 gate。
- [ ] 运行 Shell 0.6.1 回归 gate。
- [ ] 运行 CouplingInterface 回归 gate。
- [ ] 运行 output 回归 gate。
- [ ] 运行 restart 回归 gate。
- [ ] 运行完整 CTest。
- [ ] 运行 0.7.0 局部爆炸专项 gate。
- [ ] 运行 source size 相关 gate。
- [ ] 运行 `git diff --check`。
- [ ] 更新 README 中 0.7.0 当前状态和不交付范围。
- [ ] 更新 `docs/06_test_and_verification_plan.md` 的 0.7.0 release gate。
- [ ] 更新 `docs/09_release_history.md` 的 0.7.0 本地验收记录。
- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.7.0 gate 矩阵。
- [ ] 确认文档不宣称工程级水下接触爆炸响应。
- [ ] 确认文档不宣称真实 FEM-SPH 联合运行。
- [ ] 确认文档不宣称完整舱段破坏 benchmark。
- [ ] 确认输出目录、CSV、VTK、restart 和临时结果未提交。
- [ ] 确认代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。
- [ ] 准备 0.7.0 发布提交说明。