病例跟踪：读取病例活动日志

活动日志是技工所病例管理软件 Cympha 中用于病例跟踪的病例历史：记录每个事件、由谁触发以及何时发生.

受众： 病例上的任何人 —— 医生、技工所管理员、设计师、intaker 或分享的同事 —— 需要知道病例发生了什么、何时发生以及由谁完成的.

阅读后您将了解： 活动日志的位置、其中每个事件的含义、医生视图与技工所视图的区别，以及如何快速找到特定事件.

所需时间： 一两分钟略读一个正常病例. 对于您正在重构序列的有争议病例需要更长时间.

开始之前

从您的病例列表打开病例. 您将进入病例详情页面. 活动日志位于左列的 Activity Log 标题下，Case Chat 面板的上方.

日志始终存在 —— 它不是您需要切换的标签. 页面加载后，时间线就在那里.

日志是什么

活动日志是病例的审计追踪. 病例上的每个有意义事件作为一行附加，最旧在顶部、最新在底部. 每行有：

图标和颜色 指示事件类型.
角色名称 —— 执行的人（或系统）.
摘要行 描述发生了什么.
右侧的 时间戳，格式为月 + 日 + 本地时间（例如 "Mar 14 09:42"）.

日志是实时的. 新事件在发生时出现，无需重新加载 —— 病例详情页面订阅服务器发送的更新，任何推送时重新获取.

第 1 步 —— 从上到下略读

使用日志最简单的方式是把它当故事读. 从顶部病例被提交到最近发生的任何事情在底部，每一步都在那里：

谁提交了病例.
谁审查了录入，以及他们决定了什么.
谁被分配为设计师.
上传的每个文件.
每次状态变更.
每次评论或邮件交流.
每次批准、拒绝或上报.

对于大多数"这个病例怎么样了？"问题，这就是您需要的全部.

第 2 步 —— 解码每个事件类型

每个事件都有独特的图标和颜色. 这是您会看到的：

| 图标 / 颜色 | 事件 | 含义 | |---|---|---| | 绿色加人 | Case created | 医生将病例提交给技工所. | | 蓝色箭头 | Status changed | 病例从一个状态移动到另一个状态 —— 例如 Submitted → Intake Review 或 Designing → Awaiting Approval. 当转换是审批流程的一部分时，括号中显示步骤名称（例如 "Treatment Plan"）. | | 紫罗兰勾人 | Designer assigned / Designer reassigned | 特定人被分配到病例（或不同的人接管）. | | 琥珀上传 | File uploaded | 添加了一个文件 —— 该行显示为 "{actor} uploaded {file}". | | 红色减号 | File removed | 有人删除了附加的文件. | | 板岩标签 | Label added / Label removed | 标签被附加到病例或其中一个文件（例如 "Lab QC Passed"、"AlignerBot Phase 1"）. | | 静音聊天气泡 | Comment | 病例内消息. 渲染为带作者姓名、正文的小卡片 —— 如果技工所将其标记为 Visible to customer，会有一个小绿色眼睛徽章，因此技工所一眼就能看到哪些内部备注医生也能看到. | | 天蓝邮件 | Email to customer | 技工所向病例上的医生发送的正式邮件. 显示主题行和正文，在病例和医生的收件箱中都显示. |

文件上传行上的靛蓝机器人图标表示上传通过 Cympha Agent（桌面桥）传入，而不是浏览器. 角色仍然是其账户与 agent 配对的人类用户；agent 的机器标签显示为 "via Cympha Agent (workstation-name)" 后缀，以便您可以分辨它来自哪个工作站.

第 3 步 —— 快速查找特定事件

日志没有分页，页内不可搜索. 对于典型病例，滚动足够短，视觉扫描有效. 如果您在追踪一个特定事项：

特定文件 —— 查找上传图标（琥珀回形针式或靛蓝机器人）并读取文件名.
状态何时变更 —— 查找蓝色箭头图标；它们突出，"from → to" 摘要告诉您转换.
客户被告知什么 —— 天蓝邮件图标是正式邮件；带绿色 "Visible to customer" 徽章的静音聊天气泡是医生也能看到的内部评论.
谁当前持有病例 —— 这不在日志中. 查看右列的 Assignment：它显示当前受让人和角色.

对于日志变得不便的非常长的病例，浏览器的页内查找（Ctrl+F / ⌘+F）针对渲染的文本有效.

医生视图与技工所视图的区别

您看到的活动日志取决于您是谁：

技工所人员（技工所管理员、case intaker、设计师、QC、制造）看到完整日志：每个事件、每条评论、每个文件操作. 他们还看到尚未标记为 Visible to customer 的内部技工所评论.
医生（客户） 看到一个过滤后的视图. 每个事件都带有自己的客户可见性标记，医生只看到被标记为对他们可见的事件. 实际上这意味着：
- 被技工所明确标记为 Visible to customer 的评论.
- 技工所发送给他们的邮件（渲染为 "Message from <lab name>"）.
- 他们自己的活动 —— 医生本人在病例上做的任何事情.
- 通过桌面 agent 到达的文件上传，以及医生自己的上传 —— 这些始终对医生可见.（这一点很重要：当审阅文件通过 agent 到达并触发审批请求时，医生可以看到引发它的那次上传.）技工所的浏览器上传默认仅技工所端可见.

这种分割是有意的：它让技工所在同一病例上保留坦诚的内部备注（例如 "CBCT 伪影太严重无法做套筒导板，我们应该退回"），同时医生不会看到这些，但仍然给医生一个清晰的与他们相关的所有内容的记录.

接下来会发生什么

随着病例的进展，日志持续附加. 日志中没有任何内容可以从 UI 编辑或删除 —— 一旦事件被记录，它就保留. 这是有意的：日志是病例上"谁在何时做了什么"的真实来源，重写历史会破坏这一点.

如果您发现看起来错误的东西（例如错误的人上传了文件，或发生了不应该发生的状态变更），不要试图"纠正"日志. 而是发布解释实际发生情况的评论，或上报病例以便技工所管理员可以查看.

故障排除

日志说 "No messages yet." 没有事件记录到病例上. 这通常只发生在尚未提交的新创建病例上，或系统创建但没人触摸过的病例上.

我期望的状态变更不在日志中. 两种可能性：要么病例从未实际移动（有人点击了 Approve 但验证失败，转换没有发生 —— 他们的屏幕上会有 toast 但没有日志条目），要么您以医生身份查看，而该事件没有被标记为对客户可见. 技工所人员看到每个事件.

**上传显示错误的人作为角色. ** Agent 上传归属于其 Cympha 账户与 agent 配对的用户. 如果您的设计师的 agent 与他们的账户配对，但同事将文件拖到他们工作站上的监视文件夹中，上传将显示为设计师. 将 agent 与实际进行上传的人配对.

**日志不实时更新. ** 页面通过服务器订阅实时更新. 如果订阅断开（网络故障），使用病例页面右上角的 Refresh 按钮强制重新获取.

相关指南：在聊天中与病例团队对话 · 病例状态术语表 · 角色矩阵