Files
SPHLite/todo.md
T
2026-07-03 08:45:16 +08:00

7.2 KiB
Raw Permalink Blame History

SPHLite TODO

当前目标版本:0.2.2

本文档依据 docs/v2.2_development_plan.md 拆分。0.2.2 定位为 0.2 Water 阶段后的补丁、稳定化与 0.3.0 Gas 开发前的交接版本。所有事项均应限制在 SPHLite 文件夹内完成,不修改外部模块,不引入 FEMLite 直接依赖,不新增几何、网格或粒子生成能力。

执行约定:每完成 20 个待办事项,进行一次本地 git 提交,暂不推送远端。

阶段 A:基线与版本状态

  • 确认当前 git 状态并记录 0.2.2 开发起点。
  • 确认 0.2.1 最终本地提交可作为 0.2.2 基线。
  • 确认 docs/v2.2_development_plan.md 与 01-06 号文档无范围冲突。
  • 确认 0.2.2 不新增 Gas 生产求解路径。
  • 确认 0.2.2 不新增 Explosive 生产算法。
  • 确认 0.2.2 不新增 Solid 生产求解路径。
  • 确认 0.2.2 不新增 Shell 生产求解路径。
  • 确认 0.2.2 不新增真实 FEM-SPH 耦合运行。
  • 确认 0.2.2 不新增几何、网格或粒子生成目录。
  • 记录 0.2.2 是否作为实际补丁版本发布的初始判断。

阶段 B:版本号与发布文档

  • 将核心软件版本更新或确认到 0.2.2。
  • 将 CMake 项目版本更新或确认到 0.2.2。
  • 更新或确认 CLI --version 的 0.2.2 期望。
  • 更新或确认 Fortran smoke 测试中的版本期望。
  • 更新或确认 C API 测试中的版本期望。
  • 更新或确认 C++ API 测试中的版本期望。
  • 更新或确认 Python debug 测试中的版本期望。
  • 更新 README 中的当前版本与 0.2.2 定位说明。
  • 更新 docs/09_release_history.md 中的 0.2.2 条目。
  • 更新 docs/11_benchmark_matrix.md 中的 0.2.2 gate 记录占位。

阶段 C:文档一致性复核

  • 复核 README 未宣称 0.2.2 已实现 Gas 生产能力。
  • 复核 README 未宣称 0.2.2 已实现 Explosive 生产能力。
  • 复核 README 未宣称 0.2.2 已实现 Solid 生产能力。
  • 复核 README 未宣称 0.2.2 已实现 Shell 生产能力。
  • 复核 README 未宣称 0.2.2 已实现真实 FEM-SPH 耦合。
  • 复核 01 号文档中长期目标与 0.2.2 交付范围区分清楚。
  • 复核 02 号文档中求解器定位与 0.2.2 范围一致。
  • 复核 03 号文档中集中型数据管理描述与当前代码一致。
  • 复核 04 号文档中 Water 算法策略与当前代码一致。
  • 复核 05-06 号文档中接口和测试边界与 0.2.2 一致。

阶段 D:输入解析回归

  • 复核 Abaqus 子集解析仍不追求完整 Abaqus 兼容。
  • 复核可复用 Abaqus 关键词时未新增重复 SPHLite 关键词。
  • 复核 unsupported-but-safe 关键词继续报 warning。
  • 复核缺失必要关键词时继续报 error。
  • 复核输入错误信息仍包含足够定位上下文。
  • 复核 *MATERIAL, TYPE=WATER 大小写兼容。
  • 复核 Water material 与 *DENSITY 绑定校验。
  • 复核 *SECTION material 引用存在性校验。
  • 复核 *SPHLITE EOS, TYPE=TAIT 校验。
  • 复核 *SPHLITE TIME CONTROL 正值校验。

阶段 E:数据模型与邻域回归

  • 复核集中型粒子数据管理未被绕开。
  • 复核 Water、Gas、Explosive、Solid、Shell 共享基础粒子数据结构。
  • 复核 Water 计算路径不依赖 Gas 状态变量。
  • 复核 phase 改变机制不引入新的不可控相变模型。
  • 复核 inactive 粒子不参与 Water 相互作用。
  • 复核 failed 粒子不参与 Water 相互作用。
  • 复核粒子 h(i) 的独立支持仍可用。
  • 复核 kernel 在 h <= 0 时保持错误路径。
  • 复核 neighbor 搜索在重复坐标粒子下保持稳定。
  • 复核 neighbor 搜索在稀疏粒子布局下保持稳定。

阶段 F:Water 数值行为回归

  • 复核 Water 密度仍采用连续性方程更新。
  • 复核 summation density 未进入主求解流程。
  • 复核默认 Water EOS 仍为 Tait 模型。
  • 复核 B 未显式给定时仍由 rho0*c0*c0/gamma 推导。
  • 复核显式给定 B 时结果保持当前策略。
  • 复核 rho < rho0 时继续保留负压。
  • 复核 0.2.2 不新增压力截断策略。
  • 复核 0.2.2 不新增空化生产模型。
  • 复核人工黏性参数和诊断行为保持 0.2.1 兼容。
  • 复核 pressure wave smoke 不被扩展为工程精度 benchmark。

阶段 G:求解、输出与重启动

  • 复核显式时间推进仍采用 Velocity-Verlet 路线。
  • 复核 0.2.2 不引入隐式求解器。
  • 复核 stable dt 诊断仍覆盖 CFL、加速度和黏性约束。
  • 复核 TIME 与 STEPS 双约束运行逻辑。
  • 复核最后小步不超过 end_time。
  • 复核粒子 CSV 输出字段保持 0.2.1 兼容。
  • 复核 summary CSV 输出字段保持 0.2.1 兼容。
  • 复核手动输出不改变物理状态。
  • 复核 restart 写入 Water 求解关键状态。
  • 复核 restart 读回后可继续 Water 显式步。

阶段 H:接口与耦合边界

  • 复核 Fortran 公共 API 保持 0.2.1 兼容。
  • 复核 C ABI 头文件保持 0.2.1 兼容。
  • 复核 C wrapper 不重新定义物理语义。
  • 复核 C++ wrapper 仍为轻量 RAII 封装。
  • 复核 Python wrapper 仍通过 C ABI 调用。
  • 复核 Python 不直接访问 Fortran 内部符号。
  • 复核 CLI 不绕过公共生命周期接口。
  • 复核 CouplingInterface 不出现 FEMLite 内部结构依赖。
  • 复核 CouplingInterface 命名不绑定外部模块最终名称。
  • 复核默认 gate 不运行真实 FEM-SPH 联合测试。

阶段 I:测试门禁

  • 完整配置 CMake 构建目录。
  • 完整编译 sphlite_core。
  • 完整编译 sphlite_c。
  • 完整编译 sphlite_c_shared。
  • 完整编译 sphlite CLI。
  • 完整编译 Fortran 测试目标。
  • 完整编译 C/C++ 测试目标。
  • 运行默认 gate 中的 smoke 测试。
  • 运行默认 gate 中的 input 测试。
  • 运行默认 gate 中的 Water 数值测试集合。
  • 运行默认 gate 中的 output 与 restart 测试。
  • 运行默认 gate 中的 API 与 CLI 测试。
  • 运行默认 gate 中的 coupling_interface 测试。
  • 运行默认 gate 中的 pressure_wave_smoke 测试。
  • 运行 source_size 门禁。
  • 运行 git diff --check。

阶段 J:发布决策与 0.3.0 交接

  • 确认没有提交 build 目录。
  • 确认没有提交 Python 缓存。
  • 确认没有提交 CSV 临时结果。
  • 确认没有提交 restart 临时结果。
  • 确认没有提交 VTK 临时结果。
  • 记录 0.2.2 release gate 结果。
  • 记录 0.2.2 中实际修复的问题列表。
  • 记录 0.2.2 中未修复但可接受的剩余风险。
  • 整理 0.3.0 Gas 输入关键词草案入口。
  • 整理 0.3.0 Gas 状态变量清单入口。
  • 整理 0.3.0 Gas EOS 测试命名入口。
  • 整理 Water 与 Gas 共享数据但独立计算的边界说明。
  • 整理 Explosive 作用到 Gas 后形成 Bubble 的长期路线说明。
  • 给出 0.2.2 是否发布或跳过的最终建议。
  • 确认工作区只保留应提交的 0.2.2 变更。