Issue Hub AI

AI 驱动的问题调度与流转平台原型，面向“客户端提交问题，中心端自动分析、派发、提醒，并让提交人、处理人、调度员都能看到完整处理过程”的场景。

当前范围

• 调度中心 7 个页面：中心调度台、问题池、部门队列、提醒升级、知识复盘、规则配置、管理看板。
• 客户端 5 个页面：我的待办、提交问题、处理人详情、提交人进度追踪、移动端提交/补充。
• AI 调度能力原型：问题 triage、相似问题、推荐部门/处理人、置信度、缺失信息、规则测试、知识草稿和无需沉淀决策。
• AI 调用链路：中心调度台可对选中问题执行 AI 重新分析，调用设置中的 OpenAI-compatible Base URL 并写入新的推荐结果与时间线。
• 业务流转动作：提交、AI 预检查补充、派发、批量派发、批量关闭、批量升级、批量标签、问题池 CSV 导出、退回补充、部门分派、接单、协作、处理人评论、评论工具附件 / 图片 / 链接真实插入、关联任务、处理人详情展开、SLA 查看记录、处理链接复制记录、催办协作人、全局通知中心、全局帮助面板、处理记录 CSV 导出、AI 完整分析报告、转派、处理结果、验收、返工、策略驱动 SLA 扫描、升级提醒、知识合并、无需沉淀标记、规则条件删除。
• 全局状态：hash 路由、全局搜索、本地持久化、重置演示数据、侧栏同步状态、未配置同步反馈和平台设置面板。
• 平台设置：同步服务地址/Token、AI 服务类型/模型/采纳阈值/API Key、SLA 提醒阈值、重复间隔与通知渠道、当前生效角色、权限角色和审计留存策略。
• 权限拦截：路由访问和关键操作会按当前角色校验权限，缺权时保留只读视图并给出统一反馈。
• 同步链路：设置面板可测试同步健康检查、执行 push/pull，并合并服务端返回的问题、时间线和规则等数据；同步请求会携带当前角色和权限声明。
• 分层实现：src/app 应用状态与路由，src/domain 领域规则，src/data 数据仓储/同步边界，src/features 页面，src/shared 共享布局和组件。

设计与文档

• 产品 PRD：docs/ai-dispatch-issue-platform-prd.md
• 流程图：docs/ai-dispatch-flowcharts.md
• images2 高保真设计图：docs/design/images2/
• 实现截图索引：docs/design/implementation-screenshots/README.md
• 人工定稿审阅入口：docs/design/review-index.html
• 人工设计定稿审计：docs/design/manual-design-freeze-audit.md
• 最终设计定稿记录：docs/design/final-design-freeze-record.md
• 完成度审计：docs/design/completion-audit.md
• 视觉差异报告：docs/design/visual-diff/report.md
• 实现进度与验证记录：docs/design/implementation-progress.md
• 浏览器冒烟说明：docs/design/browser-smoke.md

前端启动

cd D:\NetPorjects\JavaProject\worknode\issue-hub-ai
npm install
npm run dev -- --host 127.0.0.1 --port 5174

浏览器访问：

http://127.0.0.1:5174/#/center-dashboard

桌面端

项目保留 Tauri 外壳和便携数据文件能力：

npm run tauri dev

当前新调度平台主要通过 src/data/appRepository.ts 使用浏览器 localStorage 演示持久化；src/data/appSyncRepository.ts 已抽出服务端同步边界，顶部设置面板可保存同步地址和 Token，配置后可走服务端 push/pull。

服务端同步

服务端位于 server/，使用 Spring Boot + PostgreSQL。同步服务使用通用 sync_record 表，当前支持问题、时间线、AI triage、提醒、部门、人员、规则、规则审计、知识草稿、知识决策，以及旧版附件/AI 分析/action draft。

同步接口需要：

• Authorization: Bearer <ISSUE_HUB_SYNC_TOKEN>
• X-Issue-Hub-Role
• X-Issue-Hub-Permissions，其中必须包含 manage_settings

允许调用来源可通过 ISSUE_HUB_ALLOWED_ORIGINS 配置，默认允许本地 Vite 和 Tauri 预览端口。

cd D:\NetPorjects\JavaProject\worknode\issue-hub-ai\server
docker compose up -d
$env:ISSUE_HUB_SYNC_TOKEN = "your-sync-token"
$env:ISSUE_HUB_ALLOWED_ORIGINS = "http://127.0.0.1:5174,http://localhost:5174"
mvn spring-boot:run

同步地址：

http://localhost:8088

验证

cd D:\NetPorjects\JavaProject\worknode\issue-hub-ai
npm test
npm run build
npm run smoke:browser
npm run capture:pages

最近验证结果：npx tsc --noEmit 通过；29 个前端测试文件、104 个测试通过；生产构建通过，保留既有 500 kB chunk 体积提示；浏览器 smoke 通过；逐页实现截图刷新通过；npm run visual:diff 最新报告时间为 2026-06-18T04:47:26.995Z，自动诊断为 7 页可人工复核、5 页需打磨，人工定稿流程为 4 页建议通过、8 页定稿候选、0 页需人工决策。浏览器 smoke 内置 mock 同步服务覆盖成功同步路径，内置 mock AI 服务覆盖实时 triage 链路、全局通知中心 / 帮助面板、问题池真实分页 / 每页条数切换 / 提交人真实筛选 / CSV 导出、中心调度台真实分页 / 每页条数切换 / 行级派发操作面板、提醒升级风险分组表格 / 升级链路 / 提醒规则 / 最近动作、部门队列真实分页 / 每页条数切换 / 队列设置持久化 / 成员负载明细筛选与分派、我的待办真实分页 / 每页条数切换 / 详情 tab / 关注 / 复制链接 / 返回 / 更多操作、提交人追踪真实分页 / 每页条数切换 / 排序重置、知识复盘真实分页 / 每页条数切换 / 设置持久化、AI 预检查重新检测 / 审计记录 / 分类候选写入 / 流转规则详情、提交问题附件上传 / 草稿保存 / reload 恢复 / 提交后清理、移动端联系 / 催办时间线与补充文本 / 附件持久化、提交人详情展开 / 附件下载记录、处理人详情展开 / SLA 查看记录 / 处理链接复制记录 / 催办协作人时间线 / 评论工具附件和图片入问题附件 / 评论工具链接入评论 / 附件下载记录 / 处理记录 CSV 导出与完整分析报告、问题池批量治理、知识摘要编辑 / 知识无需沉淀标记、规则草稿与变更记录、管理看板 CSV 导出、自定义布局隐藏与持久化、真实数据下钻记录、刷新记录和筛选视图状态持久化、权限角色保存、权限拦截恢复路径、处理人评论 / 关联任务和规则条件删除。

当前机器未安装 mvn，且 server/ 没有 Maven Wrapper；服务端 mvn test 需要在安装 Maven 后补跑。

安全边界

• 演示数据默认保存在本机浏览器存储，重置演示数据会恢复 seed 数据。
• 同步 Token 只用于调用自托管同步服务，不进入服务端业务记录；同步服务同时检查当前角色权限声明，但 Token 仍是服务端实际凭据。
• AI API Key 通过 Tauri 原生命令 save_secret/load_secret 保存；浏览器预览模式仅降级到本机 secret fallback。
• 服务端同步业务对象，不保存 OpenAI API Key、完整 Prompt 日志或 embedding 向量。
• AI 在当前原型中作为建议、草稿、规则预览和分析结果出现，关键状态变更仍由用户操作确认。