# sales_data_dashboard 变更日志

> 记录销售数据仪表盘项目的所有重要变更。

---

## [Unreleased]

### Added
- 项目接入协作框架
- 创建 `ai/contracts.yaml` 定义服务契约
- 定义数据接口格式（年度数据、排名数据、季度进度）
- 定义技术栈（React 18 + Vite 5 / Vue 3 + Vite 5 / 原生 HTML）

---

## [1.0.0] - 2026-02-12

### Added
- 初始化销售数据仪表盘项目
- 实现三个版本：原生 HTML、React、Vue
- 实现年度销售目标和实际销售额展示
- 实现销售完成率进度条
- 实现年度季度进度显示（Q1-Q4）
- 实现小组销售排名（列表 + 柱状图）
- 实现个人销售排名（列表 + 柱状图）
- 支持响应式设计（PC 端等比例缩放，移动端自适应）
- 集成 ECharts 5.4 进行数据可视化

### Features (React 版本)
- React Hooks (useState, useEffect, useRef)
- 组件化开发（TopData、GroupRanking、PersonRanking）
- 防抖处理窗口 resize
- 图表自动销毁重建

### Features (Vue 版本)
- Vue 3 Composition API
- Setup script 语法
- 响应式数据绑定
- 生命周期钩子（onMounted、onUnmounted）

### Features (原生 HTML 版本)
- 原生 JavaScript 实现
- DOM 操作
- Fetch API 数据获取

### Technical Details
- **技术栈**：React 18 / Vue 3 / Vite 5 / ECharts 5.4
- **开发端口**：React (3001)、Vue (3002)
- **构建工具**：Vite 5
- **样式**：原生 CSS3
- **浏览器支持**：Chrome、Firefox、Safari、Edge

---

## 变更类型说明

- **Added**: 新增功能
- **Changed**: 功能变更
- **Deprecated**: 即将废弃的功能
- **Removed**: 已删除的功能
- **Fixed**: 问题修复
- **Security**: 安全性改进

---

## 发布流程

1. 更新 CHANGELOG_AI.md
2. 更新版本号（package.json）
3. 创建 Git tag
4. 推送到远程仓库