# 表单引擎 CHANGELOG

> 变更记录 - 记录表单引擎的版本变更历史

---

## [1.1.0] - 2025-12-05

### ✨ 新增

- **可视化拖拽设计器**
  - 字段面板：支持 15 种字段类型
  - 设计画布：拖拽添加和排序字段
  - 属性面板：配置字段属性和验证规则
  - 实时预览：切换预览模式查看效果
  - 代码视图：查看生成的 JSON Schema
  
- **设计器字段类型**
  - 基础：单行文本、多行文本、数字、邮箱、手机号、网址
  - 日期：日期、日期时间、时间
  - 选择：下拉选择、单选、复选框、开关
  - 文件：文件上传、图片上传

- **字段属性配置**
  - 基本属性：字段名、标签、占位符、说明
  - 状态控制：必填、禁用
  - 验证规则：长度限制、数值范围、正则表达式
  - 选项管理：添加/删除/排序选项

### 📁 新增文件

```
frontend/src/components/forms/designer/
├── FormDesigner.tsx
├── FieldPalette.tsx
├── DesignCanvas.tsx
├── PropertyPanel.tsx
├── types.ts
├── useDesignerStore.ts
└── index.ts

frontend/src/app/forms/definitions/[id]/design/
└── page.tsx
```

### 📦 依赖

- 新增 `@dnd-kit/core`
- 新增 `@dnd-kit/sortable`
- 新增 `@dnd-kit/utilities`

---

## [1.0.0] - 2025-11-20

### ✨ 新增

- **表单定义管理**
  - 创建、编辑、删除表单定义
  - 发布、归档表单
  - Slug 和别名管理
  - 表单克隆

- **表单版本管理**
  - 创建新版本
  - 发布、废弃版本
  - 设置默认版本
  - 版本列表查看

- **表单实例管理**
  - 创建草稿
  - 保存、提交表单
  - 我的表单列表
  - 实例详情查看

- **表单渲染引擎**
  - JSON Schema 解析
  - UI Schema 支持
  - 动态字段渲染
  - 表单验证

- **基础字段类型 (8 种)**
  - 文本输入
  - 多行文本
  - 数字输入
  - 日期选择
  - 下拉选择
  - 单选按钮
  - 复选框
  - 开关

- **审批流集成**
  - 配置审批流程
  - 提交时启动审批
  - 审批状态同步
  - 审批回调处理

- **多语言支持**
  - 表单名称多语言
  - 字段标签多语言
  - 翻译管理界面

- **模板系统**
  - 模板列表
  - 从模板创建表单

### 📁 文件结构

```
backend/src/form-engine/
├── controllers/ (5 个)
├── services/ (7 个)
├── dto/ (5 个)
└── types/ (2 个)

frontend/src/
├── app/forms/ (9 个页面)
├── components/forms/ (2 个组件)
└── services/api/forms.ts
```

### 📊 统计

- 后端接口：44 个
- 前端页面：9 个
- 代码行数：~6000 行

---

## 版本规划

| 版本 | 计划日期 | 主要内容 |
|------|----------|----------|
| 1.2.0 | 2025-12 | 动态表格、计算字段、条件显示 |
| 1.3.0 | 2026-01 | 设计器优化、字段分组 |
| 1.4.0 | 2026-02 | 数据导入导出、统计图表 |

---

## 📚 相关文档

- [PRD 需求文档](PRD.md)
- [API 接口文档](API.md)
- [开发待办](TODO.md)

---

**维护者**: FFOA 开发团队