代码生成使用指南

1点击放大

1. 1点这里新建一个工程

打开左侧菜单的「工程管理」，点右上角「新增工程」。第一次进来列表是空的，也是从这里开始。

1. 1「工程名」填英文小写字母和短横线，例如 merchant-admin。
2. 2「描述」写清这个系统管什么，例如「商家入驻与信息管理」。
3. 3「服务端」「前端」保持默认；「主题色」和「布局」决定生成出来的样子，拿不准就用默认。

12点击放大

1. 1工程名：英文小写，会变成代码包名
2. 2描述：写给以后自己看的一句话

「数据库连接」是平台替你记住的一套库地址与账号。工程绑上它，生成的系统默认就用这套连接。

1点击放大

1. 1库地址、账号、密码都在这里登记

1. 1进左侧「数据库连接」菜单，点「新增连接」。
2. 2填连接名、主机地址、端口、数据库名、用户名、密码，保存。
3. 3回工程详情页，在「工程设置」里点开「数据库连接」那一行，选中刚建的连接。
4. 4重新生成一次，生成物里就带着这套连接了。

1点击放大

1. 1工程设置这一行选中要用的连接

在「表」页签点「新增表」。这里用一句建表语句来描述数据，不会写就抄下面这段，只改名字。

CREATE TABLE merchant (
  id          BIGINT       NOT NULL COMMENT '主键',
  name        VARCHAR(50)  NOT NULL COMMENT '商家名称',
  phone       VARCHAR(20)           COMMENT '联系电话',
  status      TINYINT      NOT NULL DEFAULT 1 COMMENT '状态：1=启用 0=禁用',
  create_time DATETIME              COMMENT '创建时间',
  PRIMARY KEY (id)
);

12点击放大

1. 1把建表语句粘贴到这里
2. 2表名会自动读出来，不用手填

1. 1把语句粘进「建表 SQL 语句」，表名会自动读出来，不用手填。
2. 2「描述」填中文，例如「商家」，它会显示在界面上。
3. 3点「确定」保存。想逐列手填，可以切到「字段方式」。

1点击放大

1. 1每列的说明会成为界面上的表头和标签

切到「页面」页签，点「新增页面」。这里要说清三件事：哪一类页面、用哪种样式、数据从哪张表来。

1. 1「页面名称」填中文，例如「商家管理」，它会显示在页面标题上。
2. 2「页面类型」选「后台管理页面」。
3. 3「页面模板」选「CRUD 列表」，就是一进来看到一张表格。
4. 4「数据来源」选刚建好的表；编码与路由会自动填好，对照一眼即可（如 /admin/merchant）。

123点击放大

1. 1选「后台管理页面」
2. 2选「CRUD 列表」：一进来看到一张表格
3. 3选上一步建好的那张表

保存后点这一行的「配置」，会出现四个页签——列表显示哪些列、能搜什么、能填什么、有哪些按钮，都在这里定。

1点击放大

1. 1勾选列表里要显示哪些列

菜单就是后台左边的导航栏。「目录」是可以展开的分组，例如「商家中心」；「菜单」是最后点进去的那个页面。

1点击放大

1. 1页面配好了，还要在这里挂一次

1. 1点「新增菜单」，「菜单名称」填中文，例如「商家管理」。
2. 2「类型」选「菜单」，「关联页面」选刚配好的页面。
3. 3选一个图标，填「排序」（数字越小越靠前），保存。
4. 4想让几个页面归成一组，就先建一个「目录」，再把它设成这些页面的「上级菜单」。

12点击放大

1. 1菜单名字，用户看到的就是它
2. 2选前面配好的页面，菜单才点得开

生成前先在预览里把页面点一遍。预览用的是示例数据，界面和配色跟生成出来的一致。

点击放大

1. 1在详情页点右上角「预览」，确认菜单、列表、表单都对。
2. 2回到详情页点「生成代码」，等它跑完。
3. 3在生成记录里点「下载」拿到压缩包，解压后按包里的说明启动。

1点击放大

1. 1下载最近一次生成的代码包

解压后会看到两个目录：backend 是后端，frontend-react 是前端。你只需要准备一个空的 MySQL 数据库。

第 2 步绑过数据库连接的话，直接启动即可，连接已经在里面了。没绑的话，打开 backend/src/main/resources/application.yml 改数据源。

# backend/src/main/resources/application.yml
spring:
  datasource:
    # 把 127.0.0.1:3306/your_database 换成你的地址和库名
    url: jdbc:mysql://127.0.0.1:3306/your_database?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8
    username: your_username   # 换成数据库账号
    password: your_password   # 换成数据库密码

sh mvnw -DskipTests package
java -jar backend/target/backend-0.0.1-SNAPSHOT.jar

cd frontend-react
npm install
npm run dev

1. 1准备一个空的 MySQL 库（不用建表，后端启动时会自己建好），记下地址、库名、账号、密码。
2. 2绑过连接就直接启动；没绑的话按上面第一段改 application.yml。
3. 3执行第二段启动后端，等到日志出现「数据库结构与数据已重建」。
4. 4另开一个终端执行第三段，启动前端。
5. 5浏览器打开终端里打印的地址（默认 3000，被占用会换成 3001），用 admin / 888888 登录。

1点击放大

1. 1默认账号 admin，密码 888888

点击放大

举个例子：商品表里存的是「所属商家」的编号。想在商品列表里直接看到商家名称，就把数据来源选成「联表」，把商家的字段取过来。

1. 1先在「表」页签里建好两张表，其中一张留一列存放对方的编号，例如商品的「所属商家」。
2. 2新增页面，「页面模板」选「CRUD 列表」，「数据来源类型」选「联表」。
3. 3「选择表」选主表，例如商品。
4. 4在「数据来源配置」里选要连的另一张表和两边对应的字段，并勾上想显示的字段，例如商家名称。
5. 5保存后点「配置」，在「展示字段」里给带过来的字段写个中文表头。

12点击放大

1. 1这里选「联表」
2. 2挑要连的表和字段，勾上想显示的

1点击放大

1. 1带过来的商家名称在这里写中文表头

在「权限」页签回答三件事：账号存在哪张表、哪一列表示身份、系统里有哪几种身份。之后再回「菜单」页签逐条指定谁能看到它。

12点击放大

1. 1哪一列表示身份
2. 2系统里有哪几种身份

1. 1在「权限」页签选「用户表」，再选「身份字段」「用户名字段」「密码字段」。
2. 2在「角色列表」里列出系统里的身份，例如「管理员」和「商家」。
3. 3能看到全部菜单的身份，勾上「看全部菜单」。
4. 4回「菜单」页签，逐条在「可见角色」里勾上谁能看到它，保存。

做法和前面一样，只是模板选得不一样，数据来源要选存账号的那张表（有用户名和密码的那张）。

1. 1先确认上一步的「权限」页签已经配好：账号表、身份字段、用户名与密码字段。
2. 2新增页面，「页面类型」选「前台页面」，「页面模板」选「登录页」，「数据来源」选存账号的那张表。
3. 3在「登录跳转」里按身份配规则，例如管理员进 /dashboard，商家进 /merchant。
4. 4再新增一个页面，模板选「注册页」，在「表单字段」里配用户名、密码、确认密码——注册页收哪些字段，就以这一页的配置为准。

1点击放大

1. 1按身份字段的值决定登录后进哪个页面

普通列表会把一张表的数据全部列出来。写一句查询，就能只挑符合条件的，例如「只列上架的商品，按价格从高到低」。

SELECT id, name, price, stock FROM goods WHERE status = 1 ORDER BY price DESC
-- 对应的字段列表就填：id, name, price, stock

1. 1新增页面，「页面模板」选「CRUD 列表」或「前台列表」。
2. 2「数据来源类型」选「自定义SQL」，把上面的查询粘进去。
3. 3把查询里 SELECT 后面那串列名，原样填进字段列表。
4. 4保存后点「配置」，勾选要显示的列。

1点击放大

1. 1填查询语句，并把返回的字段名填进来

图表也是页面，模板选「统计图表」。它的数据固定用一句查询，写一句按某个字段分组统计的即可。

SELECT status, COUNT(*) AS cnt FROM merchant GROUP BY status
-- 维度填 status，指标填 cnt（字段列表填：status, cnt）

1. 1新增页面，「页面模板」选「统计图表」。
2. 2把上面的查询粘进「数据来源配置」，字段列表填 status, cnt。
3. 3「图表类型」：比大小用柱状图，看趋势用折线图，看占比用饼图。
4. 4「维度」填分组字段 status，「指标」填 cnt，保存后下面会出现预览。

1点击放大

1. 1比较大小用柱状图，看趋势用折线图，看占比用饼图

看板也是一页，里面能摆好几张卡片，每张卡片显示一个数字或一张小图。

-- 数字卡：统计总数，字段填 total，取值字段填 total
SELECT COUNT(*) AS total FROM merchant

-- 图表卡：按状态分组，字段填 status, cnt，维度填 status，指标填 cnt
SELECT status, COUNT(*) AS cnt FROM merchant GROUP BY status

1. 1新增页面，「页面模板」选「数据看板」。
2. 2在「卡片」里添加一张数字卡，把上面的统计查询粘进去，取值字段填 total。
3. 3再加一张图表卡，粘分组查询，选好维度和指标。
4. 4调整卡片顺序，把最重要的放在最前面。

1点击放大

1. 1每张卡片一句统计查询

比如商品下架时把库存清零；入库加库存、出库扣库存，都是这里配的连带动作。

1. 1点「添加规则」，选「当这张表被写入」和写入时机。
2. 2写触发条件：不填就是每次写入都执行。
3. 3配动作：改哪张表的哪个字段、按什么对应上（如商品的库存）。
4. 4保存后重新生成一次代码，规则才生效。

12点击放大

1. 1每条规则一句话说清它做什么
2. 2规则都在这里加

123点击放大

1. 1先选哪张表被写入时触发
2. 2再写清什么情况下才执行
3. 3两边怎么对应上，决定改哪一条记录

12点击放大

1. 1改哪个字段，比如商品的库存
2. 2没匹配到记录时是报错还是跳过