Finalize 0.5.0 gate records

This commit is contained in:
Codex
2026-07-03 16:32:27 +08:00
parent 708016c9af
commit dfeb452b41
6 changed files with 158 additions and 30 deletions
+37 -1
View File
@@ -1,6 +1,6 @@
# 06 测试与验证计划
文档状态:规划确认稿
文档状态:0.5.0 gate 记录
## 1. 测试原则
@@ -202,6 +202,42 @@ 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。
## 8. Source Size 门禁
从第一版开始设置 source size 门禁。建议沿用 FEMLite 风格:
+51 -2
View File
@@ -1,10 +1,10 @@
# 09 版本历史与验收记录
文档状态:0.4.1 已发布记录
文档状态:0.5.0 本地验收记录
## 1. 当前状态
SPHLite 当前进入 0.4.1 `Explosive` 稳定化版本。本版本在 0.4.0 已建立的解析点火、爆轰到达时间、programmed burn、Gas 源项注入、phase 转化、restart 和接口 gate 基础上,加固多点点火、多炸药材料、冻结反应质量、release balance、Water/Gas/Explosive 混合 smoke 和 restart 兼容;`Solid`、`Shell` 生产路径和真实 FEM-SPH 联合运行仍不在本版本交付范围内。
SPHLite 当前进入 0.5.0 `Solid` 起步闭环版本。本版本在 0.4.1 已建立的 Water/Gas/Explosive 稳定 gate 基础上,新增 3D 实体结构粒子的 material/section 输入、状态数组、弹性与 Johnson-Cook 材料点、失效与渐进软化、显式推进最小路径、CSV、`STATE_0_5` restart、接口诊断和 Solid 专项 gate;`Shell` 生产路径、真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行和工程级结构破坏 benchmark 仍不在本版本交付范围内。
## 2. 规划版本线
@@ -292,6 +292,55 @@ cmake --build build-codex-unix
- 0.4.1 已于 2026-07-03 完成本地发布记录提交,并准备标记 `v0.4.1`。
### 0.5.0 本地验收记录
记录日期:2026-07-03
本地构建目录:`build-codex-unix`
版本定位:
- 0.5.0 是 `Solid` 3D 实体结构粒子的起步闭环版本。
- 0.5.0 支持 `TYPE=SOLID` material、`*DENSITY`、`*ELASTIC`、Johnson-Cook flow/failure 参数、Solid control softening 参数和 `*SOLID SECTION` 映射。
- 0.5.0 新增 Solid 应力、应变、塑性应变、塑性应变率、温度、damage、softening、内能、失效状态、参考体积和梯度修正占位状态。
- 0.5.0 支持弹性材料点、Johnson-Cook flow、Johnson-Cook failure damage 累积、线性渐进软化和失效状态切换。
- 0.5.0 将 Solid 接入 Velocity-Verlet 显式推进,提供体力驱动 smoke、结构波速稳定时间步、Solid 动能/内能/动量/max von Mises/damage/softening/dt 诊断。
- 0.5.0 restart 写入 `STATE_0_5`,保存 Solid material 表和 per-particle 状态,并兼容 `STATE_0_4_1` 及更早状态读入时初始化空 Solid 状态。
- 0.5.0 追加 Solid summary 和 failure counts 的 Fortran API、C ABI、C++ wrapper、Python `ctypes`、CLI 字段和专项 CTest gate。
验收结果:
- `cmake --build build-codex-unix --parallel` 通过。
- `ctest --test-dir build-codex-unix --output-on-failure` 通过:83/83。
- 0.4.1 Explosive 回归 gate 通过:14/14。
- 0.5.0 Solid 专项 gate 通过:17/17。
- `ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure` 通过:1/1。
- `git diff --check` 通过。
- `tests/source_size_exceptions.txt` 未新增 Solid 例外,stale exception 检查通过。
- 代码、构建脚本、测试和工具目录中未新增 FEMLite 直接依赖。
不交付范围:
- 0.5.0 不交付 `Shell` 生产路径。
- 0.5.0 不交付真实水-气-结构工程爆炸响应。
- 0.5.0 不交付真实 FEM-SPH 接触耦合或连续体耦合。
- 0.5.0 不交付工程级结构破坏 benchmark、复杂断裂面追踪、碎片云或焊缝失效库。
已知限制:
- 0.5.0 Solid 显式推进以最小体力驱动、状态闭环和诊断闭环为主,不代表已经具备工程级结构破裂预测能力。
- 梯度修正和参考构型状态已经建表和验收占位,后续版本仍需继续完善真实结构内力、应变率和断裂传播算法。
- Solid material summary 暂不对外暴露,当前接口只暴露 Solid 计数、能量、动量、damage、softening、dt 和失效统计。
发布建议:
- 建议将 0.5.0 作为 Solid 起步闭环版本发布。
- 0.5.0 发布后,后续主线可继续进入 Solid 内力/断裂加固,或进入 `Shell` 0.6.0 前置设计。
发布记录:
- 0.5.0 已完成本地发布前验收记录,待后续发布命令创建标签并按需推送远端。
后续每个版本应记录:
- 完成能力。
+34 -2
View File
@@ -1,10 +1,10 @@
# 11 Benchmark 与验收矩阵
文档状态:0.4.1 gate 记录
文档状态:0.5.0 gate 记录
## 1. 当前状态
0.4.1 在 0.4.0 `Explosive` 起步闭环基础上新增稳定化 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 Explosive programmed burn、Gas 源项注入、phase 转化、release balance、pressure wave smoke 和 Gas bubble metrics 只用于小规模数值链路检查,不作为工程精度 benchmark。
0.5.0 在 0.4.1 Water/Gas/Explosive 稳定 gate 基础上新增 `Solid` 起步闭环 gate,并继续保留工程 benchmark 矩阵作为长期规划。本版本的 Solid material point、damage、softening、显式 smoke、pressure wave smoke、Explosive programmed burn、Gas 源项注入和 Gas bubble metrics 只用于小规模数值链路检查,不作为工程精度 benchmark。
## 2. 0.1.0 Release Gate
@@ -265,6 +265,38 @@
|---|---|---|
| 2026-07-03 | `build-codex-unix` | 完整 CTest 66/66 通过,0.4.1 Explosive gate 14/14 通过,`source_size` 1/1 通过,`git diff --check` 通过 |
## 2.9 0.5.0 Release Gate
0.5.0 默认 gate 在 0.4.1 Explosive 稳定化 gate 基础上新增 Solid 输入、状态、本构、失效、显式推进、output、restart、接口和 source size 验收。
| 测试名 | 类型 | 验收点 |
|---|---|---|
| `input_solid_material` | Fortran input | Solid material、密度、弹性、Johnson-Cook flow/failure、softening 和 section 映射 |
| `input_solid_errors` | Fortran input | 缺密度、缺弹性、非法 Johnson-Cook 参数和非法 Solid section error 路径 |
| `solid_state_build` | Fortran module | Solid 状态数组分配、默认值、active/failed 计数和非 Solid 安全默认值 |
| `solid_elastic_material` | Fortran unit | 弹性材料点应力、内能和等效应力更新 |
| `solid_johnson_cook_flow` | Fortran unit | Johnson-Cook 热软化、应变率项、硬化项和屈服应力 |
| `solid_johnson_cook_failure` | Fortran unit | failure strain、damage 单调累积、失效状态切换 |
| `solid_progressive_softening` | Fortran unit | damage/softening 范围限制和线性渐进软化 |
| `solid_gradient_correction` | Fortran module | 参考体积、参考构型邻域和梯度修正占位状态 |
| `solid_stable_dt` | Fortran module | 结构波速稳定时间步和全局 dt 约束 |
| `solid_explicit_smoke` | Fortran smoke | Solid-only 体力驱动显式推进、能量和动量诊断 |
| `solid_output` | Fortran output | summary CSV 和粒子 CSV 的 Solid 字段 |
| `solid_restart_050` | Fortran restart | `STATE_0_5` 写入读回 Solid material 和 per-particle 状态 |
| `solid_restart_041_compat` | Fortran restart | `STATE_0_4_1` 兼容读入并初始化空 Solid 状态 |
| `solid_c_api` | C ABI | Solid summary、failure counts 和错误路径 |
| `solid_python` | Python `ctypes` | Solid summary 薄包装和 inspect/run 字段 |
| `solid_cli` | CLI | Solid inspect/run/restart 字段检查 |
| `solid_source_size` | 工具门禁 | Solid source size 和 stale exception 检查 |
0.5.0 不验收 `Shell` 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。Solid 显式 smoke 仅证明 0.5.0 状态、推进、输出、restart 和接口链路闭合。
本地验收记录:
| 日期 | 构建目录 | 结果 |
|---|---|---|
| 2026-07-03 | `build-codex-unix` | 完整 CTest 83/83 通过,0.4.1 Explosive gate 14/14 通过,0.5.0 Solid gate 17/17 通过,`source_size` 1/1 通过,`git diff --check` 通过 |
## 3. 基础数值矩阵
| 领域 | 测试或 benchmark | 验收点 |