长城汽车电子手册产品需要定义文档

长城汽车电子手册

产品需要定义文档

当前版本：V版本号vO.l>

修改日期：v2021-10-18〉

文档状态：正式

作者：闫晓光

VersionDateUpdatedRevisionAuthorBriefDescriptionofChanges

版本号更新日期作者修改概览

V1.02021.09.14

韩壮创建初版

Vl.l2021.09.16

韩壮修改业务流程

V1.22021.09.19

韩壮修改内审内容

V1.32021.09.29

韩壮项目明确只做车机端功能、取

消了手机小程序功能

V1.42020.10.05

韩壮修改内审内容

V1.52020.10.07

韩壮增加详细依赖功能概述

V1.62020.10.09

韩壮内审终版修改（删除全景看车

和AR识别）

V1.72020.10.12

韩壮修改闫晓光批注内容

V1.82020.10.15

韩壮增加车机端对于3D模型管理的

需求

Draft-0.12020.10.18

闫晓光修订，全文更新，增加流程流

程图，业务规则，功能设计，

资源解析规则，资源生成规

贝IJ,产品未完项，

V2.02020.10.28

闫晓光1车.型管理增加营销车型关联，

增加车型关联车辆信息逻辑。

2.增加车主用户手动更新手册流

程章节2.2

3.手册，用户常识，全景看车更

新方式由推送改为HUT自检

4.补充全景看车功能

V2.12021-10-29

闫晓光1.根据GUX2.0最新需求，删

减用户常识，快速入门两模

块

2.车型同步数据来源调整

V2.1.12021-11-01

闫晓光1.4.2细化保养手册规则异常

描述

2.323.2手册创建步骤第二

步，增加保养手册模板下载

目录

1.电子手册产品需求定义..................................................7

1.1.产品概述...............................................................7

1.2.文档背景...............................................................7

1.3.产品范围...............................................................8

1.4.目标群体...............................................................9

1.5.名词与术语...........................................................10

1.6.电子手册产品分析...................................................1034

1.6.1.需求来源.....................................................1034

1.6.2.需要分析.......................................................11

1.6.3.痛点分析.....................................................Ili2

1.7.产品目标..............................................................12

1.8.设计原则..............................................................12

1.9.系统交互............................................................1213

1.9.1,涉及系统及应用...............................................1218

1.9.2.数据来源.......................................................14

1.10.产品功能架构.........................................................15

2.电子手册产品流程设计.................................................16

2.1.操作手册流程概述.....................................................16

2.1.1.操作手册发布流程..............................................16

2.1.2.手册创建子流程.................................................21

2.1.3.更新离线包子流程...............................................26

2.2.用户更新手册流程概述................................................29

2.2.1.用户更新手册流程...............................................30

2.3.全景看车流程概述.....................................................33

2.3.1,全景看车发布流程..............................................33

2.4.车型同步流程概述.....................................................37

2.4.1.车型同步流程...................................................37

3.电子手册产品功能设计................................................4243

3.1.车型管理...........................................................4344

3.1.1.车型管理列表................................................4344

3.1.2.同步车系.....................................................4445

3.1.3.查看分组.....................................................4748

3.1.4,添加年款分组.................................................4849

3.1.5,编辑年款.....................................................5051

3.2.使用说明书管理.....................................................5253

3.2.1,年款车型列表.................................................52^3

3.2.2.手册列表.....................................................5455

3.2.3.添力口手册.....................................................56S7

3.2.4,发布历史.....................................................66^7

3.2.5.手册预览.....................................................6768

3.3.全景看车管理.......................................................6869

3.3.1,全景看车管理列表..............................................69

3.3.2,添力口资源.......................................................71

3.3.3,更新资源.....................................................7172

3.3.4.历史记录.......................................................72

3.4.通用功能............................................................7273

3.5.非功能性需求..........................................................73

4.文档解析规则.........................................................7374

4.1.解析手册资源规则...................................................7475

4.1.1,说明书首页(index.html)...........................................................................7475

4.1.2.目录中的"仪表指示灯”.......................................757€

4.2.保养手册解析规则...................................................7576

4.3.生成手册资源规则......................................................79

5.产品未完项.............................................................81

6.附录参考..............................................偌误!未定义书签。82

附录A:参考API........................................................................................................................82

附录B:GUX2.0PRD..................................................................................................................82

1.电子手册产品需求定义

1.1.产品概述

电子手册作为长城汽车未来新产车型中，有关电子说明书相关功能内容的发布、管

理后台，连接各类电子说明书的内容在不同车型、不同触点上的内容发布，更新，管理

方式。

本文档适用于长城汽车智能手册GUX2.0平台产品，在GUX2.0平台及以后平台进行

搭载，其中软件部分需要依据产品配置适配不同车型。

1.2.文档背景

目前遗留《长城汽车电子说明书小程序后台管理系统》，该系统由供应商提供建设，

采用PHP技术，目前由于无团队进行手续的维护，导致无法在该系统扩展新功能，以至

于无法满足后续新车型对于手册的需求。

基于B07的项目契机以及自研系统的需要，采用

•对原《长城汽车电子说明书小程序后台管理系统》功能（以下称：手册原系统）进

行设计重构，保持手册科以同样的工作方式制作手册内容，并通过新平台发布手册

等内容；

•在手册原系统之上，优化发布流程及功能操作设计，简化操作；

•确保新系统在触点（目前为HUT端）手册展示和手台手册发布一致；

•为未来提供新车型或更好的进行适配新车型，预留设计冗余。

1.3.产品范围

编号手册类型用户显不触点描述

使用说明

1手册科HUT

书

2用车常识手册科HUT

3快速入门手册科HUT

4全景看车手册科HUT

通过运营平台同步车型数

5车型管理手册科HUT据（4码），包含：品牌，

车型，年款，配置

6其它功能-HUT手册内容更新，场景引擎

胤取中心场景引暴

展示手册内白H-

场景简述

1.4.目标群体

qcs

漏3用户角色业务组织平台相关职责描述归属域

负责所有类型电子说明

手册管理

1手册科书内容制作，发布，更

员

新等管理

2智能驾舱智能驾舱GUX2.0产品设计，负GDC国

责各类电子说明内容内内电子手

容在HUT端使用功能和册模块

展示效果等设计实现

1.5.名词与术语

术语描述

介绍车辆的具体功能，通过图文的方式帮助用户

手册费源使用车辆所需要的h5页面资源集合，包含页面,

H5关联页面以及关联的图片

以标题或主题方式向用户介绍用车时的贴土信

用车常识

息，以帮助用户有效关注车辆信息或保养情况

通知3D渲染科拼接，形成可拖动的3D立体景

象，在景象中标有热点，用户点击热点可以直看

全景看车

热点位置的信息解读，信息解读可以是文字，图

片或视频方式

以视频方式向用户介绍相关主题和功能的使用过

快速入门

程

电子手册领域里的年款车型有别于运营系统，为

便于手册科用户管理用户手册，【年款车型】以动

力形式划分，如遇当年新款车型改款后无大变

年款车型动，旧款手册可用新款车型，故不在新增年款。

所以年款车型，包含按动力+年款两个维度组合使

用（依情况判断是否添加新款，如无必要旧年款

代替新年款保留使用）两维度含义.

1.6.电子手册产品分析

1.6.1.需求来源

1）B07项目自研需要

2）车机端GUX2.0需求

藤及云is依籁

手«8"UY主打BF.为量子修-I0是*•?.A”币QTA

n«.云n：ame子-g打wst量用.承更*

车机端功能

1.6.2.需要分析

■满足B07车机GUX2.0电子手册功能；

■满足手册科对于内容制作的功能需要，并且符合目前手册科内容制作的方式；

1.6.3.痛点分析

■手册科现行《长城汽车电子说明书小程序后台管理系统》为采用PHP技术，无资源

能够进行该系统的运行维护。

■目前无其它系统支撑B07项目，需要自研系统搭载B07项目，并向后兼容新车型，

提供可持续的功能扩展

1.7.产品目标

《电子手册》对原《长城汽车电子说明书小程序后台管理系统》进行设计重构，满足

GUX2.0需求的同时，兼容手册科内容制作流程。同时提供可持续扩展的和适配新车型

的能力

1.8.设计原则

■业务流程简单，交互方便，便于运营人员使用

■兼容现在有业务能力

■具备业务扩展能力，适配未来新车型

1.9.系统交互

1.9.1.涉及系统及应用

■全局系统关系图

HUT

系统关系涉及功能

提供品牌，车系，车型，车款数据，车辆数

TSP基础

提供方据

数据

（数据来源：车型物料号数据）

HUT消费方接收手册内容更新通知，更新手册内容

手册，用户常识，快速入门，全景看车资源

使用方发布，更新管理

电子手册

消费方

车型分组信息配置管理

1.9.2.数据来源

品牌，车系，车型，车款

注：标号不代表时序流程，仅表示数据流向

序号数据源数据消费描述

增量同步品牌，车系数据，车型

1TSP车型管理

辘

电子手册,贴土，视频，全景看

2车型管理内容发布

车依赖车型数据发布

发布更新指令，并携带资源地址

3内容发布通知中心

信息

HUT请求版本检查，资源地址

4HUT内容发布获取，下载ZIP资源包，更新并

向用户展示。

1.10.产品功能架构

电子手册管理

功能列表

一级功能二级功能三级功能功能描述

添加车型添加车型年款

编辑车型编辑车型年款

车型列表

查看车型查看车型年款

车型管理删除车型删除车型年款

用户在数据同步列表勾选待同步数

数据导入

车型同步据，确认后同步至电子手册

导入历史用户导入数据历史

发布历史用户手册发布历史

电子说明电子说明书列发布用户发布手册，更新信息推送至HUT

书表预览预览用户手册

添加手册用户通过4步上传发布电子手册

添加用户常

用户通过2步批量上传用户常识

识

用户常识用户常识列表查看历史查看创建和修订历史

修订修订用户常识

删除删除用户常识

发布发布通知HUT用户常识更新

预览预览用户常识

添加视颇添加快速入门视频内容

编辑视频编辑快速入门视频内容

快速入门列表删除视频删除快速入门

预览视频预览快视频内容

快速入门

预览封面预览快视频封面

添加资源添加资源包

全景看车列表更新资源更新资源包

删除资源删除资源包

2.电子手册产品流程设计

2.1.操作手册流程概述

手册科用户制作手册后，通过手册发布流程上载手册资源，发布最新手册内容的过

程。资源以H5,图片资源包的形式管理。

2.1.1.操作手册发布流程

.需求场景

手册科根据车型项目需求，发布新手册或对已有车型功能迭代进行手册内容更新。

2.1.12目标用户

手册科用户

.业务流程

1＜手册发布》

手册科手册管理HUT

髭

B啾

ttlb

n

H

关键活动手册发布流程

No.输入流程描述输出关键异常

1手册【手册资源准备】Zip资源

手册科用户在手册制作软件导出zip

资源，资源包括：，图片，指示灯，维

保excel

2Zip资源【手册添加】手册手册上传，解

参见子流程1.1〈手册创建〉压，解析异常

3待发布状态手册【手册发布】发布状态

手册发布手册

阶段二HUT更新用户手册

4HUT开机自检【更新离线包】更新完成

参见更新离线包子流程通知

5更新完成通知【车辆更新记录】完成

平台接收更新完成通知，标记更新车

辆的VIN号,当前版本，更新历史更

新结果，更新方式（HUT自检,用户

更新），更新时间。

更新历史：按时间倒叙，追加记录每

次更新信息，格式：

版本，更新时间，更新方式，更新结

果

2.1.14业务规贝IJ

服务名称手册发布流程

需求编号001

使用渠道主要渠道：懂车管理后台，HUT

所涉及系统懂车管理后台，HUT,通知中心

前置条件・新车型发布或车型更新

•手册内容准备完成

业务规则•手册资源准备

上传手册为zip文件

包含：

1）

2）关联h5页面

3）h5页面关联的图片资源

4）维保手册excel文件

•手册创建流程

参见下文，手册创建子流程要求

•更新离线资源流程

参见，更新离线资源子流程要求

后置条件1）手册未创建完成，状态：草稿

2）手册创建完成但未发布，状态：未发布

3）手册创建完成并发布，状态：发布

提示内容

非功能需求•支持500MB以上单个大文件上传

•单个大文件上传内网每秒不少于10MB速率，外网不少于2MB速率

•支持大文件断点续传

2.12手册创建子流程

2.121.业务流程

子流程1.1＜手册创建）

手册创建

关键活手册发布流程

动

No.输入流程描述输出关健异常

1无【填写手册基本信息】新建成功必填项未填

填写语言，适用平台,新版本号，备注写

版号规则错

误

2Zip资源包【上传资源包】上传成功上传错误

上传手册为zip文件，包含：

1)

2)关联h5页面

3)h5页面关联的图片资源

4)维保手册excel文件

3上传成功【解析包解压/解析】解析成功解压错误

在上传日志区，实时显示解压解析过程描解析错误

述，如遇异常，显示异常日志。

显示正常信息模板如下：

2021-10.2012:12:12资源上传开始上传

2021-10-2012:13:12资源上传完成

2021-10-2012:13:12资源上传解压开始

2021-10-2012:13:12资源上传解压开始

2021-10-2012:13:12资源上传解析开始

2021-10-2012:13:12资源上向1?析完成

已解析目录：35陈

html文件：382个

图片文件：38驾长

已解析仪表指示灯：41条

已解阿养丽100条

4上传成功的zip【解压判断】解压成功

解压错误，提示错误并要求用户重传资源的zip

包

5解压成功的zip【解析判断】解析成功

解析错误，提示错误并要求用户重传资源的zip

包

6解析成功的zip【预览手册】内容资源上传文件失

预览视图，以treegrid形式展示败

1）显示预览麻文件资源与

2）可点击联系显示h5页面预览定义名称不

3）逐条检测结果状查（绿色：通过，红匹配

色：异常，白色：未知）文件资源与

4）逐条显示异常描述遗漏

5）可上传html替代

6）可上传image文件（png,image）

7）可上传excel

解析规则参见5.1解析手册资源规则

7内容资源【内容检测】完整内容

同上步骤6规则校验结果

7.1内容校验结果同上，步骤6规则完成内容

资源

8完成内容资源【手册生成】zip

打包资源，并生成Zip

生成规则参见：5.2生成手册资源规则

2.122.业务规贝IJ

服务名称手册创建子流程

001-1

需求编号

使用渠道主要渠道：懂车管理后台，HUT

所涉及系统懂车管理后台，HUT,通知中心

前置条件・新车型发布或车型更新

•手册内容准备完成

业务规则•手册资源准备

上传手册为zip文件

包含：

5)

6)关联h5页面

7)h5页面关联的图片资源

8)维保手册excel文件

按规则解析文档结构，

参见<>解析规则

参见〈资源包规则〉打包规则

后置条件生成资源包

提示内容

非功能需求•支持500MB以上单个大文件上传

•单个大文件上传内网每秒不少于10MB速率，外网不少于2MB速率

•支持大文件断点续传

2.1.3.更新离线包子流程

2.131.业务流程

子流程1.2〈更新离线包》V2.0.0

关键活子流程1.2v更新离线包〉V2.0.0

动

No.输入流程描述输出关键异常

1HUT启动自检【HUT电子手册自检】版本检测请

车辆上电，HUT电子手册APP启动后自求

检手册版本

•手册检查：整册资源包形式返回

版本号、资源地址，更新时间

・用户常识检直：集合形式返回

版本号、资源地址，更新时间

•全景看车：资源包形式

版本号、资源地址，更新时间

2版本检测请求【版本检测】版本检测结

调用平台版本检测接口，检测是否为最新果

版本手册

2.1版本检测结果【是否为最新版本】版本更新提

是：;罐结束示

否：提示用户是否更新，参考HUT设计

(GUX2.0PRD)

3版本更新提示【提示用户】更新提示

HUT接收更新指令，按HUT定义策略获

取资源，参考HUT设计(GUX2.0

PRD)

3.1更新提示【是否更新】更新进入4

询问用户是否更新,参考HUT设计创建更新任

(GUX2.0PRD\务；

不更新:结束

4更新任务【获取更新离线包信息】Zip资源包

向服务器获取资源地址，获取下载资源地地址

址,参考HUT削(GUX2.0PRD)

5下载zip资源请【返回资源】Zip资源包

求服务返回资源包数据

6Zip资源包【下载资源】下载完成

HUT下载资源，检查下载状态,参考

HUT削(GUX2.0PRD)

7Zip资源包【更新内容】更新完成通

HUT按策略管理内容，参考HUT设计知

(GUX2.0PRD)

8更新完成通知【车辆更新记录】结束

平台接收更新完成通知，标记车辆更新结

果，更新时间，当前更新版本号

2.1.32业务规贝IJ

服务名称手册发布流程

需求编号001-2

使用渠道主要渠道：懂车管理后台，HUT

所涉及系统懂车管理后台，HUT,通知中心

前置条件•手册生成形成zip资源包并发布

•HUT可正常接收更新指令

业务规则•版本校验

资源状态“发布”状态，为最新版本资源

•支持HUT下载断点续传

•HUT下载资源列表

返回的资源清单，支持指定语言，无指定语言时返回所有语言当前发布版本。

后置条件HUT下载并更新完成

通知服务器更新完成

提示内容

非功能需求•支持大文件断点续传

2.2.用户更新手册流程概述

用户通过HUT手册动检查手册版本来更新手册内容

221.用户更新手册流程

221.1.需求场景

用户点击HUT手册关于页面中【手册版本信息】（参考附录GUX2.0PRD4.8关于）

触发用户更新手册流程

2212目标用户

车主用户

221.3.业务流程

1用户访问HUT手【手册版本信息】版本检测请

册用户点击手册版本信息检查版本求

2版本检测请求【版本检测】版本检测结

调用平台版本检测接口，检测是否为最新果

版本手册

2.1版本检测结果【是否为最新版本】版本