Hawthorn-Api

# 规范说明

  1. 减少bug处理
  2. 有助于代码审查
  3. 降低维护成本

# 规范要求

# 1. 统一类注释，方法注释模版

    koroFileHeader: js文件、方法注释模版
1

# 2. 包名称采用小写命名，类名称采用首字母小写并且以驼峰方式命名

    例：包名user 类名userMng
1

# 3. index.vue文件中的name要与表字段component_name一致，不可以重复首字母要大写

    例：数据库:component_name:userName  index页 name: 'userName',
1

# 4. 前台页面 时间精确到 年月日时分、日期精确到 年月日

    例：创建时间：2023-01-01 12:30  创建日期：2023-01-01,
1

# 5. 页面备注 采用textarea

    例： 
         {
          type: 'textarea',
          format: [0, 'isAny', 100],
          field: 'remark',
          label: '备注'
         }
1
2
3
4
5
6
7

# 6. 页面字段长度与数据库中的字段长度要匹配，特别是编辑页面

    例：编辑页面:
          {
          type: 'textarea',
          format: [0, 'isAny', 100],
          field: 'remark',
          label: '备注'
          }
        数据库：
          `customer_name` varchar(100) DEFAULT NULL COMMENT '备注'
1
2
3
4
5
6
7
8
9

# 7. 页面上可输入内容字段类型的控制要准确，不能都用isAny

    例：
        {
          type: 'datetime',
          format: [0, 'isDateTime', 30],
          label: '日期时间',
          dateType: 'datetimerange2',
          field: 'datetime'
        }
1
2
3
4
5
6
7
8

# 8. 涉及金额资金的，要居右并且格式化千位符展示 例如：1,000,000.00

    例：
        {
          label: '金额',
          prop: 'amount',
          align: 'right',
          render: (scope) => {
            return (
              <div>
                {amountFormat(scope.row.amount)}
              </div>
            );
          }
        }
1
2
3
4
5
6
7
8
9
10
11
12
13

# 9. 报表类查询要默认展开筛选条件

    例：
        <ht-form ref="userFm" ref-form="userFm">
          <ht-search-bar :expand="false">// 添加:expand="false"
          </ht-search-bar>
        </ht-form>
1
2
3
4
5

# 10. 涉及服务商、经销商、门店 显示简称

# 11. 对于重要显示字段要前置，并进行列锁定

    例：
        {
          label: '锁定',
          fixed: 'left'
        }
1
2
3
4
5

# 12. 如存在级联关系的字典要进行级联筛选，例：省、市、县

← 后端 →