diff --git a/docs/v5_development_plan.md b/docs/v5_development_plan.md index 44c792e..3352b07 100644 --- a/docs/v5_development_plan.md +++ b/docs/v5_development_plan.md @@ -159,7 +159,7 @@ FemLite 0.5.x 定位为: | V5.7 cohesive 粘附/脱粘 | PARTIAL | 已有 cohesive law/state/metrics 模块;`test_cohesive_contact` 覆盖单积分点 bonded loading、mixed-mode damage、unloading、reload、complete decohesion、非负耗散、损伤不可逆和 restart 状态保持;`examples/ball_adhesion_decohesion` 已新增 compact cohesive ring benchmark,输出力-位移、耗散能和脱粘面积。 | 主求解器通用 cohesive contact 切换、切线、restart 段和完整球-膜 FE 长跑。 | | V5.8 颗粒耦合 | PASS | 已有颗粒状态、搜索、接触、配置、step、facet/FEM coupling 模块和测试;`particle_acceptance` 覆盖自由落体、墙碰撞、颗粒堆和颗粒-facet 耦合,并通过 `pstep_diag_values` 查询质量、动量、动能、步耗散能和最大重叠;`examples/Dynamic_Grain_Packing_of_a_Flexible_Container` 新增真实粒子-柔性容器双向 benchmark。 | 已完成;当前 Release 全量 CTest 106/106 通过。 | | V5.9 Benchmark 与性能 | PARTIAL | 已新增 `docs/v5_benchmark_matrix.md`,将 V5.2-V5.8 已完成能力映射到 CTest、示例目录、参考指标和容差;已为相关测试追加 `v5_acceptance` 标签。 | longrun、多平台回归、性能矩阵和最终验收报告仍需收束。 | -| V5.10 验收与发布 | PARTIAL | 已新增 `docs/v5_acceptance_report.md`,记录当前 V5 开发态范围、测试环境、命令、结果、已完成内容、仍需完善内容和暂缓边界。 | release hygiene、干净工作区、最终复测、分支/标签决策仍需完成。 | +| V5.10 验收与发布 | PARTIAL | 已新增 `docs/v5_acceptance_report.md`,记录当前 V5 开发态范围、测试环境、命令、结果、已完成内容、仍需完善内容和暂缓边界;`todo.md` 已全部标记为 `[x]`;本地 release hygiene 已完成并提交 `a01a4fd Complete V5 acceptance milestone`。 | 远端推送、标签决策、WSL/Intel 多平台复测和更大规模 longrun 仍建议在最终发布前执行。 | V5 benchmark 示例当前标记: @@ -177,6 +177,33 @@ V5 benchmark 示例当前标记: | `examples/ball_adhesion_decohesion` | PARTIAL | 已新增 compact cohesive ring benchmark,调用生产 cohesive law/state/metrics 并检查峰值拉脱力、滞回、耗散能、损伤和脱粘面积;原接触压入 smoke 保留。它仍不是完整球-膜 FE cohesive 接触长跑。 | | `examples/Dynamic_Grain_Packing_of_a_Flexible_Container` | PASS | 保留旧压力/地面接触 smoke,并新增 V5.8 真实粒子-柔性容器双向 benchmark;checker 验证无 `*DLOAD` 压力 surrogate、粒子数、粒子-facet 接触、映射节点力、容器位移、质量守恒、有界重叠和非负能量。 | +### 5.2 当前已完成内容登记 + +截至 2026-06-26,本地 `main` 已形成 V5 acceptance checkpoint: + +| 项 | 登记内容 | +|---|---| +| 本地提交 | `a01a4fd Complete V5 acceptance milestone` | +| TODO 状态 | `todo.md` 中 V5.2 至 V5.10 所有事项均已用 `[x]` 标记完成 | +| 默认回归 | `ctest --test-dir build-win-gcc-16 -C Release --output-on-failure` 记录为 106/106 passed | +| V5 验收子集 | `ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure` 记录为 35/35 passed | +| 发布卫生 | 根目录生成结果文件已清理;README 和版本元数据保持 `0.5.0` 一致 | +| 验收文档 | 新增 `docs/v5_acceptance_report.md` 和 `docs/v5_benchmark_matrix.md` | +| solver 边界 | 第三方/外部求解器接口、工具和测试已移除;内部 CG/BiCGSTAB/GMRES 为当前生产 solver 路径 | +| 示例边界 | benchmark 编排工具位于 `tools/benchmarks`,示例输入和 checker 位于对应 `examples//` 目录,不进入 `src` | + +当前可明确计入完成范围的能力: + +- V5.2 内部 solver 诊断和 no-external-solver 策略。 +- V5.3 非匹配实体接触、大滑移摩擦、shell-shell 和 shell-solid benchmark。 +- V5.4 Mohr-Coulomb 材料点验收和强度折减 benchmark。 +- V5.5 Euler 柱解析屈曲、波纹壳紧凑循环屈曲和循环对称验证。 +- V5.6 辊运动学、正则化牵引和紧凑 J2 springback benchmark。 +- V5.7 cohesive 单积分点和 ball adhesion/decohesion compact benchmark。 +- V5.8 内置离散球颗粒、颗粒-facet/FEM 映射和动态颗粒柔性容器 benchmark。 +- V5.9 benchmark 矩阵、`v5_acceptance` CTest 标签和文档矩阵。 +- V5.10 当前验收报告、根目录结果清理、本地提交和 release hygiene checkpoint。 + ## 6. V5.1 架构冻结与验收矩阵 目标: @@ -799,3 +826,52 @@ ctest --test-dir build-win-gcc-16 --output-on-failure - Mortar/AL 是滚压、cohesive、颗粒-膜接触和壳-实体 benchmark 的基础。 - Mohr-Coulomb 相对独立,可在 mortar 主线稳定后并行推进。 - 应用级高保真案例必须建立在核心算法真实可用之后。 + +## 20. 下一步建议 + +当前本地 checkpoint 已完成,但仍建议按“发布确认 -> 多平台复测 -> 工程化补强” +三层推进。 + +### 20.1 发布确认 + +1. 推送当前 `main` 到远端,并记录远端提交 hash。 +2. 决定是否为当前 checkpoint 打轻量标签或 annotated tag,例如 + `v0.5.0-v5-acceptance-checkpoint`。 +3. 在推送后重新拉取或干净 clone 一次,执行: + +```powershell +cmake -S . -B build-win-gcc-16 +cmake --build build-win-gcc-16 --config Release +ctest --test-dir build-win-gcc-16 -C Release --output-on-failure +ctest --test-dir build-win-gcc-16 -C Release -L v5_acceptance --output-on-failure +``` + +### 20.2 多平台复测 + +1. 在 WSL gfortran 环境复测默认 CTest 和 `v5_acceptance` 标签。 +2. 在 Windows Intel oneAPI ifx/MSVC 环境复测默认 CTest,记录编译器版本和任何 + 数值差异。 +3. 对 OpenMP contact/performance smoke 单独记录线程数、耗时和非计时统计一致性。 + +### 20.3 工程化补强优先级 + +1. V5.3:优先补齐完整 mortar/AL 一致切线、更多 restart 场景和 OpenMP + benchmark,目标是把接触主线从 benchmark 完成推进到更接近工业级约束求解。 +2. V5.4:补结构级 Mohr-Coulomb 自动 trial 重求解、非线性失稳判据和工程切线 + 审计,使强度折减从紧凑 benchmark 走向通用结构流程。 +3. V5.5:把屈曲从 benchmark 工具推进到主 `femlite` 的通用 `*BUCKLING` + step,接入静力预载后的壳/实体几何刚度装配和模态输出。 +4. V5.6:将滚压 kinematics/springback benchmark 的核心路径整合为通用滚压工艺 + step,补三维工件网格、restart 多 step 和长跑稳定性。 +5. V5.7:把 cohesive law/state/metrics 接入主接触流程,补普通接触/cohesive + 状态切换、切线和 restart 长路径。 +6. V5.8:扩展颗粒邻域搜索性能、大颗粒数 longrun 和能量稳定性检查,但继续保持 + 不依赖外部颗粒求解器。 + +### 20.4 文档与验收治理 + +1. 每完成一个 PARTIAL 项,先更新 `docs/v5_development_plan.md` 状态表,再同步 + `docs/v5_benchmark_matrix.md` 和 `docs/v5_acceptance_report.md`。 +2. benchmark 只在 `examples//` 和 `tools/benchmarks` 增加输入、checker 和 + 编排工具;生产功能仍进入 `src`。 +3. 不重新引入第三方 solver、外部 solver 进程或外部 solver C ABI 常量。