# czleing-admin-api

**Repository Path**: czleing/czleing-admin-api

## Basic Information

- **Project Name**: czleing-admin-api
- **Description**: 基于若依单体后台管理系统修改
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2024-01-29
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# czleing-admin-api
### 基于[若依-单体-后端服务](https://gitee.com/y_project/RuoYi)修改
### czleing-admin 后台管理系统接口服务

### 基于若依单体后端服务，做了一些修改，规范了一些字段类型、命名和使用方式，如下：
- 化繁为简，去掉了 Restfull 规范，统一使用 Post 请求
- 去掉多余的 Service 接口层 IXxxService，特定场景需要再加
- 简化目录结构，删减目录层级，调整分类逻辑，不再按文件类型划分目录，改为按模块划分，相同模块的资源 controller\service\mapper 放在一起
- 是否类字段统一使用 Boolean 类型，字段名统一使用 isXxxx 命名，数据库统一用 tinyint(1)
- 规范 0、1 的意义，统一使用 0 代表否定，1 代表肯定
- 数据表主键字段后续统一命名为 id，减少心智负担
- 状态 status 的[0=正常、1=停用]统一改为是否启用 is_enabled[true、false]
- 去掉了多余的 ruoyi 前缀，更适合各个企业和项目免改使用
- 重构了代码生成模块，增加了一些配置，新增和替换了模板，SQL自动执行，菜单自动删除和新增，生成路径更智能等
- 引入 springdoc-openapi 自动生成接口文档
- 重构了请求的参数解析与返回，调整了 VO、BO、ENTITY 及相关父类继承关系，减少接口文档中因继承出现的不相关的字段信息
- 整合了分页参数和日期范围到统一的参数接收类中，不再独立从URL中和Map中接收，并统一查询参数中日期范围字段的命名方式(xxxBegin、xxxEnd)
- 其他bug修复及优化

### 注意事项
#### 1、数据库设计注意事项
- 是否类字段类型使用 `tinyint(1)`，对应 java 里使用 `Boolean`
- 用于 CRUD 的表必须加以下字段： `create_by`, `create_time`, `update_by`, `update_time`，需要逻辑删除则需加 `is_deleted` 字段
- 需关联字典的字段，统一使用字符类型 `varchar(xx)`