edit | blame | history | raw

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-managementlaw-reference
  • mediation-dashboard 集成所有其他模块的数据

迁移说明

不适用(新项目)

风险评估

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

验收标准

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