27 KiB
27 KiB
销售管理模块 PRD（复刻：升阳云ERP）
目标系统演示环境：
https://demo.rsun.vip（租户：1001）账号：
admin/ 密码：admin4321
相关文档
| 文档 | 说明 |
|---|---|
| 销售管理-前端开发规范.md | UI组件规范、字段验证、API接口、技术栈 |
| 销售管理-数据模型.md | 数据库表结构、实体关系、视图设计 |
模块概述
业务定位
销售管理模块是 ERP 系统的核心业务模块之一，负责从客户建档、销售合同、销售订单、发货、开票到退货的完整销售业务闭环管理。
核心业务流程
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ 客户档案 │───>│ 销售合同 │───>│ 销售订单 │───>│ 发货通知 │───>│ 开票结算 │
└──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘
│ │
▼ ▼
┌──────────┐ ┌──────────┐
│ 生产计划 │ │ 仓库出库 │
└──────────┘ └──────────┘
│
▼
┌──────────┐
│ 退货通知 │
└──────────┘
单据流转关系
| 上游单据 | 当前单据 | 下游单据 |
|---|---|---|
| - | 客户档案 | 销售合同、销售订单 |
| 客户档案 | 销售合同 | 销售订单 |
| 销售合同/客户档案 | 销售订单 | 生产计划、发货通知单 |
| 销售订单 | 发货通知单 | 销售出库单、开票结算单 |
| 发货通知单 | 开票结算单 | 应收单据 |
| 发货通知单/销售出库单 | 退货通知单 | 退货入库单 |
1. 模块入口与页面清单
销售管理模块位于顶部菜单栏「销售管理」。展开后包含以下功能页面：
- 客户档案：
/om/sales/customer - 销售合同：
/om/sales/contract - 销售订单：
/om/sales/order?workType=0&fmConfig=010202,020202 - 订单进度图：
/om/sales/sequence - 备货订单：
/om/sales/order/hold?workType=1&fmConfig=010202,020202 - 发货通知单：
/om/sales/deliver?workType=0&fmConfig=010203,020203 - 开票结算单：
/om/sales/omfapiao?workType=&fmConfig=010105,020105 - 退货通知单：
/om/sales/reject?bredVouch=1&workType=&fmConfig=010204,020204 - 销售订单计划表：
/om/sales/plan - 销售订单明细表：
/om/sales/detail - 7天交货明细表：
/om/sales/consignment?searchType=true
2. 页面 PRD 明细
2.1 客户档案
- 页面路径：
/om/sales/customer - 页面用途：维护客户基础档案信息；支持查询、查看、修改、删除、导入导出、打印等。
2.1.1 页面布局
-
查询区
- 客户名称（输入框）
- 联系人（输入框）
- 搜索（按钮）
-
工具栏
- 查询所有
- 新增
- 导入
- 导出
- 打印
- 清空
-
列表表格
- 字段：序号、客户名称、简称、公司地址、联系人、手机号、状态、操作
- 操作列按钮：查看、修改、删除
- 状态列：开关（switch）
-
分页区
- 总条数显示（例如：共 486 条）
- 每页条数选择（默认：100条/页）
- 页码切换、前往指定页
2.1.2 交互与操作说明
- 搜索：根据「客户名称」「联系人」过滤列表。
- 查询所有：点击工具栏「查询所有」后，会清空查询条件（例如已输入的客户名称会被清空），并刷新列表为全量数据。
- 新增：点击工具栏「新增」，弹出“客户”新增弹窗（字段与编辑弹窗一致），底部按钮：确定 / 取 消。
- 导入：点击工具栏「导入」，弹出“客户信息导入”弹窗，支持拖拽文件或点击上传；可勾选“是否更新已经存在的客户数据”；仅允许 xls/xlsx。
- 导出：点击工具栏「导出」-> 弹出确认框（标题“警告”，文案“是否确认导出客户档案?”，按钮：取消 / 确定）-> 点击“确定”触发文件下载。
- 打印：点击工具栏「打印」后页面无明显变化（未弹出打印预览/新窗口）。控制台出现日志“操作成功”。（待进一步确认是否触发浏览器打印或被弹窗拦截）
- 清空：点击工具栏「清空」，弹出确认框（标题“警告”，文案“是否确认清空客户档案?”，按钮：取消 / 确定）。本次采集选择“取消”，查询条件未清空。
- 查看：点击列表操作列「查看」，弹出“客户”详情弹窗（只读）。
- 修改：点击列表操作列「修改」，弹出“客户”编辑弹窗（可编辑），底部按钮：保存 / 取 消。
- 删除：点击列表操作列「删除」，弹出确认框（标题“警告”，文案“确认删除”，按钮：取消 / 确定）。本次采集选择“取消”，未实际删除。
- 状态开关：点击状态开关会弹出确认框（标题“警告”，文案“确认停用客户?”，按钮：取消 / 确定）。本次采集选择“取消”，未实际停用。
2.1.3 查看弹窗（客户）
- 弹窗标题：客户
- 打开方式：客户档案列表 -> 操作列 -> 查看
- 弹窗内容：
- 基础信息（均为禁用输入框/选择器，表现为只读）
- 客户名称（必填）
- 客户别名
- 简称
- 所属省/市
- 公司地址
- 邮编
- 电话
- 信用等级
- 信用额度
- 客户分类
- 备注
- 状态（单选：正常/停用）
- Tab 区域：
- 开票信息（默认选中）
- 业务联系人
- 财务联系人
- 开票信息 Tab 字段：
- 开户行
- 地址电话
- 账号
- 税号
- 基础信息（均为禁用输入框/选择器，表现为只读）
- 关闭方式：右上角 Close（×）
2.1.4 Tab 明细（只读）
- 业务联系人 Tab 字段：
- 联系人
- 手机号
- 财务联系人 Tab 字段：
- 联系人
- 手机号
2.1.5 截图与数据留存
- 页面截图：
screenshot/销售管理-客户档案-列表.png - 查看弹窗截图：
screenshot/销售管理-客户档案-查看弹窗.png - 查看弹窗-业务联系人Tab截图：
screenshot/销售管理-客户档案-查看弹窗-业务联系人.png - 查看弹窗-财务联系人Tab截图：
screenshot/销售管理-客户档案-查看弹窗-财务联系人.png - 修改弹窗截图：
screenshot/销售管理-客户档案-修改弹窗.png - 新增弹窗截图：
screenshot/销售管理-客户档案-新增弹窗.png - 删除确认截图：
screenshot/销售管理-客户档案-删除确认.png - 状态切换停用确认截图：
screenshot/销售管理-客户档案-状态切换-停用确认.png - 导出确认截图：
screenshot/销售管理-客户档案-导出确认.png - 导入弹窗截图：
screenshot/销售管理-客户档案-导入弹窗.png - 演示数据（导出文件）：
data/销售管理/客户档案/客户信息-2026年01月25日-16时16分18秒.xlsx - 清空确认截图：
screenshot/销售管理-客户档案-清空确认.png - 查询所有后截图：
screenshot/销售管理-客户档案-查询所有后.png - 打印点击后截图：
screenshot/销售管理-客户档案-点击打印后.png
2.2 销售合同
- 页面路径：
/om/sales/contract - 页面用途：维护/查询销售合同；支持新增合同、导出、查看详情、删除等。
2.2.1 列表页布局
-
查询区
- 销售员（输入框）
- 客户名称（输入框）
- 合同号（输入框）
- 流程状态（下拉）
- 按钮：搜索、重置
-
工具栏
- 新增合同
- 导出
-
列表字段
- 流程实例、业务员、客户名称、合同金额、付款方式、交付日期、流程状态、创建日期、操作
-
操作列
- 详情（所有行）
- 删除（部分行存在）
2.2.2 详情页（合同审批单）
-
进入方式：销售合同列表 -> 操作列 -> 详情
-
页面路径示例：
/om/sales/contractform?taskName=开始&uniqueId=... -
页面标题：合同审批单
-
顶部按钮：保存、提交
-
基础信息区字段：
- 单据编码
- 业务部门（选择器）
- 销售员（选择器）
- 客户名称（只读输入框 + 选择按钮）
- 合同号
- 付款方式
- 交付日期
- 交期状态
- 目的国家
- 地址
- 所属省/市
-
1）销售产品
- 按钮：新增产品
- 表格字段：序号、物料编码、物料名称、主计量、数量、销售单价、销售金额、备注、操作（删除）
-
2）费用
- 按钮：新增费用
- 表格字段：序号、费用项目、费用金额、备注、操作（删除）
-
合同信息
- 合同条款
- 附件上传（点击上传）
2.2.3 新增合同页子交互
- 新增合同：销售合同列表页点击“新增合同”，进入合同审批单页面（结构同详情页）。
- 选择客户：点击客户名称右侧“选择”，弹出“选择客户”弹窗，支持按客户名称/联系人搜索；列表字段：序号、客户名称、联系人、手机号、状态、操作（选择）。
- 新增产品：点击“新增产品”会在销售产品表格中新增一行空行（包含“选择物料”输入框与“选择”按钮）。
- 新增费用：点击“新增费用”会在费用表格中新增一行空行（费用项目下拉 + 金额输入 + 备注 + 删除）。
2.2.4 截图与数据留存
- 列表页截图：
screenshot/销售管理-销售合同-列表.png - 详情页截图（合同审批单）：
screenshot/销售管理-销售合同-详情页-合同审批单.png - 新增合同页截图：
screenshot/销售管理-销售合同-新增合同页.png - 选择客户弹窗截图：
screenshot/销售管理-销售合同-新增合同页-选择客户弹窗.png - 新增产品后截图：
screenshot/销售管理-销售合同-新增合同页-新增产品后.png - 新增费用后截图：
screenshot/销售管理-销售合同-新增合同页-新增费用后.png
2.3 订单进度图
- 页面路径：
/om/sales/sequence - 页面用途：以流程图的形式，可视化地跟踪销售订单在各个业务环节（销售、计划、生产、采购、仓库、财务）的进度与状态。
2.3.1 页面布局与交互
- 初始状态：页面加载后，主区域显示“请选择订单”。
- 工具栏：
- 订单（按钮）：点击后从右侧滑出“销售订单列表”抽屉，用于选择要查看的订单。
- 主题（下拉框）：切换进度图的显示风格（如：默认主题）。
- 截图（按钮）：对当前显示的进度图进行截图。
- 选择订单抽屉：
- 包含销售订单号、客户名称、物料名称、状态等搜索条件。
- 列表展示销售订单号、销售员、客户名称、订单日期等信息。
- 点击列表中的任一行，即可在主页面加载该订单的进度图。
- 进度图展示：
- 选择订单后，主区域展示一个从左到右的流程图，包含“销售”、“计划”、“生产”、“车间”、“采购”、“仓库”、“财务”等节点。
- 每个节点下会显示相关的单据信息和状态，如“销售订单”、“计划订单”、“生产订单”等，并标注日期。
2.3.2 截图与数据留存
- 初始页面截图：
screenshot/销售管理-订单进度图-页面.png - 选择订单抽屉截图：
screenshot/销售管理-订单进度图-选择订单抽屉.png - 已选订单进度图：
screenshot/销售管理-订单进度图-已选择订单-XSDD000066.png
2.4 备货订单
- 页面路径：
/om/sales/order/hold?workType=1&... - 页面用途：管理和查询备货类型的销售订单。
2.4.1 页面布局与交互
- 查询区：支持按合同号、单据编码、客户名称、销售员、物料名称、日期范围等进行搜索。
- 工具栏：包含“单据”、“查询所有”、“新增”、“导出”按钮。
- 列表表格：
- 字段：序号、单据编码、单据状态、销售员、物料名称、数量、金额、销售类型、单据日期等。
- 操作列：每行末尾有“生产进度”链接，点击可跳转至该订单的生产进度详情页。
- 生产进度页：显示指定备货订单的生产流程图，类似于订单进度图，但可能没有数据（如截图所示“没有生产信息”）。
2.4.2 截图与数据留存
- 列表页截图：
screenshot/销售管理-备货订单-列表.png - 生产进度页（无数据）：
screenshot/销售管理-备货订单-生产进度-XSBH000007.png - 生产进度页（另一单据）：
screenshot/销售管理-备货订单-生产进度-XSBH000006.png
2.5 发货通知单
- 页面路径：
/om/sales/deliver?workType=0&... - 页面用途：创建和管理发货通知，是仓库发货的依据。
2.5.1 页面布局与交互
- 列表页：
- 查询区：支持按销售订单号、单据编码、客户名称、销售员、物料名称、日期范围搜索。
- 工具栏：“单据”、“查询所有”、“新增”、“导出”。
- 列表字段：销售订单号、单据编码、单据状态、客户名称、物料名称、发货数量、出库数量、单据日期等。
- 新增发货单页：
- 基础信息：包含单据编码/日期/状态、业务类型、仓库、客户名称、收货人信息、运费等。
- 物料信息：可通过“引入”或“新增物料”来添加发货明细。
- 引入弹窗：点击“引入”后，弹出“销售发货”弹窗，可从销售订单中选择未发货的物料行。
- 新增物料：点击“新增物料”会在下方表格中增加一个空行，用于手动填写物料信息。
- 导出：点击列表页“导出”按钮，会弹出“是否确认导出当前发货单明细?”的确认框。
2.5.2 截图与数据留存
- 列表页截图：
screenshot/销售管理-发货通知单-列表.png - 新增页截图：
screenshot/销售管理-发货通知单-新增发货单.png - 引入弹窗截图：
screenshot/销售管理-发货通知单-新增发货单-引入弹窗.png - 新增物料后截图：
screenshot/销售管理-发货通知单-新增发货单-新增物料后.png - 导出确认截图：
screenshot/销售管理-发货通知单-导出确认.png
2.6 开票结算单
- 页面路径：
/om/sales/omfapiao?workType=&... - 页面用途：用于创建和管理销售开票信息，是财务开具发票的依据。
2.6.1 页面布局与交互
- 列表页：
- 查询区：支持按销售订单号、客户名称、开票名称、日期范围搜索。
- 工具栏：“单据”、“查询所有”、“新增”、“导出”。
- 列表字段：单据编码/日期/状态、业务类型、客户名称、物料名称、数量、金额、已开数量等。
- 新增开票结算单页：
- 基础信息：包含单据编码/日期/状态、业务类型、客户名称（可选择）、税率、发票类型、开户行/账号/税号等财务信息。
- 物料信息：可通过“引入”（初始禁用）或“新增物料”添加开票明细。
- 选择客户弹窗：点击客户名称旁的“选择”按钮，弹出客户选择列表。
- 导出：点击列表页“导出”按钮，会弹出“确认导出开票通知单?”的确认框。
2.6.2 截图与数据留存
- 列表页截图：
screenshot/销售管理-开票结算单-列表.png - 新增页截图：
screenshot/销售管理-开票结算单-新增开票结算单.png - 选择客户弹窗截图：
screenshot/销售管理-开票结算单-新增开票结算单-选择客户弹窗.png - 新增物料后截图：
screenshot/销售管理-开票结算单-新增开票结算单-新增物料后.png - 导出确认截图：
screenshot/销售管理-开票结算单-导出确认.png
2.7 退货通知单
- 页面路径：
/om/sales/reject?bredVouch=1&... - 页面用途：处理客户退货业务，创建退货通知单。
2.7.1 页面布局与交互
- 列表页：
- 查询区：支持按销售订单号、单据编码、客户名称、销售员、物料名称、日期范围搜索。
- 工具栏：“单据”、“查询所有”、“新增”、“导出”。
- 列表字段：销售订单号、单据编码/状态、客户名称、物料名称、退货数量、入库数量、单据日期等。
- 新增退货单页：
- 基础信息：包含单据编码/日期/状态、业务类型、仓库、客户名称、退货原因、处理方式等。
- 物料信息：可通过“引入”或“新增物料”添加退货明细。
- 引入弹窗：点击“引入”，弹出“销售退货”弹窗，可从已发货的记录中选择要退货的物料。
- 导出：点击列表页“导出”按钮，弹出“是否确认导出当前退货单明细?”的确认框。
2.7.2 截图与数据留存
- 列表页截图：
screenshot/销售管理-退货通知单-列表.png - 新增页截图：
screenshot/销售管理-退货通知单-新增退货单.png - 引入弹窗截图：
screenshot/销售管理-退货通知单-新增退货单-引入弹窗.png - 新增物料后截图：
screenshot/销售管理-退货通知单-新增退货单-新增物料后.png - 导出确认截图：
screenshot/销售管理-退货通知单-导出确认.png
2.8 销售订单计划表
- 页面路径：
/om/sales/plan - 页面用途：以计划的视角展示销售订单的执行情况，重点关注订单数量与计划数量的对比。
2.8.1 页面布局与交互
- 查询区：支持按销售订单号、客户名称、销售员、销售类型、物料名称、日期范围搜索。
- 工具栏：“查询所有”、“导出”、“打印”。右侧还有物料分类的快捷筛选按钮（如：纸杯机、配套机等）。
- 列表表格：表格分为左右两部分，左侧为订单基本信息（合同号、销售订单号、客户、销售员、日期等），右侧为数量信息（订单数量、计划数量、未执行数量）。
2.8.2 截图与数据留存
- 列表页截图：
screenshot/销售管理-销售订单计划表-列表.png
2.9 销售订单
- 页面路径：
/om/sales/order?workType=0&fmConfig=010202,020202 - 页面用途：创建、管理销售订单；是销售业务的核心单据，关联后续的发货、开票、生产计划等环节。
2.9.1 列表页布局
-
查询区
- 合同号（输入框）
- 单据编码（输入框）
- 客户名称（输入框）
- 销售员（输入框）
- 销售类型（下拉框）
- 物料名称（输入框）
- 日期范围（开始日期 - 结束日期）
- 搜索（按钮）
-
工具栏（明细视图）
- 单据（切换到单据视图）
- 查询所有
- 新增
- 导出
-
工具栏（单据视图）
- 明细（切换到明细视图）
- 查询所有
- 新增
- 删除（需勾选后启用）
- 审核（需勾选后启用）
- 反审核（需勾选后启用）
2.9.2 明细视图列表
- 表格字段：序号、合同号、单据编码、单据状态、客户名称、销售员、物料名称、物料编码、数量、单价、金额、发货数量、销售类型、单据日期
- 操作列：每行末尾有"生产进度"链接，点击可跳转至该订单的生产进度图
2.9.3 单据视图列表
- 表格字段：复选框、单据编码、单据日期、单据状态、业务类型、销售客户、销售员、业务状态、审核日期、操作
- 操作列按钮：查看、编辑、删除
- 单据状态：审核、开立、退回等
2.9.4 查看订单详情页
- 进入方式：单据视图 -> 操作列 -> 查看
- 页面路径示例：
/om/sales/orderview0?detailCode=XSDD000066&open=seeStatus&... - 顶部按钮：新增、编辑（已审核时禁用）、审核（已审核时禁用）、反审核、打印、操作、收起
- 基础信息区字段（只读）：
- 单据编码、单据日期、单据状态、单据类型
- 业务类型、业务状态、销售部门、销售人员
- 操作员、审核员、审核日期、销售类型、供货方式
- 客户名称、合同号（带预览链接）、付款条件、交付日期、交期状态（预计/确认）
- 收货人、电话、地址、目的国家、备注信息
- 物料信息表格：序号、物料编码、物料名称、型号规格、主计量、数量、单价、金额、质量要求、备注
2.9.5 编辑订单页
- 进入方式：单据视图 -> 操作列 -> 编辑（仅"开立"或"退回"状态可编辑）
- 页面路径示例：
/om/sales/orderedit0?detailCode=XSDD000059&open=updateStatus&... - 顶部按钮：保存、撤回、审核（禁用）、反审核（禁用）、操作、收起
- 基础信息区字段（部分可编辑）：
- 单据编码（只读）、单据日期、单据状态、单据类型（只读）
- 业务类型（只读）、业务状态（只读）、销售部门、销售人员
- 操作员（只读）、审核员（只读）、审核日期（只读）、销售类型、供货方式
- 客户名称（带"选择"按钮）、合同号（带"上传"按钮）、付款条件、交付日期、交期状态
- 收货人、电话、地址、目的国家、备注信息
- 物料信息区：
- 按钮：引入、新增物料
- 表格字段：序号、物料编码（带"选择"按钮）、物料名称、型号规格、主计量、数量、单价、金额、质量要求、备注、操作（删除）
2.9.6 删除确认
- 触发方式：单据视图列表 -> 操作列 -> 删除
- 确认弹窗：标题"警告"，内容"确认删除"，按钮：取消 / 确定
2.9.7 截图与数据留存
- 明细视图列表截图：
screenshot/销售管理-销售订单-明细视图-列表.png - 单据视图列表截图：
screenshot/销售管理-销售订单-单据视图-列表.png - 查看订单详情截图：
screenshot/销售管理-销售订单-查看订单详情.png - 编辑订单页截图：
screenshot/销售管理-销售订单-编辑订单页.png - 删除确认弹窗截图：
screenshot/销售管理-销售订单-删除确认弹窗.png - 演示数据：
data/销售管理/销售订单/销售订单-列表-前10行.json、data/销售管理/销售订单/销售订单-单据明细-前10行.json
2.10 销售订单明细表
- 页面路径：
/om/sales/detail - 页面用途：以物料明细的视角展示所有销售订单，便于按物料维度统计和跟踪订单执行情况。
2.10.1 页面布局与交互
- 工具栏：查询所有、导出、打印、计划生产、库存供应、买进卖出
- 列表表格字段：序号、销售员、销售订单号、业务类型、订单交期、交期状态、物料编码、物料名称、质量要求、包装要求、件数、目的国家、订单数量、未发货数量
- 底部汇总：显示订单数量合计（如"订单数量: 7,157"）和总条数（如"共 52 条"）
2.10.2 截图与数据留存
- 列表页截图：
screenshot/销售管理-销售订单明细表-列表.png
2.11 7天交货明细表
- 页面路径：
/om/sales/consignment?searchType=true - 页面用途：筛选显示交货日期在未来7天内的订单明细，帮助销售和仓库部门提前安排发货。
2.11.1 页面布局与交互
- 查询区：销售订单号、客户名称、销售员、销售类型、物料名称、搜索
- 工具栏：查询所有、导出、打印
- 列表表格字段：序号、合同号、销售订单号、客户名称、销售员、单据日期、交货日期、销售类型、物料编码、物料名称、发货数量、出库数量、未出库数量、订单数量、未发货数量
- 空态显示："暂无数据"（当没有符合7天内交货条件的订单时）
2.11.2 截图与数据留存
- 列表页截图：
screenshot/销售管理-7天交货明细表-列表.png
3. 任务完成说明
销售管理模块共 11 个功能页面，已全部完成 PRD 采集：
| 序号 | 页面名称 | 状态 | 页面路径 |
|---|---|---|---|
| 1 | 客户档案 | ✅ | /om/sales/customer |
| 2 | 销售合同 | ✅ | /om/sales/contract |
| 3 | 销售订单 | ✅ | /om/sales/order |
| 4 | 订单进度图 | ✅ | /om/sales/sequence |
| 5 | 备货订单 | ✅ | /om/sales/order/hold |
| 6 | 发货通知单 | ✅ | /om/sales/deliver |
| 7 | 开票结算单 | ✅ | /om/sales/omfapiao |
| 8 | 退货通知单 | ✅ | /om/sales/reject |
| 9 | 销售订单计划表 | ✅ | /om/sales/plan |
| 10 | 销售订单明细表 | ✅ | /om/sales/detail |
| 11 | 7天交货明细表 | ✅ | /om/sales/consignment |
文档交付清单
| 类型 | 文件路径 | 说明 |
|---|---|---|
| PRD主文档 | prd/销售管理.md |
页面功能描述、交互说明 |
| 前端规范 | prd/销售管理-前端开发规范.md |
UI组件、API接口、验证规则 |
| 数据模型 | prd/销售管理-数据模型.md |
数据库表结构、ER图 |
| 截图目录 | screenshot/销售管理-*.png |
80+ 张页面截图 |
| 数据目录 | data/销售管理/ |
JSON/Excel 演示数据 |
前端开发关键点
- 技术栈：Vue 2.x + Element UI 2.15.x
- 路由模式：History 模式，需后端支持
- 多租户：URL 参数
tenant=1001 - 权限控制：按钮级权限，状态驱动
- 数据联动：选择客户后自动带出收货信息
- 单据流转：引入上游单据数据，自动关联
开发优先级建议
- 第一阶段：客户档案、销售订单（核心）
- 第二阶段：发货通知单、退货通知单
- 第三阶段：销售合同、开票结算单
- 第四阶段：订单进度图、报表页面（计划表、明细表、7天交货）
- 第五阶段：备货订单（复用销售订单逻辑）