長城汽車電子手冊

產(chǎn)品需要定義文檔

當(dāng)前版本：V版本號vO.l>

修改日期：v2021-10-18〉

文檔狀態(tài)：正式

作者：閆曉光

VersionDateUpdatedRevisionAuthorBriefDescriptionofChanges

版本號更新日期作者修改概覽

V1.02021.09.14

韓壯創(chuàng)建初版

Vl.l2021.09.16

韓壯修改業(yè)務(wù)流程

V1.22021.09.19

韓壯修改內(nèi)審內(nèi)容

V1.32021.09.29

韓壯項目明確只做車機端功能、取

消了手機小程序功能

V1.42020.10.05

韓壯修改內(nèi)審內(nèi)容

V1.52020.10.07

韓壯增加詳細(xì)依賴功能概述

V1.62020.10.09

韓壯內(nèi)審終版修改（刪除全景看車

和AR識別）

V1.72020.10.12

韓壯修改閆曉光批注內(nèi)容

V1.82020.10.15

韓壯增加車機端對于3D模型管理的

需求

Draft-0.12020.10.18

閆曉光修訂，全文更新，增加流程流

程圖，業(yè)務(wù)規(guī)則，功能設(shè)計，

資源解析規(guī)則，資源生成規(guī)

貝IJ,產(chǎn)品未完項，

V2.02020.10.28

閆曉光1車.型管理增加營銷車型關(guān)聯(lián)，

增加車型關(guān)聯(lián)車輛信息邏輯。

2.增加車主用戶手動更新手冊流

程章節(jié)2.2

3.手冊，用戶常識，全景看車更

新方式由推送改為HUT自檢

4.補充全景看車功能

V2.12021-10-29

閆曉光1.根據(jù)GUX2.0最新需求，刪

減用戶常識，快速入門兩模

塊

2.車型同步數(shù)據(jù)來源調(diào)整

V2.1.12021-11-01

閆曉光1.4.2細(xì)化保養(yǎng)手冊規(guī)則異常

描述

2.323.2手冊創(chuàng)建步驟第二

步，增加保養(yǎng)手冊模板下載

目錄

1.電子手冊產(chǎn)品需求定義..................................................7

1.1.產(chǎn)品概述...............................................................7

1.2.文檔背景...............................................................7

1.3.產(chǎn)品范圍...............................................................8

1.4.目標(biāo)群體...............................................................9

1.5.名詞與術(shù)語...........................................................10

1.6.電子手冊產(chǎn)品分析...................................................1034

1.6.1.需求來源.....................................................1034

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

1.6.3.痛點分析.....................................................Ili2

1.7.產(chǎn)品目標(biāo)..............................................................12

1.8.設(shè)計原則..............................................................12

1.9.系統(tǒng)交互............................................................1213

1.9.1,涉及系統(tǒng)及應(yīng)用...............................................1218

1.9.2.數(shù)據(jù)來源.......................................................14

1.10.產(chǎn)品功能架構(gòu).........................................................15

2.電子手冊產(chǎn)品流程設(shè)計.................................................16

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

2.1.1.操作手冊發(fā)布流程..............................................16

2.1.2.手冊創(chuàng)建子流程.................................................21

2.1.3.更新離線包子流程...............................................26

2.2.用戶更新手冊流程概述................................................29

2.2.1.用戶更新手冊流程...............................................30

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

2.3.1,全景看車發(fā)布流程..............................................33

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

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

3.電子手冊產(chǎn)品功能設(shè)計................................................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,發(fā)布?xì)v史.....................................................66^7

3.2.5.手冊預(yù)覽.....................................................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.文檔解析規(guī)則.........................................................7374

4.1.解析手冊資源規(guī)則...................................................7475

4.1.1,說明書首頁(index.html)...........................................................................7475

4.1.2.目錄中的"儀表指示燈”.......................................757€

4.2.保養(yǎng)手冊解析規(guī)則...................................................7576

4.3.生成手冊資源規(guī)則......................................................79

5.產(chǎn)品未完項.............................................................81

6.附錄參考..............................................偌誤!未定義書簽。82

附錄A:參考API........................................................................................................................82

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

1.電子手冊產(chǎn)品需求定義

1.1.產(chǎn)品概述

電子手冊作為長城汽車未來新產(chǎn)車型中，有關(guān)電子說明書相關(guān)功能內(nèi)容的發(fā)布、管

理后臺，連接各類電子說明書的內(nèi)容在不同車型、不同觸點上的內(nèi)容發(fā)布，更新，管理

方式。

本文檔適用于長城汽車智能手冊GUX2.0平臺產(chǎn)品，在GUX2.0平臺及以后平臺進行

搭載，其中軟件部分需要依據(jù)產(chǎn)品配置適配不同車型。

1.2.文檔背景

目前遺留《長城汽車電子說明書小程序后臺管理系統(tǒng)》，該系統(tǒng)由供應(yīng)商提供建設(shè)，

采用PHP技術(shù)，目前由于無團隊進行手續(xù)的維護，導(dǎo)致無法在該系統(tǒng)擴展新功能，以至

于無法滿足后續(xù)新車型對于手冊的需求。

基于B07的項目契機以及自研系統(tǒng)的需要，采用

?對原《長城汽車電子說明書小程序后臺管理系統(tǒng)》功能（以下稱：手冊原系統(tǒng)）進

行設(shè)計重構(gòu)，保持手冊科以同樣的工作方式制作手冊內(nèi)容，并通過新平臺發(fā)布手冊

等內(nèi)容；

?在手冊原系統(tǒng)之上，優(yōu)化發(fā)布流程及功能操作設(shè)計，簡化操作；

?確保新系統(tǒng)在觸點（目前為HUT端）手冊展示和手臺手冊發(fā)布一致；

?為未來提供新車型或更好的進行適配新車型，預(yù)留設(shè)計冗余。

1.3.產(chǎn)品范圍

編號手冊類型用戶顯不觸點描述

使用說明

1手冊科HUT

書

2用車常識手冊科HUT

3快速入門手冊科HUT

4全景看車手冊科HUT

通過運營平臺同步車型數(shù)

5車型管理手冊科HUT據(jù)（4碼），包含：品牌，

車型，年款，配置

6其它功能-HUT手冊內(nèi)容更新，場景引擎

胤取中心場景引暴

展示手冊內(nèi)白H-

場景簡述

1.4.目標(biāo)群體

qcs

漏3用戶角色業(yè)務(wù)組織平臺相關(guān)職責(zé)描述歸屬域

負(fù)責(zé)所有類型電子說明

手冊管理

1手冊科書內(nèi)容制作，發(fā)布，更

員

新等管理

2智能駕艙智能駕艙GUX2.0產(chǎn)品設(shè)計，負(fù)GDC國

責(zé)各類電子說明內(nèi)容內(nèi)內(nèi)電子手

容在HUT端使用功能和冊模塊

展示效果等設(shè)計實現(xiàn)

1.5.名詞與術(shù)語

術(shù)語描述

介紹車輛的具體功能，通過圖文的方式幫助用戶

手冊費源使用車輛所需要的h5頁面資源集合，包含頁面,

H5關(guān)聯(lián)頁面以及關(guān)聯(lián)的圖片

以標(biāo)題或主題方式向用戶介紹用車時的貼土信

用車常識

息，以幫助用戶有效關(guān)注車輛信息或保養(yǎng)情況

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

象，在景象中標(biāo)有熱點，用戶點擊熱點可以直看

全景看車

熱點位置的信息解讀，信息解讀可以是文字，圖

片或視頻方式

以視頻方式向用戶介紹相關(guān)主題和功能的使用過

快速入門

程

電子手冊領(lǐng)域里的年款車型有別于運營系統(tǒng)，為

便于手冊科用戶管理用戶手冊，【年款車型】以動

力形式劃分，如遇當(dāng)年新款車型改款后無大變

年款車型動，舊款手冊可用新款車型，故不在新增年款。

所以年款車型，包含按動力+年款兩個維度組合使

用（依情況判斷是否添加新款，如無必要舊年款

代替新年款保留使用）兩維度含義.

1.6.電子手冊產(chǎn)品分析

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電子手冊功能；

■滿足手冊科對于內(nèi)容制作的功能需要，并且符合目前手冊科內(nèi)容制作的方式；

1.6.3.痛點分析

■手冊科現(xiàn)行《長城汽車電子說明書小程序后臺管理系統(tǒng)》為采用PHP技術(shù)，無資源

能夠進行該系統(tǒng)的運行維護。

■目前無其它系統(tǒng)支撐B07項目，需要自研系統(tǒng)搭載B07項目，并向后兼容新車型，

提供可持續(xù)的功能擴展

1.7.產(chǎn)品目標(biāo)

《電子手冊》對原《長城汽車電子說明書小程序后臺管理系統(tǒng)》進行設(shè)計重構(gòu)，滿足

GUX2.0需求的同時，兼容手冊科內(nèi)容制作流程。同時提供可持續(xù)擴展的和適配新車型

的能力

1.8.設(shè)計原則

■業(yè)務(wù)流程簡單，交互方便，便于運營人員使用

■兼容現(xiàn)在有業(yè)務(wù)能力

■具備業(yè)務(wù)擴展能力，適配未來新車型

1.9.系統(tǒng)交互

1.9.1.涉及系統(tǒng)及應(yīng)用

■全局系統(tǒng)關(guān)系圖

HUT

系統(tǒng)關(guān)系涉及功能

提供品牌，車系，車型，車款數(shù)據(jù)，車輛數(shù)

TSP基礎(chǔ)

提供方據(jù)

數(shù)據(jù)

（數(shù)據(jù)來源：車型物料號數(shù)據(jù)）

HUT消費方接收手冊內(nèi)容更新通知，更新手冊內(nèi)容

手冊，用戶常識，快速入門，全景看車資源

使用方發(fā)布，更新管理

電子手冊

消費方

車型分組信息配置管理

1.9.2.數(shù)據(jù)來源

品牌，車系，車型，車款

注：標(biāo)號不代表時序流程，僅表示數(shù)據(jù)流向

序號數(shù)據(jù)源數(shù)據(jù)消費描述

增量同步品牌，車系數(shù)據(jù)，車型

1TSP車型管理

轆

電子手冊,貼土，視頻，全景看

2車型管理內(nèi)容發(fā)布

車依賴車型數(shù)據(jù)發(fā)布

發(fā)布更新指令，并攜帶資源地址

3內(nèi)容發(fā)布通知中心

信息

HUT請求版本檢查，資源地址

4HUT內(nèi)容發(fā)布獲取，下載ZIP資源包，更新并

向用戶展示。

1.10.產(chǎn)品功能架構(gòu)

電子手冊管理

功能列表

一級功能二級功能三級功能功能描述

添加車型添加車型年款

編輯車型編輯車型年款

車型列表

查看車型查看車型年款

車型管理刪除車型刪除車型年款

用戶在數(shù)據(jù)同步列表勾選待同步數(shù)

數(shù)據(jù)導(dǎo)入

車型同步據(jù)，確認(rèn)后同步至電子手冊

導(dǎo)入歷史用戶導(dǎo)入數(shù)據(jù)歷史

發(fā)布?xì)v史用戶手冊發(fā)布?xì)v史

電子說明電子說明書列發(fā)布用戶發(fā)布手冊，更新信息推送至HUT

書表預(yù)覽預(yù)覽用戶手冊

添加手冊用戶通過4步上傳發(fā)布電子手冊

添加用戶常

用戶通過2步批量上傳用戶常識

識

用戶常識用戶常識列表查看歷史查看創(chuàng)建和修訂歷史

修訂修訂用戶常識

刪除刪除用戶常識

發(fā)布發(fā)布通知HUT用戶常識更新

預(yù)覽預(yù)覽用戶常識

添加視頗添加快速入門視頻內(nèi)容

編輯視頻編輯快速入門視頻內(nèi)容

快速入門列表刪除視頻刪除快速入門

預(yù)覽視頻預(yù)覽快視頻內(nèi)容

快速入門

預(yù)覽封面預(yù)覽快視頻封面

添加資源添加資源包

全景看車列表更新資源更新資源包

刪除資源刪除資源包

2.電子手冊產(chǎn)品流程設(shè)計

2.1.操作手冊流程概述

手冊科用戶制作手冊后，通過手冊發(fā)布流程上載手冊資源，發(fā)布最新手冊內(nèi)容的過

程。資源以H5,圖片資源包的形式管理。

2.1.1.操作手冊發(fā)布流程

.需求場景

手冊科根據(jù)車型項目需求，發(fā)布新手冊或?qū)σ延熊囆凸δ艿M行手冊內(nèi)容更新。

2.1.12目標(biāo)用戶

手冊科用戶

.業(yè)務(wù)流程

1＜手冊發(fā)布》

手冊科手冊管理HUT

髭

B啾

ttlb

n

H

關(guān)鍵活動手冊發(fā)布流程

No.輸入流程描述輸出關(guān)鍵異常

1手冊【手冊資源準(zhǔn)備】Zip資源

手冊科用戶在手冊制作軟件導(dǎo)出zip

資源，資源包括：，圖片，指示燈，維

保excel

2Zip資源【手冊添加】手冊手冊上傳，解

參見子流程1.1〈手冊創(chuàng)建〉壓，解析異常

3待發(fā)布狀態(tài)手冊【手冊發(fā)布】發(fā)布狀態(tài)

手冊發(fā)布手冊

階段二HUT更新用戶手冊

4HUT開機自檢【更新離線包】更新完成

參見更新離線包子流程通知

5更新完成通知【車輛更新記錄】完成

平臺接收更新完成通知，標(biāo)記更新車

輛的VIN號,當(dāng)前版本，更新歷史更

新結(jié)果，更新方式（HUT自檢,用戶

更新），更新時間。

更新歷史：按時間倒敘，追加記錄每

次更新信息，格式：

版本，更新時間，更新方式，更新結(jié)

果

2.1.14業(yè)務(wù)規(guī)貝IJ

服務(wù)名稱手冊發(fā)布流程

需求編號001

使用渠道主要渠道：懂車管理后臺，HUT

所涉及系統(tǒng)懂車管理后臺，HUT,通知中心

前置條件?新車型發(fā)布或車型更新

?手冊內(nèi)容準(zhǔn)備完成

業(yè)務(wù)規(guī)則?手冊資源準(zhǔn)備

上傳手冊為zip文件

包含：

1）

2）關(guān)聯(lián)h5頁面

3）h5頁面關(guān)聯(lián)的圖片資源

4）維保手冊excel文件

?手冊創(chuàng)建流程

參見下文，手冊創(chuàng)建子流程要求

?更新離線資源流程

參見，更新離線資源子流程要求

后置條件1）手冊未創(chuàng)建完成，狀態(tài)：草稿

2）手冊創(chuàng)建完成但未發(fā)布，狀態(tài)：未發(fā)布

3）手冊創(chuàng)建完成并發(fā)布，狀態(tài)：發(fā)布

提示內(nèi)容

非功能需求?支持500MB以上單個大文件上傳

?單個大文件上傳內(nèi)網(wǎng)每秒不少于10MB速率，外網(wǎng)不少于2MB速率

?支持大文件斷點續(xù)傳

2.12手冊創(chuàng)建子流程

2.121.業(yè)務(wù)流程

子流程1.1＜手冊創(chuàng)建）

手冊創(chuàng)建

關(guān)鍵活手冊發(fā)布流程

動

No.輸入流程描述輸出關(guān)健異常

1無【填寫手冊基本信息】新建成功必填項未填

填寫語言，適用平臺,新版本號，備注寫

版號規(guī)則錯

誤

2Zip資源包【上傳資源包】上傳成功上傳錯誤

上傳手冊為zip文件，包含：

1)

2)關(guān)聯(lián)h5頁面

3)h5頁面關(guān)聯(lián)的圖片資源

4)維保手冊excel文件

3上傳成功【解析包解壓/解析】解析成功解壓錯誤

在上傳日志區(qū)，實時顯示解壓解析過程描解析錯誤

述，如遇異常，顯示異常日志。

顯示正常信息模板如下：

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條

已解阿養(yǎng)麗100條

4上傳成功的zip【解壓判斷】解壓成功

解壓錯誤，提示錯誤并要求用戶重傳資源的zip

包

5解壓成功的zip【解析判斷】解析成功

解析錯誤，提示錯誤并要求用戶重傳資源的zip

包

6解析成功的zip【預(yù)覽手冊】內(nèi)容資源上傳文件失

預(yù)覽視圖，以treegrid形式展示敗

1）顯示預(yù)覽麻文件資源與

2）可點擊聯(lián)系顯示h5頁面預(yù)覽定義名稱不

3）逐條檢測結(jié)果狀查（綠色：通過，紅匹配

色：異常，白色：未知）文件資源與

4）逐條顯示異常描述遺漏

5）可上傳html替代

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

7）可上傳excel

解析規(guī)則參見5.1解析手冊資源規(guī)則

7內(nèi)容資源【內(nèi)容檢測】完整內(nèi)容

同上步驟6規(guī)則校驗結(jié)果

7.1內(nèi)容校驗結(jié)果同上，步驟6規(guī)則完成內(nèi)容

資源

8完成內(nèi)容資源【手冊生成】zip

打包資源，并生成Zip

生成規(guī)則參見：5.2生成手冊資源規(guī)則

2.122.業(yè)務(wù)規(guī)貝IJ

服務(wù)名稱手冊創(chuàng)建子流程

001-1

需求編號

使用渠道主要渠道：懂車管理后臺，HUT

所涉及系統(tǒng)懂車管理后臺，HUT,通知中心

前置條件?新車型發(fā)布或車型更新

?手冊內(nèi)容準(zhǔn)備完成

業(yè)務(wù)規(guī)則?手冊資源準(zhǔn)備

上傳手冊為zip文件

包含：

5)

6)關(guān)聯(lián)h5頁面

7)h5頁面關(guān)聯(lián)的圖片資源

8)維保手冊excel文件

按規(guī)則解析文檔結(jié)構(gòu)，

參見<>解析規(guī)則

參見〈資源包規(guī)則〉打包規(guī)則

后置條件生成資源包

提示內(nèi)容

非功能需求?支持500MB以上單個大文件上傳

?單個大文件上傳內(nèi)網(wǎng)每秒不少于10MB速率，外網(wǎng)不少于2MB速率

?支持大文件斷點續(xù)傳

2.1.3.更新離線包子流程

2.131.業(yè)務(wù)流程

子流程1.2〈更新離線包》V2.0.0

關(guān)鍵活子流程1.2v更新離線包〉V2.0.0

動

No.輸入流程描述輸出關(guān)鍵異常

1HUT啟動自檢【HUT電子手冊自檢】版本檢測請

車輛上電，HUT電子手冊APP啟動后自求

檢手冊版本

?手冊檢查：整冊資源包形式返回

版本號、資源地址，更新時間

?用戶常識檢直：集合形式返回

版本號、資源地址，更新時間

?全景看車：資源包形式

版本號、資源地址，更新時間

2版本檢測請求【版本檢測】版本檢測結(jié)

調(diào)用平臺版本檢測接口，檢測是否為最新果

版本手冊

2.1版本檢測結(jié)果【是否為最新版本】版本更新提

是：;罐結(jié)束示

否：提示用戶是否更新，參考HUT設(shè)計

(GUX2.0PRD)

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

HUT接收更新指令，按HUT定義策略獲

取資源，參考HUT設(shè)計(GUX2.0

PRD)

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

詢問用戶是否更新,參考HUT設(shè)計創(chuàng)建更新任

(GUX2.0PRD\務(wù)；

不更新:結(jié)束

4更新任務(wù)【獲取更新離線包信息】Zip資源包

向服務(wù)器獲取資源地址，獲取下載資源地地址

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

5下載zip資源請【返回資源】Zip資源包

求服務(wù)返回資源包數(shù)據(jù)

6Zip資源包【下載資源】下載完成

HUT下載資源，檢查下載狀態(tài),參考

HUT削(GUX2.0PRD)

7Zip資源包【更新內(nèi)容】更新完成通

HUT按策略管理內(nèi)容，參考HUT設(shè)計知

(GUX2.0PRD)

8更新完成通知【車輛更新記錄】結(jié)束

平臺接收更新完成通知，標(biāo)記車輛更新結(jié)

果，更新時間，當(dāng)前更新版本號

2.1.32業(yè)務(wù)規(guī)貝IJ

服務(wù)名稱手冊發(fā)布流程

需求編號001-2

使用渠道主要渠道：懂車管理后臺，HUT

所涉及系統(tǒng)懂車管理后臺，HUT,通知中心

前置條件?手冊生成形成zip資源包并發(fā)布

?HUT可正常接收更新指令

業(yè)務(wù)規(guī)則?版本校驗

資源狀態(tài)“發(fā)布”狀態(tài)，為最新版本資源

?支持HUT下載斷點續(xù)傳

?HUT下載資源列表

返回的資源清單，支持指定語言，無指定語言時返回所有語言當(dāng)前發(fā)布版本。

后置條件HUT下載并更新完成

通知服務(wù)器更新完成

提示內(nèi)容

非功能需求?支持大文件斷點續(xù)傳

2.2.用戶更新手冊流程概述

用戶通過HUT手冊動檢查手冊版本來更新手冊內(nèi)容

221.用戶更新手冊流程

221.1.需求場景

用戶點擊HUT手冊關(guān)于頁面中【手冊版本信息】（參考附錄GUX2.0PRD4.8關(guān)于）

觸發(fā)用戶更新手冊流程

2212目標(biāo)用戶

車主用戶

221.3.業(yè)務(wù)流程

1用戶訪問HUT手【手冊版本信息】版本檢測請

冊用戶點擊手冊版本信息檢查版本求

2版本檢測請求【版本檢測】版本檢測結(jié)

調(diào)用平臺版本檢測接口，檢測是否為最新果

版本手冊

2.1版本檢測結(jié)果【是否為最新版本】版本