Files
SPHLite/todo.md
T
2026-07-03 08:30:27 +08:00

149 lines
7.2 KiB
Markdown

# 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:基线与版本状态
- [x] 确认当前 git 状态并记录 0.2.2 开发起点。
- [x] 确认 0.2.1 最终本地提交可作为 0.2.2 基线。
- [x] 确认 `docs/v2.2_development_plan.md` 与 01-06 号文档无范围冲突。
- [x] 确认 0.2.2 不新增 Gas 生产求解路径。
- [x] 确认 0.2.2 不新增 Explosive 生产算法。
- [x] 确认 0.2.2 不新增 Solid 生产求解路径。
- [x] 确认 0.2.2 不新增 Shell 生产求解路径。
- [x] 确认 0.2.2 不新增真实 FEM-SPH 耦合运行。
- [x] 确认 0.2.2 不新增几何、网格或粒子生成目录。
- [x] 记录 0.2.2 是否作为实际补丁版本发布的初始判断。
## 阶段 B:版本号与发布文档
- [x] 将核心软件版本更新或确认到 `0.2.2`。
- [x] 将 CMake 项目版本更新或确认到 `0.2.2`。
- [x] 更新或确认 CLI `--version` 的 0.2.2 期望。
- [x] 更新或确认 Fortran smoke 测试中的版本期望。
- [x] 更新或确认 C API 测试中的版本期望。
- [x] 更新或确认 C++ API 测试中的版本期望。
- [x] 更新或确认 Python debug 测试中的版本期望。
- [x] 更新 README 中的当前版本与 0.2.2 定位说明。
- [x] 更新 `docs/09_release_history.md` 中的 0.2.2 条目。
- [x] 更新 `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 变更。