# 出国行程变更申请功能优化说明

## 📋 修改时间
2025-10-13

## 🎯 修改目标

根据业务需求，优化出国行程变更申请流程：
1. ✅ 修改选项卡名称："全部变更" → "变更申请"，"我的变更" → "变更记录"
2. ✅ 删除"变更记录"选项卡中的"新增变更申请"按钮
3. ✅ 修改新增变更申请逻辑：从选择"出国记录"改为选择"已审批通过的出国申请"
4. ✅ 流程优化：通过出国申请菜单下已审批通过的申请创建变更申请

## 📝 详细修改内容

### 一、前端修改

#### 1. 页面UI优化 (`web/src/views/rs/overseas/itinerary-change.vue`)

**选项卡名称修改**：
- `<el-tab-pane label="全部变更" name="all">` → `<el-tab-pane label="变更申请" name="all">`
- `<el-tab-pane label="我的变更" name="my">` → `<el-tab-pane label="变更记录" name="my">`

**移除"变更记录"选项卡中的新增按钮**：
```vue
<!-- 删除前 -->
<el-col :span="1.5">
  <el-button type="primary" plain icon="Plus" @click="handleAdd">
    新增变更申请
  </el-button>
</el-col>

<!-- 删除后 -->
<!-- 只保留 right-toolbar -->
<right-toolbar v-model:showSearch="showMySearch" @queryTable="getMyList"></right-toolbar>
```

**修改新增变更申请弹窗**：
```vue
<!-- 修改前：选择出国记录 -->
<el-form-item label="选择原出国记录" prop="recordId">
  <el-select v-model="form.recordId" ...>
    <el-option v-for="record in availableRecordList" .../>
  </el-select>
</el-form-item>

<!-- 修改后：选择已审批通过的出国申请 -->
<el-form-item label="选择原出国申请" prop="applicationId">
  <el-select v-model="form.applicationId" filterable ...>
    <el-option v-for="application in availableApplicationList" .../>
  </el-select>
</el-form-item>
```

#### 2. 业务逻辑调整

**数据结构变更**：
```typescript
// 修改前
availableRecordList: [] as OverseasRecordVO[]

// 修改后
availableApplicationList: [] as OverseasApplicationVO[]
```

**API调用变更**：
```typescript
// 修改前
import { getAvailableOverseasRecords, getOverseasRecordForChange }

// 修改后  
import { getApprovedOverseasApplications, getOverseasApplication }
```

**方法更新**：
- `getAvailableRecordList()` → `getApprovedApplicationList()`
- `handleRecordChange(recordId)` → `handleApplicationChange(applicationId)`
- 验证规则：`recordId` → `applicationId`

#### 3. API接口更新 (`web/src/api/rs/overseas.ts`)

**新增API方法**：
```typescript
// 获取已审批通过的出国申请列表（用于行程变更申请选择）
export function getApprovedOverseasApplications() {
  return request({
    url: '/rs/overseas/application/status/1',
    method: 'get'
  });
}
```

**类型定义修改**：
```typescript
export interface ItineraryChangeForm {
  changeId?: number | string;
  recordId: number;  // ❌ 删除/废弃
  applicationId: number;  // ✅ 新增必填
  // ... 其他字段保持不变
}
```

### 二、后端修改

#### 1. BO类修改 (`RsOverseasItineraryChangeBo.java`)

**字段验证调整**：
```java
// 修改前
@NotNull(message = "关联备案记录ID不能为空", groups = { AddGroup.class, EditGroup.class })
private Long recordId;

private Long applicationId;

// 修改后
/**
 * 关联备案记录ID（外键，关联rs_overseas_entry_exit_record.record_id）
 * 注：该字段已废弃，现在使用applicationId
 */
private Long recordId;

/**
 * 关联出国申请ID（外键，关联rs_overseas_application.application_id）
 */
@NotNull(message = "关联出国申请ID不能为空", groups = { AddGroup.class, EditGroup.class })
private Long applicationId;
```

#### 2. Service实现修改 (`RsOverseasItineraryChangeServiceImpl.java`)

**依赖注入调整**：
```java
// 新增
private final IRsOverseasApplicationService applicationService;

// 删除（不再使用）
// private final IRsOverseasRecordService recordService;
```

**新增逻辑修改**：
```java
// 修改前：基于recordId查询出国记录
RsOverseasRecordVo record = recordService.queryById(bo.getRecordId());
if (record == null) {
    throw new ServiceException("出国记录不存在");
}

// 修改后：基于applicationId查询出国申请
RsOverseasApplicationVo application = applicationService.queryById(bo.getApplicationId());
if (application == null) {
    throw new ServiceException("出国申请不存在");
}

// 新增：检查申请状态
if (!"1".equals(application.getStatus())) {
    throw new ServiceException("只能为已通过审批的出国申请提交变更申请");
}
```

**数据来源变更**：
```java
// 修改前：从出国记录复制原始信息
entity.setOriginalDestination(record.getDestination());
entity.setOriginalStartDate(record.getActualStartDate());
entity.setOriginalEndDate(record.getActualEndDate());
entity.setOriginalDuration(record.getActualDuration());

// 修改后：从出国申请复制原始信息
entity.setOriginalDestination(application.getDestination());
entity.setOriginalStartDate(application.getStartDate());
entity.setOriginalEndDate(application.getEndDate());
entity.setOriginalDuration(application.getDuration());
```

**查重逻辑修改**：
```java
// 修改前：检查recordId
wrapper.eq(RsOverseasItineraryChange::getRecordId, bo.getRecordId())

// 修改后：检查applicationId
wrapper.eq(RsOverseasItineraryChange::getApplicationId, bo.getApplicationId())
```

## 🔄 业务流程对比

### 修改前流程
1. 用户在"出国申请"菜单中提交出国申请
2. 申请通过审批后，在"出国记录"选项卡中生成记录
3. 用户在"行程变更"菜单中，选择"出国记录"创建变更申请
4. 变更申请提交到审批流程

### 修改后流程  
1. 用户在"出国申请"菜单中提交出国申请
2. 申请通过审批后（状态=1）
3. 用户在"行程变更申请"选项卡中，**直接选择已审批通过的出国申请**创建变更申请
4. 变更申请提交到审批流程
5. 用户在"变更记录"选项卡中查看自己的变更历史

## ✨ 优化亮点

1. **简化流程**：不再依赖"出国记录"，直接从已审批申请创建变更
2. **状态验证**：后端强制检查申请状态为"已通过"（status=1）才能创建变更
3. **UI优化**：
   - 选择框支持筛选（`filterable`）
   - 清晰的选项卡命名（变更申请/变更记录）
   - "变更记录"仅查看，不允许新增
4. **数据一致性**：直接从原始申请复制数据，避免中间环节
5. **权限控制**：保持原有权限体系不变

## 🧪 测试建议

### 前端测试
1. ✅ 验证选项卡名称显示正确
2. ✅ 验证"变更记录"选项卡无新增按钮
3. ✅ 验证新增弹窗显示已审批通过的申请列表
4. ✅ 验证选择申请后自动填充原始信息
5. ✅ 验证筛选功能正常工作

### 后端测试
1. ✅ 验证必填字段从recordId改为applicationId
2. ✅ 验证只能选择status=1的申请
3. ✅ 验证相同申请不能重复提交待审核的变更
4. ✅ 验证数据来源为出国申请而非出国记录
5. ✅ 验证编译通过无警告错误

## 📦 涉及文件清单

### 前端
- `web/src/views/rs/overseas/itinerary-change.vue` - 主页面组件
- `web/src/api/rs/overseas.ts` - API接口定义

### 后端  
- `backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/domain/bo/RsOverseasItineraryChangeBo.java` - BO类
- `backend/ruoyi-modules/ruoyi-rs/src/main/java/org/dromara/rs/service/impl/RsOverseasItineraryChangeServiceImpl.java` - Service实现

## ⚠️ 注意事项

1. **数据库兼容性**：`record_id`字段保留但不再必填，`application_id`字段成为必填
2. **向后兼容**：已有的变更记录仍然可以正常查看和处理
3. **权限不变**：所有权限配置保持原样，无需重新配置
4. **API不变**：后端API路径和返回格式保持不变

## 🎉 完成状态

✅ 所有修改已完成并通过编译验证
✅ 前端TypeScript类型检查通过
✅ 后端Java编译成功
✅ 业务逻辑符合需求
✅ 代码质量良好（无警告）