使用 hexo + github 搭建博客网站

本地授权

集中授权

前端问题解决方案编写规范

一、 目录结构

- Docs

-- 常见问题
--- images
--- 20220718 集中授权样式覆盖问题.md
--- 20220720 解决代码合并冲突问题.md

-- 公共模块方法
-- images
--- 20220720 凭证打印.md

-- 前端规范
-- images
--- 20220721 前端问题解决方案文档编写规范

-- 业务知识
-- images
--- 20220726 发起集中授权任务及捞任务操作步

1. 【常见问题】目录

用来存放开发过程中产生的bug问题收集，以及解决方案。

2. 【公共模块方法】目录

用来存放fox项目的一些公共方法介绍文档，以及使用步骤。

3. 【前端规范】目录

用来存放前端开发规范文档。

4.【业务知识】

用来存放交易相关业务知识、交易需求分析等。

二、 图片规范

1. 图片存放目录

图片存放在 xxx/images 文件夹

2. 图片命名

-- images
--- jQuery问题01.png
--- jQuery问题02.png
--- 集中授权样式覆盖截图01.png
--- 集中授权样式覆盖截图02.png

命名需要和所编写的文档文件名保持一致，多张图片一数字区分

集中授权样式覆盖截图(文档名称) + 01(数字).png

// 错误写法
集中授权样式覆盖截图-01.png
集中授权样式覆盖截图_01.png

// 正确写法
集中授权样式覆盖截图01.png

3. 图片大小

使用的图片不允许超过1M大小

4. 图路径

文档中图片路径使用相对路径

错误写法

![集中授权样式覆盖截图04.png](E:\work\work\集中作业-集中授权\images/集中授权样式覆盖截图04.png)

正确写法

![集中授权样式覆盖截图04.png](images/集中授权样式覆盖截图04.png)

• [] 内文字和图片名保持一致 ![xxxx.png](images/xxxx.png)

如：![集中授权样式覆盖截图04.png](images/集中授权样式覆盖截图04.png)

三. 文档规范

1. 文档命名规范

20220718(文档编写日期) + 集中授权样式覆盖问题(文档核心内容描述).md

20220718 集中授权样式覆盖问题.md

2.文档内容规范

2.1. 【常见问题】 文档

• 一、问题复现
  • 异常效果
  • 正常效果
• 二、产生原因(问题分析)
• 三、解决方案

文档内容需要按照这三个要点编写

2.2. 标题结构（大纲）

标题结构清晰、要有顺序，一级一级的写，不要一会一级一会六级。

可参考下图：

凭证打印实现流程

支持设备列表

一、 涉及场景、业务

涉及凭证或者其他需要打印的场景。

二、 方法阐述

1. 打印数据

/**
 * 打印数据
 * @param {*} templateId 模板id
 * @param {*} params     模板数据
 */
print(templateId, params) {
    fox.dev.printer
        .print(this, templateId, params)
        .then((response) => {
            console.debug(response)
        })
        .catch((error) => {
            console.error(error)
        })
}

2. 打印预览

/**
 * 打印预览
 * @param {*} templateId 模板id
 * @param {*} params     模板数据
 */
preview(templateId, params) {
    fox.dev.printer
        .preview(this, templateId, params)
        .then((response) => {
            console.debug(response)
        })
        .catch((error) => {
            console.error(error)
        })
}

三、 打印模板生成相关

• 打印模板需要按照格式自行生成，具体使用方法请参考 《YUPT编辑器使用文档》；

• 模板生成后需要上传的位置，请 RTX 或者企业微信@徐建峰处理；
• 先前的打印业务，老柜面有现成的模板，可以联系自己的业务确定。

1. 如有需要配数据字典，则需要在 pub.xml 文件中进行字典翻译项添加，pub.xml文件需要放置于打印服务所部署服务器的指定路径（具体路径参考apollo配置）。如下图所示：一个DataSource标签表示一个字典项，name 属性为字典项的属性名称，如币种、账户类型等；Item标签中为具体属性值，根据业务需求进行配备，id属性与value属性一致。

2. 若新增一种模板文件，后台代码则需要重新对前端上送数据进行取值，并在遍历模板信息时需要新增模板文件信息如下图：

将需要的值都填充完之后，后台会根据所指定的模板文件转成指定格式，经后台转换后为如下样式的加密报文返回给前端.

缺少jQuery问题

一、问题复现

二、产生原因(问题分析)

缺少jQuery插件

三、解决方案

1、安装jQuery依赖

npm install jquery --save

2、修改 webpack.base.js 文件

const webpack = require('webpack')

module.exports = {
    plugins: [
        new webpack.ProvidePlugin({
            $: 'jquery',
            jQuery: 'jquery',
            'windows.jQuery': 'jquery'
        })
    ],
}