# Change: 初始化云小调劳动争议AI调解智能体平台

## Why

"云小调"是一个面向劳动争议场景的AI调解智能体Web系统，需要从零开始构建一个完整的前端平台。当前web-app目录已有基础React脚手架，但缺少核心业务功能的实现。系统需要提供案例搜索、法条检索、类案推荐、欠薪计算、材料审核、协议编辑和调解看板等9大核心功能模块，为调解员、基层综治工作人员提供全流程线上辅助工具。

## What Changes

本次变更将创建以下核心能力（capabilities）：

- **case-management** - 案例管理能力（案例搜索、案例详情）
- **law-reference** - 法条参考能力（法条搜索、法条详情）
- **similar-case-recommendation** - 类案推荐能力
- **wage-calculator** - 欠薪计算器能力
- **document-management** - 文档管理能力（材料审核、协议编辑）
- **mediation-dashboard** - 调解看板能力（主页工作台）
- **ui-foundation** - UI基础设施（布局、导航、通用组件）
- **mock-data-layer** - Mock数据层（所有模块的测试数据）

技术栈确立：
- 框架：React 19.2.3 + React Router DOM 6.22.3
- UI库：Ant Design 4.24.12
- 语言：JavaScript (ES6+)
- 状态管理：React Hooks（useState, useEffect）
- 数据模拟：本地Mock服务层

## Impact

### 影响的文件/系统
- **新增specs目录**：8个capability spec文件
- **web-app/src/**：全新的目录结构和组件体系
  - `pages/` - 9个页面级组件
  - `components/` - 业务组件按功能模块划分
  - `services/` - 服务层抽象
  - `mocks/` - Mock数据
  - `utils/` - 工具函数
  - `App.js` - 路由和布局重构

### 受影响的现有代码
- `web-app/package.json` - 添加antd和react-router-dom依赖
- `web-app/src/index.js` - 引入AntD样式
- `web-app/src/App.js` - 完全重写为Layout + Router结构

### 破坏性变更
无，这是全新项目初始化

### 依赖关系
- 所有业务模块依赖 `ui-foundation` 提供的布局和通用组件
- 所有数据请求依赖 `mock-data-layer` 提供的Mock数据
- `similar-case-recommendation` 依赖 `case-management` 和 `law-reference`
- `mediation-dashboard` 集成所有其他模块的数据

### 迁移说明
不适用（新项目）

### 风险评估
- 🟢 低风险：使用成熟的技术栈（React + AntD）
- 🟢 低风险：Mock数据驱动，无后端依赖
- 🟡 中风险：9个页面同时开发，需要保持一致性
- 🟡 中风险：需要严格按照原型HTML的UI/UX规范实现

### 验收标准
1. 所有9个页面可通过导航访问
2. 每个页面的UI与原型HTML保持100%一致
3. 所有表单、筛选、分页等交互功能正常
4. Mock数据完整，能够支撑完整的用户流程演示
5. 代码结构清晰，组件可复用性好
6. 无console错误，页面流畅运行