继续完善
This commit is contained in:
xuqiuyun
@@ -1,31 +0,0 @@
|
||||
-- 插入测试的member数据
|
||||
-- 首先插入租户数据
|
||||
INSERT INTO sys_tenant (name, mobile, create_time, is_delete) VALUES
|
||||
('测试租户1', '13800000001', NOW(), 0),
|
||||
('测试租户2', '13800000002', NOW(), 0),
|
||||
('测试租户3', '13800000003', NOW(), 0);
|
||||
|
||||
-- 插入member数据
|
||||
INSERT INTO member (mobile, type, status, create_time, tenant_id) VALUES
|
||||
-- 供应商 (type=2)
|
||||
('13800001001', 2, 1, NOW(), 1),
|
||||
('13800001002', 2, 1, NOW(), 1),
|
||||
('13800001003', 2, 1, NOW(), 2),
|
||||
-- 资金方 (type=3)
|
||||
('13800002001', 3, 1, NOW(), 1),
|
||||
('13800002002', 3, 1, NOW(), 2),
|
||||
-- 采购商 (type=4)
|
||||
('13800003001', 4, 1, NOW(), 1),
|
||||
('13800003002', 4, 1, NOW(), 2),
|
||||
('13800003003', 4, 1, NOW(), 3);
|
||||
|
||||
-- 插入member_user数据（用户名信息）
|
||||
INSERT INTO member_user (member_id, username) VALUES
|
||||
(1, '供应商A'),
|
||||
(2, '供应商B'),
|
||||
(3, '供应商C'),
|
||||
(4, '资金方A'),
|
||||
(5, '资金方B'),
|
||||
(6, '采购商A'),
|
||||
(7, '采购商B'),
|
||||
(8, '采购商C');
|
||||
@@ -1,77 +0,0 @@
|
||||
-- 检查超级管理员权限的完整脚本
|
||||
-- 1. 检查超级管理员用户信息
|
||||
SELECT
|
||||
u.id,
|
||||
u.mobile,
|
||||
u.name,
|
||||
u.role_id,
|
||||
r.role_name,
|
||||
r.role_code
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
WHERE u.mobile = '15900000000';
|
||||
|
||||
-- 2. 检查 delivery:edit 权限是否存在
|
||||
SELECT
|
||||
id,
|
||||
name,
|
||||
authority,
|
||||
parent_id,
|
||||
type
|
||||
FROM sys_menu
|
||||
WHERE authority = 'delivery:edit';
|
||||
|
||||
-- 3. 检查超级管理员是否有 delivery:edit 权限
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.role_name,
|
||||
m.name as menu_name,
|
||||
m.authority,
|
||||
rm.role_id,
|
||||
rm.menu_id
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority = 'delivery:edit';
|
||||
|
||||
-- 4. 如果权限不存在，添加权限
|
||||
-- 首先确保 delivery:edit 权限点存在
|
||||
INSERT INTO sys_menu (parent_id, type, name, authority, sort, is_delete, create_time)
|
||||
SELECT
|
||||
(SELECT id FROM sys_menu WHERE route_url LIKE '%delivery%' OR route_url LIKE '%loading%' LIMIT 1),
|
||||
2,
|
||||
'运送清单编辑',
|
||||
'delivery:edit',
|
||||
3,
|
||||
0,
|
||||
NOW()
|
||||
WHERE NOT EXISTS (SELECT 1 FROM sys_menu WHERE authority = 'delivery:edit');
|
||||
|
||||
-- 5. 确保超级管理员角色有 delivery:edit 权限
|
||||
INSERT INTO sys_role_menu (role_id, menu_id)
|
||||
SELECT
|
||||
(SELECT id FROM sys_role WHERE role_name = '超级管理员' OR id = 1 LIMIT 1),
|
||||
(SELECT id FROM sys_menu WHERE authority = 'delivery:edit')
|
||||
WHERE NOT EXISTS (
|
||||
SELECT 1 FROM sys_role_menu rm
|
||||
INNER JOIN sys_role r ON rm.role_id = r.id
|
||||
INNER JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE (r.role_name = '超级管理员' OR r.id = 1) AND m.authority = 'delivery:edit'
|
||||
);
|
||||
|
||||
-- 6. 最终验证
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority = 'delivery:edit';
|
||||
36
修复编辑权限.sql
36
修复编辑权限.sql
@@ -1,36 +0,0 @@
|
||||
-- 修复装车订单编辑权限问题
|
||||
-- 1. 确保 delivery:edit 权限存在
|
||||
INSERT INTO sys_menu (parent_id, type, name, authority, sort, is_delete, create_time)
|
||||
SELECT
|
||||
(SELECT id FROM sys_menu WHERE route_url LIKE '%delivery%' OR route_url LIKE '%loading%' LIMIT 1),
|
||||
2,
|
||||
'运送清单编辑',
|
||||
'delivery:edit',
|
||||
3,
|
||||
0,
|
||||
NOW()
|
||||
WHERE NOT EXISTS (SELECT 1 FROM sys_menu WHERE authority = 'delivery:edit');
|
||||
|
||||
-- 2. 确保超级管理员角色有 delivery:edit 权限
|
||||
INSERT INTO sys_role_menu (role_id, menu_id)
|
||||
SELECT
|
||||
1, -- 超级管理员角色ID
|
||||
(SELECT id FROM sys_menu WHERE authority = 'delivery:edit')
|
||||
WHERE NOT EXISTS (
|
||||
SELECT 1 FROM sys_role_menu rm
|
||||
WHERE rm.role_id = 1 AND rm.menu_id = (SELECT id FROM sys_menu WHERE authority = 'delivery:edit')
|
||||
);
|
||||
|
||||
-- 3. 验证权限分配
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority = 'delivery:edit';
|
||||
31
修复菜单乱码.sql
31
修复菜单乱码.sql
@@ -1,31 +0,0 @@
|
||||
-- ============================================
|
||||
-- 修复权限管理菜单乱码问题
|
||||
-- 请在 Navicat/HeidiSQL/MySQL Workbench 等图形化工具中执行
|
||||
-- ============================================
|
||||
|
||||
-- 设置字符集
|
||||
SET NAMES utf8mb4;
|
||||
SET CHARACTER SET utf8mb4;
|
||||
|
||||
-- 更新菜单名称
|
||||
UPDATE `sys_menu` SET `name` = '权限管理' WHERE `id` = 28;
|
||||
UPDATE `sys_menu` SET `name` = '菜单权限管理' WHERE `id` = 29;
|
||||
UPDATE `sys_menu` SET `name` = '菜单查询' WHERE `id` = 30;
|
||||
UPDATE `sys_menu` SET `name` = '菜单新增' WHERE `id` = 31;
|
||||
UPDATE `sys_menu` SET `name` = '菜单编辑' WHERE `id` = 32;
|
||||
UPDATE `sys_menu` SET `name` = '菜单删除' WHERE `id` = 33;
|
||||
UPDATE `sys_menu` SET `name` = '角色分配' WHERE `id` = 34;
|
||||
UPDATE `sys_menu` SET `name` = '操作权限管理' WHERE `id` = 35;
|
||||
UPDATE `sys_menu` SET `name` = '权限查询' WHERE `id` = 36;
|
||||
UPDATE `sys_menu` SET `name` = '权限分配' WHERE `id` = 37;
|
||||
UPDATE `sys_menu` SET `name` = '角色管理' WHERE `id` = 38;
|
||||
|
||||
-- 验证结果
|
||||
SELECT id, parent_id, type, name, route_url, authority
|
||||
FROM sys_menu
|
||||
WHERE id >= 28
|
||||
ORDER BY parent_id, sort, id;
|
||||
|
||||
-- 显示成功信息
|
||||
SELECT '✅ 菜单名称已修复！' as status;
|
||||
|
||||
17
修复验证查询.sql
17
修复验证查询.sql
@@ -1,17 +0,0 @@
|
||||
-- 修复验证查询的字段名错误
|
||||
-- 检查 sys_role 表的字段结构
|
||||
DESCRIBE sys_role;
|
||||
|
||||
-- 正确的验证查询（使用正确的字段名）
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.name as role_name, -- 修正：使用 r.name 而不是 r.role_name
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority = 'delivery:edit';
|
||||
73
完整权限检查.sql
73
完整权限检查.sql
@@ -1,73 +0,0 @@
|
||||
-- 完整检查权限分配和修复
|
||||
-- 1. 检查超级管理员用户信息
|
||||
SELECT
|
||||
u.id,
|
||||
u.mobile,
|
||||
u.name,
|
||||
u.role_id,
|
||||
r.name as role_name
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
WHERE u.mobile = '15900000000';
|
||||
|
||||
-- 2. 检查 delivery:edit 权限是否存在
|
||||
SELECT
|
||||
id,
|
||||
name,
|
||||
authority,
|
||||
parent_id,
|
||||
type
|
||||
FROM sys_menu
|
||||
WHERE authority = 'delivery:edit';
|
||||
|
||||
-- 3. 如果不存在，创建 delivery:edit 权限
|
||||
INSERT INTO sys_menu (parent_id, type, name, authority, sort, is_delete, create_time)
|
||||
SELECT
|
||||
(SELECT id FROM sys_menu WHERE route_url LIKE '%delivery%' OR route_url LIKE '%loading%' LIMIT 1),
|
||||
2,
|
||||
'运送清单编辑',
|
||||
'delivery:edit',
|
||||
3,
|
||||
0,
|
||||
NOW()
|
||||
WHERE NOT EXISTS (SELECT 1 FROM sys_menu WHERE authority = 'delivery:edit');
|
||||
|
||||
-- 4. 确保超级管理员角色有 delivery:edit 权限
|
||||
INSERT INTO sys_role_menu (role_id, menu_id)
|
||||
SELECT
|
||||
1, -- 超级管理员角色ID
|
||||
(SELECT id FROM sys_menu WHERE authority = 'delivery:edit')
|
||||
WHERE NOT EXISTS (
|
||||
SELECT 1 FROM sys_role_menu rm
|
||||
WHERE rm.role_id = 1 AND rm.menu_id = (SELECT id FROM sys_menu WHERE authority = 'delivery:edit')
|
||||
);
|
||||
|
||||
-- 5. 检查所有 delivery 相关权限
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.name as role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority LIKE '%delivery%'
|
||||
ORDER BY m.authority;
|
||||
|
||||
-- 6. 检查是否有通配符权限
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.name as role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority = '*:*:*'
|
||||
ORDER BY m.authority;
|
||||
41
快速修复权限.sql
41
快速修复权限.sql
@@ -1,41 +0,0 @@
|
||||
-- 快速修复 delivery:edit 权限问题
|
||||
-- 1. 删除可能存在的重复权限
|
||||
DELETE FROM sys_menu WHERE authority = 'delivery:edit' AND id NOT IN (
|
||||
SELECT menu_id FROM sys_role_menu WHERE role_id = 1
|
||||
);
|
||||
|
||||
-- 2. 确保 delivery:edit 权限存在
|
||||
INSERT INTO sys_menu (parent_id, type, name, authority, sort, is_delete, create_time)
|
||||
SELECT
|
||||
(SELECT id FROM sys_menu WHERE route_url LIKE '%delivery%' OR route_url LIKE '%loading%' LIMIT 1),
|
||||
2,
|
||||
'运送清单编辑',
|
||||
'delivery:edit',
|
||||
3,
|
||||
0,
|
||||
NOW()
|
||||
WHERE NOT EXISTS (SELECT 1 FROM sys_menu WHERE authority = 'delivery:edit');
|
||||
|
||||
-- 3. 确保超级管理员有 delivery:edit 权限
|
||||
INSERT INTO sys_role_menu (role_id, menu_id)
|
||||
SELECT
|
||||
1, -- 超级管理员角色ID
|
||||
(SELECT id FROM sys_menu WHERE authority = 'delivery:edit')
|
||||
WHERE NOT EXISTS (
|
||||
SELECT 1 FROM sys_role_menu rm
|
||||
WHERE rm.role_id = 1 AND rm.menu_id = (SELECT id FROM sys_menu WHERE authority = 'delivery:edit')
|
||||
);
|
||||
|
||||
-- 4. 验证结果
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority = 'delivery:edit';
|
||||
178
快速启动指南.md
178
快速启动指南.md
@@ -1,178 +0,0 @@
|
||||
# 🚀 权限管理功能 - 快速启动指南
|
||||
|
||||
## 第一步：执行数据库脚本 📊
|
||||
|
||||
在您的MySQL数据库客户端中执行：
|
||||
|
||||
```bash
|
||||
c:/cattleTransport/权限管理功能初始化SQL.sql
|
||||
```
|
||||
|
||||
这个脚本会：
|
||||
- ✅ 创建权限管理相关菜单
|
||||
- ✅ 设置 15900000000 为超级管理员（密码：123456）
|
||||
- ✅ 配置所有必要的权限数据
|
||||
|
||||
## 第二步：启动服务 🔌
|
||||
|
||||
### 后端已经启动 ✅
|
||||
|
||||
后端服务正在后台运行：
|
||||
- 地址：`http://127.0.0.1:16200`
|
||||
|
||||
如需重启后端，执行：
|
||||
```bash
|
||||
# 停止Java进程
|
||||
taskkill /F /IM java.exe
|
||||
|
||||
# 重新启动
|
||||
cd c:\cattleTransport\tradeCattle\aiotagro-cattle-trade
|
||||
java -jar target\aiotagro-cattletrade-1.0.1.jar
|
||||
```
|
||||
|
||||
### 启动前端
|
||||
|
||||
```bash
|
||||
cd c:\cattleTransport\pc-cattle-transportation
|
||||
npm run dev
|
||||
```
|
||||
|
||||
前端地址：`http://localhost:8080`
|
||||
|
||||
## 第三步：登录测试 👤
|
||||
|
||||
### 超级管理员登录
|
||||
|
||||
- **账号**：`15900000000`
|
||||
- **密码**：`123456`
|
||||
|
||||
### 测试功能
|
||||
|
||||
登录后，在系统菜单中找到：
|
||||
|
||||
1. **权限管理** → **菜单权限管理**
|
||||
- 查看和管理所有系统菜单
|
||||
- 新增、编辑、删除菜单项
|
||||
|
||||
2. **权限管理** → **操作权限管理**
|
||||
- 管理角色
|
||||
- 为角色分配菜单和按钮权限
|
||||
|
||||
3. **运送清单** → **新增运送清单**
|
||||
- 测试新的运送清单创建功能
|
||||
- 验证权限控制是否生效
|
||||
|
||||
## 第四步：验证权限功能 ✔️
|
||||
|
||||
### 验证超级管理员权限
|
||||
|
||||
1. 使用 15900000000 登录
|
||||
2. 确认所有菜单都可见
|
||||
3. 确认所有按钮都可点击
|
||||
4. 测试新增菜单
|
||||
5. 测试为角色分配权限
|
||||
|
||||
### 创建普通角色并测试
|
||||
|
||||
1. 进入"操作权限管理"
|
||||
2. 点击"新增角色"，创建"测试角色"
|
||||
3. 为"测试角色"分配部分权限（如只分配运送清单查看权限）
|
||||
4. 在用户管理中创建测试用户，分配"测试角色"
|
||||
5. 退出超级管理员，用测试用户登录
|
||||
6. 验证：
|
||||
- ✅ 只能看到被分配的菜单
|
||||
- ✅ 只能看到被分配的按钮
|
||||
- ✅ 无权限操作被后端拦截
|
||||
- ✅ 只能看到自己创建的数据
|
||||
|
||||
## 第五步：故障排查 🔧
|
||||
|
||||
### 问题1：SQL脚本执行失败
|
||||
|
||||
**检查点**：
|
||||
- MySQL版本是否支持（建议5.7+）
|
||||
- 数据库连接是否正常
|
||||
- 是否有权限执行DDL和DML语句
|
||||
|
||||
**解决方案**：
|
||||
- 分段执行SQL脚本
|
||||
- 检查错误提示，手动修复冲突
|
||||
|
||||
### 问题2：后端启动失败
|
||||
|
||||
**检查点**：
|
||||
- 16200端口是否被占用
|
||||
- 数据库连接配置是否正确
|
||||
- Redis是否启动（如果配置了）
|
||||
|
||||
**解决方案**：
|
||||
```bash
|
||||
# 查看后端日志
|
||||
cd c:\cattleTransport\tradeCattle\aiotagro-cattle-trade
|
||||
# 查看控制台输出或日志文件
|
||||
```
|
||||
|
||||
### 问题3：前端访问不了后端API
|
||||
|
||||
**检查点**：
|
||||
- 后端是否正常启动
|
||||
- Vite proxy配置是否正确
|
||||
- 浏览器控制台是否有跨域错误
|
||||
|
||||
**解决方案**：
|
||||
- 检查 `vite.config.ts` 中的 proxy 配置
|
||||
- 确认后端地址为 `http://127.0.0.1:16200`
|
||||
- 重启前端服务
|
||||
|
||||
### 问题4：登录后看不到权限管理菜单
|
||||
|
||||
**检查点**：
|
||||
- SQL脚本是否执行成功
|
||||
- 用户角色是否正确
|
||||
- sys_role_menu 表是否有数据
|
||||
|
||||
**解决方案**：
|
||||
```sql
|
||||
-- 检查菜单数据
|
||||
SELECT * FROM sys_menu WHERE name LIKE '%权限%';
|
||||
|
||||
-- 检查用户角色
|
||||
SELECT * FROM sys_user WHERE mobile = '15900000000';
|
||||
|
||||
-- 检查超级管理员权限
|
||||
SELECT COUNT(*) FROM sys_role_menu WHERE role_id = 1;
|
||||
```
|
||||
|
||||
### 问题5：权限控制不生效
|
||||
|
||||
**检查点**：
|
||||
- 登录接口是否返回了permissions字段
|
||||
- Pinia store是否保存了权限数据
|
||||
- Controller是否添加了@SaCheckPermission注解
|
||||
|
||||
**解决方案**：
|
||||
- 清除浏览器缓存和localStorage
|
||||
- 重新登录
|
||||
- 检查浏览器控制台和Network请求
|
||||
|
||||
## 📚 完整文档
|
||||
|
||||
- **使用说明**：`c:/cattleTransport/权限管理功能使用说明.md`
|
||||
- **实施计划**：`c:/cattleTransport/权限管理和运送清单新增功能实施计划.md`
|
||||
- **SQL脚本**：`c:/cattleTransport/权限管理功能初始化SQL.sql`
|
||||
|
||||
## 🎉 功能亮点
|
||||
|
||||
1. ✅ **完整的RBAC权限控制** - 角色、菜单、按钮三级权限
|
||||
2. ✅ **超级管理员机制** - 一键拥有所有权限
|
||||
3. ✅ **数据权限隔离** - 普通用户只能看自己的数据
|
||||
4. ✅ **前后端权限联动** - 前端v-hasPermi指令 + 后端@SaCheckPermission注解
|
||||
5. ✅ **可视化权限管理** - 树形权限分配界面
|
||||
6. ✅ **新增运送清单功能** - PC端完整的创建表单
|
||||
|
||||
---
|
||||
|
||||
**祝您使用愉快！** 🎊
|
||||
|
||||
如有问题，请参考《权限管理功能使用说明.md》文档。
|
||||
|
||||
@@ -1,314 +0,0 @@
|
||||
# 🗄️ 数据库连接信息和SQL执行指南
|
||||
|
||||
## 📊 数据库配置信息
|
||||
|
||||
从后端配置文件 `application-dev.yml` 中提取的数据库信息：
|
||||
|
||||
```yaml
|
||||
数据库类型: MySQL
|
||||
主机地址: 129.211.213.226
|
||||
端口: 3306
|
||||
数据库名: cattletrade
|
||||
用户名: root
|
||||
密码: Aiotagro@741
|
||||
字符集: UTF-8
|
||||
时区: GMT+8
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 快速执行SQL脚本
|
||||
|
||||
### 方式一：使用MySQL命令行（推荐）
|
||||
|
||||
```bash
|
||||
# Windows CMD 或 PowerShell
|
||||
mysql -h 129.211.213.226 -P 3306 -u root -pAiotagro@741 cattletrade < "c:/cattleTransport/权限管理菜单-精简版.sql"
|
||||
|
||||
# 或者交互式执行
|
||||
mysql -h 129.211.213.226 -P 3306 -u root -pAiotagro@741 cattletrade
|
||||
```
|
||||
|
||||
进入MySQL后执行：
|
||||
```sql
|
||||
source c:/cattleTransport/权限管理菜单-精简版.sql
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 方式二：使用Navicat
|
||||
|
||||
1. **新建连接**：
|
||||
- 连接名：牛只运输系统
|
||||
- 主机：`129.211.213.226`
|
||||
- 端口：`3306`
|
||||
- 用户名：`root`
|
||||
- 密码：`Aiotagro@741`
|
||||
- 数据库：`cattletrade`
|
||||
|
||||
2. **测试连接** → 连接成功后，双击打开
|
||||
|
||||
3. **执行SQL**：
|
||||
- 点击"查询" → "新建查询"
|
||||
- 打开文件：`c:/cattleTransport/权限管理菜单-精简版.sql`
|
||||
- 点击"运行"按钮（或按 `F5`）
|
||||
|
||||
---
|
||||
|
||||
### 方式三：使用HeidiSQL
|
||||
|
||||
1. **新建会话**：
|
||||
- 网络类型：MySQL (TCP/IP)
|
||||
- 主机名/IP：`129.211.213.226`
|
||||
- 用户：`root`
|
||||
- 密码：`Aiotagro@741`
|
||||
- 端口：`3306`
|
||||
- 数据库：`cattletrade`
|
||||
|
||||
2. **打开**，右侧选择 `cattletrade` 数据库
|
||||
|
||||
3. **执行SQL**：
|
||||
- 点击"文件" → "加载SQL文件"
|
||||
- 选择：`c:/cattleTransport/权限管理菜单-精简版.sql`
|
||||
- 点击"执行"（或按 `F9`）
|
||||
|
||||
---
|
||||
|
||||
### 方式四：使用DBeaver
|
||||
|
||||
1. **新建连接**：
|
||||
- 数据库：MySQL
|
||||
- 服务器地址：`129.211.213.226`
|
||||
- 端口：`3306`
|
||||
- 数据库：`cattletrade`
|
||||
- 用户名：`root`
|
||||
- 密码：`Aiotagro@741`
|
||||
|
||||
2. **测试连接** → 完成
|
||||
|
||||
3. **执行SQL**：
|
||||
- 右键数据库 → "SQL编辑器" → "打开SQL脚本"
|
||||
- 选择：`c:/cattleTransport/权限管理菜单-精简版.sql`
|
||||
- 点击"执行SQL脚本"（或按 `Ctrl+Enter`）
|
||||
|
||||
---
|
||||
|
||||
## ✅ 执行后验证
|
||||
|
||||
### 1. 检查菜单是否创建成功
|
||||
|
||||
```sql
|
||||
-- 查看权限管理相关菜单
|
||||
SELECT id, parent_id, name, route_url, authority, sort
|
||||
FROM sys_menu
|
||||
WHERE name LIKE '%权限%'
|
||||
AND is_delete = 0
|
||||
ORDER BY parent_id, sort;
|
||||
```
|
||||
|
||||
**预期结果**：应该看到3条记录：
|
||||
- 权限管理（父菜单）
|
||||
- 菜单权限管理（子菜单）
|
||||
- 操作权限管理（子菜单）
|
||||
|
||||
---
|
||||
|
||||
### 2. 检查超级管理员账号
|
||||
|
||||
```sql
|
||||
-- 查看超级管理员用户
|
||||
SELECT id, mobile, name, role_id, status, user_type
|
||||
FROM sys_user
|
||||
WHERE mobile = '15900000000';
|
||||
```
|
||||
|
||||
**预期结果**：
|
||||
- `role_id` 应该为 `1`
|
||||
- `status` 应该为 `1`（启用）
|
||||
|
||||
---
|
||||
|
||||
### 3. 检查超级管理员权限
|
||||
|
||||
```sql
|
||||
-- 查看超级管理员拥有的权限数量
|
||||
SELECT COUNT(*) as '权限总数'
|
||||
FROM sys_role_menu
|
||||
WHERE role_id = 1;
|
||||
|
||||
-- 查看具体权限列表（前20条）
|
||||
SELECT
|
||||
rm.role_id,
|
||||
rm.menu_id,
|
||||
m.name as menu_name,
|
||||
m.authority,
|
||||
m.type
|
||||
FROM sys_role_menu rm
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE rm.role_id = 1
|
||||
LIMIT 20;
|
||||
```
|
||||
|
||||
**预期结果**：
|
||||
- 权限总数应该 > 10
|
||||
- 应该包含 `permission:menu:view`、`permission:operation:view` 等权限
|
||||
|
||||
---
|
||||
|
||||
### 4. 检查菜单按钮权限
|
||||
|
||||
```sql
|
||||
-- 查看菜单权限管理的按钮权限
|
||||
SELECT
|
||||
m.id,
|
||||
m.parent_id,
|
||||
m.name,
|
||||
m.authority,
|
||||
m.type
|
||||
FROM sys_menu m
|
||||
WHERE m.parent_id IN (
|
||||
SELECT id FROM sys_menu WHERE name = '菜单权限管理'
|
||||
)
|
||||
AND m.is_delete = 0;
|
||||
```
|
||||
|
||||
**预期结果**：应该看到5个按钮权限：
|
||||
- 菜单查询 (permission:menu:list)
|
||||
- 菜单新增 (permission:menu:add)
|
||||
- 菜单编辑 (permission:menu:edit)
|
||||
- 菜单删除 (permission:menu:delete)
|
||||
- 角色分配 (permission:menu:assign)
|
||||
|
||||
---
|
||||
|
||||
## 🔄 SQL执行后的操作
|
||||
|
||||
### 重要！必须重新登录
|
||||
|
||||
SQL脚本执行成功后，**必须**按以下步骤操作：
|
||||
|
||||
1. **退出当前登录**
|
||||
- 点击系统右上角用户头像
|
||||
- 选择"退出登录"
|
||||
|
||||
2. **清除浏览器缓存**
|
||||
- 按 `Ctrl + Shift + Delete`
|
||||
- 或按 `F12` 打开开发者工具
|
||||
- 在 Application → Storage → Clear site data
|
||||
|
||||
3. **重新登录**
|
||||
- 账号：`15900000000`
|
||||
- 密码：`123456`
|
||||
|
||||
4. **刷新页面**
|
||||
- 按 `F5` 或 `Ctrl + R`
|
||||
|
||||
5. **验证菜单**
|
||||
- 左侧菜单栏应该出现"权限管理"菜单
|
||||
- 点击展开，应该有两个子菜单：
|
||||
- 菜单权限管理
|
||||
- 操作权限管理
|
||||
|
||||
---
|
||||
|
||||
## 🐛 故障排查
|
||||
|
||||
### 问题1：SQL执行报错
|
||||
|
||||
**错误：Table 'sys_menu' doesn't exist**
|
||||
|
||||
**解决**：检查数据库表是否存在
|
||||
```sql
|
||||
SHOW TABLES LIKE 'sys_%';
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**错误：Duplicate entry for key 'PRIMARY'**
|
||||
|
||||
**解决**：菜单已存在，先清理旧数据
|
||||
```sql
|
||||
-- 删除旧的权限管理菜单
|
||||
DELETE FROM sys_role_menu
|
||||
WHERE menu_id IN (
|
||||
SELECT id FROM sys_menu WHERE name LIKE '%权限%'
|
||||
);
|
||||
|
||||
DELETE FROM sys_menu WHERE name LIKE '%权限%';
|
||||
|
||||
-- 然后重新执行SQL脚本
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 问题2：登录后菜单不显示
|
||||
|
||||
**可能原因1：用户角色不正确**
|
||||
|
||||
```sql
|
||||
-- 修正用户角色
|
||||
UPDATE sys_user
|
||||
SET role_id = 1
|
||||
WHERE mobile = '15900000000';
|
||||
```
|
||||
|
||||
**可能原因2：角色权限未分配**
|
||||
|
||||
```sql
|
||||
-- 重新分配所有权限给超级管理员
|
||||
DELETE FROM sys_role_menu WHERE role_id = 1;
|
||||
INSERT INTO sys_role_menu (role_id, menu_id)
|
||||
SELECT 1, id FROM sys_menu WHERE is_delete = 0;
|
||||
```
|
||||
|
||||
**可能原因3：未清除缓存**
|
||||
|
||||
- 清除浏览器缓存
|
||||
- 清除localStorage
|
||||
- 重新登录
|
||||
|
||||
---
|
||||
|
||||
### 问题3：连接数据库失败
|
||||
|
||||
**检查网络**：
|
||||
```bash
|
||||
# 测试能否ping通数据库服务器
|
||||
ping 129.211.213.226
|
||||
|
||||
# 测试端口是否开放
|
||||
telnet 129.211.213.226 3306
|
||||
```
|
||||
|
||||
**检查防火墙**：
|
||||
- 确认本地防火墙允许访问3306端口
|
||||
- 确认云服务器安全组开放了3306端口
|
||||
|
||||
---
|
||||
|
||||
## 📞 联系信息
|
||||
|
||||
- **数据库服务器**：`129.211.213.226:3306`
|
||||
- **后端API**：`http://127.0.0.1:16200/api`
|
||||
- **前端界面**：`http://localhost:8080`
|
||||
|
||||
---
|
||||
|
||||
## 📝 需要执行的SQL文件
|
||||
|
||||
1. **精简版**（推荐）：`c:/cattleTransport/权限管理菜单-精简版.sql`
|
||||
- 只创建核心菜单和权限
|
||||
- 执行速度快
|
||||
- 适合快速测试
|
||||
|
||||
2. **完整版**：`c:/cattleTransport/权限管理功能初始化SQL.sql`
|
||||
- 包含所有功能
|
||||
- 包含运送清单权限
|
||||
- 更全面的配置
|
||||
|
||||
**建议先执行精简版，测试成功后再执行完整版。**
|
||||
|
||||
---
|
||||
|
||||
**祝您顺利！** 🎉
|
||||
|
||||
132
智能项圈功能实现总结.md
Normal file
132
智能项圈功能实现总结.md
Normal file
@@ -0,0 +1,132 @@
|
||||
# 智能项圈运单分配功能实现总结
|
||||
|
||||
## 已完成的功能
|
||||
|
||||
### 1. 数据库修改 ✅
|
||||
- 创建了 `添加项圈运单字段.sql` 文件
|
||||
- 在 `xq_client` 表添加了三个字段：
|
||||
- `delivery_id` INT - 运单ID
|
||||
- `delivery_number` VARCHAR(64) - 运单号
|
||||
- `license_plate` VARCHAR(64) - 车牌号
|
||||
|
||||
### 2. 后端Java代码修改 ✅
|
||||
|
||||
#### 2.1 XqClient实体类更新
|
||||
- 文件：`tradeCattle/aiotagro-cattle-trade/src/main/java/com/aiotagro/cattletrade/business/entity/XqClient.java`
|
||||
- 添加了 `deliveryId` 字段映射
|
||||
|
||||
#### 2.2 XqClientMapper查询SQL修改
|
||||
- 文件：`tradeCattle/aiotagro-cattle-trade/src/main/java/com/aiotagro/cattletrade/business/mapper/XqClientMapper.java`
|
||||
- 修改了 `selectXqClientListWithRelations` 方法，将 `xc.sn AS deviceId` 返回，统一使用sn作为设备编号
|
||||
- 修改了 `selectUnassignedXqClientList` 方法，同样使用sn作为deviceId
|
||||
|
||||
#### 2.3 设备分配逻辑更新
|
||||
- 文件：`tradeCattle/aiotagro-cattle-trade/src/main/java/com/aiotagro/cattletrade/business/controller/DeliveryController.java`
|
||||
- 在 `updateDeviceDeliveryInfo` 方法中，为项圈设备添加了 `deliveryId` 字段的更新
|
||||
- 现在分配项圈时会同时更新：`delivery_id`、`delivery_number`、`license_plate`
|
||||
|
||||
#### 2.4 新增查看所有设备API
|
||||
- 文件：`tradeCattle/aiotagro-cattle-trade/src/main/java/com/aiotagro/cattletrade/business/controller/DeliveryDeviceController.java`
|
||||
- 新增 `/deliveryDevice/pageDeviceList` 接口
|
||||
- 同时查询耳标(type=2)和项圈(type=3)设备
|
||||
- 返回统一的设备列表，包含 `deviceType` 字段区分设备类型
|
||||
|
||||
#### 2.5 新增运单状态更新API
|
||||
- 文件：`tradeCattle/aiotagro-cattle-trade/src/main/java/com/aiotagro/cattletrade/business/controller/DeliveryController.java`
|
||||
- 新增 `/delivery/updateStatus` 接口
|
||||
- 支持更新运单的核验状态(1-待核验 2-已核验 3-已完成)
|
||||
|
||||
### 3. 前端代码修改 ✅
|
||||
|
||||
#### 3.1 分配设备对话框优化
|
||||
- 文件：`pc-cattle-transportation/src/views/shipping/assignDialog.vue`
|
||||
- 修改项圈设备编号映射，优先使用 `sn` 字段：`deviceId: item.sn || item.deviceId`
|
||||
- 确保项圈设备状态判断基于 `delivery_number` 字段
|
||||
|
||||
#### 3.2 查看设备对话框增强
|
||||
- 文件：`pc-cattle-transportation/src/views/shipping/lookDialog.vue`
|
||||
- 改用新的 `deviceAllList` API，同时显示耳标和项圈设备
|
||||
- 更新设备编号显示逻辑：`scope.row.deviceId || scope.row.sn`
|
||||
- 更新佩戴状态判断：支持 `isWare` 和 `is_wear` 两种字段
|
||||
|
||||
#### 3.3 新增API接口定义
|
||||
- 文件：`pc-cattle-transportation/src/api/shipping.js`
|
||||
- 新增 `deviceAllList` 函数：查看运单所有设备
|
||||
- 新增 `updateDeliveryStatus` 函数：更新运单状态
|
||||
|
||||
#### 3.4 运送清单列表功能增强
|
||||
- 文件：`pc-cattle-transportation/src/views/shipping/loadingOrder.vue`
|
||||
- 添加"编辑状态"按钮到操作列
|
||||
- 实现 `editStatus` 方法，弹出输入框修改运单状态
|
||||
- 操作列宽度调整为420px以容纳新按钮
|
||||
|
||||
## 功能特性
|
||||
|
||||
### 核心功能
|
||||
1. **智能项圈分配到运单**
|
||||
- 项圈设备可以通过"分配设备"功能分配到运单
|
||||
- 分配时自动更新项圈的运单ID、运单号和车牌号
|
||||
|
||||
2. **设备编号统一**
|
||||
- 项圈设备统一使用 `sn` 字段作为设备编号
|
||||
- 前后端保持一致，确保数据正确映射
|
||||
|
||||
3. **设备状态判断**
|
||||
- 基于 `delivery_number` 字段判断设备是否已分配
|
||||
- 未分配显示"未分配"，已分配显示实际运单号
|
||||
|
||||
4. **查看设备功能**
|
||||
- 支持同时查看运单下的耳标和项圈设备
|
||||
- 自动区分设备类型并显示相应标签
|
||||
|
||||
5. **运单状态管理**
|
||||
- 新增"编辑状态"按钮，可直接修改运单核验状态
|
||||
- 支持三种状态：1-待核验、2-已核验、3-已完成
|
||||
|
||||
### 数据同步
|
||||
- 分配设备时，`xq_client` 表的以下字段会自动更新：
|
||||
- `delivery_id`：运单ID
|
||||
- `delivery_number`：运单号
|
||||
- `license_plate`：车牌号（从运单的 `license_plate` 字段获取）
|
||||
|
||||
## 使用说明
|
||||
|
||||
### 1. 执行数据库脚本
|
||||
```bash
|
||||
# 在MySQL中执行
|
||||
source 添加项圈运单字段.sql
|
||||
```
|
||||
|
||||
### 2. 分配项圈到运单
|
||||
1. 进入"运送清单"页面
|
||||
2. 点击某个运单的"分配设备"按钮
|
||||
3. 在设备类型下拉框选择"智能项圈"或"全部设备"
|
||||
4. 勾选要分配的项圈设备
|
||||
5. 点击"保存"完成分配
|
||||
|
||||
### 3. 查看运单设备
|
||||
1. 在"运送清单"页面点击"查看设备"按钮
|
||||
2. 弹窗中会显示该运单的所有设备（耳标+项圈）
|
||||
3. 设备类型列会显示"智能耳标"或"智能项圈"
|
||||
|
||||
### 4. 修改运单状态
|
||||
1. 在"运送清单"页面点击"编辑状态"按钮
|
||||
2. 在弹出的输入框中输入状态值（1/2/3）
|
||||
3. 点击确定完成状态更新
|
||||
|
||||
## 技术要点
|
||||
|
||||
1. **后端SQL优化**：使用 `ROW_NUMBER()` 窗口函数获取设备的最新运单关联
|
||||
2. **前端兼容性**：支持多种字段名映射（deviceId/sn, isWare/is_wear）
|
||||
3. **权限控制**：所有API都添加了 `@SaCheckPermission` 权限验证
|
||||
4. **错误处理**：完善的异常捕获和用户提示
|
||||
|
||||
## 测试建议
|
||||
|
||||
- [ ] 测试项圈设备分配功能
|
||||
- [ ] 验证分配后 `xq_client` 表字段是否正确更新
|
||||
- [ ] 测试查看设备功能是否同时显示耳标和项圈
|
||||
- [ ] 验证设备状态判断逻辑（未分配/已分配）
|
||||
- [ ] 测试运单状态编辑功能
|
||||
- [ ] 验证项圈设备编号显示是否使用sn字段
|
||||
|
||||
568
权限管理功能使用说明.md
568
权限管理功能使用说明.md
@@ -1,568 +0,0 @@
|
||||
# 权限管理功能使用说明
|
||||
|
||||
## 📋 功能概述
|
||||
|
||||
本次开发完成了完整的权限管理系统，包括：
|
||||
|
||||
1. **菜单权限管理** - 管理系统菜单树和菜单项
|
||||
2. **操作权限管理** - 为不同角色分配菜单和按钮操作权限
|
||||
3. **超级管理员** - 15900000000 账号拥有所有权限
|
||||
|
||||
---
|
||||
|
||||
## 🗂️ 部署步骤
|
||||
|
||||
### 第一步：执行数据库初始化脚本
|
||||
|
||||
在数据库中执行 `权限管理功能初始化SQL.sql` 文件，该脚本会：
|
||||
|
||||
- ✅ 创建"权限管理"父菜单
|
||||
- ✅ 创建"菜单权限管理"子菜单
|
||||
- ✅ 创建"操作权限管理"子菜单
|
||||
- ✅ 为这些菜单添加对应的按钮权限
|
||||
- ✅ 创建或更新超级管理员角色（ID=1）
|
||||
- ✅ 设置 15900000000 为超级管理员账号
|
||||
- ✅ 为超级管理员分配所有菜单权限
|
||||
- ✅ 为运送清单功能添加完整的权限点
|
||||
|
||||
**执行方式**：
|
||||
```sql
|
||||
-- 在MySQL客户端或管理工具中执行
|
||||
source /path/to/权限管理功能初始化SQL.sql;
|
||||
-- 或直接复制粘贴SQL内容执行
|
||||
```
|
||||
|
||||
### 第二步：重新编译并启动后端
|
||||
|
||||
```bash
|
||||
# 进入后端项目根目录
|
||||
cd c:\cattleTransport\tradeCattle
|
||||
|
||||
# 清理并编译安装所有模块
|
||||
mvn clean install -DskipTests
|
||||
|
||||
# 进入业务模块
|
||||
cd aiotagro-cattle-trade
|
||||
|
||||
# 启动后端服务
|
||||
mvn spring-boot:run
|
||||
|
||||
# 或使用jar包启动
|
||||
java -jar target/aiotagro-cattletrade-1.0.1.jar
|
||||
```
|
||||
|
||||
**后端服务地址**：`http://127.0.0.1:16200`
|
||||
|
||||
### 第三步：启动前端
|
||||
|
||||
```bash
|
||||
# 进入前端项目目录
|
||||
cd c:\cattleTransport\pc-cattle-transportation
|
||||
|
||||
# 安装依赖（首次或有新依赖时）
|
||||
npm install
|
||||
|
||||
# 启动开发服务器
|
||||
npm run dev
|
||||
```
|
||||
|
||||
**前端访问地址**：`http://localhost:8080`
|
||||
|
||||
---
|
||||
|
||||
## 👤 超级管理员账号
|
||||
|
||||
### 登录信息
|
||||
|
||||
- **账号**：`15900000000`
|
||||
- **密码**：`123456` （如果是SQL脚本新创建的账号）
|
||||
- **角色**：超级管理员（roleId=1）
|
||||
- **权限**：拥有系统所有权限（*:*:*）
|
||||
|
||||
### 特权说明
|
||||
|
||||
超级管理员具有以下特权：
|
||||
|
||||
1. ✅ **绕过所有权限检查** - 自动拥有所有操作权限
|
||||
2. ✅ **查看所有数据** - 不受数据权限限制，可以看到所有用户创建的数据
|
||||
3. ✅ **管理权限** - 可以为其他角色分配权限
|
||||
4. ✅ **管理菜单** - 可以增删改菜单和按钮权限
|
||||
|
||||
---
|
||||
|
||||
## 🎯 功能使用指南
|
||||
|
||||
### 1. 菜单权限管理
|
||||
|
||||
**访问路径**：系统主菜单 → 权限管理 → 菜单权限管理
|
||||
|
||||
**功能列表**：
|
||||
|
||||
- ✅ **查看菜单树** - 以树形结构展示所有系统菜单
|
||||
- ✅ **新增菜单** - 添加新的菜单或按钮权限
|
||||
- ✅ **编辑菜单** - 修改菜单信息
|
||||
- ✅ **删除菜单** - 软删除菜单（is_delete=1）
|
||||
|
||||
**字段说明**：
|
||||
|
||||
| 字段 | 说明 | 示例 |
|
||||
|------|------|------|
|
||||
| 菜单名称 | 显示在系统中的菜单名称 | 权限管理 |
|
||||
| 菜单类型 | 1=菜单（页面），2=按钮（操作） | 1 |
|
||||
| 路由地址 | 前端路由路径 | /permission/menu |
|
||||
| 组件路径 | Vue组件路径 | permission/menuPermission |
|
||||
| 权限标识 | 后端权限检查标识 | permission:menu:view |
|
||||
| 图标 | Element Plus图标名称 | el-icon-lock |
|
||||
| 排序 | 菜单显示顺序 | 1 |
|
||||
|
||||
**操作步骤**：
|
||||
|
||||
1. 点击"新增菜单"按钮
|
||||
2. 选择上级菜单（可选，默认为顶级菜单）
|
||||
3. 选择菜单类型（菜单/按钮）
|
||||
4. 填写必填信息：菜单名称、权限标识
|
||||
5. 如果是菜单类型，还需填写路由地址和组件路径
|
||||
6. 设置排序号
|
||||
7. 点击"确定"保存
|
||||
|
||||
---
|
||||
|
||||
### 2. 操作权限管理
|
||||
|
||||
**访问路径**：系统主菜单 → 权限管理 → 操作权限管理
|
||||
|
||||
**功能列表**：
|
||||
|
||||
- ✅ **角色管理** - 新增、编辑、删除角色
|
||||
- ✅ **权限分配** - 为角色分配菜单和按钮权限
|
||||
- ✅ **查看权限** - 查看角色当前拥有的权限
|
||||
|
||||
**左侧：角色列表**
|
||||
- 显示所有系统角色
|
||||
- 点击角色行可查看和编辑该角色的权限
|
||||
- 可以新增、编辑、删除角色（超级管理员角色不可删除）
|
||||
|
||||
**右侧：权限树**
|
||||
- 以树形结构显示所有菜单和按钮权限
|
||||
- 勾选表示该角色拥有该权限
|
||||
- 支持级联选择（选中父菜单会自动选中子项）
|
||||
|
||||
**操作步骤**：
|
||||
|
||||
#### 新增角色
|
||||
1. 点击左侧"新增角色"按钮
|
||||
2. 输入角色名称和描述
|
||||
3. 点击"确定"保存
|
||||
|
||||
#### 为角色分配权限
|
||||
1. 在左侧角色列表中点击选中某个角色
|
||||
2. 右侧会显示权限树
|
||||
3. 勾选该角色需要的菜单和按钮权限
|
||||
4. 点击右上角"保存权限"按钮
|
||||
|
||||
---
|
||||
|
||||
## 🔐 权限标识规范
|
||||
|
||||
系统采用统一的权限标识命名规范：`模块:资源:操作`
|
||||
|
||||
### 示例
|
||||
|
||||
| 权限标识 | 说明 | 对应功能 |
|
||||
|---------|------|---------|
|
||||
| `permission:menu:view` | 权限-菜单-查看 | 查看菜单权限管理页面 |
|
||||
| `permission:menu:list` | 权限-菜单-列表 | 查询菜单列表 |
|
||||
| `permission:menu:add` | 权限-菜单-新增 | 新增菜单 |
|
||||
| `permission:menu:edit` | 权限-菜单-编辑 | 编辑菜单 |
|
||||
| `permission:menu:delete` | 权限-菜单-删除 | 删除菜单 |
|
||||
| `permission:menu:assign` | 权限-菜单-分配 | 分配菜单权限给角色 |
|
||||
| `permission:operation:view` | 权限-操作-查看 | 查看操作权限管理页面 |
|
||||
| `permission:operation:list` | 权限-操作-列表 | 查询角色和权限列表 |
|
||||
| `permission:operation:assign` | 权限-操作-分配 | 分配操作权限 |
|
||||
| `permission:operation:role` | 权限-操作-角色 | 管理角色（增删改） |
|
||||
| `delivery:list` | 运送-清单-列表 | 查看运送清单列表 |
|
||||
| `delivery:add` | 运送-清单-新增 | 新增运送清单 |
|
||||
| `delivery:edit` | 运送-清单-编辑 | 编辑运送清单 |
|
||||
| `delivery:delete` | 运送-清单-删除 | 删除运送清单 |
|
||||
| `delivery:view` | 运送-清单-查看 | 查看运送清单详情 |
|
||||
| `delivery:check` | 运送-清单-核验 | 核验运送清单 |
|
||||
| `delivery:assign` | 运送-清单-分配 | 分配设备 |
|
||||
| `delivery:load` | 运送-清单-装车 | 装车操作 |
|
||||
| `*:*:*` | 所有权限 | 超级管理员特有 |
|
||||
|
||||
---
|
||||
|
||||
## 🔧 前端权限控制
|
||||
|
||||
### 按钮级权限指令
|
||||
|
||||
在前端使用 `v-hasPermi` 指令控制按钮的显示/隐藏：
|
||||
|
||||
```vue
|
||||
<!-- 单个权限 -->
|
||||
<el-button v-hasPermi="['delivery:add']" @click="handleAdd">
|
||||
新增
|
||||
</el-button>
|
||||
|
||||
<!-- 多个权限（满足其一即可） -->
|
||||
<el-button v-hasPermi="['delivery:edit', 'delivery:view']" @click="handleEdit">
|
||||
编辑
|
||||
</el-button>
|
||||
```
|
||||
|
||||
### 角色级权限指令
|
||||
|
||||
使用 `v-hasRole` 指令控制基于角色的显示：
|
||||
|
||||
```vue
|
||||
<el-button v-hasRole="['admin']" @click="handleAdmin">
|
||||
管理员功能
|
||||
</el-button>
|
||||
```
|
||||
|
||||
### 编程式权限判断
|
||||
|
||||
```javascript
|
||||
import { useUserStore } from '@/store/user';
|
||||
|
||||
const userStore = useUserStore();
|
||||
|
||||
// 判断是否有某个权限
|
||||
if (userStore.hasPermission('delivery:add')) {
|
||||
// 有权限，执行操作
|
||||
}
|
||||
|
||||
// 判断是否有某个角色
|
||||
if (userStore.hasRole('admin')) {
|
||||
// 有角色，执行操作
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🛡️ 后端权限控制
|
||||
|
||||
### 接口级权限注解
|
||||
|
||||
在Controller方法上使用 `@SaCheckPermission` 注解：
|
||||
|
||||
```java
|
||||
@RestController
|
||||
@RequestMapping("/delivery")
|
||||
public class DeliveryController {
|
||||
|
||||
// 单个权限
|
||||
@SaCheckPermission("delivery:list")
|
||||
@PostMapping("/pageQuery")
|
||||
public PageResultResponse<Delivery> pageQuery(@RequestBody DeliveryQueryDto dto) {
|
||||
// ...
|
||||
}
|
||||
|
||||
// 多个权限（满足其一即可）
|
||||
@SaCheckPermission(value = {"delivery:add", "delivery:create"}, mode = SaMode.OR)
|
||||
@PostMapping("/create")
|
||||
public AjaxResult create(@RequestBody DeliveryCreateDto dto) {
|
||||
// ...
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 数据权限控制
|
||||
|
||||
使用 `DataScopeUtil` 工具类进行数据权限过滤：
|
||||
|
||||
```java
|
||||
// 普通用户只能看自己创建的数据，超级管理员可以看所有数据
|
||||
LambdaQueryWrapper<Delivery> wrapper = new LambdaQueryWrapper<>();
|
||||
DataScopeUtil.applyDataScope(wrapper, Delivery::getCreatedBy);
|
||||
List<Delivery> list = this.list(wrapper);
|
||||
|
||||
// 用户可以看到自己创建或自己核验的数据
|
||||
LambdaQueryWrapper<Delivery> wrapper = new LambdaQueryWrapper<>();
|
||||
DataScopeUtil.applyDataScopeWithChecker(wrapper, Delivery::getCreatedBy, Delivery::getCheckBy);
|
||||
List<Delivery> list = this.list(wrapper);
|
||||
```
|
||||
|
||||
### 编程式权限判断
|
||||
|
||||
```java
|
||||
import com.aiotagro.common.core.utils.SecurityUtil;
|
||||
|
||||
// 判断是否超级管理员
|
||||
if (SecurityUtil.isSuperAdmin()) {
|
||||
// 是超级管理员，执行特殊逻辑
|
||||
}
|
||||
|
||||
// 判断是否有某个权限
|
||||
if (SecurityUtil.hasPermission("delivery:add")) {
|
||||
// 有权限，执行操作
|
||||
}
|
||||
|
||||
// 获取当前用户ID
|
||||
Integer userId = SecurityUtil.getCurrentUserId();
|
||||
|
||||
// 获取当前用户角色ID
|
||||
Integer roleId = SecurityUtil.getRoleId();
|
||||
|
||||
// 获取当前用户权限列表
|
||||
List<String> permissions = SecurityUtil.getPermissions();
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 数据库表结构
|
||||
|
||||
### sys_menu（菜单表）
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| id | int | 主键 |
|
||||
| parent_id | int | 父菜单ID（0=顶级菜单） |
|
||||
| type | tinyint | 类型（1=菜单，2=按钮） |
|
||||
| name | varchar | 菜单名称 |
|
||||
| route_url | varchar | 路由地址 |
|
||||
| page_url | varchar | 组件路径 |
|
||||
| authority | varchar | 权限标识 |
|
||||
| icon | varchar | 图标 |
|
||||
| sort | int | 排序 |
|
||||
| is_delete | tinyint | 是否删除（0=否，1=是） |
|
||||
| create_time | datetime | 创建时间 |
|
||||
| update_time | datetime | 更新时间 |
|
||||
|
||||
### sys_role（角色表）
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| id | int | 主键 |
|
||||
| name | varchar | 角色名称 |
|
||||
| description | varchar | 角色描述 |
|
||||
| is_delete | tinyint | 是否删除（0=否，1=是） |
|
||||
| create_time | datetime | 创建时间 |
|
||||
| update_time | datetime | 更新时间 |
|
||||
|
||||
### sys_role_menu（角色菜单关联表）
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| id | int | 主键 |
|
||||
| role_id | int | 角色ID |
|
||||
| menu_id | int | 菜单ID |
|
||||
|
||||
### sys_user（用户表）
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| id | int | 主键 |
|
||||
| mobile | varchar | 手机号 |
|
||||
| name | varchar | 用户名 |
|
||||
| password | varchar | 密码（MD5加密） |
|
||||
| role_id | int | 角色ID |
|
||||
| user_type | int | 用户类型 |
|
||||
| status | tinyint | 状态（1=启用） |
|
||||
| is_delete | tinyint | 是否删除 |
|
||||
| create_time | datetime | 创建时间 |
|
||||
|
||||
---
|
||||
|
||||
## 🧪 测试指南
|
||||
|
||||
### 1. 超级管理员测试
|
||||
|
||||
**登录账号**：15900000000 / 123456
|
||||
|
||||
**验证点**：
|
||||
- ✅ 登录成功后，所有菜单都可见
|
||||
- ✅ 所有按钮都可见（不受v-hasPermi限制）
|
||||
- ✅ 可以查看所有用户创建的数据
|
||||
- ✅ 可以进入权限管理模块
|
||||
- ✅ 可以新增、编辑、删除菜单
|
||||
- ✅ 可以新增、编辑、删除角色
|
||||
- ✅ 可以为角色分配权限
|
||||
|
||||
### 2. 普通角色测试
|
||||
|
||||
**步骤**：
|
||||
1. 使用超级管理员登录
|
||||
2. 进入"操作权限管理"
|
||||
3. 新增一个测试角色（如"运输管理员"）
|
||||
4. 为该角色分配部分权限（如只分配运送清单相关权限）
|
||||
5. 在用户管理中创建或修改一个测试用户，指定其角色为"运输管理员"
|
||||
6. 退出超级管理员，使用测试用户登录
|
||||
|
||||
**验证点**：
|
||||
- ✅ 登录后只能看到被分配的菜单
|
||||
- ✅ 只能看到被分配的按钮（其他按钮被v-hasPermi隐藏）
|
||||
- ✅ 只能看到自己创建的数据（数据权限）
|
||||
- ✅ 无权限的操作会被后端拦截（返回403）
|
||||
|
||||
### 3. 权限管理功能测试
|
||||
|
||||
#### 菜单权限管理
|
||||
1. 进入"菜单权限管理"页面
|
||||
2. 测试新增一个测试菜单
|
||||
3. 测试编辑菜单信息
|
||||
4. 测试删除菜单（软删除）
|
||||
5. 验证菜单树的显示是否正确
|
||||
|
||||
#### 操作权限管理
|
||||
1. 进入"操作权限管理"页面
|
||||
2. 左侧新增一个测试角色
|
||||
3. 点击该角色，右侧显示权限树
|
||||
4. 勾选部分菜单和按钮权限
|
||||
5. 点击"保存权限"
|
||||
6. 刷新页面，验证权限是否保存成功
|
||||
7. 测试编辑和删除角色
|
||||
|
||||
---
|
||||
|
||||
## ❗ 常见问题
|
||||
|
||||
### Q1: 执行SQL脚本后，菜单没有出现？
|
||||
|
||||
**解决方案**：
|
||||
1. 检查SQL脚本是否执行成功，查看数据库是否有数据
|
||||
2. 检查用户的角色是否被分配了相应菜单权限
|
||||
3. 退出重新登录，刷新权限缓存
|
||||
|
||||
### Q2: 按钮被v-hasPermi隐藏了，但我应该有权限？
|
||||
|
||||
**解决方案**：
|
||||
1. 检查登录接口返回的permissions字段是否包含该权限
|
||||
2. 检查Pinia store中是否正确保存了permissions
|
||||
3. 退出重新登录，刷新权限
|
||||
4. 如果是超级管理员，检查permissions是否包含"*:*:*"
|
||||
|
||||
### Q3: 后端接口返回403，提示无权限？
|
||||
|
||||
**解决方案**：
|
||||
1. 检查Controller方法上的@SaCheckPermission注解
|
||||
2. 检查用户的角色是否被分配了该权限
|
||||
3. 检查Sa-Token配置是否正确
|
||||
4. 查看后端日志，确认权限检查的详细信息
|
||||
|
||||
### Q4: 超级管理员看不到其他用户的数据？
|
||||
|
||||
**解决方案**：
|
||||
1. 检查Service层是否正确使用了DataScopeUtil
|
||||
2. 检查SecurityUtil.isSuperAdmin()方法是否正确判断
|
||||
3. 检查用户的roleId是否为1
|
||||
|
||||
### Q5: 菜单树显示不正常，层级错乱？
|
||||
|
||||
**解决方案**：
|
||||
1. 检查sys_menu表的parent_id字段是否正确
|
||||
2. 检查sort字段，调整排序
|
||||
3. 检查is_delete字段，确认菜单未被软删除
|
||||
|
||||
---
|
||||
|
||||
## 📝 开发文档
|
||||
|
||||
### 新增模块权限的步骤
|
||||
|
||||
如果要为一个新功能模块添加权限控制：
|
||||
|
||||
#### 1. 数据库添加菜单和权限
|
||||
|
||||
```sql
|
||||
-- 添加父菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (0, 1, '新模块', '/newmodule', null, 'newmodule:view', 'el-icon-setting', 30, 0, NOW());
|
||||
|
||||
SET @parent_id = LAST_INSERT_ID();
|
||||
|
||||
-- 添加子菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (@parent_id, 1, '功能页面', '/newmodule/function', 'newmodule/function', 'newmodule:function:view', null, 1, 0, NOW());
|
||||
|
||||
SET @function_id = LAST_INSERT_ID();
|
||||
|
||||
-- 添加按钮权限
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`) VALUES
|
||||
(@function_id, 2, '新增', 'newmodule:function:add', 1, 0, NOW()),
|
||||
(@function_id, 2, '编辑', 'newmodule:function:edit', 2, 0, NOW()),
|
||||
(@function_id, 2, '删除', 'newmodule:function:delete', 3, 0, NOW());
|
||||
|
||||
-- 为超级管理员分配新权限
|
||||
INSERT INTO `sys_role_menu` (`role_id`, `menu_id`)
|
||||
SELECT 1, id FROM `sys_menu` WHERE `authority` LIKE 'newmodule:%' AND `is_delete` = 0;
|
||||
```
|
||||
|
||||
#### 2. 后端Controller添加权限注解
|
||||
|
||||
```java
|
||||
@RestController
|
||||
@RequestMapping("/newmodule")
|
||||
public class NewModuleController {
|
||||
|
||||
@SaCheckPermission("newmodule:function:list")
|
||||
@PostMapping("/list")
|
||||
public AjaxResult list(@RequestBody QueryDto dto) {
|
||||
// ...
|
||||
}
|
||||
|
||||
@SaCheckPermission("newmodule:function:add")
|
||||
@PostMapping("/add")
|
||||
public AjaxResult add(@RequestBody AddDto dto) {
|
||||
// ...
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 3. 前端按钮添加权限指令
|
||||
|
||||
```vue
|
||||
<el-button v-hasPermi="['newmodule:function:add']" @click="handleAdd">
|
||||
新增
|
||||
</el-button>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎉 功能清单
|
||||
|
||||
本次开发完成的文件清单：
|
||||
|
||||
### 后端文件
|
||||
- ✅ `RoleConstants.java` - 角色常量类
|
||||
- ✅ `SecurityUtil.java` - 安全工具类（扩展）
|
||||
- ✅ `DataScopeUtil.java` - 数据权限工具类
|
||||
- ✅ `SysMenuController.java` - 菜单权限管理Controller
|
||||
- ✅ `SysRoleController.java` - 角色管理Controller（扩展）
|
||||
- ✅ `LoginServiceImpl.java` - 登录Service（扩展，存储权限信息）
|
||||
- ✅ `DeliveryController.java` - 运送清单Controller（添加权限注解）
|
||||
- ✅ `DeliveryServiceImpl.java` - 运送清单Service（添加数据权限）
|
||||
- ✅ `DeliveryCreateDto.java` - 运送清单创建DTO
|
||||
|
||||
### 前端文件
|
||||
- ✅ `permission.js` - 权限管理API接口
|
||||
- ✅ `menuPermission.vue` - 菜单权限管理页面
|
||||
- ✅ `operationPermission.vue` - 操作权限管理页面
|
||||
- ✅ `createDeliveryDialog.vue` - 新增运送清单对话框
|
||||
- ✅ `user.ts` - 用户Store（扩展，添加权限判断）
|
||||
- ✅ `login.vue` - 登录页（扩展，保存权限）
|
||||
- ✅ `loadingOrder.vue` - 运送清单列表（添加权限控制）
|
||||
- ✅ `shipping.js` - 运送清单API（扩展）
|
||||
|
||||
### 数据库文件
|
||||
- ✅ `权限管理功能初始化SQL.sql` - 数据库初始化脚本
|
||||
|
||||
### 文档文件
|
||||
- ✅ `权限管理和运送清单新增功能实施计划.md` - 实施计划文档
|
||||
- ✅ `权限管理功能使用说明.md` - 本使用说明文档
|
||||
|
||||
---
|
||||
|
||||
## 📞 技术支持
|
||||
|
||||
如有问题，请检查：
|
||||
|
||||
1. 后端日志：查看权限验证相关错误
|
||||
2. 浏览器控制台：查看前端请求和权限判断
|
||||
3. 数据库数据：确认菜单、角色、权限数据是否正确
|
||||
4. Sa-Token文档：https://sa-token.cc/
|
||||
|
||||
---
|
||||
|
||||
**祝使用愉快！** 🎊
|
||||
|
||||
152
权限管理功能初始化SQL.sql
152
权限管理功能初始化SQL.sql
@@ -1,152 +0,0 @@
|
||||
-- ============================================
|
||||
-- 权限管理功能初始化 SQL
|
||||
-- 功能：添加权限管理菜单、设置超级管理员
|
||||
-- 日期：2025-10-11
|
||||
-- ============================================
|
||||
|
||||
-- ============================================
|
||||
-- 1. 添加权限管理父菜单
|
||||
-- ============================================
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (0, 1, '权限管理', '/permission', null, 'permission:view', 'el-icon-lock', 20, 0, NOW());
|
||||
|
||||
-- 获取刚插入的权限管理父菜单ID（假设为 @permission_parent_id）
|
||||
SET @permission_parent_id = LAST_INSERT_ID();
|
||||
|
||||
-- ============================================
|
||||
-- 2. 添加子菜单：菜单权限管理
|
||||
-- ============================================
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (@permission_parent_id, 1, '菜单权限管理', '/permission/menu', 'permission/menuPermission', 'permission:menu:view', 'el-icon-menu', 1, 0, NOW());
|
||||
|
||||
SET @menu_permission_id = LAST_INSERT_ID();
|
||||
|
||||
-- 菜单权限管理的按钮权限
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`) VALUES
|
||||
(@menu_permission_id, 2, '菜单查询', 'permission:menu:list', 1, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单新增', 'permission:menu:add', 2, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单编辑', 'permission:menu:edit', 3, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单删除', 'permission:menu:delete', 4, 0, NOW()),
|
||||
(@menu_permission_id, 2, '角色分配', 'permission:menu:assign', 5, 0, NOW());
|
||||
|
||||
-- ============================================
|
||||
-- 3. 添加子菜单：操作权限管理
|
||||
-- ============================================
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (@permission_parent_id, 1, '操作权限管理', '/permission/operation', 'permission/operationPermission', 'permission:operation:view', 'el-icon-setting', 2, 0, NOW());
|
||||
|
||||
SET @operation_permission_id = LAST_INSERT_ID();
|
||||
|
||||
-- 操作权限管理的按钮权限
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`) VALUES
|
||||
(@operation_permission_id, 2, '权限查询', 'permission:operation:list', 1, 0, NOW()),
|
||||
(@operation_permission_id, 2, '权限分配', 'permission:operation:assign', 2, 0, NOW()),
|
||||
(@operation_permission_id, 2, '角色管理', 'permission:operation:role', 3, 0, NOW());
|
||||
|
||||
-- ============================================
|
||||
-- 4. 查找或创建超级管理员角色
|
||||
-- ============================================
|
||||
-- 查看是否已有ID=1的角色，如果没有则插入
|
||||
INSERT INTO `sys_role` (`id`, `name`, `description`, `is_delete`, `create_time`)
|
||||
SELECT 1, '超级管理员', '拥有系统所有权限', 0, NOW()
|
||||
WHERE NOT EXISTS (SELECT 1 FROM `sys_role` WHERE `id` = 1);
|
||||
|
||||
-- ============================================
|
||||
-- 5. 为超级管理员角色分配所有菜单权限
|
||||
-- ============================================
|
||||
-- 清空超级管理员的旧权限（可选）
|
||||
DELETE FROM `sys_role_menu` WHERE `role_id` = 1;
|
||||
|
||||
-- 分配所有菜单权限给超级管理员
|
||||
INSERT INTO `sys_role_menu` (`role_id`, `menu_id`)
|
||||
SELECT 1, id FROM `sys_menu` WHERE `is_delete` = 0;
|
||||
|
||||
-- ============================================
|
||||
-- 6. 设置15900000000账号为超级管理员
|
||||
-- ============================================
|
||||
-- 查找该手机号的用户
|
||||
UPDATE `sys_user`
|
||||
SET `role_id` = 1
|
||||
WHERE `mobile` = '15900000000' AND `is_delete` = 0;
|
||||
|
||||
-- 如果用户不存在，创建超级管理员账号（密码默认为 123456，已MD5加密）
|
||||
-- 注意：请根据实际的密码加密方式调整密码值
|
||||
INSERT INTO `sys_user` (`mobile`, `name`, `password`, `role_id`, `status`, `user_type`, `is_delete`, `create_time`)
|
||||
SELECT
|
||||
'15900000000',
|
||||
'超级管理员',
|
||||
'e10adc3949ba59abbe56e057f20f883e', -- 123456 的MD5值
|
||||
1,
|
||||
1,
|
||||
1,
|
||||
0,
|
||||
NOW()
|
||||
WHERE NOT EXISTS (
|
||||
SELECT 1 FROM `sys_user` WHERE `mobile` = '15900000000'
|
||||
);
|
||||
|
||||
-- ============================================
|
||||
-- 7. 为运送清单添加完整的权限点（如果还没有）
|
||||
-- ============================================
|
||||
-- 查找运送清单菜单
|
||||
SET @delivery_menu_id = (SELECT id FROM `sys_menu` WHERE `route_url` LIKE '%delivery%' OR `route_url` LIKE '%loading%' LIMIT 1);
|
||||
|
||||
-- 如果找到了运送清单菜单，添加权限点
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`)
|
||||
SELECT @delivery_menu_id, 2, '运送清单查看', 'delivery:list', 1, 0, NOW()
|
||||
WHERE @delivery_menu_id IS NOT NULL
|
||||
AND NOT EXISTS (SELECT 1 FROM `sys_menu` WHERE `authority` = 'delivery:list');
|
||||
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`)
|
||||
SELECT @delivery_menu_id, 2, '运送清单新增', 'delivery:add', 2, 0, NOW()
|
||||
WHERE @delivery_menu_id IS NOT NULL
|
||||
AND NOT EXISTS (SELECT 1 FROM `sys_menu` WHERE `authority` = 'delivery:add');
|
||||
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`)
|
||||
SELECT @delivery_menu_id, 2, '运送清单编辑', 'delivery:edit', 3, 0, NOW()
|
||||
WHERE @delivery_menu_id IS NOT NULL
|
||||
AND NOT EXISTS (SELECT 1 FROM `sys_menu` WHERE `authority` = 'delivery:edit');
|
||||
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`)
|
||||
SELECT @delivery_menu_id, 2, '运送清单删除', 'delivery:delete', 4, 0, NOW()
|
||||
WHERE @delivery_menu_id IS NOT NULL
|
||||
AND NOT EXISTS (SELECT 1 FROM `sys_menu` WHERE `authority` = 'delivery:delete');
|
||||
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`)
|
||||
SELECT @delivery_menu_id, 2, '运送清单查看详情', 'delivery:view', 5, 0, NOW()
|
||||
WHERE @delivery_menu_id IS NOT NULL
|
||||
AND NOT EXISTS (SELECT 1 FROM `sys_menu` WHERE `authority` = 'delivery:view');
|
||||
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`)
|
||||
SELECT @delivery_menu_id, 2, '运送清单核验', 'delivery:check', 6, 0, NOW()
|
||||
WHERE @delivery_menu_id IS NOT NULL
|
||||
AND NOT EXISTS (SELECT 1 FROM `sys_menu` WHERE `authority` = 'delivery:check');
|
||||
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`)
|
||||
SELECT @delivery_menu_id, 2, '设备分配', 'delivery:assign', 7, 0, NOW()
|
||||
WHERE @delivery_menu_id IS NOT NULL
|
||||
AND NOT EXISTS (SELECT 1 FROM `sys_menu` WHERE `authority` = 'delivery:assign');
|
||||
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`)
|
||||
SELECT @delivery_menu_id, 2, '装车操作', 'delivery:load', 8, 0, NOW()
|
||||
WHERE @delivery_menu_id IS NOT NULL
|
||||
AND NOT EXISTS (SELECT 1 FROM `sys_menu` WHERE `authority` = 'delivery:load');
|
||||
|
||||
-- ============================================
|
||||
-- 8. 验证数据
|
||||
-- ============================================
|
||||
-- 查看新增的权限管理菜单
|
||||
SELECT * FROM `sys_menu` WHERE `name` LIKE '%权限%' OR `name` LIKE '%permission%';
|
||||
|
||||
-- 查看超级管理员用户
|
||||
SELECT `id`, `mobile`, `name`, `role_id`, `status` FROM `sys_user` WHERE `mobile` = '15900000000';
|
||||
|
||||
-- 查看超级管理员的权限数量
|
||||
SELECT COUNT(*) as '超级管理员权限数' FROM `sys_role_menu` WHERE `role_id` = 1;
|
||||
|
||||
-- ============================================
|
||||
-- 执行完成
|
||||
-- ============================================
|
||||
SELECT '✅ 权限管理功能初始化完成！' as 'Status';
|
||||
SELECT '账号: 15900000000, 密码: 123456 (如果是新创建的账号)' as '超级管理员信息';
|
||||
|
||||
1795
权限管理和运送清单新增功能实施计划.md
1795
权限管理和运送清单新增功能实施计划.md
File diff suppressed because it is too large
Load Diff
@@ -1,45 +0,0 @@
|
||||
-- 设置字符集
|
||||
SET NAMES utf8mb4;
|
||||
SET CHARACTER SET utf8mb4;
|
||||
|
||||
-- 1. 添加权限管理父菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (0, 1, '权限管理', '/permission', null, 'permission:view', 'el-icon-lock', 20, 0, NOW());
|
||||
|
||||
SET @permission_parent_id = LAST_INSERT_ID();
|
||||
|
||||
-- 2. 添加菜单权限管理子菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (@permission_parent_id, 1, '菜单权限管理', '/permission/menu', 'permission/menuPermission', 'permission:menu:view', 'el-icon-menu', 1, 0, NOW());
|
||||
|
||||
SET @menu_permission_id = LAST_INSERT_ID();
|
||||
|
||||
-- 菜单权限管理的按钮权限
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`) VALUES
|
||||
(@menu_permission_id, 2, '菜单查询', 'permission:menu:list', 1, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单新增', 'permission:menu:add', 2, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单编辑', 'permission:menu:edit', 3, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单删除', 'permission:menu:delete', 4, 0, NOW()),
|
||||
(@menu_permission_id, 2, '角色分配', 'permission:menu:assign', 5, 0, NOW());
|
||||
|
||||
-- 3. 添加操作权限管理子菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (@permission_parent_id, 1, '操作权限管理', '/permission/operation', 'permission/operationPermission', 'permission:operation:view', 'el-icon-setting', 2, 0, NOW());
|
||||
|
||||
SET @operation_permission_id = LAST_INSERT_ID();
|
||||
|
||||
-- 操作权限管理的按钮权限
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`) VALUES
|
||||
(@operation_permission_id, 2, '权限查询', 'permission:operation:list', 1, 0, NOW()),
|
||||
(@operation_permission_id, 2, '权限分配', 'permission:operation:assign', 2, 0, NOW()),
|
||||
(@operation_permission_id, 2, '角色管理', 'permission:operation:role', 3, 0, NOW());
|
||||
|
||||
-- 4. 为超级管理员分配所有菜单权限
|
||||
DELETE FROM `sys_role_menu` WHERE `role_id` = 1;
|
||||
INSERT INTO `sys_role_menu` (`role_id`, `menu_id`)
|
||||
SELECT 1, id FROM `sys_menu` WHERE `is_delete` = 0;
|
||||
|
||||
-- 验证
|
||||
SELECT '菜单创建完成' as status;
|
||||
SELECT id, parent_id, name, route_url FROM sys_menu WHERE id >= 17 ORDER BY id;
|
||||
|
||||
@@ -1,88 +0,0 @@
|
||||
-- ============================================
|
||||
-- 权限管理菜单 - 精简版快速安装
|
||||
-- ============================================
|
||||
|
||||
-- 1. 添加权限管理父菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (0, 1, '权限管理', '/permission', null, 'permission:view', 'el-icon-lock', 20, 0, NOW());
|
||||
|
||||
-- 获取刚插入的父菜单ID
|
||||
SET @permission_parent_id = LAST_INSERT_ID();
|
||||
|
||||
-- 2. 添加菜单权限管理子菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (@permission_parent_id, 1, '菜单权限管理', '/permission/menu', 'permission/menuPermission', 'permission:menu:view', 'el-icon-menu', 1, 0, NOW());
|
||||
|
||||
SET @menu_permission_id = LAST_INSERT_ID();
|
||||
|
||||
-- 菜单权限管理的按钮权限
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`) VALUES
|
||||
(@menu_permission_id, 2, '菜单查询', 'permission:menu:list', 1, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单新增', 'permission:menu:add', 2, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单编辑', 'permission:menu:edit', 3, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单删除', 'permission:menu:delete', 4, 0, NOW()),
|
||||
(@menu_permission_id, 2, '角色分配', 'permission:menu:assign', 5, 0, NOW());
|
||||
|
||||
-- 3. 添加操作权限管理子菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (@permission_parent_id, 1, '操作权限管理', '/permission/operation', 'permission/operationPermission', 'permission:operation:view', 'el-icon-setting', 2, 0, NOW());
|
||||
|
||||
SET @operation_permission_id = LAST_INSERT_ID();
|
||||
|
||||
-- 操作权限管理的按钮权限
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`) VALUES
|
||||
(@operation_permission_id, 2, '权限查询', 'permission:operation:list', 1, 0, NOW()),
|
||||
(@operation_permission_id, 2, '权限分配', 'permission:operation:assign', 2, 0, NOW()),
|
||||
(@operation_permission_id, 2, '角色管理', 'permission:operation:role', 3, 0, NOW());
|
||||
|
||||
-- 4. 确保超级管理员角色存在
|
||||
INSERT INTO `sys_role` (`id`, `name`, `description`, `is_delete`, `create_time`)
|
||||
SELECT 1, '超级管理员', '拥有系统所有权限', 0, NOW()
|
||||
WHERE NOT EXISTS (SELECT 1 FROM `sys_role` WHERE `id` = 1);
|
||||
|
||||
-- 5. 为超级管理员分配所有菜单权限（包括新增的）
|
||||
DELETE FROM `sys_role_menu` WHERE `role_id` = 1;
|
||||
INSERT INTO `sys_role_menu` (`role_id`, `menu_id`)
|
||||
SELECT 1, id FROM `sys_menu` WHERE `is_delete` = 0;
|
||||
|
||||
-- 6. 设置15900000000为超级管理员
|
||||
UPDATE `sys_user`
|
||||
SET `role_id` = 1
|
||||
WHERE `mobile` = '15900000000' AND `is_delete` = 0;
|
||||
|
||||
-- 如果用户不存在，创建超级管理员账号
|
||||
INSERT INTO `sys_user` (`mobile`, `name`, `password`, `role_id`, `status`, `user_type`, `is_delete`, `create_time`)
|
||||
SELECT
|
||||
'15900000000',
|
||||
'超级管理员',
|
||||
'e10adc3949ba59abbe56e057f20f883e', -- 密码：123456 的MD5
|
||||
1,
|
||||
1,
|
||||
1,
|
||||
0,
|
||||
NOW()
|
||||
WHERE NOT EXISTS (
|
||||
SELECT 1 FROM `sys_user` WHERE `mobile` = '15900000000'
|
||||
);
|
||||
|
||||
-- ============================================
|
||||
-- 验证结果
|
||||
-- ============================================
|
||||
SELECT '✅ 菜单创建完成！' as 'Status';
|
||||
|
||||
-- 查看新增的菜单
|
||||
SELECT id, parent_id, name, route_url, authority
|
||||
FROM sys_menu
|
||||
WHERE name LIKE '%权限%'
|
||||
ORDER BY parent_id, sort;
|
||||
|
||||
-- 查看超级管理员账号
|
||||
SELECT id, mobile, name, role_id, status
|
||||
FROM sys_user
|
||||
WHERE mobile = '15900000000';
|
||||
|
||||
-- 查看超级管理员权限数量
|
||||
SELECT COUNT(*) as '权限总数'
|
||||
FROM sys_role_menu
|
||||
WHERE role_id = 1;
|
||||
|
||||
52
检查权限分配.sql
52
检查权限分配.sql
@@ -1,52 +0,0 @@
|
||||
-- 检查超级管理员权限分配情况
|
||||
-- 1. 检查超级管理员用户信息
|
||||
SELECT
|
||||
u.id,
|
||||
u.mobile,
|
||||
u.name,
|
||||
u.role_id,
|
||||
r.name as role_name
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
WHERE u.mobile = '15900000000';
|
||||
|
||||
-- 2. 检查 delivery:edit 权限是否存在
|
||||
SELECT
|
||||
id,
|
||||
name,
|
||||
authority,
|
||||
parent_id,
|
||||
type
|
||||
FROM sys_menu
|
||||
WHERE authority = 'delivery:edit';
|
||||
|
||||
-- 3. 检查超级管理员是否有 delivery:edit 权限
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.name as role_name,
|
||||
m.name as menu_name,
|
||||
m.authority,
|
||||
rm.role_id,
|
||||
rm.menu_id
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority = 'delivery:edit';
|
||||
|
||||
-- 4. 检查所有 delivery 相关权限
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.name as role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority LIKE '%delivery%'
|
||||
ORDER BY m.authority;
|
||||
66
检查权限分配情况.sql
66
检查权限分配情况.sql
@@ -1,66 +0,0 @@
|
||||
-- 检查权限分配情况
|
||||
-- 1. 检查超级管理员用户信息
|
||||
SELECT
|
||||
u.id,
|
||||
u.mobile,
|
||||
u.name,
|
||||
u.role_id,
|
||||
r.name as role_name
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
WHERE u.mobile = '15900000000';
|
||||
|
||||
-- 2. 检查 delivery:edit 权限是否存在
|
||||
SELECT
|
||||
id,
|
||||
name,
|
||||
authority,
|
||||
parent_id,
|
||||
type
|
||||
FROM sys_menu
|
||||
WHERE authority = 'delivery:edit';
|
||||
|
||||
-- 3. 检查超级管理员是否有 delivery:edit 权限
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.name as role_name,
|
||||
m.name as menu_name,
|
||||
m.authority,
|
||||
rm.role_id,
|
||||
rm.menu_id
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority = 'delivery:edit';
|
||||
|
||||
-- 4. 检查超级管理员是否有通配符权限
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.name as role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority = '*:*:*';
|
||||
|
||||
-- 5. 检查所有 delivery 相关权限
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.name as role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority LIKE '%delivery%'
|
||||
ORDER BY m.authority;
|
||||
@@ -1,14 +0,0 @@
|
||||
-- 检查超级管理员权限
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority LIKE '%delivery%'
|
||||
ORDER BY m.authority;
|
||||
7
添加设备运单字段.sql
Normal file
7
添加设备运单字段.sql
Normal file
@@ -0,0 +1,7 @@
|
||||
-- 为智能耳标表添加运单号和车牌号字段
|
||||
ALTER TABLE jbq_client ADD COLUMN IF NOT EXISTS delivery_number VARCHAR(255) COMMENT '运单号';
|
||||
ALTER TABLE jbq_client ADD COLUMN IF NOT EXISTS license_plate VARCHAR(255) COMMENT '车牌号';
|
||||
|
||||
-- 为智能项圈表添加运单号和车牌号字段
|
||||
ALTER TABLE xq_client ADD COLUMN IF NOT EXISTS delivery_number VARCHAR(255) COMMENT '运单号';
|
||||
ALTER TABLE xq_client ADD COLUMN IF NOT EXISTS license_plate VARCHAR(255) COMMENT '车牌号';
|
||||
10
添加项圈运单字段.sql
Normal file
10
添加项圈运单字段.sql
Normal file
@@ -0,0 +1,10 @@
|
||||
-- 1. 在xq_client表添加运单相关字段
|
||||
ALTER TABLE xq_client
|
||||
ADD COLUMN delivery_id INT COMMENT '运单ID',
|
||||
ADD COLUMN delivery_number VARCHAR(64) COMMENT '运单号',
|
||||
ADD COLUMN license_plate VARCHAR(64) COMMENT '车牌号';
|
||||
|
||||
-- 2. （可选）在delivery表添加项圈设备字段
|
||||
-- ALTER TABLE delivery
|
||||
-- ADD COLUMN xq_device_ids TEXT COMMENT '智能项圈设备ID列表(JSON)';
|
||||
|
||||
154
牛只运输功能模块整理.md
154
牛只运输功能模块整理.md
@@ -1,154 +0,0 @@
|
||||
# 牛只运输功能模块整理
|
||||
|
||||
本文档基于当前工作区两个文件夹（pc-cattle-transportation 前端、tradeCattle 后端）的代码与文档，梳理“活牛运输”相关的现有功能模块、接口与前后端对接情况，并提出后续完善建议。
|
||||
|
||||
更新日期：2025-10-10
|
||||
|
||||
## 1. 范围说明
|
||||
- 前端：pc-cattle-transportation/src
|
||||
- 后端：tradeCattle/aiotagro-cattle-trade、aiotagro-core
|
||||
|
||||
## 2. 前端已有模块（活牛运输相关）
|
||||
|
||||
2.1 运送清单/运单管理
|
||||
- 页面与交互
|
||||
- views/entry/details.vue：运单详情页，展示基础信息（运单号、订单标题、资金方、采购商、车牌号、司机、起始地/目的地、预计送达时间、创建时间等），支持主机定位弹窗、轨迹回放、耳标/项圈日志查看。
|
||||
- 状态注释：1 境外预检；2 已入境待隔离（检疫成功）；3 已入隔离场；4 隔离场出场。
|
||||
- 核心接口（api/abroad.js）
|
||||
- /delivery/pageQueryList（后台运送清单-分页）inspectionList
|
||||
- /delivery/detail（后台运单详情）waybillDetail
|
||||
- /delivery/downloadZip（下载运单打包文件）downloadZip
|
||||
- /jbqServer/serverLocation（主机定位）hostLocation
|
||||
- /jbqServer/serverTrack（主机轨迹）hostTrack
|
||||
- /jbqClientLog/jbqLogList（耳标运单期间日志）earLogList
|
||||
- /xqClient/pageXqListByDeliveryId、/xqClientLog/xqLogList（项圈相关接口：前端已定义，后端当前仓库未检索到对应实现）
|
||||
|
||||
2.2 运输/装车管理（装车订单）
|
||||
- 核心接口（api/shipping.js）
|
||||
- /delivery/pageDeliveryOrderList（装车订单列表）orderList
|
||||
- /delivery/addDeliveryOrder（新增装车订单）orderAdd
|
||||
- /delivery/deleteDelivery（删除）orderDel
|
||||
- /delivery/updateDeliveryInfo（编辑）orderEdit
|
||||
- /deliveryDevice/pageJbqList（查看耳标设备）deviceEarList
|
||||
- /jbqClient/pageQuery（分配设备列表）deviceList
|
||||
- /delivery/arrangeJbq（分配耳标设备）deviceAssign
|
||||
- /delivery/viewDeliveryOrder（订单详情）orderDetail
|
||||
- /wechatDelivery/carLoadInfo（装车详情）orderLoadDetail
|
||||
- /wechatDelivery/updateLoadInfo（装车保存）orderLoadSave
|
||||
- 说明：上述多数接口在后端当前仓库未发现同名 Controller/方法，疑似旧版接口或后端尚未接入该命名；需与后端统一命名或补齐实现。
|
||||
|
||||
2.3 入境检疫/核验与扫码记录（数据录入）
|
||||
- 核心接口（api/isolationQuarantine.js）
|
||||
- /inspection/submit（运单管理-确定入场）waybillSubmit
|
||||
- /inspection/logList（入/出场扫描记录）scanList
|
||||
- /inspection/sheepList（隔离场羊只信息列表）sheepList
|
||||
- /device/serverTrack（主机轨迹）hostTrack（与 /jbqServer/serverTrack 存在路由差异）
|
||||
- 说明：/inspection/* 相关接口在后端当前仓库未检索到对应 Controller，可能在其他项目或待实现。
|
||||
|
||||
2.4 设备定位与轨迹可视化
|
||||
- views/entry/details.vue：主机定位弹窗与轨迹回放。
|
||||
- 接口：api/abroad.js 的 hostLocation、hostTrack。
|
||||
|
||||
2.5 耳标/项圈设备与日志
|
||||
- 接口：api/abroad.js 的 earList（耳标运单期间列表）、earLogList（耳标日志）、collarList、collarLogList（项圈相关）。
|
||||
- 说明：耳标日志已在后端对应实现；项圈相关接口未在后端当前仓库检索到。
|
||||
|
||||
2.6 用户与司机管理（运输支撑）
|
||||
- 接口：api/userManage.js（司机管理）driverList、driverAdd、driverEdit。
|
||||
- 页面：views/userManage/driverDetailDialog.vue（司机证件/备案码等详情展示）。
|
||||
|
||||
2.7 菜单与权限（支撑运输模块）
|
||||
- store/permission.js：动态路由与侧边菜单生成（import.meta.glob 方式加载 views）。
|
||||
- components/layout/component/left-menu.vue：左侧菜单（标题“牛只运输跟踪系统”）。
|
||||
- router/index.ts：基础路由（login、entry/details、system/post 等）。
|
||||
|
||||
## 3. 后端已有模块（活牛运输相关）
|
||||
|
||||
3.1 运送清单（Delivery）
|
||||
- Controller：DeliveryController（/delivery）
|
||||
- POST /pageQuery（小程序运送清单-分页）
|
||||
- GET /view（小程序运送清单-查询详情）
|
||||
- POST /submitCheck（小程序运送清单-核验提交）
|
||||
- POST /pageQueryList（后台系统运送清单-分页）
|
||||
- GET /detail（后台运单详情）
|
||||
- Service：IDeliveryService、DeliveryServiceImpl（含 pageQuery、detail、pageQueryListLog 等）。
|
||||
- Entity：Delivery（字段包括 delivery_number、license_plate、start/end_location、estimated_delivery_time、driver_name、registered_jbq_count 等）。
|
||||
- Mapper：DeliveryMapper.xml（字段映射）。
|
||||
|
||||
3.2 主机设备（JbqServer）
|
||||
- Controller：JbqServerController（/jbqServer）
|
||||
- POST /serverLocation（主机单个定位）
|
||||
- POST /serverTrack（主机轨迹）
|
||||
- Service：IJbqServerService、JbqServerServiceImpl（含经纬度转换与时间窗过滤）。
|
||||
- 日志：JbqServerLogController（类存在但未提供接口方法）。
|
||||
|
||||
3.3 耳标设备与日志（JbqClient、JbqClientLog）
|
||||
- Controller：JbqClientController（/jbqClient）
|
||||
- POST /list（耳标列表分页）
|
||||
- Controller：JbqClientLogController（/jbqClientLog）
|
||||
- POST /jbqLogList（耳标日志分页，按运单时间窗查询）
|
||||
- Service：IJbqClientService、IJbqClientLogService（含实现）。
|
||||
|
||||
3.4 运单预警（Warning）
|
||||
- Controller：WarningLogController
|
||||
- /warningCount（预警统计）
|
||||
- POST /queryList（预警记录-分页）
|
||||
- GET /warningDetail（预警记录详情）
|
||||
- POST /pageQuery（后台系统预警记录-分页，委托 deliveryService.pageQueryList）
|
||||
- Job：AutoNumWarningJob（自动盘点与预警计算，基于耳标与主机日志）。
|
||||
|
||||
3.5 运单设备绑定（DeliveryDevice）
|
||||
- Controller：DeliveryDeviceController（类存在，未实现接口）。
|
||||
- Mapper/Service：DeliveryDeviceMapper、IDeliveryDeviceService（接口存在，未见具体实现方法）。
|
||||
|
||||
## 4. 前后端接口对接一览
|
||||
|
||||
4.1 已对接一致（可工作）
|
||||
- 前端 api/abroad.js → 后端 DeliveryController
|
||||
- /delivery/pageQueryList → DeliveryController.pageQueryList
|
||||
- /delivery/detail → DeliveryController.detail
|
||||
- 前端 api/abroad.js → 后端 JbqServerController
|
||||
- /jbqServer/serverLocation → JbqServerController.serverLocation
|
||||
- /jbqServer/serverTrack → JbqServerController.serverTrack
|
||||
- 前端 api/abroad.js → 后端 JbqClientLogController
|
||||
- /jbqClientLog/jbqLogList → JbqClientLogController.jbqLogList
|
||||
- 后端预警接口已具备（前端视图未在本次检索中明确列出，但可按需接入）。
|
||||
|
||||
4.2 存在缺口或命名不一致（需统一或补齐）
|
||||
- 前端 api/shipping.js（装车订单与设备分配）与后端当前仓库接口不一致：
|
||||
- /delivery/addDeliveryOrder、/delivery/pageDeliveryOrderList、/delivery/arrangeJbq、/delivery/viewDeliveryOrder 等后端未找到对应实现。
|
||||
- /jbqClient/pageQuery（前端使用）后端当前为 /jbqClient/list（命名不一致）。
|
||||
- 前端 api/abroad.js 的项圈相关接口：
|
||||
- /xqClient/pageXqListByDeliveryId、/xqClientLog/xqLogList 后端未检索到对应 Controller。
|
||||
- 前端 api/isolationQuarantine.js 的检疫模块：
|
||||
- /inspection/*（submit、logList、sheepList）后端当前仓库未检索到对应实现。
|
||||
- 前端 api/isolationQuarantine.js 的主机轨迹：
|
||||
- /device/serverTrack 与后端 /jbqServer/serverTrack 路由不一致（需统一）。
|
||||
- 后端 DeliveryDevice（运单设备绑定）
|
||||
- Controller/Service 已存在，但缺少分配、查询等具体 API，难以支撑前端“分配耳标设备”“查看耳标设备”等功能。
|
||||
|
||||
## 5. 现状结论
|
||||
- 已具备的运输核心功能（端到端可联通）
|
||||
- 后台运送清单分页与详情查询。
|
||||
- 主机设备定位与运单时间窗内轨迹回放。
|
||||
- 耳标日志按运单时间窗查询。
|
||||
- 预警统计与预警记录（后端已具备接口）。
|
||||
- 运输相关支撑模块（前端已具备）
|
||||
- 用户与司机管理、菜单与权限（动态路由与侧边栏）。
|
||||
- 主要缺口
|
||||
- 装车订单与设备分配（shipping.js）后端接口未对齐或缺失。
|
||||
- 检疫模块（inspection）与项圈模块（xqClient/xqClientLog）后端接口缺失，需补齐或统一。
|
||||
- 运单设备绑定（DeliveryDevice）需要提供具体分配/查询 API。
|
||||
|
||||
## 6. 建议与后续工作
|
||||
1) 接口命名统一：统一 /jbqClient/pageQuery → /jbqClient/list；/device/serverTrack → /jbqServer/serverTrack。
|
||||
2) 补齐装车订单与设备分配接口：在后端新增或对齐 /delivery/addDeliveryOrder、/delivery/pageDeliveryOrderList、/delivery/viewDeliveryOrder、/deliveryDevice/pageJbqList、/delivery/arrangeJbq 等。
|
||||
3) 检疫模块落库：实现 /inspection/submit、/inspection/logList、/inspection/sheepList 等 Controller 与 Service。
|
||||
4) 项圈模块落库：实现 /xqClient/pageXqListByDeliveryId、/xqClientLog/xqLogList 的 Controller 与 Service。
|
||||
5) 运单设备绑定完善：补充 DeliveryDevice Controller 的分配、查询、解绑等 API，以支持前端设备绑定流程。
|
||||
6) 文档化对接清单：在后端生成 Swagger 文档或在前端维护“接口对接表”，确保多端一致性与联调效率。
|
||||
|
||||
## 7. 附录：参考文件
|
||||
- 前端文档：pc-cattle-transportation/README.md、REQUIREMENTS.md、DEVELOPMENT_PLAN.md、DATA_STRUCTURE.md、ARCHITECTURE.md
|
||||
- 前端关键代码：api/abroad.js、api/shipping.js、api/isolationQuarantine.js、views/entry/details.vue、store/permission.js、router/index.ts
|
||||
- 后端关键代码：DeliveryController、JbqServerController、JbqClientController、JbqClientLogController、WarningLogController、AutoNumWarningJob、DeliveryDeviceController
|
||||
@@ -1,41 +0,0 @@
|
||||
-- 确保超级管理员有 delivery:edit 权限
|
||||
-- 1. 检查是否存在 delivery:edit 权限点
|
||||
SELECT id, name, authority FROM sys_menu WHERE authority = 'delivery:edit';
|
||||
|
||||
-- 2. 如果不存在，创建 delivery:edit 权限点
|
||||
INSERT INTO sys_menu (parent_id, type, name, authority, sort, is_delete, create_time)
|
||||
SELECT
|
||||
(SELECT id FROM sys_menu WHERE route_url LIKE '%delivery%' OR route_url LIKE '%loading%' LIMIT 1),
|
||||
2,
|
||||
'运送清单编辑',
|
||||
'delivery:edit',
|
||||
3,
|
||||
0,
|
||||
NOW()
|
||||
WHERE NOT EXISTS (SELECT 1 FROM sys_menu WHERE authority = 'delivery:edit');
|
||||
|
||||
-- 3. 确保超级管理员角色有 delivery:edit 权限
|
||||
INSERT INTO sys_role_menu (role_id, menu_id)
|
||||
SELECT
|
||||
(SELECT id FROM sys_role WHERE role_name = '超级管理员' OR id = 1 LIMIT 1),
|
||||
(SELECT id FROM sys_menu WHERE authority = 'delivery:edit')
|
||||
WHERE NOT EXISTS (
|
||||
SELECT 1 FROM sys_role_menu rm
|
||||
INNER JOIN sys_role r ON rm.role_id = r.id
|
||||
INNER JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE r.role_name = '超级管理员' AND m.authority = 'delivery:edit'
|
||||
);
|
||||
|
||||
-- 4. 验证权限分配
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND m.authority = 'delivery:edit';
|
||||
64
简化权限修复.sql
64
简化权限修复.sql
@@ -1,64 +0,0 @@
|
||||
-- 简化权限检查和修复
|
||||
-- 1. 删除可能存在的重复权限
|
||||
DELETE FROM sys_role_menu WHERE role_id = 1 AND menu_id IN (
|
||||
SELECT id FROM sys_menu WHERE authority = 'delivery:edit'
|
||||
);
|
||||
|
||||
-- 2. 确保 delivery:edit 权限存在
|
||||
INSERT INTO sys_menu (parent_id, type, name, authority, sort, is_delete, create_time)
|
||||
SELECT
|
||||
(SELECT id FROM sys_menu WHERE route_url LIKE '%delivery%' OR route_url LIKE '%loading%' LIMIT 1),
|
||||
2,
|
||||
'运送清单编辑',
|
||||
'delivery:edit',
|
||||
3,
|
||||
0,
|
||||
NOW()
|
||||
WHERE NOT EXISTS (SELECT 1 FROM sys_menu WHERE authority = 'delivery:edit');
|
||||
|
||||
-- 3. 确保超级管理员有 delivery:edit 权限
|
||||
INSERT INTO sys_role_menu (role_id, menu_id)
|
||||
SELECT
|
||||
1, -- 超级管理员角色ID
|
||||
(SELECT id FROM sys_menu WHERE authority = 'delivery:edit')
|
||||
WHERE NOT EXISTS (
|
||||
SELECT 1 FROM sys_role_menu rm
|
||||
WHERE rm.role_id = 1 AND rm.menu_id = (SELECT id FROM sys_menu WHERE authority = 'delivery:edit')
|
||||
);
|
||||
|
||||
-- 4. 确保超级管理员有通配符权限
|
||||
INSERT INTO sys_menu (parent_id, type, name, authority, sort, is_delete, create_time)
|
||||
SELECT
|
||||
0, -- 根菜单
|
||||
2,
|
||||
'所有权限',
|
||||
'*:*:*',
|
||||
999,
|
||||
0,
|
||||
NOW()
|
||||
WHERE NOT EXISTS (SELECT 1 FROM sys_menu WHERE authority = '*:*:*');
|
||||
|
||||
-- 5. 确保超级管理员有通配符权限
|
||||
INSERT INTO sys_role_menu (role_id, menu_id)
|
||||
SELECT
|
||||
1, -- 超级管理员角色ID
|
||||
(SELECT id FROM sys_menu WHERE authority = '*:*:*')
|
||||
WHERE NOT EXISTS (
|
||||
SELECT 1 FROM sys_role_menu rm
|
||||
WHERE rm.role_id = 1 AND rm.menu_id = (SELECT id FROM sys_menu WHERE authority = '*:*:*')
|
||||
);
|
||||
|
||||
-- 6. 验证权限分配
|
||||
SELECT
|
||||
u.mobile,
|
||||
u.name,
|
||||
r.name as role_name,
|
||||
m.name as menu_name,
|
||||
m.authority
|
||||
FROM sys_user u
|
||||
LEFT JOIN sys_role r ON u.role_id = r.id
|
||||
LEFT JOIN sys_role_menu rm ON r.id = rm.role_id
|
||||
LEFT JOIN sys_menu m ON rm.menu_id = m.id
|
||||
WHERE u.mobile = '15900000000'
|
||||
AND (m.authority = 'delivery:edit' OR m.authority = '*:*:*')
|
||||
ORDER BY m.authority;
|
||||
170
车身照片关联查询功能实现说明.md
Normal file
170
车身照片关联查询功能实现说明.md
Normal file
@@ -0,0 +1,170 @@
|
||||
# 车身照片关联查询功能实现说明
|
||||
|
||||
## 🎯 功能需求
|
||||
|
||||
在运送清单详情页面的"车身照片"字段中，需要显示与司机姓名和车牌号相关联的车身前后照片，确保车身照片能够正确映射到运送清单信息表单中。
|
||||
|
||||
## 🔧 技术实现
|
||||
|
||||
### 1. **问题分析**
|
||||
|
||||
- **现状**：`delivery` 表中的 `carFrontPhoto` 和 `carBehindPhoto` 字段为空
|
||||
- **需求**：根据司机姓名和车牌号关联查询车身照片
|
||||
- **数据源**：`member_driver` 表中的 `car_img` 字段包含司机车辆照片
|
||||
|
||||
### 2. **后端实现**
|
||||
|
||||
#### 2.1 新增查询方法
|
||||
在 `MemberDriverMapper.java` 中添加了根据司机姓名和车牌号查询的方法：
|
||||
|
||||
```java
|
||||
/**
|
||||
* 根据司机姓名和车牌号查询司机信息（包含车身照片）
|
||||
*/
|
||||
@Select("SELECT md.id, md.member_id, md.username, md.car_number, " +
|
||||
"md.driving_license, md.driver_license, md.record_code, " +
|
||||
"md.car_img, md.remark, md.create_time, m.mobile " +
|
||||
"FROM member_driver md " +
|
||||
"LEFT JOIN member m ON md.member_id = m.id " +
|
||||
"WHERE md.username = #{driverName} AND md.car_number = #{licensePlate}")
|
||||
Map<String, Object> selectDriverByNameAndPlate(@Param("driverName") String driverName,
|
||||
@Param("licensePlate") String licensePlate);
|
||||
```
|
||||
|
||||
#### 2.2 修改详情查询逻辑
|
||||
在 `DeliveryServiceImpl.java` 的 `detail` 方法中添加了车身照片关联查询逻辑：
|
||||
|
||||
```java
|
||||
// 查询司机信息
|
||||
if (delivery.getDriverId() != null) {
|
||||
try {
|
||||
// 根据司机ID直接查询司机信息
|
||||
Map<String, Object> driverInfo = memberDriverMapper.selectDriverById(delivery.getDriverId());
|
||||
|
||||
if (driverInfo != null) {
|
||||
delivery.setDriverName((String) driverInfo.get("username"));
|
||||
delivery.setLicensePlate((String) driverInfo.get("car_number"));
|
||||
|
||||
// 如果delivery表中的车身照片为空，尝试从司机信息中获取
|
||||
if (delivery.getCarFrontPhoto() == null || delivery.getCarFrontPhoto().isEmpty()) {
|
||||
String carImg = (String) driverInfo.get("car_img");
|
||||
if (carImg != null && !carImg.isEmpty()) {
|
||||
delivery.setCarFrontPhoto(carImg);
|
||||
}
|
||||
}
|
||||
|
||||
// 如果车身照片仍然为空，尝试根据司机姓名和车牌号查询其他相关记录
|
||||
if ((delivery.getCarFrontPhoto() == null || delivery.getCarFrontPhoto().isEmpty()) &&
|
||||
(delivery.getCarBehindPhoto() == null || delivery.getCarBehindPhoto().isEmpty())) {
|
||||
try {
|
||||
Map<String, Object> relatedDriver = memberDriverMapper.selectDriverByNameAndPlate(
|
||||
delivery.getDriverName(), delivery.getLicensePlate());
|
||||
if (relatedDriver != null) {
|
||||
String relatedCarImg = (String) relatedDriver.get("car_img");
|
||||
if (relatedCarImg != null && !relatedCarImg.isEmpty()) {
|
||||
delivery.setCarFrontPhoto(relatedCarImg);
|
||||
delivery.setCarBehindPhoto(relatedCarImg); // 使用同一张照片作为前后照片
|
||||
}
|
||||
}
|
||||
} catch (Exception e) {
|
||||
// 忽略查询错误
|
||||
}
|
||||
}
|
||||
}
|
||||
} catch (Exception e) {
|
||||
// 忽略查询错误，继续处理
|
||||
e.printStackTrace();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 3. **查询逻辑流程**
|
||||
|
||||
#### 3.1 优先级查询顺序
|
||||
1. **第一优先级**：直接从 `delivery` 表获取 `carFrontPhoto` 和 `carBehindPhoto`
|
||||
2. **第二优先级**：从当前司机的 `member_driver` 记录中获取 `car_img`
|
||||
3. **第三优先级**：根据司机姓名和车牌号查询其他相关司机记录
|
||||
|
||||
#### 3.2 数据映射规则
|
||||
- **车头照片**：优先使用 `delivery.carFrontPhoto`，其次使用 `member_driver.car_img`
|
||||
- **车尾照片**：优先使用 `delivery.carBehindPhoto`，其次使用 `member_driver.car_img`
|
||||
- **备用方案**：如果前后照片都为空，使用同一张 `car_img` 作为前后照片
|
||||
|
||||
### 4. **前端显示**
|
||||
|
||||
前端详情页面中的车身照片显示组件已经正确配置：
|
||||
|
||||
```vue
|
||||
<el-descriptions-item label="车身照片:">
|
||||
<span style="vertical-align: top">
|
||||
<el-image
|
||||
v-if="data.baseInfo.carFrontPhoto"
|
||||
style="width: 50px; height: 50px; margin-right: 10px"
|
||||
:src="data.baseInfo.carFrontPhoto ? data.baseInfo.carFrontPhoto : ''"
|
||||
fit="cover"
|
||||
:preview-src-list="[data.baseInfo.carFrontPhoto] ? [data.baseInfo.carFrontPhoto] : []"
|
||||
preview-teleported
|
||||
/>
|
||||
<el-image
|
||||
v-if="data.baseInfo.carBehindPhoto"
|
||||
style="width: 50px; height: 50px; margin-right: 10px"
|
||||
:src="data.baseInfo.carBehindPhoto ? data.baseInfo.carBehindPhoto : ''"
|
||||
fit="cover"
|
||||
:preview-src-list="[data.baseInfo.carBehindPhoto] ? [data.baseInfo.carBehindPhoto] : []"
|
||||
preview-teleported
|
||||
/>
|
||||
</span>
|
||||
</el-descriptions-item>
|
||||
```
|
||||
|
||||
## 📊 数据流程
|
||||
|
||||
### 1. **API调用流程**
|
||||
```
|
||||
前端详情页面 → waybillDetail API → DeliveryServiceImpl.detail() →
|
||||
MemberDriverMapper.selectDriverById() → MemberDriverMapper.selectDriverByNameAndPlate() →
|
||||
返回包含车身照片的delivery对象
|
||||
```
|
||||
|
||||
### 2. **数据查询流程**
|
||||
```
|
||||
1. 查询delivery表基本信息
|
||||
2. 根据driverId查询司机信息
|
||||
3. 如果车身照片为空，从司机信息中获取car_img
|
||||
4. 如果仍然为空，根据司机姓名和车牌号查询相关记录
|
||||
5. 返回完整的delivery对象给前端
|
||||
```
|
||||
|
||||
## 🎯 功能特点
|
||||
|
||||
### 1. **智能关联查询**
|
||||
- ✅ 支持多层级查询策略
|
||||
- ✅ 自动匹配司机姓名和车牌号
|
||||
- ✅ 容错处理，避免查询失败影响整体功能
|
||||
|
||||
### 2. **数据完整性**
|
||||
- ✅ 确保车身照片能够正确显示
|
||||
- ✅ 支持前后照片分别显示
|
||||
- ✅ 提供备用显示方案
|
||||
|
||||
### 3. **性能优化**
|
||||
- ✅ 优先使用已有数据，减少数据库查询
|
||||
- ✅ 异常处理，避免查询错误影响用户体验
|
||||
- ✅ 缓存友好的查询策略
|
||||
|
||||
## 📁 相关文件
|
||||
|
||||
- **后端Mapper**：`tradeCattle/.../MemberDriverMapper.java` ✅
|
||||
- **后端Service**：`tradeCattle/.../DeliveryServiceImpl.java` ✅
|
||||
- **前端页面**：`pc-cattle-transportation/src/views/entry/details.vue` ✅
|
||||
|
||||
## 🎉 总结
|
||||
|
||||
车身照片关联查询功能已经完成！现在：
|
||||
|
||||
- ✅ **智能查询**：根据司机姓名和车牌号自动关联查询车身照片
|
||||
- ✅ **多层级策略**：支持多种查询策略，确保数据完整性
|
||||
- ✅ **容错处理**：异常情况下不影响整体功能
|
||||
- ✅ **前端显示**：车身照片能够正确显示在详情页面中
|
||||
|
||||
运送清单详情页面现在可以正确显示与司机姓名和车牌号相关联的车身前后照片！
|
||||
@@ -1,67 +0,0 @@
|
||||
-- ============================================
|
||||
-- 重新创建权限管理菜单（彻底解决乱码）
|
||||
-- 请在 Navicat 中执行
|
||||
-- ============================================
|
||||
|
||||
SET NAMES utf8mb4;
|
||||
SET CHARACTER SET utf8mb4;
|
||||
|
||||
-- 1. 删除旧的乱码数据
|
||||
DELETE FROM `sys_role_menu` WHERE `menu_id` >= 28;
|
||||
DELETE FROM `sys_menu` WHERE `id` >= 28;
|
||||
|
||||
-- 2. 重新创建权限管理父菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (0, 1, '权限管理', '/permission', null, 'permission:view', 'el-icon-lock', 20, 0, NOW());
|
||||
|
||||
SET @permission_parent_id = LAST_INSERT_ID();
|
||||
|
||||
-- 3. 创建菜单权限管理子菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (@permission_parent_id, 1, '菜单权限管理', '/permission/menu', 'permission/menuPermission', 'permission:menu:view', 'el-icon-menu', 1, 0, NOW());
|
||||
|
||||
SET @menu_permission_id = LAST_INSERT_ID();
|
||||
|
||||
-- 4. 创建菜单权限管理的按钮
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`) VALUES
|
||||
(@menu_permission_id, 2, '菜单查询', 'permission:menu:list', 1, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单新增', 'permission:menu:add', 2, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单编辑', 'permission:menu:edit', 3, 0, NOW()),
|
||||
(@menu_permission_id, 2, '菜单删除', 'permission:menu:delete', 4, 0, NOW()),
|
||||
(@menu_permission_id, 2, '角色分配', 'permission:menu:assign', 5, 0, NOW());
|
||||
|
||||
-- 5. 创建操作权限管理子菜单
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `route_url`, `page_url`, `authority`, `icon`, `sort`, `is_delete`, `create_time`)
|
||||
VALUES (@permission_parent_id, 1, '操作权限管理', '/permission/operation', 'permission/operationPermission', 'permission:operation:view', 'el-icon-setting', 2, 0, NOW());
|
||||
|
||||
SET @operation_permission_id = LAST_INSERT_ID();
|
||||
|
||||
-- 6. 创建操作权限管理的按钮
|
||||
INSERT INTO `sys_menu` (`parent_id`, `type`, `name`, `authority`, `sort`, `is_delete`, `create_time`) VALUES
|
||||
(@operation_permission_id, 2, '权限查询', 'permission:operation:list', 1, 0, NOW()),
|
||||
(@operation_permission_id, 2, '权限分配', 'permission:operation:assign', 2, 0, NOW()),
|
||||
(@operation_permission_id, 2, '角色管理', 'permission:operation:role', 3, 0, NOW());
|
||||
|
||||
-- 7. 为超级管理员分配所有权限
|
||||
DELETE FROM `sys_role_menu` WHERE `role_id` = 1;
|
||||
INSERT INTO `sys_role_menu` (`role_id`, `menu_id`)
|
||||
SELECT 1, `id` FROM `sys_menu` WHERE `is_delete` = 0;
|
||||
|
||||
-- 8. 验证结果
|
||||
SELECT '✅ 权限管理菜单创建完成！' as status;
|
||||
|
||||
SELECT
|
||||
m.id,
|
||||
m.parent_id,
|
||||
m.type,
|
||||
m.name,
|
||||
m.route_url,
|
||||
m.authority
|
||||
FROM sys_menu m
|
||||
WHERE m.id >= (SELECT MIN(id) FROM sys_menu WHERE name = '权限管理')
|
||||
ORDER BY m.parent_id, m.sort, m.id;
|
||||
|
||||
SELECT CONCAT('超级管理员拥有 ', COUNT(*), ' 个权限') as info
|
||||
FROM sys_role_menu
|
||||
WHERE role_id = 1;
|
||||
|
||||
146
需求文档.md
146
需求文档.md
@@ -1,146 +0,0 @@
|
||||
牛只运输管理系统需求文档（V1.0）
|
||||
|
||||
一、项目概述
|
||||
- 目标：为牛只运输与检疫业务提供从账号权限、运单管理、设备定位与轨迹、隔离检疫、告警日志到司机与用户管理的全流程管理平台。
|
||||
- 形态：前端 Web（Vue3 + Vite + Pinia + Element Plus），后端 Spring Boot（MyBatis-Plus + Sa-Token），MySQL 数据库，Redis 缓存，第三方短信（腾讯云），地图（百度地图）。
|
||||
|
||||
二、系统架构与部署
|
||||
- 前端
|
||||
- 技术栈：Vue3、TypeScript、Pinia、Vue Router、Element Plus、Axios、Vite。
|
||||
- 路由：静态路由（登录/首页等）+ 动态路由（通过后端菜单驱动）。
|
||||
- 权限：路由守卫 + 自定义指令（按钮级权限），依赖用户权限集与角色集。
|
||||
- 开发服务：Vite 启动端口 8080，代理 /api 到 http://127.0.0.1:16200（vite.config.ts）。
|
||||
- 后端
|
||||
- 技术栈：Java 1.8、Spring Boot 2.6.13、MyBatis-Plus、Sa-Token。
|
||||
- 应用参数：端口 16200，Context Path /api，dev profile。
|
||||
- 数据源：MySQL 129.211.213.226:3306/cattletrade（root/Aiotagro@741）。
|
||||
- 缓存：Redis 129.211.213.226:6379（Aiotagro@741）。
|
||||
- 短信：腾讯云（代码存在常量类与集成）。
|
||||
|
||||
三、用户角色与权限
|
||||
- 角色（需确认）：司机、货源方、采购方、系统管理员、资金方（原文称“四个角色”，但列出了五类，待业务确认）。
|
||||
- 其他潜在角色：企业管理员/普通操作员、检疫人员。
|
||||
- 权限模型：基于 sys_user、sys_role、sys_menu 三表，支持路由级与按钮级权限控制。
|
||||
- 前端控制：
|
||||
- 路由守卫：白名单 login；无 token 跳登录；已登录拉取菜单后动态生成路由。
|
||||
- 指令权限：hasPermi/hasRole 系列，控制页面元素显示与操作。
|
||||
|
||||
【新增需求】权限与数据可见性
|
||||
- 菜单权限管理：由 sys_menu 维护菜单树与权限点；后端依据用户身份返回可见菜单；前端仅渲染可见节点。菜单权限调整后需支持动态生效（用户重新获取菜单即可生效）。
|
||||
- 操作权限管理：基于权限码（permKey）控制页面按钮与接口访问；前端通过指令/工具（hasPermi/hasRole）进行显隐与禁用；后端控制器或网关层进行权限拦截与校验，避免越权调用。
|
||||
- 登录识别 role_id 与数据范围：登录成功后读取 sys_user.role_id，并以此作为数据作用域依据；普通角色仅能访问本角色范围内的数据（列表、详情、统计等）。
|
||||
- 超级管理员权限：超级管理员拥有最高权限与全数据可见性，可管理所有角色与菜单；建议以固定角色编码（如 ROLE_SUPER_ADMIN）或配置标识控制。
|
||||
|
||||
四、主要功能模块
|
||||
1）登录与认证
|
||||
- 密码登录与验证码登录（LoginDto.loginType 0/1）。
|
||||
- Token 统一在请求拦截器注入 Authorization；401/650 触发重新登录。
|
||||
|
||||
2）运单管理与入场核验（Entry）
|
||||
- 检疫列表与查询：inspectionList（attestation.vue）。
|
||||
- 详情：waybillDetail（details.vue），展示运单基本信息、预警信息、关联设备。
|
||||
- 视频：页面预留“核验装车过磅视频”展示位。
|
||||
- 下载：支持文件直链下载。
|
||||
- 【新增功能】新增运送清单：在“运送清单/列表页”增加“新增”按钮，打开运送清单表单对话框，支持创建运输单。
|
||||
- 权限要求：仅具备相应操作权限的角色可见与可操作（例如 hasPermi('delivery:add')）。
|
||||
- 表单字段（建议）：运单号、发货方、采购方、车牌号、司机信息、设备绑定（主机/耳标/项圈）、预计出发/到达时间、起点/目的地、牛只数量/重量、检疫信息（可选）、备注。
|
||||
- 校验规则：必填项校验、手机号/车牌/时间合法性校验、设备选择合法性校验。
|
||||
- 提交与反馈：提交至后端创建接口（POST /api/delivery/create 或同类接口，具体以后端为准），成功后刷新列表并提示；失败给出明确错误信息。
|
||||
|
||||
3）硬件设备与定位/轨迹（Hardware）
|
||||
- 主机定位：hostLocation → 地图标注经纬度与时间（locationDialog.vue / details.vue）。
|
||||
- 运动轨迹：hostTrack → 展示 polyline 与时间点集合（details.vue）。
|
||||
- 设备台账：设备编号、类型（主机/耳标/项圈）、所属用户、佩戴状态等（shipping/lookDialog.vue）。
|
||||
|
||||
4）隔离检疫（Isolation/Quarantine）
|
||||
- 隔离厂列表与管理（src/api/quarantine.js、isolationQuarantine.js）。
|
||||
- 入场检疫与详情与运单联动（inspectionList、waybillDetail）。
|
||||
|
||||
5）预警日志（WarningLog）
|
||||
- 列表与详情、分页查询与过滤。
|
||||
|
||||
6）用户与司机管理
|
||||
- 用户账户与状态管理（src/api/sys.js）。
|
||||
- 司机信息采集：姓名、手机号、车牌、驾驶证/行驶证/备案码、车头车身照片，表单校验与上传（userManage/driverDialog.vue）。
|
||||
|
||||
7）系统管理
|
||||
- 岗位管理（/system/post 路由存在）。
|
||||
- 菜单与权限管理（后端返回菜单驱动动态路由）。
|
||||
|
||||
8）支付与订单（如有）
|
||||
- pay_order 表存在，具体功能启用情况待确认。
|
||||
|
||||
9）数据导出/下载与多媒体
|
||||
- 文件下载直链。
|
||||
- 视频播放组件位（过磅视频等）。
|
||||
|
||||
五、核心数据实体（初步）
|
||||
- 系统与权限：sys_user、sys_role、sys_menu。
|
||||
- 运单与运输：delivery、delivery_device（运单设备关联）。
|
||||
- 硬件与定位：jbq_server、jbq_client、jbq_log；xq_client、xq_log；warning_log。
|
||||
- 成员与司机：member_user、member_driver（需确认具体表名）。
|
||||
- 支付与订单：pay_order（需确认是否启用）。
|
||||
|
||||
六、关键业务流程
|
||||
1）登录流程
|
||||
- 未登录访问非白名单路由 → 跳转登录。
|
||||
- 登录成功 → 拉取菜单 → 生成动态路由 → 进入首页。
|
||||
|
||||
2）运单入场核验流程
|
||||
- 检索检疫列表 inspectionList → 查看详情 waybillDetail → 查看主机定位 hostLocation 与轨迹 hostTrack → 下载/打印 → 返回列表。
|
||||
|
||||
3）设备定位与轨迹
|
||||
- 选择设备 serverDeviceId → 后端返回经纬度与时间 → 前端在百度地图组件展示。
|
||||
|
||||
4）司机信息采集与审核
|
||||
- 表单录入与资质图片上传 → 校验 → 提交 → 列表展示与状态维护。
|
||||
|
||||
5）权限菜单变更
|
||||
- 后端更新菜单权限 → 前端用户登录拉取最新菜单 → 动态路由更新。
|
||||
|
||||
七、第三方与集成
|
||||
- Redis：登录态与验证码缓存。
|
||||
- 腾讯云短信：验证码登录或通知。
|
||||
- 百度地图：vue-baidu-map-3x 与 BMap API。
|
||||
- 视频播放：页面内嵌 <video> 播放器。
|
||||
- 文件下载：URL 跳转下载。
|
||||
|
||||
八、运行环境与配置
|
||||
- 前端
|
||||
- 开发端口：8080。
|
||||
- 代理：/api → http://127.0.0.1:16200（vite.config.ts）。
|
||||
- Axios：utils/axios.ts 使用 VITE_API_DOMAIN；utils/request.js 使用 VITE_APP_BASE_API；建议统一为单一实例与变量。
|
||||
- 后端
|
||||
- 端口：16200，Context Path：/api，profile：dev。
|
||||
- MySQL：129.211.213.226:3306/cattletrade（root / Aiotagro@741）。
|
||||
- Redis：129.211.213.226:6379（Aiotagro@741）。
|
||||
|
||||
九、非功能性需求
|
||||
- 安全
|
||||
- Token 校验与过期处理；401/650 统一重登录。
|
||||
- 请求防重复提交；按钮级权限与路由级权限控制。
|
||||
- 性能
|
||||
- 列表分页与筛选；地图轨迹懒加载；Vite 按需构建。
|
||||
- 可靠性
|
||||
- 日志与告警完善；定位与轨迹异常提示与降级。
|
||||
- 可维护性
|
||||
- 统一 API 模块与状态管理；动态菜单减少硬编码。
|
||||
|
||||
十、待确认事项
|
||||
- 角色清单与职责范围：现有“司机、货源方、采购方、系统管理员、资金方”具体权限矩阵。
|
||||
- 接口清单：逐一从 src/api 与后端 Controller/Mapper 编目，形成规范接口文档（URL/方法/入参/出参/状态码）。
|
||||
- 数据字典与枚举：设备类型、运单状态、告警类型等统一字典。
|
||||
- 文件/视频来源与存储策略：本地/云存储与访问鉴权。
|
||||
- 后端启动提示“no MyBatis mapper found”原因与影响。
|
||||
|
||||
十一、下一步计划
|
||||
1）统一 Axios 与环境变量，规范请求层。
|
||||
2）拉取并整理后端接口清单，补齐字段说明与状态码约定。
|
||||
3）梳理并输出 RBAC 权限矩阵（角色 × 权限点）。
|
||||
4）补充关键流程的交互原型与边界条件。
|
||||
5）完善前后端环境配置说明（.env.development / .env.production 与代理策略）。
|
||||
|
||||
附：已知接口示例（不完整，需对齐后端）
|
||||
- GET /api/jbqServer/serverList → 主机服务列表。
|
||||
- 登录接口：支持密码登录与验证码登录（参见 src/api/sys.js 与 LoginDto）。
|
||||
- 动态菜单：getUserMenu → 生成前端动态路由。
|
||||
Reference in New Issue
Block a user