Files
SPHLite/docs/06_test_and_verification_plan.md
2026-07-05 21:41:34 +08:00

566 lines
32 KiB
Markdown
Raw Permalink 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.
# 06 测试与验证计划
文档状态:0.7.1 gate 记录
## 1. 测试原则
SPHLite 测试体系仿照 FEMLite,采用 CMake + CTest + Python checker + release gate。求解器、粒子/单元语义、材料和物理模块等算法核心使用 Fortran 95;worker、CLI、IPC 等外围集成层及其测试/工具性 Fortran 代码可使用 Fortran 2018,但不得倒逼核心模块引入 Fortran 2018 语法。C ABI、C++ wrapper、Python API 和 CLI 作为接口层分别测试。
测试设计原则:
- 新物理能力必须配套小型、可重复测试或 checker。
- 默认 release gate 只包含快速、稳定、小规模测试。
- 长跑、工程 benchmark 和研究项不进入默认 gate。
- C ABI 是第一优先接口测试对象。
- C++ wrapper 测试保留,但不作为 0.1 最小 gate 必选项。
- Python 基础 smoke 纳入默认 gate。
- 从第一版开始启用 source size 门禁。
## 2. 测试分层
| 层级 | 目标 |
|---|---|
| 单元测试 | 核函数、邻域搜索、EOS、Velocity-Verlet、Johnson-Cook 材料点、Mindlin-Reissner 局部量 |
| 输入测试 | Abaqus `.inp` 子集、`*SPHLITE ...` 扩展关键词、warning/error 路径 |
| 模块测试 | Water、Gas、Explosive、Solid、Shell、CouplingInterface |
| 接口测试 | Fortran API、C ABI、C++ wrapper、Python `ctypes`、CLI |
| 示例 smoke | 小型可运行模型,检查方向、量级和关键输出 |
| benchmark | 带 checker 的紧凑工程验收 |
| 外部集成测试 | 与外部 CouplingModule/FEMLite 的联合验证,不属于 SPHLite 默认 gate |
| release gate | 当前版本发布前必须通过的组合测试 |
## 3. 第一批默认测试
第一批默认测试按长期能力逐步扩展。0.1.0 的默认 gate 只覆盖工程骨架、接口、最小输入、最小显式步进和 source size;下列物理项在对应版本实现后再进入默认 gate:
- Wendland C2 核函数归一性和梯度反对称性。
- Wendland C4 和 cubic spline 对比/回归测试。
- uniform cell/bin 邻域搜索与朴素搜索一致性。
- Tait EOS 压力计算。
- JWL EOS 压力计算。
- 理想气体 EOS 压力计算。
- Stiffened gas EOS 压力计算。
- Monaghan 人工黏性方向和量级。
- Velocity-Verlet 自由运动、恒力或简化振动步进。
- 水相连续性方程小算例。
- 小型压力波 smoke。
- 解析爆轰到达时间。
- programmed burn 反应进度 `lambda`。
- 气体团簇体积和等效气泡半径统计。
- Johnson-Cook 材料点。
- Johnson-Cook 失效与渐进软化材料点。
- Mindlin-Reissner 板壳小变形 smoke。
- C ABI 空指针、非正容量和小缓冲区错误。
- Python `ctypes` 基础 smoke。
## 4. 输入解析测试
SPHLite 支持 Abaqus `.inp` 明确子集,不追求完整 Abaqus 兼容。输入测试必须覆盖:
- `*NODE`。
- `*ELEMENT`。
- `*NSET`。
- `*ELSET`。
- `*MATERIAL`。
- `*SECTION` 或等价 section 关键词。
- `*SPHLITE ...` 扩展关键词。
- 未支持但不影响运行的关键词 warning。
- 缺失关键数据或无法继续运行的 error。
- set 只表示集合,不作为类型判断依据。
- material 和 section 对 phase/物理路径的识别。
输入解析测试应同时覆盖 CLI 路径和 API 路径。
## 5. 模块测试顺序
模块测试按开发路线递进:
1. `Water`:核函数、邻域、Tait EOS、连续性方程、压力波 smoke。
2. `Gas`:JWL、理想气体、Stiffened gas、气体团簇和气泡诊断。
3. `Explosive`:爆轰到达时间、反应进度、质量/动量/能量源项。
4. `Solid`:Johnson-Cook 材料点、失效和渐进软化。
5. `Shell`:Mindlin-Reissner 小变形、厚度积分点选择。
6. `CouplingInterface`:中立耦合状态导出、外力导入、耦合功和能量诊断。
## 6. CouplingInterface 测试边界
SPHLite 默认 gate 不包含真正 FEM-SPH 联合测试。外部 CouplingModule、FEMLite 或其他求解器的联合运行属于外部集成测试。
SPHLite 仓库内只测试中立接口:
- coupling region 解析。
- coupling particles 导出。
- coupling facets 或近似面片导出。
- 外部粒子力、面力或体力导入。
- 显式步内载荷施加。
- 耦合功、动量交换和能量交换统计。
- 接触耦合和连续体耦合诊断字段区分。
## 7. 0.1 Release Gate 草案
0.1 release gate 建议包含:
```powershell
cmake --build build-codex-gcc --parallel
ctest --test-dir build-codex-gcc -R "^(smoke|input|c_api|python_debug)$" --output-on-failure
ctest --test-dir build-codex-gcc -R "^source_size$" --output-on-failure
git diff --check
```
其中:
- `smoke` 覆盖 Fortran 生命周期、数据库、最小显式步。
- `input` 覆盖 `.inp` 支持子集和 warning/error。
- `c_api` 覆盖 C ABI 生命周期、查询和错误路径。
- `python_debug` 覆盖 Python `ctypes` 基础调用。
- `source_size` 控制单文件和单过程持续膨胀。
实际 build 目录和测试名称可在代码实现阶段按 CMake 配置调整。
## 7.1 0.3.1 Release Gate
0.3.1 在 0.3.0 默认 gate 基础上新增 Gas 多材料、material/EOS 分派、Gas 源项占位、扩展诊断、restart 兼容和接口扩展测试。默认 gate 包含:
- `input_gas_multimaterial`
- `gas_eos_dispatch`
- `gas_extended_summary`
- `gas_source`
- `gas_source_errors`
- `gas_restart_031`
- `gas_restart_030_compat`
- `gas_python_extended`
- `gas_cli_extended`
- `gas_source_size_cleanup`
0.3.1 本地 release gate:
```powershell
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check
```
2026-07-03 本地结果:默认 gate 37/37 通过,`source_size` 1/1 通过,`git diff --check` 通过。
## 7.2 0.4.0 Release Gate
0.4.0 在 0.3.1 Gas 稳定化 gate 基础上新增 `Explosive` 起步闭环测试。默认 gate 继续覆盖既有 Water/Gas/接口/restart/output/source-size 路径,并新增以下 Explosive 专项 gate:
- `input_explosive`
- `input_explosive_errors`
- `explosive_detonation_time`
- `explosive_reaction_progress`
- `explosive_release_source`
- `explosive_to_gas_phase`
- `explosive_gas_coupling`
- `explosive_summary`
- `explosive_restart_040`
- `explosive_restart_031_compat`
- `explosive_c_api`
- `explosive_python`
- `explosive_cli`
- `explosive_source_size`
0.4.0 本地 release gate:
```powershell
cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_explosive|input_explosive_errors|explosive_detonation_time|explosive_reaction_progress|explosive_release_source|explosive_to_gas_phase|explosive_gas_coupling|explosive_summary|explosive_restart_040|explosive_restart_031_compat|explosive_c_api|explosive_python|explosive_cli|explosive_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check
```
2026-07-03 本地结果:完整 CTest 51/51 通过,Explosive 专项 gate 14/14 通过,`source_size` 1/1 通过,`git diff --check` 通过。
## 7.3 0.4.1 Release Gate
0.4.1 在 0.4.0 `Explosive` 起步闭环 gate 基础上新增稳定化和兼容性测试。默认 gate 继续覆盖既有 Water/Gas/Explosive/接口/restart/output/source-size 路径,并新增以下 Explosive 专项 gate:
- `input_explosive_multi_ignition`
- `input_explosive_multimaterial`
- `explosive_initial_mass_release`
- `explosive_release_balance`
- `explosive_source_targeting`
- `explosive_phase_refresh`
- `explosive_restart_041`
- `explosive_restart_040_compat`
- `explosive_restart_no_double_release`
- `explosive_water_gas_smoke`
- `explosive_release_c_api`
- `explosive_release_python`
- `explosive_release_cli`
- `explosive_041_source_size`
0.4.1 本地 release gate:
```powershell
cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_explosive_multi_ignition|input_explosive_multimaterial|explosive_initial_mass_release|explosive_release_balance|explosive_source_targeting|explosive_phase_refresh|explosive_restart_041|explosive_restart_040_compat|explosive_restart_no_double_release|explosive_water_gas_smoke|explosive_release_c_api|explosive_release_python|explosive_release_cli|explosive_041_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check
```
2026-07-03 本地结果:完整 CTest 66/66 通过,0.4.1 Explosive 专项 gate 14/14 通过,`source_size` 1/1 通过,`git diff --check` 通过。
## 7.4 0.5.0 Release Gate
0.5.0 在 0.4.1 `Explosive` 稳定化 gate 基础上新增 `Solid` 起步闭环测试。默认 gate 继续覆盖既有 Water/Gas/Explosive/接口/restart/output/source-size 路径,并新增以下 Solid 专项 gate:
- `input_solid_material`
- `input_solid_errors`
- `solid_state_build`
- `solid_elastic_material`
- `solid_johnson_cook_flow`
- `solid_johnson_cook_failure`
- `solid_progressive_softening`
- `solid_gradient_correction`
- `solid_stable_dt`
- `solid_explicit_smoke`
- `solid_output`
- `solid_restart_050`
- `solid_restart_041_compat`
- `solid_c_api`
- `solid_python`
- `solid_cli`
- `solid_source_size`
0.5.0 本地 release gate:
```powershell
cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_explosive_multi_ignition|input_explosive_multimaterial|explosive_initial_mass_release|explosive_release_balance|explosive_source_targeting|explosive_phase_refresh|explosive_restart_041|explosive_restart_040_compat|explosive_restart_no_double_release|explosive_water_gas_smoke|explosive_release_c_api|explosive_release_python|explosive_release_cli|explosive_041_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_solid_material|input_solid_errors|solid_state_build|solid_elastic_material|solid_johnson_cook_flow|solid_johnson_cook_failure|solid_progressive_softening|solid_gradient_correction|solid_stable_dt|solid_explicit_smoke|solid_output|solid_restart_050|solid_restart_041_compat|solid_c_api|solid_python|solid_cli|solid_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check
```
2026-07-03 本地结果:完整 CTest 83/83 通过,0.4.1 Explosive 回归 gate 14/14 通过,0.5.0 Solid 专项 gate 17/17 通过,`source_size` 1/1 通过,`git diff --check` 通过。
0.5.0 不验收 `Shell` 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。
## 7.5 0.5.1 Release Gate
0.5.1 在 0.5.0 `Solid` 起步闭环 gate 基础上新增 `Solid` 稳定化和结构算法加固测试。默认 gate 继续覆盖既有 Water/Gas/Explosive/Solid/接口/restart/output/source-size 路径,并新增以下 Solid 0.5.1 专项 gate:
- `solid_051_input_validation`
- `solid_reference_neighbor`
- `solid_correction_matrix`
- `solid_velocity_gradient`
- `solid_strain_increment`
- `solid_internal_force_pair`
- `solid_uniform_stress_balance`
- `solid_softening_force`
- `solid_energy_diagnostics`
- `solid_dt_acceleration`
- `solid_restart_051`
- `solid_restart_050_compat`
- `solid_state_api`
- `solid_python_051`
- `solid_cli_051`
- `solid_051_source_size`
0.5.1 本地 release gate:
```powershell
cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_solid_material|input_solid_errors|solid_state_build|solid_elastic_material|solid_johnson_cook_flow|solid_johnson_cook_failure|solid_progressive_softening|solid_gradient_correction|solid_stable_dt|solid_explicit_smoke|solid_output|solid_restart_050|solid_restart_041_compat|solid_c_api|solid_python|solid_cli|solid_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(solid_051_input_validation|solid_reference_neighbor|solid_correction_matrix|solid_velocity_gradient|solid_strain_increment|solid_internal_force_pair|solid_uniform_stress_balance|solid_softening_force|solid_energy_diagnostics|solid_dt_acceleration|solid_restart_051|solid_restart_050_compat|solid_state_api|solid_python_051|solid_cli_051|solid_051_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|solid_source_size|solid_051_source_size)$" --output-on-failure
git diff --check
```
2026-07-03 本地结果:完整 CTest 99/99 通过,0.5.0 Solid 回归 gate 17/17 通过,0.5.1 Solid 专项 gate 16/16 通过,`source_size`/`solid_source_size`/`solid_051_source_size` 3/3 通过,`git diff --check` 通过。
0.5.1 不验收 `Shell` 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。0.5.1 的 Solid gate 只证明参考构型、速度梯度、应变率、最小内力、诊断、restart 和接口可观测性在小型模型内闭合。
## 7.6 0.6.0 Release Gate
0.6.0 在 0.5.1 `Solid` 稳定化 gate 基础上启动 `Shell` 板壳粒子版本线。当前发布范围限定为 Shell 输入解析、Shell section 校验、粒子级状态数组和厚度积分点状态数组的基线验收;不把尚未完成的 director/转动更新、Mindlin-Reissner 应变路径、Shell 材料点更新、Shell 内力、显式推进、restart 或公开 API 纳入本次验收。
0.6.0 Shell 输入与状态基线专项 gate 包含:
- `input_shell_section`
- `input_shell_errors`
- `shell_state_build`
- `shell_section_integration`
0.6.0 本地 release gate:
```powershell
cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_shell_section|input_shell_errors|shell_state_build|shell_section_integration)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check
```
2026-07-03 本地结果:完整 CTest 103/103 通过,0.6.0 Shell 输入/状态基线专项 gate 4/4 通过,`source_size` 1/1 通过,`git diff --check` 通过。
0.6.0 不验收完整 `Shell` 动力学闭环,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级船舱破坏 benchmark。0.6.0 的 Shell gate 只证明 Shell material/section 输入、厚度/积分点/剪切修正校验、Shell 粒子状态数组和厚度积分点状态数组在小型模型内可构建、可检查。
## 7.7 0.6.1 Release Gate
0.6.1 在 0.6.0 `Shell` 输入与状态基线之上新增 director 输入/推断、局部坐标、转动状态、参考面积/惯量、Mindlin-Reissner 小变形膜/弯曲/横向剪切应变和厚度积分点应变增量映射。当前 gate 仍限定为小型运动学链路,不把 Shell 材料点更新、Shell 内力、Shell 内力矩、完整显式推进、restart、公开接口或工程响应纳入验收。
0.6.1 Shell 运动学专项 gate 包含:
- `input_shell_section`
- `input_shell_errors`
- `shell_state_build`
- `shell_section_integration`
- `shell_director_input`
- `shell_reference_geometry`
- `shell_director_update`
- `shell_rotation_kinematics`
- `shell_local_frame`
- `shell_membrane_strain`
- `shell_bending_strain`
- `shell_shear_strain`
- `shell_ip_strain_increment`
- `shell_061_source_size`
0.6.1 本地 release gate:
```powershell
cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_shell_section|input_shell_errors|shell_state_build|shell_section_integration|shell_director_input|shell_reference_geometry|shell_director_update|shell_rotation_kinematics|shell_local_frame|shell_membrane_strain|shell_bending_strain|shell_shear_strain|shell_ip_strain_increment)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|shell_061_source_size)$" --output-on-failure
git diff --check
```
2026-07-03 本地结果:完整 CTest 113/113 通过,0.6.1 Shell 运动学专项 gate 13/13 通过,`source_size`/`shell_061_source_size` 2/2 通过,`git diff --check` 通过。
0.6.1 不验收完整 `Shell` 动力学闭环,不验收 Shell 材料点更新、内力、内力矩、稳定时间步、显式推进生产路径、restart、公开 C ABI/C++/Python/CLI 诊断字段、真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级船舱破坏 benchmark。
## 7.8 0.7.0 Release Gate
0.7.0 在 0.6.1 Shell 运动学基线之上新增水-气-结构局部爆炸 smoke 起点。该 gate 只验收小型 Water/Gas/Explosive/Solid/Shell 链路、局部爆炸输入控制、源/目标筛选、结构外载荷缓存、显式推进接入、诊断输出和 restart 边界,不验收真实工程级水下接触爆炸响应。
0.7.0 局部爆炸专项 gate 包含:
- `input_blast_region`
- `input_blast_errors`
- `blast_source_snapshot`
- `blast_target_filter`
- `blast_load_accumulator`
- `blast_load_conservation`
- `blast_solver_order`
- `blast_solid_response`
- `blast_shell_response`
- `blast_noop_regression`
- `blast_summary`
- `blast_output`
- `blast_restart_boundary`
- `blast_smoke`
0.7.0 本地 release gate:
```powershell
cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_blast_region|input_blast_errors|blast_source_snapshot|blast_target_filter|blast_load_accumulator|blast_load_conservation|blast_solver_order|blast_solid_response|blast_shell_response|blast_noop_regression|blast_summary|blast_output|blast_restart_boundary|blast_smoke)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|explosive_source_size|explosive_041_source_size|gas_source_size_cleanup|solid_source_size|solid_051_source_size|shell_061_source_size)$" --output-on-failure
git diff --check
```
2026-07-03 本地结果:完整 CTest 127/127 通过,0.7.0 局部爆炸专项 gate 14/14 通过,source size 相关 gate 7/7 通过,`git diff --check` 通过。
0.7.0 不验收真实工程级水下接触爆炸响应,不验收真实 FEM-SPH 接触耦合或连续体耦合,不验收完整舱段破坏 benchmark,不验收复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。0.7.0 的局部爆炸诊断先提供 Fortran API 和 CSV 调试输出,不新增公开 C ABI/C++/Python 稳定接口,也不写入正式 `STATE_0_7` restart。
## 7.9 0.7.1 Release Gate
0.7.1 在 0.7.0 局部爆炸 smoke 起点之上进行稳定化。该 gate 只验收多 blast region 输入、启用/禁用控制、源/目标统计、结构载荷叠加、显式推进顺序、输出字段、restart 边界和小模型 smoke,不验收真实工程级水下接触爆炸响应。
0.7.1 局部爆炸专项 gate 包含:
- `input_blast_multiregion`
- `input_blast_region_errors_071`
- `blast_multiregion_snapshot`
- `blast_multiregion_target_filter`
- `blast_load_superposition`
- `blast_load_diagnostics_071`
- `blast_solver_order_071`
- `blast_response_multiregion`
- `blast_noop_regression_071`
- `blast_output_071`
- `blast_restart_boundary_071`
- `blast_smoke_071`
0.7.1 本地 release gate:
```powershell
cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(water_eos|water_density|water_viscosity|water_force|solver_water|pressure_wave_smoke)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_gas|input_gas_multimaterial|gas_eos_ideal|gas_eos_jwl|gas_eos_stiffened|gas_eos_dispatch|gas_state|gas_summary|gas_extended_summary|gas_source|gas_source_errors|solver_gas|gas_output|gas_restart|gas_restart_031|gas_restart_030_compat)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_explosive|input_explosive_errors|input_explosive_multi_ignition|input_explosive_multimaterial|explosive_detonation_time|explosive_reaction_progress|explosive_initial_mass_release|explosive_release_balance|explosive_release_source|explosive_source_targeting|explosive_to_gas_phase|explosive_phase_refresh|explosive_gas_coupling|explosive_water_gas_smoke|explosive_summary|explosive_restart_040|explosive_restart_041|explosive_restart_040_compat|explosive_restart_no_double_release|explosive_restart_031_compat|explosive_c_api|explosive_release_c_api|explosive_release_cpp_api|explosive_python|explosive_release_python|explosive_cli|explosive_release_cli)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_solid_material|input_solid_errors|solid_051_input_validation|solid_state_build|solid_elastic_material|solid_johnson_cook_flow|solid_johnson_cook_failure|solid_progressive_softening|solid_gradient_correction|solid_reference_neighbor|solid_correction_matrix|solid_velocity_gradient|solid_strain_increment|solid_internal_force_pair|solid_uniform_stress_balance|solid_softening_force|solid_energy_diagnostics|solid_dt_acceleration|solid_stable_dt|solid_explicit_smoke|solid_output|solid_state_api|solid_restart_050|solid_restart_051|solid_restart_050_compat|solid_restart_041_compat|solid_c_api|solid_python|solid_python_051|solid_cli|solid_cli_051)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_shell_section|input_shell_errors|shell_state_build|shell_section_integration|shell_director_input|shell_reference_geometry|shell_director_update|shell_rotation_kinematics|shell_local_frame|shell_membrane_strain|shell_bending_strain|shell_shear_strain|shell_ip_strain_increment)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_blast_region|input_blast_errors|blast_source_snapshot|blast_target_filter|blast_load_accumulator|blast_load_conservation|blast_solver_order|blast_solid_response|blast_shell_response|blast_noop_regression|blast_summary|blast_output|blast_restart_boundary|blast_smoke)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_blast_multiregion|input_blast_region_errors_071|blast_multiregion_snapshot|blast_multiregion_target_filter|blast_load_superposition|blast_load_diagnostics_071|blast_solver_order_071|blast_response_multiregion|blast_noop_regression_071|blast_output_071|blast_restart_boundary_071|blast_smoke_071)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|explosive_source_size|explosive_041_source_size|gas_source_size_cleanup|solid_source_size|solid_051_source_size|shell_061_source_size)$" --output-on-failure
git diff --check
```
2026-07-04 本地结果:完整 CTest 139/139 通过,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、16/16、27/27、31/31、13/13 通过,0.7.0 blast 回归 gate 14/14 通过,0.7.1 blast 专项 gate 12/12 通过,source size 相关 gate 7/7 通过,`git diff --check` 通过。
0.7.1 不验收真实工程级水下接触爆炸响应,不验收真实 FEM-SPH 接触耦合或连续体耦合,不验收完整舱段破坏 benchmark,不验收复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。0.7.1 的 Blast 诊断仍限定为 Fortran 内部查询和 CSV 调试边界,不新增公开 C ABI/C++/Python 稳定接口,也不写入新的正式 restart state。
## 7.10 0.8.0 Release Gate
0.8.0 在 0.7.1 局部爆炸稳定化版本之上交付 SPHLite 侧中立接触耦合接口。该 gate 验收 coupling region 输入、粒子/Facet Proxy 导出、外部粒子力、facet load、运动边界、显式步响应、diagnostics、`STATE_0_8` restart、C ABI/C++/Python/CLI 接口和 mock coupling smoke。
0.8.0 coupling 专项 gate 包含:
- `input_coupling_region_080`
- `input_coupling_errors_080`
- `coupling_region_build_080`
- `coupling_particle_export_080`
- `coupling_facet_export_080`
- `coupling_facet_errors_080`
- `coupling_particle_force_import_080`
- `coupling_facet_load_import_080`
- `coupling_motion_boundary_080`
- `coupling_diagnostics_080`
- `coupling_solver_order_080`
- `coupling_solid_response_080`
- `coupling_shell_response_080`
- `coupling_noop_regression_080`
- `coupling_output_080`
- `coupling_restart_080`
- `coupling_restart_071_compat`
- `coupling_fortran_api_080`
- `coupling_c_api_080`
- `coupling_cpp_api_080`
- `coupling_python_080`
- `coupling_cli_080`
- `coupling_smoke_080`
- `coupling_source_size_080`
0.8.0 本地 release gate:
```powershell
cmake --build build-codex-unix
ctest --test-dir build-codex-unix -R "^(input_coupling_region_080|input_coupling_errors_080|coupling_region_build_080|coupling_particle_export_080|coupling_facet_export_080|coupling_facet_errors_080|coupling_particle_force_import_080|coupling_facet_load_import_080|coupling_motion_boundary_080|coupling_diagnostics_080|coupling_solver_order_080|coupling_solid_response_080|coupling_shell_response_080|coupling_noop_regression_080|coupling_restart_080|coupling_restart_071_compat|coupling_output_080|coupling_fortran_api_080|coupling_c_api_080|coupling_cpp_api_080|coupling_python_080|coupling_cli_080|coupling_smoke_080|coupling_source_size_080)$" --output-on-failure
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|explosive_source_size|explosive_041_source_size|gas_source_size_cleanup|solid_source_size|solid_051_source_size|shell_061_source_size|coupling_source_size_080)$" --output-on-failure
git diff --check
```
2026-07-04 本地结果:完整 CTest 163/163 通过,0.8.0 coupling 专项 gate 24/24 通过,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、19/19、28/28、33/33、14/14 通过,0.7.0 blast 回归 gate 19/19 通过,0.7.1 blast 专项 gate 7/7 通过,source size 相关 gate 8/8 通过,`git diff --check` 通过。
0.8.0 不验收真实 FEMLite 联合运行,不验收外部 CouplingModule/CoupleLite/CoupledLite/CouplingLite,不验收连续体一部分 FEM 一部分 SPH 的生产级连续体耦合,不验收工程级船舶水下接触爆炸舱段破坏 benchmark,不验收复杂接触搜索、真实接触约束求解、大规模并行或 GPU 后端。
## 7.11 0.8.1 Release Gate
0.8.1 默认 gate 在 0.8.0 中立接触耦合接口基础上做稳定化。该 gate 只验收 SPHLite 侧小型、可重复 mock coupling 链路、载荷分配、接触诊断、输出、restart 和接口契约,不验收真实 FEMLite 联合运行、外部 CouplingModule/CoupleLite/CoupledLite/CouplingLite、连续体耦合或工程级船舶水下接触爆炸破坏 benchmark。
0.8.1 coupling 专项测试:
- `input_coupling_load_mode_081`
- `input_coupling_load_errors_081`
- `coupling_contact_state_081`
- `coupling_facet_pressure_081`
- `coupling_facet_traction_081`
- `coupling_facet_resultant_081`
- `coupling_distribution_uniform_081`
- `coupling_distribution_area_081`
- `coupling_distribution_mass_081`
- `coupling_load_balance_081`
- `coupling_contact_diagnostics_081`
- `coupling_solver_order_081`
- `coupling_stale_epoch_081`
- `coupling_solid_surface_pressure_081`
- `coupling_shell_pressure_081`
- `coupling_mixed_pressure_motion_081`
- `coupling_output_081`
- `coupling_restart_081`
- `coupling_restart_080_compat`
- `coupling_fortran_api_081`
- `coupling_c_api_081`
- `coupling_cpp_api_081`
- `coupling_python_081`
- `coupling_cli_081`
- `coupling_smoke_081`
- `coupling_source_size_081`
0.8.1 本地 release gate:
```powershell
cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix -R "^(input_coupling_load_mode_081|input_coupling_load_errors_081|coupling_contact_state_081|coupling_facet_pressure_081|coupling_facet_traction_081|coupling_facet_resultant_081|coupling_distribution_uniform_081|coupling_distribution_area_081|coupling_distribution_mass_081|coupling_load_balance_081|coupling_contact_diagnostics_081|coupling_solver_order_081|coupling_stale_epoch_081|coupling_solid_surface_pressure_081|coupling_shell_pressure_081|coupling_mixed_pressure_motion_081|coupling_output_081|coupling_restart_081|coupling_restart_080_compat|coupling_fortran_api_081|coupling_c_api_081|coupling_cpp_api_081|coupling_python_081|coupling_cli_081|coupling_smoke_081|coupling_source_size_081)$" --output-on-failure
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|explosive_source_size|explosive_041_source_size|gas_source_size_cleanup|solid_source_size|solid_051_source_size|shell_061_source_size|coupling_source_size_080|coupling_source_size_081)$" --output-on-failure
git diff --check
```
2026-07-04 本地结果:完整 CTest 189/189 通过,0.8.1 coupling 专项 gate 26/26 通过,0.8.0 coupling 回归 gate 24/24 通过,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、19/19、29/29、33/33、14/14 通过,0.7.0 blast 回归 gate 15/15 通过,0.7.1 blast 专项 gate 11/11 通过,source size 相关 gate 9/9 通过,`git diff --check` 通过。代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖,输出目录、CSV、VTK、restart 和临时结果未进入待提交清单。
0.8.1 不验收真实 FEMLite 联合运行,不验收外部 CouplingModule/CoupleLite/CoupledLite/CouplingLite,不验收连续体一部分 FEM 一部分 SPH 的生产级连续体耦合,不验收工程级船舶水下接触爆炸舱段破坏 benchmark,不验收生产级接触搜索、接触约束、摩擦、复杂撕裂/穿孔/碎片云、焊缝失效库、大规模并行或 GPU 后端。
## 7.12 0.8.3 CCLite Worker Release Gate
0.8.3 worker gate 用于 CCLite 集成加固。验收对象是 worker CLI 参数、capabilities 查询、状态/命令枚举、IPC adapter mock、Windows shared memory/named event self-test、命令到 SPHLite API 的映射表、AOR v1 数据契约、worker 诊断文件和 CCLite mock command/data block 闭环。
专项测试:
- `worker_protocol`
- `worker_cli`
- `worker_ipc`
- `worker_ipc_selftest`
- `worker_dispatch`
- `worker_contract`
- `worker_blocks`
- `worker_reports`
- `worker_runtime_reports`
- `worker_mock`
- `input_cclite_082`
建议命令:
```powershell
ctest --test-dir build-codex-unix -R "^(worker_protocol|worker_cli|worker_ipc|worker_ipc_selftest|worker_dispatch|worker_contract|worker_blocks|worker_reports|worker_runtime_reports|worker_mock|input_cclite_082)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(worker|coupling_.*_08[01]|coupling_source_size_08[01])" --output-on-failure
```
2026-07-05 本地结果:完整 CTest 200/200 通过,worker/coupling 专项 gate 55/55 通过,source size 相关 gate 9/9 通过,`git diff --check` 通过。无限水域爆炸示例脚本生成 VTU/PVD,`tools/publish_to_cclite.bat -TargetRoot ..\CCLite\SPHLite` 实际发布通过。
该 gate 已验收 SPHLite 侧 Windows shared memory/named event self-test,但不验收真实外部 CCLite 进程联调,不验收 FEM-SPH 接触搜索、接触约束、摩擦、tied/release 物理作用或生产级 FSI。
## 8. Source Size 门禁
从第一版开始设置 source size 门禁。建议沿用 FEMLite 风格:
- 普通过程设置 review target 和 hard limit。
- 普通源文件设置 review target 和 hard limit。
- 必要例外登记到例外清单。
- stale exception 应被检查。
0.6.1 当前新增 Shell 运动学路径,`src/shell/sph_shell.f90` 暂作为 Shell 输入、状态和运动学 owner 登记说明性例外,并新增 `shell_061_source_size` gate 保持 stale exception 检查。后续进入 Shell 材料点、内力、restart 或接口层前,应优先拆分 Shell geometry/kinematics/diagnostics 模块,减少主文件例外范围。`src/solid/sph_solid.f90` 继续作为 Solid 输入/material 表 owner,并在例外清单中登记说明;后续若拆分 Solid material ownership 应同步移除此例外。
具体阈值可在实现阶段与 FEMLite 保持一致或按 SPHLite 文件结构微调。
## 9. 非默认长跑和研究项
以下内容不进入默认 release gate:
- 自由场水下爆炸工程曲线。
- 气泡多周期脉动。
- 板壳穿孔、撕裂和碎片云。
- 舱段局部水下接触爆炸破坏。
- FEM-SPH 联合长算例。
- 大规模粒子数性能测试。
- 近场强冲击 Riemann-SPH 对比。
- 多材料复杂断裂和焊缝失效。
这些内容应作为非默认 benchmark、研究项或外部集成测试维护,并配套独立 checker 和运行说明。
## 10. 文档与产物检查
发布前必须确认:
- README 和 01-11 文档与当前版本能力一致。
- 默认 gate 结果写入版本历史和 benchmark 矩阵。
- 输出目录、CSV、VTK、restart 和大型临时结果不提交。
- Python 生成器仅作为测试/示例辅助工具,不宣传为求解器几何或粒子生成功能。
- 文档使用 UTF-8 without BOM。
## 11. 待讨论问题
- 0.1 source size 具体阈值。
- 第一批 CTest 测试名称和 label。
- Python checker 的目录组织。
- 非默认 benchmark 的运行入口和命名。
- 外部集成测试与 CouplingModule 仓库的边界。