部门编码编辑 - 快速参考

界面位置

系统管理 -> 部门管理

新增功能

1️⃣ 列表显示

部门列表新增两列：

2️⃣ 编辑功能

在"添加/修改部门"对话框中可以编辑：

[ 服务单编码 ]  [ 调度单编码 ]

快速操作

查看编码

1. 登录后台
2. 系统管理 -> 部门管理
3. 查看列表中的编码列

新增时设置

1. 点击"新增"按钮
2. 填写部门名称
3. 输入服务单编码（如：JA）
4. 输入调度单编码（如：JA01）
5. 保存

修改编码

1. 找到要修改的分公司
2. 点击"修改"按钮
3. 修改编码字段
4. 保存

编码示例

字段规则

• 最大长度：20个字符
• 是否必填：否
• 格式要求：无
• 建议格式：2-10个字符的简短编码

权限要求

数据来源

自动同步（推荐）

1. 执行部门同步任务
2. 系统自动从SQL Server读取编码
3. 根据地名自动匹配
4. 写入编码字段

手动输入

1. 管理员在编辑界面手动输入
2. 适用于自动匹配失败的情况

注意事项

⚠️ 重要提示

1. 建议使用自动同步批量设置编码
2. 自动匹配后检查是否正确
3. 对错误或未匹配的手动修正
4. 编码建议使用城市拼音首字母

文件变更

修改文件：
- ruoyi-ui/src/views/system/dept/index.vue

变更内容：
- ✅ 列表新增服务单编码列
- ✅ 列表新增调度单编码列
- ✅ 表单新增编码编辑字段
- ✅ 表单数据结构更新

快速验证

验证步骤

# 1. 登录后台
http://localhost/login

# 2. 进入部门管理
系统管理 -> 部门管理

# 3. 检查列表
查看是否显示服务单编码和调度单编码列

# 4. 测试编辑
修改任意分公司，查看是否有编码字段

预期结果

✅ 列表中显示编码列
✅ 已有编码的显示为彩色标签
✅ 未设置编码的显示为"-"
✅ 编辑对话框中可以修改编码
✅ 保存后列表实时更新

常见问题

Q1: 看不到编码列？

解决：刷新浏览器缓存（Ctrl+F5）

Q2: 编辑后没有保存？

解决：检查是否有权限 system:dept:edit

Q3: 如何批量设置编码？

解决：使用部门同步功能自动匹配

相关命令

-- 查看所有分公司的编码
SELECT 
    dept_name,
    service_order_class,
    dispatch_order_class
FROM sys_dept 
WHERE parent_id = 100 
  AND dept_name LIKE '%分公司';

-- 手动更新编码
UPDATE sys_dept 
SET service_order_class = 'JA',
    dispatch_order_class = 'JA01'
WHERE dept_name = '中山分公司';

技术支持

详细文档：prd/部门编码编辑功能说明.md

更新时间：2025-10-19