diff --git a/docs/architecture/详细设计/招标专员工作台详细设计说明书.md b/docs/architecture/详细设计/招标专员工作台详细设计说明书.md new file mode 100644 index 0000000..934720b --- /dev/null +++ b/docs/architecture/详细设计/招标专员工作台详细设计说明书.md @@ -0,0 +1,540 @@ +# 招标专员工作台详细设计说明书 + +| 文档名称 | 招标专员工作台详细设计 | +| :------- | :---------- | +| **文档版本** | V1.0 | +| **编制日期** | 2026-07-06 | +| **关联文档** | 《需求分析说明书》 | + + +## 1. 概述 + +### 1.1 设计目标 +招标专员工作台是招标专员登录后默认进入的页面,作为其日常招标业务操作的核心枢纽。设计核心围绕 **“任务驱动”** 与 **“AI主动辅助”** 两大理念: +- **任务驱动**:集中展示待办任务(委托确认、寻源确认、立项审批、评标组织、定标发起等),按招标流程阶段分类,引导专员高效推进。 +- **AI主动辅助**:AI助手“小滨”以悬浮窗口形式常驻,主动分析当前待办任务,推送优先级建议、风险预警和操作指引,实现“事找人”的智能工作模式。 + +### 1.2 适用角色 +- 集团及下属公司的招标专员、招标管理部人员。 +- 不同专员的待办任务根据其被分配的项目和流程节点差异化展示。 + +### 1.3 设计原则 +| 原则 | 说明 | +| :--- | :--- | +| **流程驱动** | 任务按招标全生命周期(委托→寻源→立项→开标→评标→定标)自然排列,符合业务认知。 | +| **AI优先** | AI助手悬浮窗主动推送待办建议,减少专员主动查找的认知负担。 | +| **效率优先** | 高频操作(确认、审批、发起)一键可达,缩短操作路径。 | +| **实时同步** | 所有任务状态、待办数量实时更新,确保不遗漏关键节点。 | + + +## 2. 页面布局总览 + +```svg + + + + + + + + + + + + + + + + + + + + + + + + + 智慧招标平台 + Smart Tendering Platform + + + 首页 + 工作台 + 项目管理 + 供应商管理 + 专家管理 + + + + + 张婷 + + + + + + + 👋 早上好,张婷 + 今日待办:8 项 | 进行中项目:5 + + + + + ⚡ 快捷入口 + + + + + + 📝 + 新建委托 + + + + + 📂 + 我的项目 + + + + + 🏢 + 供应商库 + + + + + 👨‍🏫 + 专家库 + + + + + 📄 + 模板库 + + + + + 📊 + 报表中心 + + + + + 💰 + 保证金管理 + + + + + + 定标审批 + + + 🤖 小滨推荐 + + + + 🔍 + AI智慧寻源 + 2个项目待AI寻源 + + 2 + + + + 📋 + 待定标项目 + 1个项目待发起定标 + + 1 + + + 📋 待办任务 + + + + + 📝 待确认委托 + 3 + 个委托单待审核确认 + 查看全部 → + + 新委托 + + + + + 🔍 待寻源确认 + 2 + 个寻源结果待确认 + 查看全部 → + + AI已完成 + + + + + 📄 待立项审批 + 1 + 个招标方案待审批 + 查看全部 → + + 待发起 + + + + + ⚖️ 待开标/评标 + 2 + 个项目待组织评标 + 查看全部 → + + 即将截止 + + + 📂 我的在办项目 + + + + + + 项目编号 + 项目名称 + 当前阶段 + 所属委托 + 截止日期 + 状态 + 操作 + + + + BID-2026-001 + 年产5万吨聚丙烯项目设备采购 + + 寻源中 + 技术部-李工 + 2026-07-15 + + 进行中 + 继续 + + + + BID-2026-003 + 数字化交付平台开发服务 + + 立项中 + 数字化部-王工 + 2026-07-10 + + 即将截止 + 处理 + + + + BID-2026-005 + 2026年度防腐保温工程框架 + + 待开标 + 工程部-刘工 + 2026-07-08 + + 紧急 + 组织评标 + + + 查看全部项目 → + + + + + + + + + + + + + + 小滨 AI 助手 + + + + + + + ● 在线 · 已为您分析今日待办 + + + + 🔥 紧急:BID-2026-005 今日需开标 + “2026年度防腐保温工程框架”已到开标时间,请立即组织评标 + 去处理 → + + + + ✅ AI 已完成:寻源报告生成 + “年产5万吨聚丙烯项目”已自动寻源,匹配到12家潜在供应商 + 查看 → + + + + 📋 您有 3 个委托单待审核 + 来自技术部、采购部的委托申请已提交,请及时审核确认 + 去审核 → + + + + 输入您的问题... + + + + + + + 5 + +``` + + +## 3. 各模块详细说明 + +### 3.1 顶部导航栏 +- **品牌区**:平台Logo + 名称,点击返回首页。 +- **导航菜单**:首页、工作台(高亮)、项目管理、供应商管理、专家管理。 +- **用户区**:显示招标专员头像(首字母)、姓名,下拉菜单含个人设置、退出等。 +- **颜色主题**:绿色系(#00695c → #00897b),与供应商(红色)、专家(蓝紫色)区分。 + +### 3.2 欢迎横幅 + 今日概览 + +| 属性 | 说明 | +| :--- | :--- | +| **位置** | 导航栏下方,全宽1120px,高度70px | +| **内容** | 问候语(根据时段动态:早上好/下午好)+ 专员姓名 | +| **今日概览** | 今日待办总数(所有待办卡片计数之和)+ 进行中项目数 | +| **数据来源** | 实时统计各流程节点的待办任务数量 | + +### 3.3 待办任务看板(4个阶段卡片) + +> 按招标全生命周期阶段组织,每个卡片突出显示待办数量,支持点击查看明细。 + +| 卡片 | 颜色主题 | 数据来源 | 任务类型 | +| :--- | :--- | :--- | :--- | +| **待确认委托** | 红色(#e91e63) | 委托流程 | 委托审核确认、委托补充 | +| **待寻源确认** | 橙色(#ff9800) | 供应商寻源流程 | AI寻源结果确认、短名单确认 | +| **待立项审批** | 蓝色(#1565c0) | 招标立项流程 | 招标方案评审、审批发起 | +| **待开标/评标** | 绿色(#4caf50) | 开标及评标流程 | 截标确认、专家抽取、组织评标 | + +**交互规则**: +- 点击卡片任意区域 → 跳转至对应任务列表页。 +- 点击“查看全部” → 跳转至带筛选条件的完整任务列表。 +- 右上角标签 → 显示该阶段最高优先级状态(如“新委托”、“即将截止”)。 +- 数字实时更新,有变化时数字闪烁(0.5s 呼吸动画)。 + +### 3.4 我的在办项目 + +| 属性 | 说明 | +| :--- | :--- | +| **位置** | 待办看板下方 | +| **尺寸** | 1120 × 200px | +| **展示逻辑** | 当前专员负责的、状态为“进行中”的项目,按紧急程度排序(即将截止优先) | +| **表格列** | 项目编号、项目名称、当前阶段、所属委托、截止日期、状态、操作 | +| **状态标签** | 进行中(绿色)、即将截止(橙色)、紧急(红色) | +| **操作列** | 根据项目阶段动态变化:继续、处理、组织评标、查看等 | +| **查看更多** | 跳转至完整项目列表页 | + +**操作列映射表**: + +| 项目阶段 | 操作按钮 | 跳转目标 | +| :--- | :--- | :--- | +| 委托中 | 确认 | 委托详情页 | +| 寻源中 | 查看报告 | AI寻源结果页 | +| 立项中 | 编辑方案 | 招标方案编辑页 | +| 待开标 | 组织评标 | 开标准备页 | +| 评标中 | 进入评标 | 评标管理页 | +| 定标中 | 发起审批 | 定标审批页 | + +### 3.5 AI 助手“小滨”悬浮窗(核心特色) + +#### 3.5.1 视觉设计 + +| 属性 | 说明 | +| :--- | :--- | +| **位置** | `position: fixed`,默认位于右下角(距底部80px,距右侧40px) | +| **尺寸** | 宽340px,高400px | +| **可拖动** | 用户可通过拖拽头部区域移动悬浮窗位置 | +| **可折叠** | 点击头部“−”按钮最小化到右下角图标,点击“✕”关闭(可在系统设置中重新开启) | + +#### 3.5.2 主动提示能力 + +AI助手“小滨”**不需要用户主动提问**,而是主动分析当前专员的待办任务状态,推送以下类型提示: + +| 提示类型 | 触发条件 | 样式 | 示例 | +| :--- | :--- | :--- | :--- | +| **🔥 紧急提醒** | 任务截止时间 < 24小时 | 橙色背景(#fff3e0) | “BID-2026-005 今日需开标” | +| **✅ AI完成通知** | AI自动完成阶段性工作 | 绿色背景(#e8f5e9) | “✅ AI已完成:寻源报告生成” | +| **📋 待办汇总** | 日常任务堆积提醒 | 蓝色背景(#e3f2fd) | “您有3个委托单待审核” | +| **⚠️ 风险预警** | 检测到异常或风险 | 红色背景(#ffebee) | “⚠️ 供应商不足3家,需二次寻源” | +| **💡 操作建议** | 下一步最佳操作 | 灰色背景(#f5f5f5) | “💡 建议优先处理即将截止的委托” | + +#### 3.5.3 消息推送规则 + +```mermaid +graph TD + A[定时扫描待办任务
(每30秒)] --> B{检测到待办?} + B -->|无| C[显示“暂无待办,继续保持!”] + B -->|有| D[按优先级排序] + D --> E{优先级判定} + E -->|截止时间<24h| F[生成“紧急提醒”] + E -->|AI自动完成| G[生成“AI完成通知”] + E -->|常规任务| H[生成“待办汇总”] + E -->|异常检测| I[生成“风险预警”] + F --> J[按时间倒序展示在悬浮窗] + G --> J + H --> J + I --> J + J --> K[最多显示4条消息] + K --> L[用户点击“去处理”→跳转对应页面] +``` + +#### 3.5.4 消息交互 + +| 交互 | 说明 | +| :--- | :--- | +| **点击消息卡片** | 跳转至对应的任务处理页面(如点击“委托审核”→委托审核列表) | +| **点击“去处理”** | 同点击消息卡片,跳转至对应页面 | +| **输入框提问** | 用户可在底部输入框主动提问,小滨基于知识库+当前任务上下文回答 | +| **消息自动消失** | 任务处理后,该消息在下次刷新时自动消失 | +| **消息手动关闭** | 点击消息右上角“✕”可手动关闭该条消息 | + +#### 3.5.5 状态指示器 + +- 在线状态:绿色圆点 + “在线 · 已为您分析今日待办” +- 处理中状态(AI执行任务时):橙色圆点 + “正在分析任务...” +- 离线/错误状态:红色圆点 + “连接异常,点击重试” + + +## 4. 交互流程 + +### 4.1 待办任务处理完整流程 + +```mermaid +flowchart TD + A[专员登录工作台] --> B[小滨自动扫描待办] + B --> C[待办卡片显示数量] + B --> D[小滨窗口推送优先级消息] + D --> E{专员操作} + E -->|点击消息卡片| F[跳转至对应任务页] + E -->|点击待办卡片| F + E -->|点击项目操作按钮| G[跳转至具体操作页] + F --> H[完成任务操作] + G --> H + H --> I[返回工作台] + I --> J[小滨自动刷新待办状态] + J --> K{有待办?} + K -->|有| L[更新待办数量+消息列表] + K -->|无| M[显示“🎉 所有任务已处理完毕!”] +``` + +### 4.2 小滨主动提醒触发场景 + +| 场景 | 触发时机 | 小滨动作 | +| :--- | :--- | :--- | +| 新委托到达 | 委托审核通过 | 推送“📋 新的委托单已到达,请确认” | +| AI寻源完成 | 寻源任务完成 | 推送“✅ AI已完成供应商寻源,请确认短名单” | +| 开标时间临近 | 开标前24小时 | 推送“🔥 项目XX即将开标,请确认准备工作” | +| 有效投标人不足 | 报名截止后 | 推送“⚠️ 有效投标人不足3家,建议二次寻源” | +| 定标待审批 | 评标完成 | 推送“📋 评标已完成,请发起定标审批” | +| 无待办任务 | 所有任务完成 | 推送“🎉 今日所有任务已处理完毕!” | + +### 4.3 项目列表操作交互 + +- 点击项目行任意位置 → 跳转至项目详情页。 +- 点击操作列按钮 → 跳转至具体任务处理页(如“组织评标”→评标准备页)。 +- 支持行内快速操作(如状态变更下拉)。 + + +## 5. 数据模型 + +### 5.1 待办统计 API +``` +GET /api/v1/buyer/todo/statistics +响应: +{ + "pendingEntrust": 3, // 待确认委托 + "pendingSourcing": 2, // 待寻源确认 + "pendingApproval": 1, // 待立项审批 + "pendingBidOpen": 2, // 待开标/评标 + "todayTotal": 8 // 今日待办总计 +} +``` + +### 5.2 在办项目列表 +``` +GET /api/v1/buyer/projects/ongoing +参数:limit=5 +响应:[{ + "projectId": "BID-2026-001", + "projectName": "年产5万吨聚丙烯项目设备采购", + "phase": "SOURCING", // ENTRUST/SOURCING/APPROVAL/BID_OPEN/EVALUATION/FINALIZE + "entrustDept": "技术部-李工", + "deadline": "2026-07-15", + "status": "ONGOING", // ONGOING/URGENT/EXPIRING + "action": "VIEW_REPORT" // CONFIRM/EDIT/ORGANIZE/VIEW等 +}] +``` + +### 5.3 小滨消息列表(由后端实时生成) +``` +GET /api/v1/buyer/ai-messages +响应:[{ + "id": "MSG_001", + "type": "URGENT", // URGENT/AI_COMPLETE/TODO/RISK/SUGGESTION + "title": "BID-2026-005 今日需开标", + "content": "“2026年度防腐保温工程框架”已到开标时间,请立即组织评标", + "action": "ORGANIZE_BID", // 对应跳转路由 + "actionLabel": "去处理", + "createTime": "2026-07-06T09:00:00Z", + "expireTime": "2026-07-07T09:00:00Z" +}] +``` + + +## 6. 业务规则 + +| ID | 规则 | 说明 | +| :--- | :--- | :--- | +| R01 | 待办看板按流程阶段分组,每个阶段独立计数 | 委托/寻源/立项/开标评标 | +| R02 | 小滨消息最多展示4条,按优先级排序 | 紧急>风险>AI完成>待办汇总 | +| R03 | 消息有效期24小时,超时自动归档 | 避免信息过载 | +| R04 | 任务处理后,相关消息在下次刷新时自动消失 | 实时同步 | +| R05 | 待办卡片数字变化时触发呼吸动画 | 吸引注意 | +| R06 | 小滨悬浮窗默认展开,支持最小化 | 用户可控制 | + + +## 7. 安全与性能 + +| 维度 | 措施 | +| :--- | :--- | +| **权限控制** | 仅招标专员可见工作台,数据按专员权限隔离 | +| **数据实时性** | 待办统计每30秒轮询更新,WebSocket推送状态变更 | +| **消息历史** | AI助手消息保留7天,可查询历史记录 | +| **防打扰** | 支持关闭小滨主动推送(仅保留角标提醒) | + + +## 8. 与供应商/专家工作台的差异 + +| 维度 | 供应商工作台 | 专家工作台 | 招标专员工作台 | +| :--- | :--- | :--- | :--- | +| **主题色** | 红色(#c2185b) | 蓝紫色(#1a237e) | 绿色(#00695c) | +| **核心任务** | 投标报名、文件上传 | 接收评审邀请 | 流程推进、任务管理 | +| **待办分类** | 按操作类型(报名/缴费/上传) | 按评审状态 | **按招标阶段(委托/寻源/立项/开标)** | +| **AI助手定位** | 操作问答 | 评审提醒 | **主动流程推进器** | +| **数据看板** | 投标项目列表 | 评审历史 | **在办项目+阶段任务** | + +--- + +以上为招标专员工作台的完整详细设计,核心特色为 **AI助手“小滨”的悬浮窗主动提示机制**,通过实时扫描待办任务、推送优先级建议和操作指引,帮助招标专员高效推进招标流程,真正实现“事找人”的智能化工作模式。 \ No newline at end of file