# 部门编码编辑 - 快速参考

## 界面位置

**系统管理 -> 部门管理**

## 新增功能

### 1️⃣ 列表显示

部门列表新增两列：

| 列名 | 显示样式 |
|------|----------|
| 服务单编码 | 🟢 绿色标签 |
| 调度单编码 | 🟠 橙色标签 |

### 2️⃣ 编辑功能

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

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

## 快速操作

### 查看编码

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

### 新增时设置

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

### 修改编码

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

## 编码示例

| 分公司 | 服务单编码 | 调度单编码 |
|--------|-----------|-----------|
| 中山分公司 | JA | JA01 |
| 广州分公司 | GZ | GZ01 |
| 湛江分公司 | ZJ | ZJ01 |
| 珠海分公司 | ZH | ZH01 |
| 佛山分公司 | FS | FS01 |

## 字段规则

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

## 权限要求

| 操作 | 权限 |
|------|------|
| 查看 | system:dept:list |
| 编辑 | system:dept:edit |
| 新增 | system:dept:add |

## 数据来源

### 自动同步（推荐）

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

### 手动输入

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

## 注意事项

⚠️ **重要提示**

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

## 文件变更

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

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

## 快速验证

### 验证步骤

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

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

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

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

### 预期结果

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

## 常见问题

### Q1: 看不到编码列？

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

### Q2: 编辑后没有保存？

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

### Q3: 如何批量设置编码？

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

## 相关命令

```sql
-- 查看所有分公司的编码
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