87 lines
5.5 KiB
Markdown
87 lines
5.5 KiB
Markdown
# 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` 命名接口。
|