Codex 项目变更日志

项目路径：D:\SalesCRM

用途：记录每次由 Codex 执行的系统优化、部署准备、数据结构调整和验证结果，避免后续遗忘、重复修改或丢失上下文。

记录规则

每次执行优化前后都要记录：

• 执行时间
• 本次目标
• 修改文件
• 主要变更
• 验证方式
• 结果
• 遗留问题/下一步

---

2026-07-15 变更日志制度建立

本次目标：

• 建立固定变更日志文件。
• 后续所有 CRM 项目优化都追加记录到本文件。

修改文件：

• docs/codex-change-log.md

结果：

• 已建立日志模板。

下一步：

• 开始执行 codex-task-list.md 中上线前高优先级优化。

---

2026-07-15 JSON原子写入与客户类别字段

本次目标：

• 提升 crm_full_data.json 保存安全性，降低写入中断造成数据文件损坏的风险。
• 补齐客户类别字段，让“来源平台”和“客户类别”分开记录、筛选、编辑和导出。

修改文件：

• work/crm_full_server.js
• outputs/sales_crm_full_demo.html
• docs/codex-change-log.md

主要变更：

• 后端保存数据改为先写临时文件，再替换正式 JSON 文件，并增加 _version 版本递增。
• 后端读取历史客户时自动补 customerCategory，老数据默认使用原 source。
• 新增客户、编辑客户、离线本地体验、CSV 导出均支持 customerCategory。
• 客户列表增加“客户类别”列，客户筛选增加“客户类别”筛选。
• 客户详情抽屉的基础资料和运营来源资料均可编辑客户类别。

验证方式：

• 执行 node --check work/crm_full_server.js。
• 执行前端脚本解析检查。
• 临时启动 8097 端口，完成登录、新增测试客户、读取客户类别、删除测试客户闭环。

结果：

• 后端语法检查通过。
• 前端脚本解析通过。
• 接口闭环验证通过：测试客户保存 customerCategory=快手 后可读取，并已删除测试客户。

遗留问题/下一步：

• 暂未清理 D:\SalesCRM\data\data、D:\SalesCRM\outputs\outputs、D:\SalesCRM\work\work 等重复目录，删除前需要再次确认，避免误删用户数据。
• codex-task-list.md 中产品表、销售订单明细、密码安全等高优先级事项仍需后续逐项执行。

---

2026-07-15 导航固定折叠与账号权限勾选

本次目标：

• 解决左侧导航和主页面一起滚动，导致页面底部看不到主内容的问题。
• 给左侧部门导航增加收起/展开能力。
• 主管后台可按账号勾选开通或取消部门权限，不再只能按岗位固定权限。

修改文件：

• outputs/sales_crm_full_demo.html
• work/crm_full_server.js
• docs/codex-change-log.md

主要变更：

• 页面布局改为左侧导航独立滚动、右侧主页面独立滚动。
• 左侧每个大部门模块支持点击收起/展开，默认保留第一个模块展开，其余模块收起。
• 前端新增权限目录和权限勾选区，账号列表显示实际开通权限。
• 导航显示从“按岗位”调整为“按账号权限”，主管可给不同部门人员开通对应模块。
• 后端账号保存接口支持保存自定义权限，编辑账号时不再自动重置为岗位默认权限。

验证方式：

• 执行 node --check work/crm_full_server.js。
• 执行前端脚本解析检查。

结果：

• 后端语法检查通过。
• 前端脚本解析通过。

遗留问题/下一步：

• 当前权限主要用于前端导航和账号配置展示，后续上线前建议继续把关键接口也逐步加上按权限校验。

---

2026-07-16 销售订单生成销售单流程优化

本次目标：

• 参照旧智能云系统截图，优化销售订单板块的“生成销售单”操作。
• 补齐销售单中仓库、送货方式、商品明细、结算账户、现结款、欠款、销售员、保存并审核等关键字段。

修改文件：

• outputs/sales_crm_full_demo.html
• work/crm_full_server.js
• docs/codex-change-log.md

主要变更：

• 后端业务数据类型新增 salesBills，用于保存销售单记录。
• 销售订单列表每行增加“销售单”操作。
• 顶部“生成单据”调整为“生成销售单”，打开销售单弹层而不是静默生成多类记录。
• 新增销售单弹层，自动从销售订单带出客户、订单号、商品、数量、单价、销售员、备注等信息。
• 销售单支持出库仓库、送货方式、商品明细、折扣、结算账户、现结款、其它费用、优惠金额、欠款和总金额计算。
• “保存并审核”会创建销售单记录，并回写销售订单的销售单状态、审核状态、收款和欠款信息。

验证方式：

• 执行 node --check work/crm_full_server.js。
• 执行前端脚本解析检查。
• 临时启动 8098 端口，验证 salesBills 业务记录可创建、读取、删除。

结果：

• 后端语法检查通过。
• 前端脚本解析通过。
• salesBills 接口闭环验证通过，测试记录已删除。

遗留问题/下一步：

• 当前销售单先支持单行商品明细，后续可继续扩展为多商品行、商品库选择、扫码录入和附件云存储。
• 销售单生成后与真实库存扣减、出库审核、物流签收、财务收款的联动还需要继续细化。

---

2026-07-17 正式开发目录迁移到 E 盘

本次目标：
- 将销售 CRM 的正式开发目录迁移到 E:\code\SalesCRM。
- 保留原 C 盘开发目录和 D 盘部署/备份目录，不删除旧数据，避免误删。
- 后续开发、优化、同步、部署默认以 E:\code\SalesCRM 作为正式代码目录。

涉及目录：
- 原开发目录：C:\Users\Administrator\Documents\Codex\2026-07-04\wo-x
- 新正式开发目录：E:\code\SalesCRM
- 本地部署/备份目录：D:\SalesCRM
- 云服务器部署目录：/home/ubuntu/SalesCRM

主要变更：
- 创建 E:\code\SalesCRM。
- 将当前项目完整复制到 E:\code\SalesCRM，包括 work、outputs、data、docs、deploy、tools、package.json、start_crm.bat 等内容。
- 后续对销售 CRM 的代码修改，默认在 E:\code\SalesCRM 进行，再按需要同步到 D 盘或云服务器。

验证方式：
- 在 E:\code\SalesCRM 执行 node --check work\crm_full_server.js。

结果：
- 新目录已创建并完成复制。
- 后端语法检查通过。

遗留问题/下一步：
- 若后续需要彻底切换开发工作区，可将 Codex 当前工作目录也切到 E:\code\SalesCRM。
- D 盘仍作为本地部署/备份目录，不作为主要代码开发目录。