# linyun-mid-web **Repository Path**: corepillar/linyun-mid-web ## Basic Information - **Project Name**: linyun-mid-web - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-11 - **Last Updated**: 2026-10-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 科赛数据中台 · 纯前端评审演示版 对应《03-数据中台建设方案》V2.6 评审草案。用于评审业务规则、功能边界与交互，不连接 hospital、ERP、数据库、网关、消息队列或身份服务。 ## 启动与验证 ```bash cd /Users/liuyh/data-platform/mid-web npm install npm run dev ``` 默认访问 http://localhost:8896/#/home 。首页先看结果：业务工作台、综合查询、医院服务月报。左侧分为业务使用、接入配置、数据治理、平台管理、方案与演示；14 步校验在「方案与演示」的「附一样例走查」，方案与意见也在这一组。重新走查先到「评审指引与重置」恢复演示数据。 2026-10-10 页面整理后再次收导航：首页改为工作台、综合查询、月报三个结果；侧栏分为「看结果」「走查怎么做到」「方案与评审」。功能索引、经营大屏、指标说明、调用记录等退出默认菜单，菜单搜索和结果页仍可进入。14 步校验、原路由与模拟数据保留。自由浏览时不显示走查向导，向导只出现在当前步骤及其相关页。 ```bash npm test npm run build ``` 70 项规则测试覆盖用户来源与人工对照、登录场景证据、权限、实体身份、回写、幂等、拆分补偿、补数、死信、库存口径、期间毛利、收款对照和导出，以及方案意见校验、跨院候选拒绝和月报有效分母。构建仍有 Element Plus / 图表包体积提示，评审版可以正常使用。 ## 全流程演示（保留 14 步向导） 访问 http://localhost:8896/#/flow ，点击“开始全流程演示”或“继续演示”。跟随向导提供前后步骤、自动带填、收起/退出和进度保存。14 步由同一主线的实际模拟结果自动验证，前置未完成不能跳到下一步；“只看页面”可自由浏览。SSO 完整模拟浏览器位于第 4 步，要求登录、登出与不可达兜底全部通过。 第 4 步点击“打开登录演练”，按顶部待办操作：登录医院 → 打开 ERP → 科赛员工登录（SSO）→ 全局登出 → “继续：演示中台不可达兜底” → 再点登录。三项完成后可直接进入第 5 步。关闭自动带填仍能打开演练；仅剩兜底时可直接继续该场景。“重新核验本步”只清除第四步场景证据，保留用户对照与业务样本。下方六步简版保留为链路回顾，不替代场景验证。 “重置流程进度”只清空走查记录，不清空业务样本；“评审演示指引”中的重置才恢复全部模拟业务数据。14 步进度与业务评审结果分别显示。左侧菜单和页顶均保留全流程入口，新增评审指引不替代原演示。 ## 建议评审顺序（约 20 分钟） 完整主线按 [08-全流程演示评审说明](../08-全流程演示评审说明.md) 的 14 步走查。以下为可独立补充评审的原有业务与异常功能。 1. 在“评审演示指引”重置演示，使用李工运营视角。 2. “待确认队列”核验附一医院 `#48213` 导联线与 ERP `#3917`，确认后查看版本化映射及待执行回写。 3. “备件回写与质量”选择“超时未知”，执行后只能查询结果。模拟查询未写入，再选择成功重试。 4. 用 `DEMO-IN-001` 入库 2 件，再以同一单号点一次。库存全景中附一现场仓从 10 变为 12；重复请求不再增加，也不增加备件档案。 5. “对账补数”选择模拟失败：源 18,422 / ODS 18,421，差异与告警保留。关闭失败开关重试，ODS 恢复 18,422；工单全景出现 `DEMO-RECOVERED-001`。本院关联异常 1 条独立核验；联安医院原有 3 条关联异常保留为独立场景。 6. “事件通道”直接重放库存死信会失败；模拟纠正载荷后再重放。指派过的问题在修复复核后自动关闭关联待办。 7. 进入附一合同 360，选择 2026-09：期间收入 106,666.67、期间成本 57,750.00、管理毛利 48,916.67。成本项可看来源预览；核销收款逐笔汇总核对合同累计值。 8. 查看联安合同：成本待归集，毛利标暂估；核销汇总与合同累计值预置 5,000 元差异，显示待核对。 9. 生成附一医院服务月报，到任务中心下载 CSV。订阅只生成本地固定快照，不自动运行或发送。 10. 切张三医院视角：仅见附一数据、内部金额隐藏。试访问人民医院的同序列号设备 `DEV-RM-SAME-SN`，应提示无权查看；切王强仅见本人工单，财务不开放工单明细。 11. 异常纠错：对已回写映射“拆分”，旧映射立即停止入库，补偿任务成功后才重新开放候选；既有库存账不删除。 ## 本轮完善 - 第 3 步改为 ERP 接口配置 → 连接测试 → 首次分页 / 后续增量同步 → 记录医院账号来源并读取 → 人工对照 → 第 4 步登录演练。ERP 配置由账号同步页与对照页共享；地址从保存配置读取，失败或配置改变需重新测试，不直接把预置员工当作来源证据。 - 全流程与跟随向导逐步说明“先有”与“得到”，区分首次接入准备和日常采集 / 质量 / 查询 / 报告；数据源目录说明员工接口与业务数据接口的不同用途。 - 两边用户样本独立于对照结果，来源批次、接口地址、医院提供方式、确认人、时间与依据可追溯。频率仅为演示配置，未运行真实接口或定时任务。 - 重排 14 步为接入准备 → 身份/接口 → 主数据 → 采集/质量 → 业务交付，保留自动带填和跟随向导。 - 固定附一医院、王强、同一设备和 2026-10；新增工单在失败、成功、重复拉取之间呈现真实的本地数据变化。 - 增加结构/字段版本、样本基线、模拟读服务与四角色边界验证；月报必须包含新增工单并实际下载才能完成。 - 增加业务工作台、评审指引、合同 360、工单/备件/工程师详情、来源预览、医院服务月报、任务与归档。 - 统一模拟数据和权限规则：检索、详情、全景、报表、下载使用同一医院范围与字段授权，角色切换即时重算。 - 接通确认 → 回写 → 幂等入库 → 库存变化及失败/未知/拆分补偿分支。 - 接通补数 → 复核 → 工单恢复 → 告警解除，采集数量与关联质量分开处理。 - 八个报表主题按权限展示；审批历史、设备日快照、HR 评价等缺少样本的指标明确留空。 - 统一期间成本和管理毛利，纳入人工分摊；维护累计成本明确采集区间；修正库存呆滞条件与镜像去重口径。 - CSV 可实际下载，保存生成时间、口径与数据版本。历史文件冻结；角色切换或权限收窄后再次检查下载权限。 - 医院接入配置跨页共享；SSO 客户端编辑、用户对照与会话注销保存到本地；接口测试与应急演练只写模拟审计。 - 支持桌面及窄屏布局，窄屏侧栏可展开，表格可横向滚动；经营图表随月份更新。 ## 数据与落地边界 核心状态存储于当前浏览器 localStorage：`midweb.review.v4`、`midweb.roles.v2`、`midweb.flow.v2`；医院与月份选择存储在 `midweb.report-context.v1`；方案意见单独存储在 `midweb.plan-review.v1`，重置业务样本不清除这些讨论意见。不同浏览器和设备不共享；“重置演示数据”恢复预置样本。浏览器缓存并不是后端存储或真实权限控制。 数据源数量、对账聚合总量和 API 能力是演示/规划样例；可浏览的设备与工单是小样本，两者在页面分别注明。SSO 的令牌、密钥、回调和密码只用于解释交互，不输入真实凭证。 本版可评审功能是否覆盖问题、业务规则是否正确、角色边界及报告模板是否满足使用需求。真实数据完整性、客户分支接口能力、性能、源端回写/补偿安全、身份鉴权和灾备能力需要评审通过后的后端开发与源系统联调验证。本轮未开发这些后端能力。 2026-10-10 再次复审：修正向导自动跨步、遮挡按钮和带填请求重复执行；第三步只带填，手动保存/测试/同步。接口验证绑定当前调用配置版本、准确记录双向调用，并精确核验医院范围。当前共 57 项测试通过。旧版第五步成功记录没有配置版本时会要求重测，不删除业务样本；重测通过后下游已有证据重新复核。详见 `../09-Demo复审与优化清单.md`。 ## V2.5 方案与效果评审 入口 http://localhost:8896/#/plan ，包括目标与范围、医院接入、接口效果、数据与报告、评审意见五个页签。业务摘要见 [10-数据中台方案与目标效果](../10-数据中台方案与目标效果.md)，详细主方案仍为 03 号文。 - 四项目标分别对应问题、使用效果、演示证据与边界，保留四期交付顺序。 - 医院能力卡区分已有梳理资料和待确认事项；全部演示医院目录不冒充实际客户完整名录。 - 四条接口说明业务经过、责任、授权范围、设计报文与错误处理；即时 HTTP、原库存消息、ODS 汇集分开说明。接口详情也可查看对应样例。 - 设备、医院、仓库补人工核对效果预览，不修改原备件闭环和 14 步证据。 - 月报以六部分展示完整阅读效果，响应指标穿透明细和来源，缺失 / 非有限时间不参与分母。浏览器打印当前报告，归档工单明细 CSV 继续沿用原下载验证。 - 八项讨论可记负责人、意见状态、内容与时间，支持刷新保留、撤回本地意见、导出 CSV。医院等无治理权限角色只读；记录意见不等于正式批准。 本轮共 64 项规则测试通过；生产构建通过，既有大包提示仍在。浏览器核对了首页入口、双向接口预览、跨院候选阻断、指标明细、意见保存/刷新/导出/撤回、医院角色只读与本院月报、390px 窄屏无页面横向溢出。原本已通过的主线仍为 14/14；未重置业务样本。打印入口已调用，系统 PDF 的最终分页仍需评审者在实际打印环境核对。 ## V2.6 整体审核修复（2026-10-11） - 首页、工作台、查询、合同、设备和报告共享医院与月份；初始演示范围为附一医院 2026-10，可选其他授权医院和月份，不重置业务样本。 - 菜单底部提供“全部功能”和“运行概况”；接入流程先读取来源，再核对编号。 - 员工目录只提供资料和状态，凭据激活、改密与停用联动作为独立责任草案；登录演练分开后端校验与浏览器建立全局会话。明确密码错误、停用拒绝不走故障兜底。 - 方案新增“统一登录与凭据责任”评审项，共九项；旧版意见归档保留，新版需重新确认。业务样本和 14 步走查证据继续保留。 - 同步 03/10 方案、04/05 开发规范和规范 HTML；当前仍为纯前端模拟演示，正式接口协议、授权和实施排期待评审。 ## V2.6 菜单按职责重整（2026-10-11） 首页独立入口，五组菜单分别为：业务使用、接入配置、数据治理、平台管理、方案与演示。默认首页展开业务使用，进入功能后展开所属分组；菜单搜索可查找隐藏的辅助功能。 运行概况、调用记录和权限设置归平台管理；14 步演示归方案与演示；接入配置和日常治理不再塞进演示分组。设备/合同详情、指标说明、数据总览和对照分发保留原入口；路由、权限规则、业务样本和已有演示进度均保留。