版本更新记录:

序号 日期 更改内容 版次 起草或修订人 批准人
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文档:

待更新

需求规格说明书(待拆解) - 图2

4.3 线路

4.3.1 功能描述

“线路”模块包含“线路配置”、“线路管理”、“历史实际拜访”三大功能块,具体功能如下:

模块名称 实现功能 操作角色
线路配置 配置服务日划分权重,服务日及工作时长等参数,生成计划线路 线路规划专员
线路管理 管理已生成的线路,并对线路计划进行调整
历史实际拜访 查看历史实际拜访线路方案,为未来规划提供参考
线路还原 按一定的格式,手工整理拜访计划excel,将拜访计划上传到“线路还原”工具中,可视化呈现拜访计划,并支持调整计划,调整后导出计划并上传到师傅通中执行;

4.3.2 原型页面

需求规格说明书(待拆解) - 图3
线路配置-列表页面

需求规格说明书(待拆解) - 图4
线路配置-新增线路配置方案页面

需求规格说明书(待拆解) - 图5
线路管理页面,在管理页面中修改/编辑线路并提交审核

需求规格说明书(待拆解) - 图6
线路管理页面-已应用线路数据导出

4.4 数据管理

4.4.0 功能描述

在系统内通过不同维度:“部门”、“人员”、“客户”查询不同客户信息及相关状态;数据源取自“师傅通”系统,每日24点进行数据同步。

4.4.1 功能拆解-数据查询(二期新增)

  • 通过菜单栏进入“数据查询”功能
  • 数据查询维度及字段类型描述如下: | 数据查询维度 | 对应查询字段 | 备注 | | —- | —- | —- | | 部门 | 部门名称 |
    - 搜索项支持模糊/精确查询
    - 下拉选择项系统自动带出
    - 点击“重置”清空搜索项
    - 查询后列表显示字段:部门编码、部门名称、上级部门名称、部门名称全路径、部门状态、创建时间、修改时间、同步时间
    | | | 部门状态 | | | 人员 | 所属部门 |
    - 搜索项支持模糊/精确查询
    - 下拉选择项系统自动带出
    - 点击“重置”清空搜索项
    - 查询后列表显示字段:员工登录账号、姓名、性别、手机号码、是否机构领导、职务、岗位、账号状态、创建时间、修改时间、同步时间
    | | | 员工账户 | | | | 姓名 | | | | 账号状态 | | | | 职务 | | | | 岗位 | | | 客户 | 客户编码 |
    - 搜索项支持模糊/精确查询
    - 下拉选择项系统自动带出
    - 点击“重置”清空搜索项
    - 查询后列表显示字段:客户编码、客户名称、经销商名称、客户类型、合作状态、客户经理、客户级别、销售区域、详细地址、删除状态、审批状态、同步时间
    | | | 客户名称 | | | | 经销商名称 | | | | 客户经理 | | | | 客户级别 | | | | 客户类型 | |

需求规格说明书(待拆解) - 图7
按“部门”维度查询,查询字段有:部门名称、部门状态

需求规格说明书(待拆解) - 图8
按“人员”维度查询,查询字段有:所属部门、员工账户、姓名、账号状态、职务、岗位

需求规格说明书(待拆解) - 图9
按“客户”维度进行查询,查询字段有:客户编码、客户名称、客户经理、客户级别、客户类型

4.5 用户登录

4.5.1 功能描述

  • 登录方式:访问系统地址后输入账户名密码进行登录;
  • 身份识别:系统对用户登录信息进行验证,验证通过后根据用户的访问权限的设置显示不同的功能模块。

4.5.2 原型页面

需求规格说明书(待拆解) - 图10
系统登录页面

五、接口需求

5.1 内部接口

5.2 外部接口

5.2.1 从师傅通获取数据

目前从师傅通系统取数,使用到以下8个接口。同一时间最多有2个API同时进行,避免师傅通压力过大。
需求规格说明书(待拆解) - 图11

5.2.2 数据写入师傅通

GAIA线路规划产品,会根据康饮提供的配置参数,对业代进行片区划分,并生成计划拜访线路。在这个过程中,会引起网点与组织,网点与业代的关系发生变更,需要将数据回流到师傅通系统,并将计划拜访线路传输到师傅通。为了打通两个系统间实时数据交互,目前需师傅通系统配合提供数据对接接口(包括正式环境和测试环境)。该文档旨在说明系统对接的各个场景,以及涉及的对接内容,做一个初步的建议和规划。
image.png
数据交互流转图

修改客户数据接口
场景描述
- 调整营业所管辖边界时,客户与所属部门的对应关系可能发生变更,需要将最新的所属部门更新至师傅通系统;
- 调整业代管辖边界,或者为片区重新分配业代时,客户与业代的归属关系可能发生变更,需要将最新的业代更新至师傅通系统。
接口调用方 GIAI
接口提供方 师傅通
调用条件 /
接口调用流程 /
新增客户数据接口
场景描述 在计划线路中加入GAIA推荐客户时,需要将客户主档新增至师傅通系统
接口调用方 GIAI
接口提供方 师傅通
调用条件 /
接口调用流程 /
计划拜访线路更新接口
场景描述 线路规划中,当生成/变更计划拜访线路,需将计划线路更新或新增至师傅通系统,内容有:计划拜访日期,客户编码,客户名称,拜访人编码,拜访人名称,拜访顺序
接口调用方 GIAI
接口提供方 师傅通
调用条件 /
接口调用流程 /

六、数据逻辑描述

6.1 数据范围

本项目中使用到的数据,按用途及来源主要分为四大类:

数据类型 类型定义
主数据 组织架构、员工、客户(客户ID,客户名称,客户部门,所属业代,经纬度)
业务数据 生成的计划拜访线路数据
其他数据 调取高德地图上客户经纬度,路程时长,路况信息等
配置数据 参与划区建线计算配置的一些参数,全局参数(门店规模,拜访频次与在店时长),片区设置参数(业代人数,划分权重),线路配置参数(服务日,权重)

6.2 目前数据获取情况:

  • 业务数据
  1. 实际拜访线路
  2. 经销商订单信息,包括销量及销额
  3. 已获取2018至2019年历史数据
  • 静态主数据
  1. 组织架构
  2. 员工
  3. 客户主数据

注:以上数据的增量将持续通过接口从第三方获取

6.3 数据逻辑

数据名称 取值口径
网点销量销额 不同时间颗粒度下(月度、季度等),有效回单的总销量(箱)和总金额。
单个网点拜访每周频次 不同时间颗粒度下网点的拜访次数/时间颗粒度下的周数
拜访达成率 当日业代按照计划拜访的网点数/当日业代计划拜访网点总数
拜访成交率 当日业代拜访门店中下单网点数/当日业代计划拜访网点总数
拜访网点数 单个业代拜访所有网点数的总和
拜访路途和在店时长
- 当日拜访总时长=转换成分钟(当日最后一个网点的离店时间 - 当日第一个网点的到店时间)
- 单个网点在店时长=转换成分钟(单个网点的离店时间 - 单个网点的到店时间)

七、非功能性需求

7.1 部署环境

  • 部署结构图如下:

需求规格说明书(待拆解) - 图13
部署结构图

  • 服务器要求如下:
服务器名称 操作系统 安装应用 个数
数据库服务器 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 其它需求

无。