# LDP-MCS操作手册

[TOC]

## 1、登录

![登录](progress/1登录.png)

依次输入正确的用户名、密码、验证码，点击登录即可成功登录。

## 2、主界面

![主界面](progress/2主界面.png)

目前dashboard还没有内容。

## 3、系统维护

系统维护中包含账号管理、组织管理、职位管理、员工管理、管理菜单维护、应用菜单维护、定时任务、定时任务日志等相关信息维护。

### 3.1、账号管理

#### 3.1.1、账号列表

![账号管理列表](progress/3账号管理列表页.png)

账号列表页面可以进行条件查询、批量删除数据、对单条账号数据的新增、信息修改、删除操作、密码修改等。

#### 3.1.2、条件查询

可以通过名称、状态、用户类型进行**精确查询**，例如查询账号名称为admin的账号：先在名称处输入admin，然后点击查询即可。

#### 3.1.3、批量删除

在列表中勾选要删除的数据，点击列表数据上面的删除按钮，即可实现批量删除。PS：**不能删除当前登录账号，不能删除超级管理员。**

#### 3.1.4、新增账号

![账号新增界面](progress/4账号新增界面.png)

输入对应的账号信息，点击保存即可。

#### 3.1.5、单条数据修改、删除

点击对应数据后面的修改，修改界面和新增界面类似，修改对应的字段，点击保存即可；

点击删除按钮后，提示是否删除，点击确定即可（**不能删除当前登录账号，不能删除超级管理员账号**）；

#### 3.1.6、修改密码

![修改密码](progress/29修改密码弹窗.png)

点击操作列中的修改密码按钮，输入对应的新密码和管理员密码，即可修改对应账号密码。

### 3.2、组织管理

#### 3.2.1、组织列表

![组织管理列表](progress/5组织管理列表.png)

组织管理列表支持条件查询、批量删除、对单条数据进行修改和删除。

#### 3.2.2、新增组织

![新增组织](progress/6新增组织弹窗.png)

输入对应的组织名称、简称、编码等信息，选择上级组织后，自动生成层级和排序值，点击提交即可。

### 3.3、职位管理

#### 3.3.1、职位列表

![职位列表](progress/7职位列表界面.png)

职位管理列表支持条件查询、批量删除、对单条数据进行修改和删除。通过点击左侧的组织树中的组织，列表中的职位将按组织筛选（只暂时对应的组织下的职位）。

#### 3.3.2、新增职位

![新增职位](progress/8职位新增界面.png)

选择左侧的组织树中某个组织，点击列表上新增按钮，填写职位信息后，点击提交即可。

### 3.4、员工管理

#### 3.4.1、员工列表

![员工列表](progress/9员工管理列表界面.png)

员工管理列表支持条件查询、批量删除、对单条数据进行修改和删除。

#### 3.4.2、新增员工

![员工新增](progress/10员工添加界面.png)

输入对应的信息，并选择关联组织和关联职位之后（先选择关联组织，才能获取到关联职位），点击提交即可。

### 3.5、管理/应用菜单维护

<center>管理菜单维护</center>
![管理菜单维护](progress/11管理菜单维护.png)

<center>应用菜单维护</center>
![应用菜单维护](progress/12应用菜单维护.png)



#### 3.5.1、新增菜单

例如：在**系统维护**下建一个新菜单**测试菜单**，直接在右侧填写信息，在**上级节点**字段选中**系统维护**，最后点击提交即可。

#### 3.5.2、删除菜单

在左侧菜单树选中想删除的节点，点击最上面的删除按钮（根节点无法被删除、存在子节点无法被删除，被角色引用的节点无法被删除）。

#### 3.5.3、修改菜单

在左侧菜单树选中想修改的节点，在右侧修改相应的数据，点击提交即可。

### 3.6、定时任务

![定时任务](progress/13定时任务.png)

定时任务管理列表支持根据任务名称查询、对单条任务进行启动、暂停、修改、删除、手动执行等操作。

#### 3.6.1、新增定时任务

![新增定时任务](progress/30新增定时任务.png)

输入对应的任务名称，定时调用的接口地址，cron表达式（任务执行时间及频率），或者指定确定的时间执行，请求方式分别为POST、GET，然后填写请求参数，最后点击提交即可。

#### 3.6.2、删除定时任务

在定时任务列表操作列种点击删除按钮即可。

#### 3.6.3、启动和暂停定时任务

定时任务可以通过点击操作列种的第一个按钮，进行启动和暂停，也可以点击最后一个按钮手动执行。

### 3.7、定时任务日志

![定时任务日志](progress/14定时任务日志.png)

定时任务日志会记录所有定时任务执行的情况，如果是异常，可以让鼠标悬停在详细信息列查看更完整的信息。可以通过任务名称查询。

## 4、权限管理

权限管理包含组织数据权限、角色管理、管理菜单权限、应用菜单权限。

### 4.1、组织数据权限

#### 4.1.1、数据角色关联

![组织数据权限](progress/15组织数据权限.png)

组织数据权限主要管理的是类型为数据的角色，主要是此类型的角色关联组织数据以及。按照上图的操作，先选择角色，右侧会出现两棵树，左边是已经关联的数据，右边是备选数据，在备选数据中，勾选上相要关联的组织数据，对不想要的组织数据取消勾选，再点击**保存**即可。

#### 4.1.2、角色关联用户

![关联用户](progress/16角色关联用户.png)

按照上图操作，将数据角色和未关联用户关联起来，或者把已关联的用户取消关联。

### 4.2、角色管理

#### 4.2.1、角色列表

![角色列表](progress/17角色管理界面.png)

角色管理列表支持**条件查询**，通过角色名称或者角色类型进行**精确查询**，还支持单条记录的**修改**和**删除**。

#### 4.2.2、新增角色

![新增角色](progress/18新增角色弹窗.png)

选择角色类型，输入角色名称和备注，点击**提交**即可。

### 4.3、管理/应用菜单权限

![管理菜单](progress/19管理菜单权限.png)

1、首先点击角色名后面的**权限配置**，

2、在**菜单角色关联**中对角色关联的权限进行变更（增加/删除关联）

3、点击**保存**即可。

右侧的**角色关联用户**参照[4.1.2、角色关联用户](#4.1.2、角色关联用户)

## 5、数据字典

### 5.1、字典管理

#### 5.1.1、字典列表

![字典列表](progress/20字典列表界面.png)

依照上图点击做边的字典，右边会刷新出该字典的字典项，在字典或者字典项后方都可以对该字典或字典项进行修改或删除。

#### 5.1.2、新增字典

![新增字典](progress/21新增字典弹窗.png)

填上对应的字典名称或者字典编码，点击提交即可。

#### 5.1.3、新增字典项

待定（可能需要修改）

## 6、系统状态

系统状态包含操作日志、用户登录日志、在线用户监控、接口调用日志等模块。

### 6.1、操作日志

![操作日志](progress/22操作日志列表界面.png)

点击左侧日志模块类型，该类型的日志信息列表就会出现在右侧，可以通过模块类型名称对日志类型进行**精确查询**，日志列表中也可以通过**时间段**和**是否异常**进行**精确查询**。

### 6.2、用户登录日志

![用户登录日志](progress/23用户登录日志.png)

用户登录日志可以通过**用户名**和**时间段**进行条件查询。

### 6.3、在线用户监控

![在线用户监控](progress/24在线用户监控.png)

在线用户监控可以通过**用户名**进行**精确查询**

### 6.4、接口调用日志

![接口调用日志](progress/25接口调用日志.png)

接口调用日志是用来监控第三方应用调用接口的日志，可以通过**接口名称**与**时间段**进行**精确查询**

## 7、编码规则

### 7.1、编码规则

编码规则是一种固定格式的规则，新建一个编码规则后，每一次调用API，根据规则生成一个自增后的编码。

#### 7.1.1、编码规则列表

![编码规则列表](progress/26编码规则列表界面.png)

编码规则列表可以使用**编码名称**进行**精确查询**，还可以通过操作列对每条数据做出**修改**和**删除**

#### 7.1.2、新增编码规则

![新增编码规则](progress/27新增编码规则弹窗.png)

输入对应的key、名称、描述后，选择间隔符与模板，设定好序号位数(1位表示1-9，2位表示01-99)，点击提交即可。

## 8、快速开发

### 8.1、代码生成

代码生成模块通过，定义好模型与关联后，自动生成相关的Entity、Service、Rest代码。

![代码生成](progress/31代码生成.png)

**业务模型ID**：此业务的标识符。

**业务模型名称**：此业务名称

**数据库连接**：可选，MySQL、Oracle、SQLServer。

#### 8.1.1、新建数据模型

![新建数据模型](progress/32新建数据模型.png)

**数据模型ID**：业务ID，建立关联依赖于此ID，生成的Rest接口也会以此ID作为业务名称。

**数据模型类名**：代码类名。

**说明**：数据库建表的备注。

**默认控件**：在前端的展现样式。

#### 8.1.2、数据模型字段

![数据模型字段](progress/33数据模型字段.png)

**字段**：字段名，对应表名中的字段，实体类的属性。

**说明**：对字段的说明

**类型**：对应表中的类型和实体类的类型，目前有primary（主键）、string（普通字符）、longstring（长字符串）、date（日期格式）、int（整型）、decimal（浮点型）。

**计算函数**：目前内置4个自动填充函数，sysuuid（自动生成唯一表示的算法）、sysmd5（字段进行md5加密）、sysuserid（默认填充当前登录用户）、systime（默认填充当前时间）

#### 8.1.3、新建关联

创建好相应的数据模型后，就可以创建关联关系了。目前支持一对多、多对一、多对多。

![关联](progress/34新增关联关系.png)

输入关系对象ID，再选择多方数据模型（有外键的一方），最后选择关联关系：MTO、MTM，分别为一对多、多对多。

![多对多关联](progress/35多对多关联.png)

然后再通过外键将模型之间关联起来。点击提交生成代码，浏览器会下载一个压缩包，解压后包含一个项目（或者是部分代码，根据选择的工程代码模块）、数据库建表sql脚本文件。

将代码导入到IDEA中，根据工程中的README.md文档进行编译构建。



















