# 用户反馈系统 - 变更日志

> 本文档记录用户反馈模块的变更历史  
> **最后更新**: 2026-01-07  
> **当前版本**: v1.1.3

---

## [1.1.1] - 2026-01-06

### 🔧 前端与规范对齐

**实施时间**: 2026-01-06  
**状态**: ✅ 已完成

#### 变更概述

补齐前端 data-testid 并更新 UI/E2E 规范状态描述。

#### 文档变更内容

| 文档 | 变更内容 |
|------|---------|
| **05-ui-interaction-spec.md** | 更新页面状态与说明 |
| **10-e2e-test-spec.md** | 更新覆盖状态描述 |
| **99-changelog.md** | 本次记录 |

---

## [1.1.0] - 2026-01-06

### 📄 文档体系补全（v2.2）

**实施时间**: 2026-01-06  
**状态**: ✅ 已完成

#### 变更概述

根据文档系统 v2.2，补齐 E2E 测试规范文档并更新索引。

#### 文档变更内容

| 文档 | 变更内容 |
|------|---------|
| **10-e2e-test-spec.md** | 新增 E2E 测试规范 |
| **README.md** | 增加 E2E 测试规范入口 |
| **99-changelog.md** | 本次记录 |

---

## [1.0.2] - 2026-01-06

### ✅ 二次一致性校验

**实施时间**: 2026-01-06  
**状态**: ✅ 已完成

#### 变更概述

修正文档中残留的上传/校验/结构差异，确保与当前代码一致。

#### 文档变更内容

| 文档 | 变更内容 |
|------|---------|
| **01-prd.md** | 更新附件 UI 描述与数据保留项 |
| **02-user-journey.md** | 调整“上传”表述为“提交/填写” |
| **03-architecture.md** | 对齐区域过滤示例与目录结构 |
| **05-ui-interaction-spec.md** | 标注页面待实现 |
| **06-data-model.md** | 补充 region 默认值与校验层说明 |
| **99-changelog.md** | 本次记录 |

---

## [1.0.1] - 2026-01-06

### 🧭 文档对齐代码

**实施时间**: 2026-01-06  
**状态**: ✅ 已完成

#### 变更概述

对齐反馈模块文档与现有后端实现，修正 region 来源、角色代码与附件校验规则，并清理未实现的上传/安全描述。

#### 文档变更内容

| 文档 | 变更内容 |
|------|---------|
| **README.md** | 更新代码位置、接口描述与状态 |
| **01-prd.md** | 修正 region 来源与管理员角色，调整附件校验与安全说明 |
| **02-user-journey.md** | 调整附件与异常路径描述 |
| **03-architecture.md** | 对齐守卫、附件策略与安全说明，修正示例 |
| **05-ui-interaction-spec.md** | 调整附件字段描述 |
| **06-data-model.md** | 对齐 region 来源描述 |
| **07-api.md** | 调整附件校验规则与错误码 |
| **08-error-codes.md** | 移除未实现的附件错误码 |
| **09-test-scenarios.md** | 调整附件场景描述 |

---

## [1.0.0] - 2026-01-06

### 📝 文档补全

**实施时间**: 2026-01-06  
**状态**: ✅ 已完成

#### 变更概述

补齐反馈模块的核心与推荐文档，并修正相关文档引用链接。

#### 文档变更内容

| 文档 | 变更内容 |
|------|---------|
| **02-user-journey.md** | 新增用户场景文档 |
| **04-state-machine.md** | 新增状态机文档 |
| **05-ui-interaction-spec.md** | 新增 UI 交互规范 |
| **06-data-model.md** | 新增数据模型文档 |
| **08-error-codes.md** | 新增错误码文档 |
| **09-test-scenarios.md** | 新增测试场景文档 |
| **01-prd.md** | 修正文档引用 |
| **03-architecture.md** | 修正文档引用 |
| **07-api.md** | 修正文档引用 |
| **99-changelog.md** | 本文档 |

---

## 📌 版本节奏（待确认）

> 说明：以下为建议节奏，需产品/研发确认后生效。

| 版本类型 | 节奏 | 说明 |
|----------|------|------|
| Patch | 按需 | 文档修订、错误修复 |
| Minor | 每月 | 功能小幅迭代 |
| Major | 每季度 | 里程碑功能交付 |

---

## 🗺️ 里程碑（与 PRD 阶段对齐）

| 阶段 | 目标 | 状态 | 对应版本 |
|------|------|------|----------|
| Phase 1 | 基础反馈提交 + 我的反馈 | 📋 待开发 | v1.x |
| Phase 2 | 管理员列表 + 状态管理 | 📋 待开发 | v1.x |
| Phase 3 | 优先级 + 指派处理人 | 📋 待开发 | v1.x |
| Phase 4 | 统计分析 | 📋 待规划 | v2.0 |
| Phase 5 | 通知集成 | 📋 待规划 | v2.0+ |

---

**最后更新**: 2026-01-06  
**当前版本**: v1.1.1
## [1.1.2] - 2026-01-07

### 🧾 文档一致性修订

**实施时间**: 2026-01-07  
**状态**: ✅ 已完成

#### 变更概述

对齐文档与实际实现：功能状态、region 默认值、统计接口与测试报告规则。

#### 文档变更内容

| 文档 | 变更内容 |
|------|---------|
| **README.md** | 更新实现状态、代码位置与索引时间 |
| **01-prd.md** | 功能状态与里程碑对齐实现 |
| **03-architecture.md** | 对齐 Prisma 默认值与索引 |
| **06-data-model.md** | 对齐默认值与索引清单 |
| **07-api.md** | 统计接口状态与 UNSET 说明 |
| **10-e2e-test-spec.md** | 报告产出与路径规则 |
| **99-changelog.md** | 本次记录 |
## [1.1.3] - 2026-01-07

### ✅ 文档一致性校验清单补充

**实施时间**: 2026-01-07  
**状态**: ✅ 已完成

#### 变更概述

补充反馈模块文档一致性校验清单与自检命令。

#### 文档变更内容

| 文档 | 变更内容 |
|------|---------|
| **README.md** | 增加一致性校验清单与自检命令 |
| **99-changelog.md** | 本次记录 |