Files
SPHLite/todo.md
T
2026-07-04 00:49:18 +08:00

208 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SPHLite TODO
当前目标版本:0.7.1
本文档面向用户指定的 `docs/v7.1_development_plan.md`。当前仓库中暂未检出该计划文件;补入后应首先复核本清单,并按计划文件修正版本范围、gate 名称和不交付边界。
在 `docs/v7.1_development_plan.md` 缺失期间,本清单按 01-06 号文档、0.7.0 已发布边界、README 当前状态和 0.7.0 blast 实现现状拆分。0.7.1 暂定位为局部爆炸链路稳定化版本:在 0.7.0 小型 Water/Gas/Explosive/Solid/Shell smoke 起点之上,加固多 blast region、载荷叠加、诊断一致性、restart 边界和 release gate,不进入 0.8 FEM-SPH 接触耦合,也不宣称工程级水下接触爆炸响应。
所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。核心代码继续遵守 Fortran95 约束,C/C++/Python 接口只在语义冻结后再扩展。执行约定:每完成一个阶段,进行一次本地 git 提交,暂不推送远端,除非用户另行要求。
## 阶段 A:0.7.1 基线、计划复核和版本边界
- [x] 确认当前 git 工作区状态并记录已有未提交内容。
- [x] 确认 `v0.7.0` 标签和远端发布提交可作为 0.7.1 开发基线。
- [x] 检查 `docs/v7.1_development_plan.md` 是否已补入仓库。
- [x] 若 `docs/v7.1_development_plan.md` 仍缺失,在本清单顶部保留复核提示。
- [x] 若 `docs/v7.1_development_plan.md` 已补入,逐条比对并修正本清单范围。
- [x] 确认 0.7.1 定位为局部爆炸稳定化版本,而不是 0.8 耦合版本。
- [x] 确认 0.7.1 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- [x] 确认 0.7.1 不交付工程级船舱水下接触爆炸 benchmark。
- [x] 将核心 Fortran 版本号更新为 `0.7.1`。
- [x] 将 CMake 项目版本更新为 `0.7.1`。
- [x] 更新 Fortran smoke 测试中的版本期望。
- [x] 更新 C API 测试中的版本期望。
- [x] 更新 C++ API 测试中的版本期望。
- [x] 更新 Python debug 测试中的版本期望。
- [x] 更新 CLI `--version` 和 inspect 版本期望。
- [x] 更新 README 当前开发版本为 `0.7.1`。
- [x] 在 README 中说明 0.7.1 的局部爆炸稳定化范围。
- [x] 在 README 中说明 0.7.1 的不交付边界。
- [x] 准备 0.7.1 release gate 的初始测试名称清单。
- [x] 准备阶段 A 本地提交说明。
## 阶段 B:blast region 输入稳定化和多区域控制
- [x] 复核现有 `*SPHLITE BLAST REGION` 关键词字段。
- [x] 明确 0.7.1 多 blast region 的输入语义。
- [x] 明确 blast region 名称唯一性规则。
- [x] 明确重复 blast region 名称的 error 路径。
- [x] 明确 blast region 最大数量超过上限的 error 路径。
- [x] 明确 `ENABLED` 或等价启停字段的默认值。
- [x] 明确源 phase 默认值仍保持 0.7.0 行为。
- [x] 明确目标 phase 默认值仍保持 0.7.0 行为。
- [x] 明确 `TARGET SET` 缺失时继续报 error。
- [x] 明确空 target set 的 warning 或 no-op 规则。
- [x] 明确中心坐标必须为有限值。
- [x] 明确半径必须为正有限值。
- [x] 明确载荷比例系数必须为有限值。
- [x] 明确时间窗必须为非负有限值。
- [x] 明确未知 source phase 的 error 路径。
- [x] 明确未知 target phase 的 error 路径。
- [x] 明确未知 projection mode 的 error 路径。
- [x] 支持同一输入文件中读取多个 blast region。
- [x] 保持单 region 0.7.0 输入样例兼容。
- [x] 新增 `input_blast_multiregion` 测试。
- [x] 新增 `input_blast_region_errors_071` 测试。
- [x] 将 0.7.1 blast 输入测试接入 CTest。
- [x] 准备阶段 B 本地提交说明。
## 阶段 C:源项快照、目标筛选和多区域诊断
- [x] 复核现有 blast source snapshot 数据结构。
- [x] 确认 source snapshot 按 region 独立刷新。
- [x] 统计每个 region 内 active Water 源粒子数量。
- [x] 统计每个 region 内 active Gas 源粒子数量。
- [x] 统计每个 region 内 active Explosive 源粒子数量。
- [x] 统计每个 region 内源粒子总质量。
- [x] 统计每个 region 内源粒子总能量。
- [x] 统计每个 region 内 Water 压力范围。
- [x] 统计每个 region 内 Gas 总体积。
- [x] 统计每个 region 内 Explosive 平均反应进度。
- [x] 对 region 外源粒子执行跳过计数。
- [x] 对非 active 源粒子执行跳过计数。
- [x] 对不匹配 source phase 的粒子执行跳过计数。
- [x] 确认无源粒子时返回安全默认诊断。
- [x] 复核现有 blast target 筛选规则。
- [x] 确认 target 筛选按 region 独立执行。
- [x] 按 target set 筛选结构粒子。
- [x] 按 target phase 筛选 Solid 和 Shell 粒子。
- [x] 跳过 failed Solid 目标并记录计数。
- [x] 跳过 failed Shell 目标并记录计数。
- [x] 确认无目标粒子时返回安全默认诊断。
- [x] 新增 `blast_multiregion_snapshot` 测试。
- [x] 新增 `blast_multiregion_target_filter` 测试。
- [x] 将源项和目标筛选测试接入 CTest。
- [x] 准备阶段 C 本地提交说明。
## 阶段 D:结构载荷缓存、叠加和守恒诊断
- [x] 复核现有 Solid 外载荷缓存数组布局。
- [x] 复核现有 Shell 外载荷缓存数组布局。
- [x] 确认每个显式步开始前清零 blast 外载荷缓存。
- [x] 确认禁用 blast load 时缓存保持零值。
- [x] 支持多个 blast region 对同一 Solid 目标载荷叠加。
- [x] 支持多个 blast region 对同一 Shell 目标载荷叠加。
- [x] 保持 Solid 和 Shell 外载荷缓存相互隔离。
- [x] 保持 Water 粒子不被结构外载荷缓存污染。
- [x] 保持 Gas 粒子不被结构外载荷缓存污染。
- [x] 保持 Explosive 粒子不被结构外载荷缓存污染。
- [x] 统一距离权重归一化的零分母处理。
- [x] 统一非有限载荷贡献的跳过处理。
- [x] 记录每个 region 的载荷目标数。
- [x] 记录每个 region 的载荷 pair 数。
- [x] 记录每个 region 的零权重 pair 数。
- [x] 记录每个 region 的非有限贡献数。
- [x] 记录每个 region 的总力。
- [x] 记录每个 region 的 Solid 分力。
- [x] 记录每个 region 的 Shell 分力。
- [x] 记录每个 region 的冲量累计。
- [x] 记录每个 region 的做功累计。
- [x] 记录每个 region 的最大粒子力。
- [x] 新增 `blast_load_superposition` 测试。
- [x] 新增 `blast_load_diagnostics_071` 测试。
- [x] 将结构载荷稳定化测试接入 CTest。
- [x] 准备阶段 D 本地提交说明。
## 阶段 E:Velocity-Verlet 接入、时间窗和响应回归
- [x] 复核 blast load 在 Velocity-Verlet 显式步中的调用顺序。
- [x] 确认 Explosive 更新早于 blast source snapshot。
- [x] 确认 Gas 源项应用早于结构载荷投影。
- [x] 确认 Water 压力更新早于结构载荷投影。
- [x] 确认 Gas 压力更新早于结构载荷投影。
- [x] 确认 blast load 只在时间窗内生效。
- [x] 确认时间窗结束后外载荷缓存清零。
- [x] 确认禁用 blast load 时完整显式步保持 no-op。
- [x] 将 Solid blast 外载荷并入 Solid 加速度路径。
- [x] 保持 Solid-only 无 blast 输入回归结果不变。
- [x] 将 Shell blast 平动外载荷并入 Shell 受控入口。
- [x] 保持 Shell director 不被 blast 外载荷非法修改。
- [x] 保持 Shell 内力路径仍不宣称完整闭环。
- [x] 验证 Solid/Shell 混合目标的载荷隔离。
- [x] 验证多个 region 叠加后的 Solid 响应方向。
- [x] 验证多个 region 叠加后的 Shell 响应方向。
- [x] 验证 failed Solid 目标不产生响应。
- [x] 验证 failed Shell 目标不产生响应。
- [x] 验证 Water-only 模型不进入结构载荷路径。
- [x] 验证 Gas-only 模型不进入结构载荷路径。
- [x] 验证 Explosive-only 模型不进入结构载荷路径。
- [x] 新增 `blast_solver_order_071` 测试。
- [x] 新增 `blast_response_multiregion` 测试。
- [x] 新增 `blast_noop_regression_071` 测试。
- [x] 将显式推进回归测试接入 CTest。
- [x] 准备阶段 E 本地提交说明。
## 阶段 F:输出、restart 边界和公开接口策略
- [x] 复核 0.7.0 summary CSV blast 字段。
- [x] 扩展 summary CSV 的多 region 输出规则。
- [x] 保持单 region summary CSV 字段兼容。
- [x] 为多 region 输出记录 region 数量。
- [x] 为多 region 输出记录每个 region 的源粒子数量。
- [x] 为多 region 输出记录每个 region 的目标粒子数量。
- [x] 为多 region 输出记录每个 region 的总力。
- [x] 为多 region 输出记录每个 region 的能量输入。
- [x] 为多 region 输出记录每个 region 的跳过计数。
- [x] 复核 particle CSV blast 外载荷字段。
- [x] 确认 particle CSV 输出叠加后的粒子外载荷。
- [x] 确认默认未开启输出时不生成临时结果文件。
- [x] 明确 0.7.1 是否新增正式 blast restart state。
- [x] 若不新增正式 state,保持 `STATE_0_7` 未冻结边界并补充测试。
- [x] 若新增正式 state,保存 blast 控制、诊断和外载荷缓存。
- [x] 若新增正式 state,验证读回后继续显式步一致。
- [x] 保持既有 restart 兼容读入路径稳定。
- [x] 明确 0.7.1 不新增公开 C ABI blast 稳定接口。
- [x] 明确 0.7.1 不新增 C++ wrapper blast 稳定接口。
- [x] 明确 0.7.1 不新增 Python blast 稳定接口。
- [x] 保留 Fortran 内部 blast summary 查询入口。
- [x] 新增 `blast_output_071` 测试。
- [x] 新增 `blast_restart_boundary_071` 或 `blast_restart_071` 测试。
- [x] 将输出和 restart 测试接入 CTest。
- [x] 准备阶段 F 本地提交说明。
## 阶段 G:smoke、门禁、文档和发布准备
- [x] 设计 0.7.1 多 region 局部爆炸 smoke 样例。
- [x] 新增 Solid 多 region blast smoke 输入样例。
- [x] 新增 Shell 多 region blast smoke 输入样例。
- [x] 新增 Solid/Shell 混合多 region blast smoke 输入样例。
- [x] 新增禁用 blast load 的 smoke 回归样例。
- [x] 新增空 target set 或无 active target 的 smoke 样例。
- [x] 验证 smoke 中所有粒子状态保持有限。
- [x] 验证 smoke 中 Explosive 反应进度单调或受控。
- [x] 验证 smoke 中 Gas 体积和压力诊断方向受控。
- [x] 验证 smoke 中 Solid/Shell 载荷方向受控。
- [x] 验证 smoke 中冲量和能量诊断为有限值。
- [x] 新增 `blast_smoke_071` 测试。
- [x] 运行 Water 回归 gate。
- [x] 运行 Gas 回归 gate。
- [x] 运行 Explosive 回归 gate。
- [x] 运行 Solid 回归 gate。
- [x] 运行 Shell 回归 gate。
- [x] 运行 0.7.0 blast 回归 gate。
- [x] 运行 0.7.1 blast 专项 gate。
- [x] 运行完整 CTest。
- [x] 运行 source size 相关 gate。
- [x] 运行 `git diff --check`。
- [x] 检查代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖。
- [x] 检查输出目录、CSV、VTK、restart 和临时结果未被提交。
- [x] 更新 `docs/06_test_and_verification_plan.md` 的 0.7.1 release gate。
- [x] 更新 `docs/09_release_history.md` 的 0.7.1 本地验收记录。
- [x] 更新 `docs/11_benchmark_matrix.md` 的 0.7.1 gate 矩阵。
- [x] 更新 README 的 0.7.1 当前状态和不交付范围。
- [x] 确认文档不宣称真实 FEM-SPH 联合运行。
- [x] 确认文档不宣称工程级船舱破坏 benchmark。
- [x] 准备 0.7.1 发布提交说明。
- [x] 准备阶段 G 本地提交说明。