Files
FemLite/todo.md
T
shenw a2126f360c
FemLite CI / build-test (push) Has been cancelled
Release 0.6.5 real IPC worker
2026-07-05 21:09:37 +08:00

5.5 KiB
Raw Blame History

FemLite TODO

文档状态:根据 docs/12_cclite_integration_suggestions.md 重写。当前待办面向 0.6.5,目标是完成真实 IPC worker 接入闭环。

开发边界

  • 保留现有 worker mock,不把 mock 结果描述为真实 IPC worker。
  • 保持 FemLite 独立求解器身份,不把 CCLite/SPHLite 算法核心写入 FemLite。
  • 本轮只做数据边界、worker 通信、自测和诊断,不做真实 SPH-FEM 接触物理验收。
  • 每个开发阶段完成后补充对应 smoke、单元测试或文档验收。

阶段 A:Worker CLI 与能力查询

  • 盘点现有 --cclite-worker 参数解析、默认值、错误返回和测试覆盖。
  • 增加 --solver-id、--timeout-ms、--worker-id 参数,并保持旧参数兼容。
  • 增加 --command-block、--data-prefix、--worker-backend 参数,并明确 mock/ipc 模式选择规则。
  • 校验 --solver-id 初期只接受 FEM 或 FEMLite,错误时输出稳定错误码。
  • 新增 --cclite-capabilities CLI,输出稳定 key=value 文本。
  • 为能力查询补充测试,覆盖 mock、Windows IPC 支持状态和非 Windows unsupported 状态。

阶段 B:Worker 命令执行器解耦

  • 盘点现有 mock worker 命令状态机和日志字段,找出与 mock backend 绑定的逻辑。
  • 抽出 backend 无关的 worker 命令执行器,覆盖 INIT 到 STOP 命令。
  • 让 mock worker 改用统一命令执行器,确保原有 100 step 空耦合测试不退化。
  • 统一 seq、ack_seq、worker_state、error_code 和短错误消息的写回规则。
  • 增加命令执行器单元测试,覆盖正常命令、未知命令、错误输入和 STOP 退出。

阶段 C:真实 IPC Worker 主循环

  • 将真实 IPC worker 接入现有 femlite_cclite_transport facade,不新增第二套 IPC 封装。
  • 启动真实 IPC worker 时打开 command block、command event 和 done event。
  • 在真实 IPC worker 启动后进入 READY 状态,并写回初始 ack/state/error 字段。
  • 实现真实 IPC worker 的 wait command、执行命令、写回状态、signal done 主循环。
  • 确认 FemLite 只 wait/signal named event,不 reset 由 CCLite 创建的 event。
  • 为 IPC attach、READY、STOP、timeout 和 open 失败路径补充测试。

阶段 D:AOR_V1 Data Block

  • 设计 AOR_V1 data block header,包含 magic、version、capacity、record count 和错误字段。
  • 设计 FEM_TO_CCL_FACET 最小 facet record,覆盖节点、位置、法向、面积和材料/截面字段。
  • 设计 CCL_TO_FEM_LOAD 最小 nodal force record,覆盖节点力、source、load mode 和 valid flags。
  • 实现 data block 打开、版本检查、容量检查和错误返回,不由 FemLite 创建 data block。
  • 实现空 facet、空 load 的读写闭环,作为真实 IPC worker 最小验收路径。
  • 将 nodal force records 映射到现有 coupling 节点力导入接口。
  • 将 facet records 映射到现有 surface/facet 导出接口,暂以现有字段为准。
  • 为 data block header、容量不足、版本不匹配和空记录路径补充测试。

阶段 E:诊断与日志

  • 扩展 worker log header,记录 backend、solver_id、worker_id、ipc_name 和 timeout。
  • 扩展 worker log header,记录 command_block、data_prefix 和实际 data block 名称。
  • 扩展每条命令日志,记录 command_id、step_id、substep_id、iteration_id 和 ack_seq。
  • 扩展每条命令日志,记录 worker_state、error_code 和短错误消息。
  • 在 WRITE_OUTPUT 或每步结束时同步输出 surface/load 诊断统计。
  • 保持 femlite_cclite_worker.log、femlite_cclite_surface_report.csv、femlite_cclite_load_report.csv 文件名稳定。
  • 为日志字段、错误消息和诊断 CSV 输出补充回归测试。

阶段 F:Process-Level 自测与联调准备

  • 增加本地 IPC self-test helper,用于创建 shared memory 和 named event 测试对象。
  • 增加 process-level worker 自测,覆盖启动、attach、READY、空 facet、空 load 和 STOP。
  • 增加 1 step 空耦合进程级 smoke,验证 CCLite mock 驱动真实 FemLite worker。
  • 增加 100 step 空耦合进程级 smoke,验证 seq/ack、日志和稳定退出。
  • 增加异常输入和 timeout 进程级 smoke,验证可控错误和退出码。
  • 将 process-level 自测纳入常规回归入口,必要时按平台跳过 Windows-only 测试。

阶段 G:文档与版本边界

  • 更新接口控制文档,说明 worker mock、IPC adapter、real IPC worker 的边界。
  • 更新 CCLite 联合改造文档,记录 0.6.5 已完成项和仍暂缓项。
  • 更新用户文档,给出 --cclite-worker 和 --cclite-capabilities 示例。
  • 更新开发路线图,将 0.6.6/0.6.7 的 surface/body id、facet pressure 和 force balance 边界保持清晰。
  • 更新发布检查清单,加入真实 IPC worker 自测、能力查询和日志字段验收。

暂缓到后续版本

  • DEFERRED:稳定 surface id 显式映射和真实 body_id 映射。
  • DEFERRED:facet pressure 中立 data block 导入和完整物理验收。
  • DEFERRED:moment 外部载荷导入。
  • DEFERRED:kinematic boundary 外部约束导入。
  • DEFERRED:真实 SPH-FEM penalty contact 物理验收。
  • DEFERRED:FSI 工程算例。
  • DEFERRED:tied/release 联合接触。
  • DEFERRED:强耦合 rollback 和预测状态接口。
  • DEFERRED:删除旧 sph 命名接口。