版本更新记录:
| 序号 | 日期 | 更改内容 | 版次 | 起草或修订人 | 批准人 |
|---|---|---|---|---|---|
| 1 | 2020-7-13 | 新文件建立 | 1.0 | 孙怡芳 | Eric |
| 2 | 2020-7-28 | 新增用例图 | 1.1 | 孙怡芳 | Eric |
| 3 | 2020-08-03 | 新增业务流程图 | 1.2 | 孙怡芳 | Eric |
| 4 | 2020-08-06 | - 新增服务关系配置模块功能说明 - 全局总览新增跳转至用户管理页面功能说明 - 图例新增经销商点位功能说明 - 全局配置新增日志查询功能说明 |
1.3 | 孙怡芳 |
最新prd文档:
待更新
4.3 线路
4.3.1 功能描述
“线路”模块包含“线路配置”、“线路管理”、“历史实际拜访”三大功能块,具体功能如下:
| 模块名称 | 实现功能 | 操作角色 |
|---|---|---|
| 线路配置 | 配置服务日划分权重,服务日及工作时长等参数,生成计划线路 | 线路规划专员 |
| 线路管理 | 管理已生成的线路,并对线路计划进行调整 | |
| 历史实际拜访 | 查看历史实际拜访线路方案,为未来规划提供参考 | |
| 线路还原 | 按一定的格式,手工整理拜访计划excel,将拜访计划上传到“线路还原”工具中,可视化呈现拜访计划,并支持调整计划,调整后导出计划并上传到师傅通中执行; |
4.3.2 原型页面

线路配置-列表页面

线路配置-新增线路配置方案页面

线路管理页面,在管理页面中修改/编辑线路并提交审核
4.4 数据管理
4.4.0 功能描述
在系统内通过不同维度:“部门”、“人员”、“客户”查询不同客户信息及相关状态;数据源取自“师傅通”系统,每日24点进行数据同步。
4.4.1 功能拆解-数据查询(二期新增)
- 通过菜单栏进入“数据查询”功能
- 数据查询维度及字段类型描述如下:
| 数据查询维度 | 对应查询字段 | 备注 |
| —- | —- | —- |
| 部门 | 部门名称 |
- 搜索项支持模糊/精确查询
- 下拉选择项系统自动带出
- 点击“重置”清空搜索项
- 查询后列表显示字段:部门编码、部门名称、上级部门名称、部门名称全路径、部门状态、创建时间、修改时间、同步时间
| | | 部门状态 | | | 人员 | 所属部门 |
- 搜索项支持模糊/精确查询
- 下拉选择项系统自动带出
- 点击“重置”清空搜索项
- 查询后列表显示字段:员工登录账号、姓名、性别、手机号码、是否机构领导、职务、岗位、账号状态、创建时间、修改时间、同步时间
| | | 员工账户 | | | | 姓名 | | | | 账号状态 | | | | 职务 | | | | 岗位 | | | 客户 | 客户编码 |
- 搜索项支持模糊/精确查询
- 下拉选择项系统自动带出
- 点击“重置”清空搜索项
- 查询后列表显示字段:客户编码、客户名称、经销商名称、客户类型、合作状态、客户经理、客户级别、销售区域、详细地址、删除状态、审批状态、同步时间
| | | 客户名称 | | | | 经销商名称 | | | | 客户经理 | | | | 客户级别 | | | | 客户类型 | |

按“部门”维度查询,查询字段有:部门名称、部门状态

按“人员”维度查询,查询字段有:所属部门、员工账户、姓名、账号状态、职务、岗位

按“客户”维度进行查询,查询字段有:客户编码、客户名称、客户经理、客户级别、客户类型
4.5 用户登录
4.5.1 功能描述
- 登录方式:访问系统地址后输入账户名密码进行登录;
- 身份识别:系统对用户登录信息进行验证,验证通过后根据用户的访问权限的设置显示不同的功能模块。
4.5.2 原型页面

系统登录页面
五、接口需求
5.1 内部接口
5.2 外部接口
5.2.1 从师傅通获取数据
目前从师傅通系统取数,使用到以下8个接口。同一时间最多有2个API同时进行,避免师傅通压力过大。
5.2.2 数据写入师傅通
GAIA线路规划产品,会根据康饮提供的配置参数,对业代进行片区划分,并生成计划拜访线路。在这个过程中,会引起网点与组织,网点与业代的关系发生变更,需要将数据回流到师傅通系统,并将计划拜访线路传输到师傅通。为了打通两个系统间实时数据交互,目前需师傅通系统配合提供数据对接接口(包括正式环境和测试环境)。该文档旨在说明系统对接的各个场景,以及涉及的对接内容,做一个初步的建议和规划。
数据交互流转图
| 修改客户数据接口 | |
|---|---|
| 场景描述 | - 调整营业所管辖边界时,客户与所属部门的对应关系可能发生变更,需要将最新的所属部门更新至师傅通系统; - 调整业代管辖边界,或者为片区重新分配业代时,客户与业代的归属关系可能发生变更,需要将最新的业代更新至师傅通系统。 |
| 接口调用方 | GIAI |
| 接口提供方 | 师傅通 |
| 调用条件 | / |
| 接口调用流程 | / |
| 新增客户数据接口 | |
|---|---|
| 场景描述 | 在计划线路中加入GAIA推荐客户时,需要将客户主档新增至师傅通系统 |
| 接口调用方 | GIAI |
| 接口提供方 | 师傅通 |
| 调用条件 | / |
| 接口调用流程 | / |
| 计划拜访线路更新接口 | |
|---|---|
| 场景描述 | 线路规划中,当生成/变更计划拜访线路,需将计划线路更新或新增至师傅通系统,内容有:计划拜访日期,客户编码,客户名称,拜访人编码,拜访人名称,拜访顺序 |
| 接口调用方 | GIAI |
| 接口提供方 | 师傅通 |
| 调用条件 | / |
| 接口调用流程 | / |
六、数据逻辑描述
6.1 数据范围
本项目中使用到的数据,按用途及来源主要分为四大类:
| 数据类型 | 类型定义 |
|---|---|
| 主数据 | 组织架构、员工、客户(客户ID,客户名称,客户部门,所属业代,经纬度) |
| 业务数据 | 生成的计划拜访线路数据 |
| 其他数据 | 调取高德地图上客户经纬度,路程时长,路况信息等 |
| 配置数据 | 参与划区建线计算配置的一些参数,全局参数(门店规模,拜访频次与在店时长),片区设置参数(业代人数,划分权重),线路配置参数(服务日,权重) |
6.2 目前数据获取情况:
- 业务数据
- 实际拜访线路
- 经销商订单信息,包括销量及销额
- 已获取2018至2019年历史数据
- 静态主数据
- 组织架构
- 员工
- 客户主数据
6.3 数据逻辑
| 数据名称 | 取值口径 |
|---|---|
| 网点销量销额 | 不同时间颗粒度下(月度、季度等),有效回单的总销量(箱)和总金额。 |
| 单个网点拜访每周频次 | 不同时间颗粒度下网点的拜访次数/时间颗粒度下的周数 |
| 拜访达成率 | 当日业代按照计划拜访的网点数/当日业代计划拜访网点总数 |
| 拜访成交率 | 当日业代拜访门店中下单网点数/当日业代计划拜访网点总数 |
| 拜访网点数 | 单个业代拜访所有网点数的总和 |
| 拜访路途和在店时长 | - 当日拜访总时长=转换成分钟(当日最后一个网点的离店时间 - 当日第一个网点的到店时间) - 单个网点在店时长=转换成分钟(单个网点的离店时间 - 单个网点的到店时间) |
七、非功能性需求
7.1 部署环境
- 部署结构图如下:

部署结构图
- 服务器要求如下:
| 服务器名称 | 操作系统 | 安装应用 | 个数 |
|---|---|---|---|
| 数据库服务器 | Centos7.5 | Postgre V9 | 1 |
| 应用服务器 | Centos7.5 | AUTH、线路规划、商机导航、Eureka | 1 |
| 网关/负载服务器 | Centos7.5 | Nginx | 1 |
7.2 易用性需求
7.2.1 界面易用性原则
7.2.2 出错信息和警告
7.2.3 信息显示
7.2.4 数据输入
7.3 其它需求
无。


