docs: scope private ONLYOFFICE integration

This commit is contained in:
lofyer
2026-10-01 13:59:07 +08:00
parent c9d5e63276
commit 9fa8f3e762
6 changed files with 189 additions and 28 deletions
+18 -2
View File
@@ -5,8 +5,8 @@
| 项目 | 内容 |
| --- | --- |
| 状态 | 设计中 |
| 版本 | 0.7 |
| 日期 | 2026-09-30 |
| 版本 | 0.8 |
| 日期 | 2026-10-01 |
| 适用产品 | 独立部署的 ShareServer 与 Web 管理控制台 |
| 关联架构 | [共享网络总体设计](../../../../goodbuddy/docs/architecture/share-network-architecture.md) |
| 关联文档 | [功能逻辑](./logic-design.md)、[管理界面](./ui-design.md)、[技术设计](./technical-design.md) |
@@ -41,6 +41,20 @@
真实目录与组织样例分别展示。API、状态和验证证据分别由技术设计、逻辑设计和实施进度维护。
身份认证、组织授权、内容同步与远程调用仍按以下完整产品范围继续实现。
### Office 私有部署第一阶段(待实现)
在可信私有网络内,先验证浏览器上传 DOCX、打开、编辑、保存到 ShareServer、关闭后重新打开,
以及服务重启后仍能读取已保存内容。采用独立 ONLYOFFICE Document Server 容器,默认使用现有
数据目录下的本地文件存储;不要求先建设身份源、组织数据库、S3/MinIO 或独立 callback worker。
此阶段不提供用户授权或组织隔离,能访问服务的可信使用者可操作试验文档,不适合广泛暴露。
JWT 用于编辑器配置和服务回调校验,不代表浏览器用户已认证;文档与会话关联也不是访问授权。
第一阶段允许 Web 试验入口,完整产品的日常入口仍为 GoodBuddy。XLSX/PPTX、Desktop 文档 Tab、
本地/SSH 回写、Agent 实时编辑、个人/组织归属与权限在后续阶段实现。FR-14 中的多类短期
凭据、组织策略与插件要求属于这些后续能力,不作为本阶段的前置条件。存储和容器契约见
[技术设计第 10.1 节](./technical-design.md#101-私有部署第一阶段待实现),状态规则见
[逻辑设计第 8.2 节](./logic-design.md#82-office-私有部署第一阶段待实现)。
### 3.1 包含
- 本地账号及可配置 OIDC 身份源。
@@ -212,6 +226,8 @@
### FR-14 Office 编辑服务
以下为完整产品目标;私有部署第一阶段按第 3 节的限定范围单独验收,不据此宣称完整 Office 能力已交付。
- 日常文档使用在 GoodBuddy 中完成,ShareServer 主存文档与临时编辑会话分别管理。个人创建者
可删除自己的文档或确认转移给组织;转移后按组织权限删除,原创建者的个人删除权失效。
管理后台展示归属元数据不授予个人正文访问权。原型以显式“组织文档管理员”角色模拟组织