Cympha
全部文档

保存设计并请求审批

请求审批结束设计师在技工所病例管理软件 Cympha 中的工作，并把交付物交给医生审阅.

适用人群： 在 OrthoPlus / Implant Master / Studio 里完成病例细调、想把它交回医生签字的设计师.

读完你会掌握： 你保存的文件是如何到达云端的（哪些自动上传、哪些等你点击），Request Approval 按钮具体在哪里，点完后会发生什么状态变化，以及客户接下来看到什么.

所需时间： 大约四分钟.

开始之前

你需要：

  • 一个状态为 Designing、且你是持有人的病例. Request Approval 按钮只有当两个条件同时满足（你是技工所一侧的用户，且病例当前处于 Designing）时才显示.
  • 已经保存到该患者工作区文件夹的最终交付物. 对于隐形矫治病例是 .gvw 审阅文件或 .gos.gpk 转移包（.gos 工程本身留在本地——它永远不会上传）；对于种植病例是导板的 .stl；对于通用 lab service 则是客户在 intake 表单里要求的任何东西.
  • Cympha Agent Manager 正在运行且托盘里显示 Paired. 如果图标显示 Not paired，先按 Install and pair Cympha Agent Manager 修复 —— 没有 Agent，你保存的文件回不到云端.

如果你还没做"打开并细调"那一步，先从 Open a .cyp in Studio and refine the plan 开始.

第 1 步 —— 把交付物保存进病例文件夹

把交付物导出或保存到工作区下该患者的病例子文件夹里 —— {workspace}/{category}/{PatientName_Date_caseID}/. Cympha Agent Manager 的 Cloud Monitor 监视着那个文件夹，接下来发生什么取决于文件类型：

  • .gvw 审阅文件和 .zip 设计输出会自动上传 —— 无需点击. 而且 .gvw 不只是上传：它经由 Agent 到达处于 Designing 状态的病例时，会自行发起 Plan 审批请求 —— 病例翻到 Awaiting Approval、医生收到邮件，你一个按钮都不用点. 请在方案真正可以给人看时再导出 .gvw.
  • **大多数其他类型的文件等你点击. **Agent 提供上传的扩展名有：stl、ply、obj、png、gvw、txt、pdf、pie、xml、gpk、zip. 清单上不会自动上传的文件会停在 Cloud Monitor 面板的 New in workspace 下，每行有 Upload / Ignore 按钮，另有 Upload all —— 由你把关什么进云端.
  • **.gos 工程文件永远不会上传. **它不在清单上，这是有意设计 —— 你的 OrthoPlus 工程留在本地. 云端交付物是导出的 .gvw 和 .gos.gpk 转移包.
  • .gos.gpk 有自己的触发器，作用于流程后段：它经由 Agent 到达停在 Approved 或 Changes Requested 的隐形矫治病例时，会自动发起 Appliance 步骤的审批.

第 2 步 —— 确认文件已在病例上

对于自动上传的文件：切到浏览器，打开病例详情页 /cases/<id>，滚到 Files 面板 —— 保存后不久文件就会出现. 对于其他文件：右键托盘图标 → Cloud Monitoring → Show panel，在 New in workspace 下找到该文件，点 Upload，然后回浏览器的 Files 面板确认.

文件没出现的话：

  • **确认 Agent 已配对. **托盘会显示配对状态；Cloud Monitoring → Show panel 里能看到实时活动.
  • **确认文件在正确的文件夹里. **它必须位于工作区下该患者的病例子文件夹里 —— 丢在工作区根目录或错的患者文件夹里都会被忽略.
  • **确认扩展名可上传. **只有上面列出的文件类型会被提供上传；.gos（或临时/备份文件）永远不会出现在面板里.

如果我想上传一个 Agent 没自动捡起来的文件呢？ 用病例详情上的 Upload via Agent 按钮（仅限桌面浏览器）. 它会打开本地文件选择器，你指给它文件，Agent 会通过同一条认证通道上传. 这是用于工作区外一次性上传的正确逃生口.

第 3 步 —— 点 Request Approval

仍然在 /cases/<id> 的病例详情上，看病例标题附近的操作行. 你会看到 Request Approval 按钮 —— 一个带勾选圆圈图标的描边按钮 —— 出现在设计师操作行里.

注意：如果你的 .gvw 已经经由 Agent 上传，病例可能已经处于 Awaiting Approval —— Agent 的上传替你发起了请求，没有什么可点的了. 这一步针对的是不会自动发起请求的交付物.

没有单独的对话框或文本框 —— 点击直接发出请求，Cympha 会根据病例上已记录的审批情况自动判断下一个审批步骤（Plan / Appliance / Design）. 也没有留言字段：想给医生留一段书面注释，先在 Case Chat 里发，然后再点 Request Approval.

第 4 步 —— 确认状态翻转

页面重新拉取，你应该看到：

  • 状态徽章从 Designing（蓝）变为 Awaiting Approval（琥珀色）.
  • 病例上出现系统标签：根据病例处于哪个阶段，分别是 Plan Approval Pending、Appliance Approval Pending 或 Design Approval Pending. 步骤按类别固定：
    • 正畸 / AlignerBot / 种植：两步 —— 先 Plan，后 Appliance.
    • Lab service（冠、义齿、通用设计）：一步 —— Design.
  • 持有人就审批这件事而言从你转给客户 —— 现在等回应的是他们.
  • 活动日志收到一条 "Approval requested" 事件，payload 里带着步骤名.

Request Approval 按钮消失 —— 它只在病例处于 Designing 时显示. AlignerBot 操作员在适用时看到的是 Self-approve and run aligner design 路径.

接下来会怎样

  • **客户收到邮件. ** 邮件链接指向 /cases/<id>/approve —— 一个专门的评审页面，展示 lab slip 下载、文件列表，以及三个按钮：Approve、Request changes、Escalate to lab manager.
  • **客户登录评审. ** 评审页的用意是让他们在签字前先看到文件和 lab slip，而不是对没看过的东西一键放行.
  • **他们批准. ** 病例状态翻为 Approved（青绿色徽章）—— 而 Approved 是中转点，不是停留状态. 数字交付类别会立即自动推进，无需你任何点击：如果还剩审批环节，病例回到 Designing（仍归你）；最后一轮批准后直接到 Delivered. 实体的 lab service 类别则停在 Approved，等技工所把它切到 In Manufacturing.
  • **他们请求修改. ** 病例回退到 Changes Requested（玫红徽章）. 你仍然是持有人 —— 系统把病例留在你这里，而不是丢回通用队列. 医生的留言出现在聊天里，AlignerBot/ClearAligner.AI 病例会附上 XML 牙位文件或替换的 .gos.gpk 作为文件. 走查：Handle customer rejection.
  • **他们升级. ** 病例翻为 Escalated（红徽章）. 持有人转给你的技工所经理；他/她分诊后，要么带着注释发回给你，要么改派他人.

客户在 /approve 页面上看到什么

如果技工所里的医生好奇他们把客户引到了什么界面，简要总结如下：

  • 页面顶部是患者姓名，旁边是 Awaiting Approval 徽章和步骤标签（"Plan"、"Appliance" 或 "Design"）.
  • 一个 Download lab slip (PDF) 链接.
  • Files 区列出病例上每一个文件，配有 View 链接跳回病例详情上的完整文件面板.
  • 主要 CTA 面板：一段提醒文字，让他们看完文件 + lab slip，然后是 Approve / Request changes / Escalate to lab manager 三连.
  • 特别对 AlignerBot 和 ClearAligner.AI 病例，Request changes 对话框强制要求附加一个上传的 XML 牙位文件或替换的 .gos.gpk 才能接受拒绝（纯文本拒绝按设计被屏蔽 —— 规划器无法执行文字描述）.

疑难排查

**Request Approval 按钮不在. ** 两种原因：(1) 你不在 Designing —— 看状态徽章；(2) 你不是当前持有人 —— 技工所经理或 intake 操作员可能改派了. 打开活动日志，找最近一条分派记录.

**我点了 Request Approval 但状态没变. ** 刷新页面. 硬刷新后还在 Designing 的话，请求碰到了服务端校验错误（最可能的情况：每个审批步骤都已经有 APPROVED 标签，没有可请求的步骤了）. 在和技工所经理的聊天里反馈.

**客户说收到邮件但链接 404. ** 最可能的原因是病例已经越过了 Awaiting Approval —— 期间有人批准或改了状态. 刷新病例详情看它现在停在哪里.

**我想附一段书面注释解释设计选择. ** Request Approval 没有留言字段 —— 先在 Case Chat 里发注释，再点 Request Approval. 聊天线程会保留在病例上让客户看到.

我是 AlignerBot 操作员 —— 该用 Self-approve 还是 Request Approval？ Self-approve 在你的工作站上自动跑plan步骤的审批（这是"我既是技工所又是医生"路径）. Request Approval 是标准路径，把病例弹给外部客户. 按你这例的实际客户来选.

*相关教程：Open a .cyp in Studio and refine the plan、Handle customer rejection，以及医生侧的同一交接 Approve or reject a design. *

CymphaLMSCymphaStudio