1.0 文档信息

 

系统归属

WEB;BE

文档版本

1.0.3

撰写人

@Saber.tang

编写日期

2025-09-25

 

2.0 修订记录

 

版本号

日期

属性

描述

1.0.3

2025-10-17

新增

  1. 新增:备注名字段

1.0.2

2025-10-16

新增

  1. 新增:8.3 边界场景

  2. 新增:批量上传逻辑说明

1.0.1

2025-10-13

新增

  1. 新增:筛选项新增编号搜索

  2. 新增:hover 状态时的说明

  3. 新增:栏目选项(新增后有 5 个栏目选项)

  4. 修改:新增/编辑页面,添加语言改为语言(文案修改)

  5. 修改:筛选项和字段删除标题

  6. 完善:帮助中心和通用文章状态同步说明

1.0.0

2025-09-25

新增

新增文档

 

3.0 关联清单

 

 

4.0 需求背景

 

在推进新人转化专项需求落地时,需解决「多页面展示帮助中心文档」的问题,初始评估两种方案存在明显局限:

 

  1. 前端写死:提前确定文档内容由前端录入,更新需重新发版,灵活性差,文档更新与管理效率低。

  2. 页面单独开发后台:为每个业务页面单独开发运营管理后台,功能重复开发导致研发成本高,且无法实现多页面统一管理。

 

经与 @Clio.zhou @Kui.pan @May.liu @Nicole.zhang 讨论确认,最终确定开发通用化文章展示功能,支持多业务页面灵活调用文档,既能节省研发资源、简化文档管理流程,也为后续扩展至更多业务页面预留空间。

 

5.0 需求目标

 

  1. 提高管理便捷性:通过统一管理和同步更新,确保各业务页面文档与帮助中心更新状态实时一致。

  • 保障可扩展性:预留扩展能力,未来可快速将功能接入更多业务页面,无需重复开发。

  • 节省人力:减少研发重复开发后台的工作量,降低运营重复配置的时间成本,提升整体协作效率。

  • 用户体验优化:支持文档排序和封面文章功能,让页面内容展示更具逻辑性,增强对用户的引导效果。

 

目前需要调用该功能的任务清单如下:

 

https://project.larksuite.com/lbk/story/detail/7495848

https://project.larksuite.com/lbk/story/detail/7483961

https://project.larksuite.com/lbk/story/detail/8151128

 

6.0 方案设计

 

由于 【APP+WEB+TWALK+BE】【新人专项】【首次合约转化】【9月】合约入门落地页 已做了管理页面,因此决定在该页面基础之上做迭代优化。

 

目前 @Boris.bao 对合约入门落地页的新手教程功能还没做完,因此方案分为两部分,需要活动线研发支持:

  1. 完成现有的合约入门落地页的新手教程

  2. 对新手教程做优化和功能迭代。

 

8.0 需求详情

 

8.1 现有合约入门落地页的新手教程需求

 

页面

截图和说明

新手教程



 

 



用户控制客户端「新手教程」显示哪些文章,以及文章的排序;文章从「运营管理-内容中心-公告&帮助中心」,以编号的形式获取。


筛选项

  1. 编号:搜索框

  2. 标题:搜索框(搜索默认语言的标题)

  3. 状态:select 下拉框


表格字段:

  1. 编号:同「公告&帮助中心」编号

  2. 标题:默认语言的标题,从「公告&帮助中心」获取

  3. 排序值:控制文章显示顺序;越大越靠前;

  4. 创建人

  5. 创建时间

  6. 修改人

  7. 修改时间

  8. 帮助中心状态:同「公告&帮助中心」状态,禁用,不可编辑

  9. 合约落地页状态:

    1. on/off:是否显示文章

    2. 帮助中心状态为 on 时,合约入门落地页状态可以为 on/off

    3. 帮助中心状态为 off 时,合约入门落地页状态必须为 off(数据单向同步);帮助中心状态有更新时,合约入门落地页状态同步更新。

  10. 操作

    1. 预览:点击新页面,打开默认语言的文章

    2. 编辑:显示「编辑文章」抽屉

    3. 删除:显示「删除确认」弹窗


新增文章

  1. 编号:input 输入框

    1. 未输入:提示文案 请输入

    2. 未输入:点击「同步」,message error 提示「请输入编号」

    3. 已输入:点击「同步」,同步按钮 loading 中

      1. 编号输入正确:message success 提示「同步成功」

      2. 编号输入错误/找不到:message error 提示「编号错误,请重新输入」

      3. 网络等错误:message error 提示「网络错误,请重试」

  2. 语言:

    1. 未同步编号:图三所示

    2. 已同步编号:图四所示

      1. 显示默认语言(排第一)

      2. 显示其他语言

  3. 封面上传:upload 上传组件,逻辑同「广告管理」;用于在客户端显示

  4. 排序值:逻辑同「广告管理」;用于在客户端控制文章顺序

  5. 帮助中心文章状态:显示该文章在帮助中心的当前状态;禁用不可编辑;

    1. 状态为启用,就显示启用;状态为禁用,就显示禁用

  6. 合约入门落地页文章状态:

    1. 默认为启用

    2. 当帮助中心文章状态为禁用,合约合约入门落地页状态必须为禁用


编辑文章

  1. 禁用编号,无法修改

  2. 其他同新增


交互:

  1. 在表格字段,切换「合约落地页状态」状态,popconfirm 提示「确认要启用吗」「确认要禁用吗」,图二所示

  2. 在表格字段,点击删除,popconfirm 提示,「确认要删除吗」,图二所示

 

8.2 文章显示管理(新手教程的迭代需求)

 

页面

截图和说明

入口

将原有「运营管理-运营工具-合约入门新手教程」移动至「运营管理-内容中心-公告&帮助中心」的下方,并重命名为「文章显示管理」

文章显示管理



 


 




页面作用:

  1. 控制客户端某个页面显示哪些文章,以及文章的排序;文章从编号的形式获取。


页面改动点(图一):

  1. 表格筛选项:

    1. 编号:input 输入框

    2. 备注名:input 输入框

    3. 栏目:select 单选下拉框

    4. 状态:select 单选下拉框

  2. 表格字段:

    1. 编号:同「公告&帮助中心」编号

    2. 备注名:同「公告&帮助中心」备注名

    3. 标题:默认语言的标题,从「公告&帮助中心」获取

    4. 栏目;显示文章对应的栏目,多个用 分隔符

    5. 状态:当帮助中心文章状态为禁用,hover 状态的 switch 按钮时,提示 帮助中心为禁用状态,暂不支持修改

  3. 按钮:添加文章按钮改为关联文章 ; 对应的新增/编辑弹窗标题需一起修改


关联文章改动点(图二图三)

  1. 备注名:

    1. select 下拉框;可搜索可输入

    2. 只显示「公告&帮助中心」已启用的文章

  2. 原有「语言」选项:删除

  3. 添加语言和标题:新增项

    1. 作用:用于控制客户端文章显示的语言和标题(即同一份文章,允许在「公告&帮助中心」显示 LBank 新手指南:合约入门新手教程,在其他页面(通过此功能),显示 合约入门新手教程

    2. 状态:

      1. 编号未同步时,语言和标题为空

      2. 同步成功后,展示源文章支持的所有语言;语言选项禁用,不可新增或删除语言;可以修改标题

      3. 每个语言对应一个标题输入框,运营可选择性填写自定义标题;

      4. 若不填写:前端显示时,将直接采用该语言对应的原始标题;点击预览按钮,新页面显示「原始标题 + 文章正文」

      5. 若填写:前端显示时,将使用此处填写的自定义标题; 点击预览按钮,新页面显示「原始标题 + 文章正文」

      6. 标题支持批量导入(即批量导入自定义标题)

      7. 交互参考「花猫广告管理-广告管理」

  4. 新增 栏目

    1. 控制文章在哪些页面显示;select 下拉框,可搜索可多选

    2. 选项:合约入门落地页现货帮助中心现货杠杆帮助中心合约帮助中心APP 下载页

  5. 修改「封面上传」:改为可选;若不上传,则前端显示时,不展示封面图。

  6. 编辑:

    1. 备注名禁用,不可编辑


帮助中心状态和状态的同步说明:

  1. 新增时:

    1. 帮助中心状态为 on 时,状态可以为 on/off

    2. 帮助中心状态为 off 时,状态必须为 off(数据单向同步);

  2. 帮助中心状态有更新时,状态半同步更新:

    1. 帮助中心从 off 改为 on,状态不变 也改为 on

    2. 帮助中心从 on 改为 off,状态改为 off


批量上传模版

articleTitle.xlsx

批量上传只更新语言代码匹配的部分:

  1. 场景一:文章语言代码 9 个,批量上传文件有 12 个,匹配成功 9 个,最后更新 9 个

  2. 场景二:文章语言代码 9 个,批量上传文件有 9 个,匹配成功 9 个,最后更新 9 个

  3. 场景三:文章语言代码 9 个,批量上传文件有 5 个,匹配成功 5 个,最后更新 5 个

  4. 场景四:文章语言代码 9 个,批量上传文件有 0 个,匹配成功 0 个,最后更新 0 个,提示:Excel 文件为空,请检查


其余同原有逻辑

 

8.3 边界场景

 

公告中心的文章语言状态的同步问题

1 不管语言状态,同步所有的标题

 

边界场景

1 公告中心语言从禁用改为启用,文章显示管理 不同步

2 公告中心新增语言,文章显示管理 不同步

后续二期再提需求优化,一期不改

 

9.0 测试验收

 

序号

问题和说明

1

 


删除 运营工具-合约入门新手教程

2

 


  1. 删除红框内的文章显示管理

  2. 将选中的文章显示管理移动至「公告帮助中心」下方

3

 


  1. 在公告帮助中心复制备注名,直接粘贴到输入框,没有搜索结果;但是手动输入是有的

  2. 没有搜索结果后,关闭下拉框,再重新选中,下拉框的内容一直在 loading(如上图);必须要关闭面板,重新点击关联文章,才能重新显示下拉框内容。



4

 


所有字段左对齐

5

 


  1. 需要确认下现在前端是最多显示多少条,后端配置了 14 条,但前端只显示 8 条

  2. 和设计师、业务方已确认,web\app 最多显示 10 条

6

 


  1. 新手指南点击广告位,也是在新 tab 页面打开

 

10.0 运营配置说明

 

功能位于 「运营工具-文章显示管理」

  1. 作用:目前可控制现货/现货杠杆/合约的新手指南、合约入门落地页、App 下载页五个场景的显示哪些文章

  2. 数据来源:

    1. 文章显示管理的文章都是从「公告帮助中心」获取的

    2. 因此,如果有一篇新文章想要在上述 5 个场景展示,需要先在「公告帮助中心」新增,再在「文章显示管理」配置



 

 

关联文章的步骤:

  1. 编号:输入编号,进行搜索、

  2. 备注名:无需填写,搜索编号后自动显示

  3. 显示标题:

    1. 重新编辑标题,例如在「公告帮助中心」页面,显示的标题是 LBank新手必做攻略:如何进行现货交易

    2. 但是觉得标题太长,于是改成了 如何进行现货交易,最后在用户看来, 就是显示 如何进行现货交易

    3. 选填,可以不编辑,保留原有标题

  4. 栏目:这篇文章想要显示在哪个栏目

  5. 排序值:文章在栏目中的排序值,越大越靠前

  6. 封面上传:

    1. 现货/现货杠杆/合约、帮助中心:不需要上传

    2. 合约入门落地页:需要上传图片,宽高尺寸 384*216

  7. 状态:

    1. 启用(默认)

    2. 禁用:在对应的栏目不显示这篇文章

 

 

 

特殊说明

  1. 目前选择的文章只能是「公告帮助中心」的帮助中心和公告中心,如果选择了学院/问答平台的,会 404

  2. 搜索编号后,需要确认在「显示标题」没有变量,如果有变量,需要编辑标题,将变量去掉。

    1. 例如显示标题是 LBank合約下架YIDAFANG永續合約 ,快来参与

    2. 需要删除 变量,最终显示 LBank合約下架 YIDAFANG 永續合約

  3. 关联公告中心的文章时,保存状态必须为「保存」,不要关联「仅保存」的文章