# 醋业销售 CRM 项目进度纪要

> 记录日期：2026-09-22（最近一次阶段性结束自动同步）

---

## 零、最新进展（2026-09-22：客户账号关联多家公司 + 订单流程调整）

**员工可为一个客户账号挂多家公司（客商），客户下单时选择「下单给哪家公司」。**

- **正式网址**：http://47.94.5.75/app/ （登录即用，手机优先）
- **本阶段（9-22）改动**：
  - 新增「客户账号」管理页：员工在一个表单里填客户名字 + 登录账号 + 密码，并**勾选一家或多家公司（客商）**一次性建号；创建成功后弹「账号信息」面板，方便员工把账号密码发给客户（账号分发）
  - 一个客户账号可关联**多家公司**；一家公司只归属一个账号；可编辑（改名字 / 重置密码 / 改关联公司）、可删除（解绑公司，公司档案保留）
  - 客户登录「新建订单」时：顶部显示自己的名字；名下挂**多家**公司时出现下拉框选「下单给哪家公司」，只挂**一家**时直接显示公司名（不显示下拉），一家都没挂时提示联系管理员
  - 老「开通账号」快捷入口（客户档案内）保留兼容，改为写入新关联表；删除客户档案时自动清理不再关联任何公司的空账号
  - **订单流程调整**：下单时**同时上传付款凭证**（客户必传）→ 状态「待审核」；审核通过后变「待发货」；实际发货后变「已发货」；去掉「已签收」环节；客户发货前可重新上传凭证、发货后不可改
  - （承接 9-21：库存已接入 ERP 真实现存量，下单超过现存量时提示「因该品可用量不足原因，可能延长送货周期」）

---

## 一、已完成的工作

1. **需求挖掘**：读取原始需求 Word，多轮提问，把需求从「客户+拜访+报表」扩展成完整销售闭环。
2. **定稿需求**：《需求规格书 V3》（8 大模块 + 5 角色）。
3. **界面原型**：可点击原型（单文件 HTML）→ 拆分为模块化结构 → 接入真实后端。
4. **原型迭代（8-20）**：6 处细节修改（订单去折扣额、客户类型/标签、区域改地址、产品加存货编码、去破损类别、破损补偿精简）。
5. **后端 + 数据库（8-25）**：PostgreSQL 建库 + 11 表 + 种子数据 + 9 组 REST 接口。
6. **前端接真实数据（8-25）**：9 个模块从静态假数据改为 api() 取数 + 增删改。
7. **云端部署（8-25）**：systemd 服务 + nginx 反代，正式可写入网址上线。
8. **订单重构 + 移动端（8-26）**：订单改客户自助下单 + 支付凭证上传 + 全站移动端适配。

---

## 二、已确定的关键决策

| 项 | 决定 |
|---|---|
| 开发方 | 委托 Claude 编写 |
| 使用规模 | 联网云端，多人共用同一套数据 |
| 技术栈 | Vue3 + Electron（.exe）+ Node.js + PostgreSQL |
| 使用方式 | 手机为主 + 电脑辅助（移动优先） |
| 角色 | 老板 / 销售总监 / 销售经理 / 业务员 / 销售内勤 |

**8 大模块**：客户档案、产品SKU与价格、经销合同（仅有效期）、订单（不扣库存）、渠道动销、财务、报表、系统管理。

---

## 三、关键业务规则

- **破损补偿**：瓶装 0.5% / 袋装 2%，按发货数量计算，季度结束次月「货补」。
- **返利**：按销售额 + 销售任务指标，规则复杂 → 专项沟通，系统做成可配置。
- **库存 / 临期 / 散装**：不做，归仓储环节。
- **打卡**：业务员手机定位打卡。

---

## 四、部署信息（服务器）

| 项 | 内容 |
|---|---|
| 公网 IP | 47.94.5.75（阿里云 ECS，Ubuntu 26.04） |
| 正式网址 | http://47.94.5.75/app/ |
| 前端目录 | /var/www/crm/app/（index.html + css/ + js/） |
| 后端目录 | /var/www/crm/server/（Node/Express，systemd 服务 `crm`，端口 3000） |
| 数据库 | PostgreSQL 18，库 `crm`（用户 crm/crm123456） |
| 反向代理 | nginx `/api/` → 127.0.0.1:3000 |

---

## 五、下一步

1. **验收试用**：在 http://47.94.5.75/app/ 用 boss/123456 登录（或 业务员1、经销商1 等账号），逐模块点一遍，反馈要改的地方。
2. **导入确认**：核对已导入的 355 产品、943 客户；确认价格映射（经销商价←批发销售、商超价←商超销售）是否符合预期。
3. **微信小程序上线**：按步骤说明办理域名备案、小程序账号注册等事项，我同步搭建小程序端。
4. **打包 .exe**：迁移到 Vue3 + Electron，出 Windows 桌面版（连同一云端）。

---

## 六、待提供 / 待沟通清单（不阻塞，对应模块开发前到位即可）

| # | 事项 | 需要时机 |
|---|---|---|
| 1 | ✅ 产品清单（已提供并导入 355 条） | 已完成 |
| 2 | 返利计算规则 | 做「财务-返利」前 |
| 3 | 各角色权限明细 | 做「系统管理」前 |
| 4 | 合同到期是否需要提醒 | 做「合同」前 |
| 5 | ✅ 历史数据（已导入：产品 355 + 客户 943） | 已完成 |
| 6 | 拜访打卡手机端标签文案 | 做「拜访打卡」前 |

---

## 七、下次如何继续

- 命令行输入 `claude --continue` 或 `claude --resume` 即可恢复本对话。
- 或直接新开对话，把桌面这些文件路径发给我，我也能接着干。