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

87 lines
5.5 KiB
Markdown
Raw 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.
# FemLite TODO
文档状态:根据 `docs/12_cclite_integration_suggestions.md` 重写。当前待办面向 0.6.5,目标是完成真实 IPC worker 接入闭环。
## 开发边界
- [x] 保留现有 worker mock,不把 mock 结果描述为真实 IPC worker。
- [x] 保持 FemLite 独立求解器身份,不把 CCLite/SPHLite 算法核心写入 FemLite。
- [x] 本轮只做数据边界、worker 通信、自测和诊断,不做真实 SPH-FEM 接触物理验收。
- [x] 每个开发阶段完成后补充对应 smoke、单元测试或文档验收。
## 阶段 A:Worker CLI 与能力查询
- [x] 盘点现有 `--cclite-worker` 参数解析、默认值、错误返回和测试覆盖。
- [x] 增加 `--solver-id`、`--timeout-ms`、`--worker-id` 参数,并保持旧参数兼容。
- [x] 增加 `--command-block`、`--data-prefix`、`--worker-backend` 参数,并明确 mock/ipc 模式选择规则。
- [x] 校验 `--solver-id` 初期只接受 `FEM` 或 `FEMLite`,错误时输出稳定错误码。
- [x] 新增 `--cclite-capabilities` CLI,输出稳定 `key=value` 文本。
- [x] 为能力查询补充测试,覆盖 mock、Windows IPC 支持状态和非 Windows unsupported 状态。
## 阶段 B:Worker 命令执行器解耦
- [x] 盘点现有 mock worker 命令状态机和日志字段,找出与 mock backend 绑定的逻辑。
- [x] 抽出 backend 无关的 worker 命令执行器,覆盖 `INIT` 到 `STOP` 命令。
- [x] 让 mock worker 改用统一命令执行器,确保原有 100 step 空耦合测试不退化。
- [x] 统一 `seq`、`ack_seq`、`worker_state`、`error_code` 和短错误消息的写回规则。
- [x] 增加命令执行器单元测试,覆盖正常命令、未知命令、错误输入和 STOP 退出。
## 阶段 C:真实 IPC Worker 主循环
- [x] 将真实 IPC worker 接入现有 `femlite_cclite_transport` facade,不新增第二套 IPC 封装。
- [x] 启动真实 IPC worker 时打开 command block、command event 和 done event。
- [x] 在真实 IPC worker 启动后进入 READY 状态,并写回初始 ack/state/error 字段。
- [x] 实现真实 IPC worker 的 wait command、执行命令、写回状态、signal done 主循环。
- [x] 确认 FemLite 只 wait/signal named event,不 reset 由 CCLite 创建的 event。
- [x] 为 IPC attach、READY、STOP、timeout 和 open 失败路径补充测试。
## 阶段 D:AOR_V1 Data Block
- [x] 设计 `AOR_V1` data block header,包含 magic、version、capacity、record count 和错误字段。
- [x] 设计 `FEM_TO_CCL_FACET` 最小 facet record,覆盖节点、位置、法向、面积和材料/截面字段。
- [x] 设计 `CCL_TO_FEM_LOAD` 最小 nodal force record,覆盖节点力、source、load mode 和 valid flags。
- [x] 实现 data block 打开、版本检查、容量检查和错误返回,不由 FemLite 创建 data block。
- [x] 实现空 facet、空 load 的读写闭环,作为真实 IPC worker 最小验收路径。
- [x] 将 nodal force records 映射到现有 coupling 节点力导入接口。
- [x] 将 facet records 映射到现有 surface/facet 导出接口,暂以现有字段为准。
- [x] 为 data block header、容量不足、版本不匹配和空记录路径补充测试。
## 阶段 E:诊断与日志
- [x] 扩展 worker log header,记录 backend、solver_id、worker_id、ipc_name 和 timeout。
- [x] 扩展 worker log header,记录 command_block、data_prefix 和实际 data block 名称。
- [x] 扩展每条命令日志,记录 command_id、step_id、substep_id、iteration_id 和 ack_seq。
- [x] 扩展每条命令日志,记录 worker_state、error_code 和短错误消息。
- [x] 在 `WRITE_OUTPUT` 或每步结束时同步输出 surface/load 诊断统计。
- [x] 保持 `femlite_cclite_worker.log`、`femlite_cclite_surface_report.csv`、`femlite_cclite_load_report.csv` 文件名稳定。
- [x] 为日志字段、错误消息和诊断 CSV 输出补充回归测试。
## 阶段 F:Process-Level 自测与联调准备
- [x] 增加本地 IPC self-test helper,用于创建 shared memory 和 named event 测试对象。
- [x] 增加 process-level worker 自测,覆盖启动、attach、READY、空 facet、空 load 和 STOP。
- [x] 增加 1 step 空耦合进程级 smoke,验证 CCLite mock 驱动真实 FemLite worker。
- [x] 增加 100 step 空耦合进程级 smoke,验证 seq/ack、日志和稳定退出。
- [x] 增加异常输入和 timeout 进程级 smoke,验证可控错误和退出码。
- [x] 将 process-level 自测纳入常规回归入口,必要时按平台跳过 Windows-only 测试。
## 阶段 G:文档与版本边界
- [x] 更新接口控制文档,说明 worker mock、IPC adapter、real IPC worker 的边界。
- [x] 更新 CCLite 联合改造文档,记录 0.6.5 已完成项和仍暂缓项。
- [x] 更新用户文档,给出 `--cclite-worker` 和 `--cclite-capabilities` 示例。
- [x] 更新开发路线图,将 0.6.6/0.6.7 的 surface/body id、facet pressure 和 force balance 边界保持清晰。
- [x] 更新发布检查清单,加入真实 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` 命名接口。