# 开发日志

## 2026-05-08

### 修复：版本管理更新保存不生效

**问题描述：**
- 编辑版本时，将"可选更新"切换为"强制更新"后保存，提示成功但实际未生效
- 编辑版本页面进入后没有数据，全是默认状态

**根因分析：**

1. **编辑页数据获取错误**
   - `[id].vue` 中 `fetchVersion()` 使用了 `data?.version || data`，由于 API 返回的 data 对象包含 `version` 字段（版本号字符串），导致 `data?.version` 返回的是版本号字符串而非版本对象，后续取 `ver.application_id` 等字段均为 `undefined`

2. **Switch 组件事件绑定错误**
   - 项目使用了 Reka UI 的 Switch 组件，该组件明确要求使用 `v-model` 绑定，不支持 `:checked` + `@update:checked` 方式
   - 原代码 `@update:checked` 事件实际上不会触发，导致 `formData.update_strategy` 始终为初始值 `optional`
   - 这是版本更新不生效的真正根因

**修复方案：**

| 文件 | 修改内容 |
|------|----------|
| `frontend/src/pages/admin/versions/[id].vue` | 1. `fetchVersion()` 直接使用 `api.get()` 返回值而非 `data?.version`<br>2. Switch 改用 `v-model="isForcedUpdate"` 绑定 computed getter/setter |
| `frontend/src/pages/admin/versions/create.vue` | Switch 改用 `v-model="isForcedUpdate"` 绑定 computed getter/setter |
| `frontend/src/pages/admin/versions/components/columns.ts` | 状态列改为根据 `update_strategy` 判断（`optional`/`forced`），移除旧的 `active`/`superseded` 判断 |
| `backend/internal/router/admin/versions.go` | 改用 `DB.Model().Where().Updates()` 替代 `DB.Save()`，添加 `RowsAffected` 检查和调试日志 |

**技术要点：**
- Reka UI 的 `SwitchRoot` 组件必须使用 `v-model` 双向绑定，不能使用 `v-model:checked` 或 `:checked` + `@update:checked`
- 组件源码注释：[Switch.vue](../../frontend/src/components/ui/switch/Switch.vue) 第 5-9 行

```vue
<!-- 正确 -->
<UiSwitch v-model="isForcedUpdate" />

<!-- 错误：值不会正确更新 -->
<UiSwitch v-model:checked="form.enabled" />
<UiSwitch :checked="val" @update:checked="val = $event" />
```

---

### 修复：版本状态判断逻辑

**问题描述：**
- 状态列误展示为更新策略（optional/forced），应与策略区分开
- 状态应反映该版本是否仍然生效

**正确逻辑：**
- 同一应用下，版本按 ID 升序排列（ID 越大越新）
- 若存在**更新版本**（ID 更大）且策略为**强制更新** → 当前版本状态为 `superseded`（失效）
- 否则 → 当前版本状态为 `active`（生效）

**举例：**
| 版本 | 策略 | 状态 | 说明 |
|------|------|------|------|
| v1.0.0 (ID=1) | optional | **生效** | 没有比它新的版本 |
| v1.0.0 (ID=1) | optional | **失效** | ID=2 的 v1.0.1 是强制更新 |
| v1.0.0 (ID=1) | forced | **生效** | ID=2 的 v1.0.2 是可选更新 |

**修改文件：**

| 文件 | 修改内容 |
|------|----------|
| `backend/internal/router/admin/versions.go` | `handleGetAllVersions`: 查询所有版本，按 app 分组收集 forced 版本 ID，遍历时检查是否有 ID 更大的 forced 版本<br>`handleGetVersionByID`: 用 COUNT 查询是否有同应用下 ID 更大且策略为 forced 的版本 |
| `frontend/src/pages/admin/versions/components/columns.ts` | 恢复状态列展示 `status` 字段的 `active`/`superseded` |