docs: 更新项目说明并存档开发进度（重装后快速启动）

- 项目说明新增：系统实现现状、目录结构、三端启动指南、模块状态、待办清单、常见坑位 - 新增 AI开发日志/2026-08-23.md 开发进度存档
2026-08-23 11:15:23 +08:00
parent f2a4a5a96e
commit b124e709dd
2 changed files with 119 additions and 2 deletions
@@ -0,0 +1,22 @@
+# 2026-08-23 开发日志
+
+## 本日工作
+- 更新根目录《项目说明》文档：新增「三、系统实现现状」「四、开发进度状态存档」「五、常见坑位与经验」三大章节，补齐技术栈落地、目录结构、本地启动指南（三端命令 + 端口 + 账号）、模块上线状态、待办清单。
+- 目的：用户将重新安装 CodeBuddy 并更换文件夹路径，需要靠根目录文档快速无探索恢复项目上下文、直接启动。
+
+## 项目启动速记（详见《项目说明》3.3）
+- 后端：`cd server && dotnet run --project src/F9MES.Api/F9MES.Api.csproj --launch-profile http`（端口 5136，启动 60-70 秒属正常）
+- 前端：`cd web && npm install && npm run dev`（端口 5173）
+- 打印：`cd openprint && npm install && npm run dev`（端口 5227）
+- 账号：`13800000000 / 123456`
+
+## 四模块开发进度（截止今日，均待补业务服务层）
+- WmsWu（五金）：实体 + 页面 + TABLE_MAP/BILL_MAP 已就绪；缺 `WmsWuService`（库存重算 + Ledger 台账流水）、`DataController.StockLink` 挂接 `WmsWu_InStock/OutStock`。
+- Enms（能耗）：实体 + 页面已就绪；缺 `EnmsService`（抄表 Usage 自动计算 + 按账期/规则分摊写 AllocateResult）、Reading 联动挂接。
+- Sams（销售）：实体 + 页面已就绪；缺 `SamsService`（发货→ContractItem.ShippedQuantity / Contract.ExecutedAmount；回款→PaidAmount）。
+- Fims（成品）：实体 + 页面 + FimsService/StockService 联动已建；仅剩 bill-configs 补 2 张表（Stock/StatusChange）。
+- WmsFu（副产品）：实体 + 页面已就绪；缺库存联动服务。
+- 统一收尾：MetaController 补 CodeRules/RefMap；bill-configs.js 补 8 张表布局；Program.cs 注册新服务。
+
+## 待办下一步
+按《项目说明》3.5 顺序：WmsWuService → EnmsService → SamsService → WmsFu → Meta 补充 → bill-configs 补充 → dotnet build 验证。