解决方案路径
从首次接入，到多系统复用和规模化运行01 / 业务挑战
多系统接入难，不只是把同一段代码复制多次
OA、网盘和 IM 都有自己的用户、文件、权限和流程。真正需要统一的是文档接入方式，不是业务数据。
核心方案统一维护共性接入逻辑
每个系统各自建设一套文档接入
通用文档链路统一建设和维护
每个入口分别处理参数、回调和异常
共性接入逻辑统一建设和维护
不同系统的预览和编辑体验不一致
多个入口使用一致的在线文档体验
为了复用能力而混用业务数据
各系统独立管理自己的用户、文件和权限
02 / 方案架构
把共性能力放在中间，把业务差异留在各系统
统一的是接入方式、在线文档体验和事件处理；各业务系统继续管理自己的用户、文件、权限和流程。
OA、网盘、IM 与其他应用提供业务页面、用户身份、文件入口和具体工作流程。
OA网盘IM其他
企业集成服务
上下文、事件与异常的统一封装
映射用户、文件、权限和业务回调，沉淀可复用的接入方式。
石墨文档中台
一致的预览、编辑与协作体验
为多个业务入口提供统一的在线文档处理能力。
事件回到原业务入口
各应用的数据和权限独立管理共享文档能力不等于共享业务数据，权限结果仍由业务规则决定。用户、文件、权限和流程由各系统独立管理
业务系统负责用户、文件、流程、权限和审计决策；企业集成服务是业务方已有或项目中建设的集成层，负责上下文映射、接口封装、事件接收和异常处理；石墨文档中台提供在线预览、编辑与协作能力。企业集成服务的具体建设与运维归属需要在项目评估中确认。
03 / 应用场景
从一个入口扩展到一组业务系统
适合多个系统都需要文档处理能力，但又不能把业务数据和权限规则混在一起的组织。
文件在原目录中打开即可协作
网盘继续管理目录、存储和权限，用户不再因下载上传中断文件链路。
角色网盘使用者
入口 / 流程网盘原目录
文件对象目录内文件
处理动作打开并协作
完成结果目录、存储和权限仍由网盘管理
在正文和附件中直接协作
起草、审阅和审批留在同一业务链路，协作结果回到原流程。
角色OA 经办人
入口 / 流程OA 正文或附件
文件对象流程文稿
处理动作起草、审阅和审批
完成结果结果回到原流程
消息里的文件点开后继续协作
讨论、文件处理和结果通知留在同一会话上下文中。
角色IM 会话成员
入口 / 流程IM 会话
文件对象消息文件
处理动作打开并继续协作
完成结果结果通知留在会话
复用标准链路，只补充场景差异
项目、知识或其他系统聚焦上下文映射和业务验收。
角色业务系统使用者
入口 / 流程项目、知识等系统
文件对象场景文件
处理动作补充上下文映射
完成结果按业务场景验收
04 / 核心能力
四项通用能力，支撑多个业务入口持续复用
共性能力集中维护，新入口只需要完成自身业务映射和场景验收。
开放接口全景
一套开放接口，从页面嵌入延伸到深度业务集成
前端 JS-API、石墨后端 API 和接入方回调分层配合，按场景组合文件、内容、组织权限和事件服务。
前端稳定可调用方法
覆盖选区、内容、样式、评论、版本和套件对象
后端与回调接口
覆盖文件生命周期、组织权限、搜索和事件通知
在线文档套件统一开放
文档、文稿、表格、幻灯片、应用表格和表单
嵌入、界面、内容与套件对象操作
创建、预览、导入导出和内容处理
用户、文件、权限、组织、搜索与事件接收
统计自石墨文档中台开发文档；已排除前端废弃和明确待复测方法。具体范围以实际版本、终端和开通情况为准。
本方案的接口组合
复用标准链路
新入口不再从零建设通用链路
首次接入沉淀参数、接口、事件和异常处理基线。
每个系统的真实业务上下文得到保留
新入口补充用户、文件、权限和流程映射规则。
共享能力不改变数据和权限边界
各应用继续管理自己的用户、文件、权限和审计数据。
新增系统的完成结果可以单独验收
围绕入口动作、文件处理、事件回流和异常处理形成清单。
05 / 方案价值和收益
多系统从重复建设，走向标准复用
让新系统更快获得在线文档服务，同时保持原有数据归属和管理方式。
通用链路统一维护
接入参数、接口封装、事件接收和异常处理不再分散在多个项目中。
From各做一套
To统一建设
新入口聚焦业务差异
新增系统只补用户、文件、权限和流程映射，不再从零搭建。
From重复接入
To复用标准链路
跨系统体验保持一致
OA、网盘和 IM 中使用一致的预览、编辑与协作方式。
From体验割裂
To使用方式统一
业务数据仍各自管理
共享文档能力不等于共享用户、文件、权限或审计数据。
From边界担忧
To责任清晰
06 / 产品证明
产品界面证明在线文档效果，业务嵌入结果按场景验收
以下截图用于确认文件列表或文档协作界面；OA、网盘、IM 的入口、目录、流程、权限和事件回流需要在对应系统中完成验收。
查看测试文件与文档入口
展示文件列表和在线文档入口，不代表业务网盘的原目录、存储或权限规则。
07 / 评估与咨询
多应用扩展，先确认六条隔离边界
共享的是文档能力，不是业务数据。每个新增入口都要确认自己的上下文和责任。
用户边界
用户由各应用或统一身份体系提供，映射规则需要明确。
文件边界
文件归属、存储和生命周期由对应业务系统管理。
权限边界
权限由业务规则判断，文档中台执行业务系统返回的结果。
事件边界
协作事件回到对应业务链路，由明确的系统消费和记录。
异常边界
能区分业务参数、集成服务、文档中台和部署环境问题。
审计边界
明确哪些操作需要留痕、由谁保存、怎样查询和追溯。