feat: add workbench kafka migration support

docs/IM-会议笔记产品原型需求文档.md

@@ -0,0 +1,147 @@
+# IM 会议笔记产品原型需求文档
+
+> 本文档根据 `docs/note/` 中的 8 张会议笔记产品原型图整理。文档格式与 `IM-产品原型需求文档.md` 保持一致，后续可合并到第 9 章“企业工作台与办公协同”中，建议插入在总经理信箱之后、个人资料与设置之前。
+
+## 9.14 会议笔记
+
+会议笔记是企业工作台下的办公协同模块，用于围绕会议记录会议资料、纪要文件和相关附件。功能需要和会议通知、参会人、会议状态及文件能力联动，保证发起人、会议记录员、参会人和普通成员在不同权限下看到合适的入口、文件列表和操作按钮。
+
+通知与刷新规则：
+
+1. 工作台底部 Tab 的红点数字需要与工作台内可接收通知的模块上下对应。当前原型中的红点 `3` 表示工作台下共有 3 条未读通知，这 3 条通知只归属到“会议通知”模块。
+2. 当前只有“会议通知”模块接收移动端通知，并承担会议创建、会议变更、会议提醒、参会反馈等通知展示。
+3. 打卡、月报、日报、部门框架、举报信箱、会议笔记等其他工作台模块不做移动端通知，也不产生独立通知红点。
+4. 除会议通知外，其他模块在用户进入模块时调用各自接口获取最新数据并刷新页面；客户端不得依赖通知事件来更新这些模块。
+5. 会议笔记的文件新增、预览、下载状态只在会议笔记列表/详情页内刷新展示，不向工作台 Tab 追加通知数。
+
+### 9.14.1 会议笔记-工作台入口.png
+
+<img src="images/会议笔记-工作台入口.png" alt="会议笔记-工作台入口" width="360">
+
+功能说明：
+
+工作台新增“会议笔记”入口，与打卡、月报、日报、部门框架、举报信箱、会议通知等企业应用并列展示。入口点击后进入会议笔记列表页。
+
+业务规则：
+
+1. 会议笔记入口应由企业工作台配置和用户权限控制，未启用或无权限时不展示。
+2. 工作台底部 Tab 红点只展示可通知模块的未读通知总数；当前只统计“会议通知”，不统计会议笔记、日报、月报、打卡、部门框架和举报信箱。
+3. 入口排序、图标和名称应支持后台配置，但客户端需限制为白名单内部路由，不能跳转任意外部地址。
+
+### 9.14.2 会议笔记-列表.png
+
+<img src="images/会议笔记-列表.png" alt="会议笔记-列表" width="360">
+
+功能说明：
+
+会议笔记列表展示“与我有关”的会议记录，顶部提供会议搜索。每条会议卡片展示会议主题、发起人、会议时间、参会人、会议时长和会议状态，并提供“会议笔记”按钮进入详情；部分卡片支持“查看更多”查看完整会议信息或参会人信息。
+
+业务规则：
+
+1. “与我有关”仅展示当前用户作为发起人、会议记录员、参会人或具备组织查看权限的会议，且会议必须是已结束状态；未开始、进行中和已取消会议不进入会议笔记列表。
+2. 列表按会议开始时间倒序展示，今天、昨天、前天等相对日期应由客户端按本地时区展示，排序仍以后端时间戳为准。
+3. 搜索支持按会议主题、发起人、参会人和会议地点检索；搜索结果仍必须受会议可见权限限制。
+4. 已结束但会议记录员尚未上传笔记的会议仍需要在会议笔记列表展示，卡片只展示会议基础信息和已结束状态，进入详情后展示“暂无笔记”空状态。
+5. 已结束会议可查看有权限访问的会议笔记；会议记录员进入详情可上传文件，普通参会人进入详情不展示上传按钮且只能预览已上传文件。
+6. 参会人过多时列表只展示前几名并省略，点击“查看更多”进入详情查看完整信息。
+
+### 9.14.3 会议笔记-发布页面.png
+
+<img src="images/会议笔记-发布页面.png" alt="会议笔记-发布页面" width="360">
+
+功能说明：
+
+会议发布页用于创建会议并指定会议记录员。页面包含发起人、地点、会议记录员、参会人、开始时间、时长、会议主题等字段，底部通过“发起会议”按钮提交。
+
+业务规则：
+
+1. 发起人默认取当前登录用户，不允许普通用户手动伪造；具备代发权限时应明确展示实际发起人和创建人。
+2. 发布页面字段顺序中，会议记录员应位于参会人上方；会议记录员默认取会议发起人，用户可按权限改选其他成员。
+3. 会议记录员、参会人、开始时间、时长和会议主题为必填项；地点可选。
+4. 参会人可选择“所有人”或指定成员。选择所有人时应按组织权限和企业规模做确认提示，避免误发全员会议。
+5. 会议记录员默认拥有上传、替换、删除本人上传文件和查看全部会议笔记的权限；普通参会人只能查看和预览已上传文件，不提供上传入口。
+6. 创建成功后应进入会议详情或会议笔记列表；需要通知参会人时统一走“会议通知”模块，会议笔记模块本身不产生移动端通知。重复点击“发起会议”需防抖和幂等处理。
+
+### 9.14.4 会议笔记-详情页.png
+
+<img src="images/会议笔记-详情页.png" alt="会议笔记-详情页" width="360">
+
+功能说明：
+
+会议详情页展示会议主题、状态、发起人、时间、地点、会议记录员、参会人和会议时长。下方“全部笔记（文件）”展示会议相关文件，文件项包含类型图标、文件名、大小、上传人、上传日期和下载按钮。底部提供“上传文件”按钮。
+
+业务规则：
+
+1. 会议基础信息应与会议通知模块共用同一份会议数据，避免会议时间、参会人或状态在两个模块展示不一致。
+2. 文件列表按上传时间倒序展示；同名文件允许存在，但应保留唯一文件 ID、上传人和上传时间。
+3. 文件类型需识别 PDF、Office 文档、图片、压缩包等常见格式；未知格式展示通用文件图标。
+4. “上传文件”按钮只对会议记录员展示；如后续扩展管理员代传能力，必须由服务端显式下发上传权限。
+5. 当前用户是会议记录员时，详情页展示上传文件按钮；当前用户只是参会人时，不展示上传按钮，文件操作只保留预览能力。
+6. 下载和预览都必须校验当前用户是否仍具备会议可见权限，不能仅凭文件 ID 访问。
+
+### 9.14.5 会议笔记-详情页（普通成员）.png
+
+<img src="images/会议笔记-详情页（普通成员）.png" alt="会议笔记-详情页（普通成员）" width="360">
+
+功能说明：
+
+普通成员或普通参会人进入会议笔记详情时，可查看会议基础信息；当没有可见笔记文件时，文件区域展示空状态“暂无笔记”。普通参会人页面不展示上传按钮，已上传文件仅提供预览入口。
+
+业务规则：
+
+1. 普通参会人只可查看对自己开放的会议笔记文件；无文件或无权限时展示统一空状态。
+2. 空状态应区分“暂无笔记”和“无权限查看”两类业务原因，但默认文案可统一为不泄露权限细节的提示。
+3. 普通参会人不能通过前端构造请求上传、删除、替换或下载文件；服务端必须再次校验角色和会议权限。
+4. 若会议后续新增了对该成员可见的笔记文件，列表和详情应能刷新出新文件。
+
+### 9.14.6 会议笔记-详情页-在线预览.png
+
+<img src="images/会议笔记-详情页-在线预览.png" alt="会议笔记-详情页-在线预览" width="360">
+
+功能说明：
+
+当文件支持在线预览时，文件项右侧展示“预览”按钮，文件状态显示“在线预览”。点击后进入文件预览页；不支持预览的文件仍展示下载按钮。
+
+业务规则：
+
+1. 支持预览的文件类型至少包括 PDF 和常见图片，Office 文档是否预览取决于后端转换能力。
+2. 预览状态由服务端返回，客户端不得仅按扩展名判断是否可预览。
+3. 预览入口和下载入口都需要受文件权限控制；预览失败时应允许用户回到详情页并选择下载。
+4. 预览文件应使用短期授权地址或受控文件接口，禁止暴露长期有效的公开下载链接。
+
+### 9.14.7 会议笔记-详情页-文件下载中.png
+
+<img src="images/会议笔记-详情页-文件下载中.png" alt="会议笔记-详情页-文件下载中" width="360">
+
+功能说明：
+
+文件下载过程中，当前文件项展示“正在下载”、进度条和“取消”按钮；其他文件仍保持可下载状态。
+
+业务规则：
+
+1. 每个文件需独立展示下载进度、成功、失败和取消状态。
+2. 下载中允许取消，取消后应停止网络请求并恢复可下载状态；已完成文件可进入系统打开或本地文件管理流程。
+3. 下载失败需展示可重试状态，并保留失败原因用于问题排查。
+4. 后台、断网、弱网场景下应保存下载任务状态，恢复网络后按产品策略继续或提示重试。
+
+### 9.14.8 会议笔记-文件预览.png
+
+<img src="images/会议笔记-文件预览.png" alt="会议笔记-文件预览" width="360">
+
+功能说明：
+
+文件预览页展示文档内容，顶部提供返回、标题和更多菜单。预览区域展示页码进度，例如 `1/213`；更多菜单包含举报和分享操作。
+
+业务规则：
+
+1. 文件预览页应支持多页文档翻页、缩放、滑动浏览和加载失败重试。
+2. 页码、加载状态和错误状态必须与当前文件一致，切换文件或返回详情页后应清理旧状态。
+3. 分享权限由会议和文件权限共同决定；无分享权限时隐藏分享入口或提示无权限。
+4. 举报入口用于举报文件内容或会议资料，提交后应关联会议 ID、文件 ID、上传人和当前查看人。
+5. 预览页不得缓存超出权限有效期的文件内容；退出登录、切换企业或权限被收回后必须清理本地可访问副本。
+
+## 合并建议
+
+1. 合并到 `IM-产品原型需求文档.md` 时，建议将本章插入到第 9 章“企业工作台与办公协同”的 `9.13 总经理信箱-文案提示.png` 之后。
+2. 如果主文档继续按图片顺序编号，可将本章编号调整为 `9.14` 至 `9.21`；如果按业务模块编号，可保留 `9.14.x` 子编号。
+3. 本文档引用的图片已经复制到 `docs/images/`，文件名均以 `会议笔记-` 开头，避免与现有 `工作台.png` 等图片重名。