# shieldsb-admin-modules

**Repository Path**: donggongai/shieldsb-admin-modules

## Basic Information

- **Project Name**: shieldsb-admin-modules
- **Description**: shieldsb项目的模块，需要作为模块引入到shieldsb-admin-demo中使用，将常用的用户管理、角色管理、菜单管理、权限管理、代码生成器、插件管理、敏感词管理、配置文件管理、服务器监控、文件监控、日志查看、以及一些常用在线工具。
- **Primary Language**: Java
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 2
- **Created**: 2020-06-03
- **Last Updated**: 2022-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[TOC]

### 软件管理中心-模块
![](https://img.shields.io/badge/release-1.0.0-blue.svg)
#### 项目说明
将通用功能拆解为模块，方便升级管理。

 
#### 开发约束
原则：命名尽量简洁并参考字典库中的定义，同一模块的功能放到同一个目录下

-  必须有createTime，createBy，updateBy，updateTime，status字段 

-  1、状态显示：

审核状态：通过、退回、待审核
评分审核状态：评分完成、待审核、退回、通过，正在计算分值
处理状态：处理、质疑、待处理
处理类型：处理、待处理、已导出
上报状态：上报、未上报、数据错误
申请状态：申请中、待审核、通过申请、退回申请
申请状态2：申请中、关闭、待审核、被退回
申请进度：完成、处理》处理中
受理状态：待受理、受理、未受理
数据状态：正确、疑问
屏蔽：屏蔽、显示
置顶：置顶、空
启用状态：启用、禁用
排列顺序：统一倒序排列
搜索功能中下拉框必须有全部，添加修改部分可根据实际情况调整
其他状态显示根据情况定，遵循简洁的原则

-  2、按钮命名（包括图标按钮）：

审核状态：通过、退回
列表页: 添加（非新增）、修改（非编辑、非更新）
表单页：添加修改是否统一改为提交（非新增、非编辑、非更新）、删除

-  3、controller命名：

原则上toXX的是到某个jsp页面，如toUpdate是到update页面;
doXX是执行xx操作，do可以省略，如doUpdate为更新操作，do可省略即为update;

-  4、service命名：

与controller保持同源命名，除非是公用service
如controller命名为SysMenuController，则service命名为SysMenuService，去除表明语义的后缀部分（Controller、Service）其他部分相同

-  5、jsp命名：

业务开头，动作结束，建议添加与修改用同一个页面update.jsp
如用户 user_update.jsp（添加） use_update.jsp（修改） user_list.jsp（列表） user_search.jsp（搜索），user_audit.jsp(审核)
建议使用代码生成器生成。

-  6、日志：增删改等凡涉及数据变动的操作必须记录日志，日志需要记录主键

-  7、创建人、创建时间、修改人、修改时间必须有

-  8、内容一致：详情页与修改页、列表页同一字段显示一致

-  9、资源路径中必须有ctxPath，${ctxPath }

-  10、查询数据必须有排序，默认以创建时间倒序排列

-  11、jsp页面中调用变量时，注意标明作用域，requestScope默认可省略，其他如sessionScope，applicationScope不可省略

-  12、展示页面的数字不使用科学计数法（客户理解不了）使用标签或工具类处理如：<fmt:formatNumber value=" ${manageUserModel.money }" pattern="0.####"/>

-  13、model中属性不能使用基本类型对象等带默认值的对象，防止默认值的干扰

-  14、ShieldJS插件的选择器及插件方法必须以"_plugin"结尾

#### 目录说明
- src/main/java    		后端框架的代码;
- src/main/resources   资源文件目录
- log4j2.xml          log4j2的日志输出文件
- src/test/java    		后端框架的测试代码;
- src/test/resources   资源文件目录
- out    			       导出目录
- test-output          testng的输出目录
#### 新增注解说明
- EqualsAndHashCode  
默认子类的equals和hashCode方法，不会包含或者考虑基类的属性
 
#### 版本说明
##### v1.0.0（2019-05-06）
- 初版发布;
- ;