开发规范

源码

项目源码

使用旭纸业的项目作为基础源码

• 删除所有业务层代码
• 删除配置文件中所有上传文件的路径，注意要同步删除 WebMvcConfigure 中配套的 URI
• 更换 mybatis 为 mybatis-flex
• 更换登录页面为商贸软件登录页面

二开必读

二次开发时必须先读本文档，这里记录关联关系

• 修改项目配置文件中项目名称，PDA 有后台 app，要重新编译安装

数据

创建/修改时间

所有表都有创建时间 create_time 和修改时间 update_time，这两个字段都不需要开发人员管理，都有数据库自动填充/修改数据

审计字段

所有数据表都要有 创建时间、创建人、最后一次修改时间、最后一次修改人，依次对应字段 create_time,create_user,update_time,update_user

逻辑删除

所有数据使用逻辑删除，字段 is_delete，删除前判断不可有关联数据（一般为下游数据）

操作

模态窗

保存退出按钮显示在右下角，从左到右顺序依次是：保存、退出

导出

基础资料表格、序时表、统计数据报表都是导出过滤后的数据

UI/UX

图标

所有使用的图标要求在文件 D:\projs\snbcems\frontend\jquery-easyui-1.6.7\themes\icon.css 中有注册，如果没有注册，保证在目录 D:\projs\snbcems\frontend\jquery-easyui-1.6.7\themes\icons 下有图标文件后在文件 icon.css 中类似下面注册后即可使用

.icon-deete{background:url('icons/bullet_arrow_up.png') no-repeat center center;}

如果图标文件名称是 bullet_arrow_up.png 则在 html 文件中如下使用

icon-bullet_arrow_up

• 角色操作 - icon-group
• 菜单操作 - icon-text_list_bullets
• 新增 - 旭纸业项目使用的图标是 icon-add
• 修改 - 同旭纸业使用一样的图标 icon-edit
• 删除 - 同旭纸业使用一样的图标 icon-cancel
• 删除全部 - icon-clear
• 保存 - 使用图标 icon-disk
• 保存新增 - icon-page-save
• 复制单据 - 图标 icon-page-copy，如果没有，在文件 \jquery-easyui-1.6.7\themes\icon.css 最顶上追加一行代码 .icon-page-copy{background:url('icons/page_copy.png') no-repeat center center;}
• 添加全部 - icon-table-add
• 删除全部 - icon-table-delete
• 复制行 - icon-page-copy
• 新增行 - icon-table-row-insert
• 删除行 - icon-table-row-delete
• 查询 - 同旭纸业使用 icon-search
• 刷新 - icon-reload
• 清除过滤 - icon-clear-filter
• 导出 - icon-page-excel
• 关闭 - 同旭纸业使用一样的图标 icon-no
• 列 - 同旭纸业使用一样的图标 icon-text-columns
• 作废 - icon-cancel16
• 上移 - icon-move-up
• 下移 - icon-move-down
• 置顶 - icon-move-top
• 置底 - icon-move-bottom
• 维修对策 - icon-book-edit
• 纳入知识库 - icon-brick-add
• 取消纳入知识库 - icon-brick-delete

基础资料

• 对于树形结构的数据，其他业务逻辑中引用其主键，不要引用名称。为兼容不同类别下有同名的情况
• 表格显示数据，弹出模态窗用于新增 / 修改数据，不要使用行内编辑方式。
• 模态窗从上到下显示的属性按照表格从左到右的列顺序显示

其他

• 工具栏采用扁平风格的 ribbon 菜单栏（翔轮项目报表的菜单栏，双行大小按钮）
• 所有基础资料采用表格显示数据，通过弹出对话框的方式新增 / 修改数据