Homepage Layout Specification
ADDED Requirements
Requirement: App Header Component
系统 SHALL 在页面顶部显示蓝色背景的Header组件，包含系统名称、通知图标和调解员信息。
Scenario: Header displays system name
- WHEN 页面加载完成
- THEN Header左侧显示"矛盾纠纷应用"系统名称
Scenario: Header displays notification icon with badge
- WHEN 存在未读通知消息
- THEN Header右侧显示通知图标，图标右上角显示红色气泡，气泡内显示未读消息数量
Scenario: Header displays mediator info from URL params
- WHEN URL参数包含trueName、unit、roleName、avatar
- THEN Header右侧显示调解员头像、姓名、"地址|角色"格式的信息
Scenario: Header uses default avatar when param empty
- WHEN URL参数avatar为空
- THEN 使用系统默认头像图片
Scenario: Notification popup on icon click
- WHEN 用户点击通知图标
- THEN 显示通知消息列表弹窗
Requirement: Warning Alert Component
系统 SHALL 在调解进度条下方显示预警提示消息条，支持多条消息查看。
Scenario: Single warning message display
- WHEN 预警消息API返回1条消息
- THEN 预警条直接显示完整消息内容，背景为浅黄色
Scenario: Multiple warning messages display
- WHEN 预警消息API返回多条消息
- THEN 预警条显示第一条消息 + "还有N条预警" + "查看更多"按钮
Scenario: Warning modal on view more click
- WHEN 用户点击"查看更多"按钮
- THEN 弹出Modal显示全部预警消息列表
Scenario: Warning API call
- WHEN 页面加载且mediationId存在
- THEN 调用
/api/v1/mediation-timeline/v2/warning-notify-list/{mediation_id} 获取预警数据
Requirement: Party Info Card Component
系统 SHALL 在调解分析面板右侧显示申请双方信息卡片。
Scenario: Applicant info display
- WHEN 当事人列表API返回申请方当事人数据
- THEN 左侧显示申请人头像、姓名，上方显示情绪标签(如有)
Scenario: Respondent info display
- WHEN 当事人列表API返回被申请方当事人数据
- THEN 右侧显示被申请人头像、公司名称，上方显示标签(如有)
Scenario: VS separator display
- WHEN 同时存在申请人和被申请人
- THEN 中间显示VS分隔符图标
Scenario: Emotion tag style
- WHEN 当事人数据包含tag_name和tag_style
- THEN 按tag_style渲染标签颜色(red=红色等)
Scenario: Person list API call
- WHEN 页面加载且caseId存在
- THEN 调用
/api/v1/mediation-timeline/v2/person-list/{case_id} 获取当事人数据
Requirement: Success Rate YoY Display
系统 SHALL 在预计调解成功率组件中显示同比数据。
Scenario: YoY rate from API field
- WHEN timeline.mediation.yoy_success_rate存在
- THEN 显示该值作为同比增长率(如+8%)
Scenario: YoY rate calculation fallback
- WHEN yoy_success_rate为空
- THEN 计算 (success_rate - last_success_rate) * 100 作为同比增长率
Scenario: YoY time display
- WHEN timeline.mediation.yoy_before_hours存在
- THEN 显示"较{yoy_before_hours}小时前"
Scenario: YoY time default
- WHEN yoy_before_hours为空
- THEN 显示"较0小时前"
Requirement: Negotiation Progress Component
系统 SHALL 在调解分析面板右侧显示协商沟通进度组件。
Scenario: Round count display
- WHEN timeline.mediation.mediation_count存在
- THEN 显示"第{mediation_count}轮"
Scenario: Progress dots default count
- WHEN 沟通次数 <= 流程节点总数
- THEN 总次数 = 流程节点总数，已完成轮次显示蓝色，未完成显示灰色
Scenario: Progress dots dynamic count
- WHEN 沟通次数 > 流程节点总数 且 未到最后节点
- THEN 总次数 = 沟通次数 + 1
Scenario: Progress dots all complete
- WHEN 已到达最后节点
- THEN 全部点显示蓝色
Requirement: AI Suggestion Card Component
系统 SHALL 在诉求差距分析下方显示AI调解建议面板。
Scenario: AI suggestion content display
- WHEN 面板加载
- THEN 显示AI调解建议内容(Mock数据)，背景为浅蓝色
Scenario: View detail button display
- WHEN 面板加载
- THEN 底部显示"查看详细策略建议"按钮
Scenario: View detail button click
- WHEN 用户点击"查看详细策略建议"按钮
- THEN 显示提示消息"该功能正在升级中，敬请期待！"
Requirement: Warning Notify API Service
系统 SHALL 提供预警消息列表API服务方法。
Scenario: Get warning notify list
- WHEN 调用 getWarningNotifyList(mediationId)
- THEN 发送GET请求到
/api/v1/mediation-timeline/v2/warning-notify-list/{mediationId}
- AND 返回预警消息数组
Requirement: Person List API Service
系统 SHALL 提供当事人列表API服务方法。
Scenario: Get person list
- WHEN 调用 getPersonList(caseId)
- THEN 发送GET请求到
/api/v1/mediation-timeline/v2/person-list/{caseId}
- AND 返回当事人数组
MODIFIED Requirements
Requirement: Mediation Data Board Layout
系统 SHALL 将调解数据看板调整为左右两栏布局。
Scenario: Left column content
- WHEN 调解分析Tab激活
- THEN 左列显示：诉求差距分析 + AI调解建议面板
Scenario: Right column content
- WHEN 调解分析Tab激活
- THEN 右列显示：申请双方信息 + 预计调解成功率(含同比) + 协商沟通进度
