feat(collaboration): 完善在线文档协作与通知闭环
- 新增协作文件夹、文件、不可变修订、成员、会话、回调回执、编辑申请与分享链接数据模型。 - 补齐新建、导入、复制、下载、回收站、恢复、成员授权、所有权转让及文件级权限接口。 - 接入 ONLYOFFICE 共同编辑、历史版本预览与恢复、修订另存副本、导出下载审计和幂等回调保存。 - 增加编辑权限申请、审批通知、项目提醒聚合、通知 Feed、已读处理及历史待办数据回填。 - 支持公开分享的查看或编辑模式、有效期、密码哈希、失败锁定、短时访问凭证与固定分享地址。 - 增加协作者导出、申请编辑、工作表结构保护和所有权管理策略，并纳入项目接口权限矩阵。 - 新增协作文件库、编辑工作区、公开分享页、下载与另存为对话框，以及导航、路由和权限入口。 - 统一网页端与桌面端通知布局，增加沉浸式工作区和浏览器、Tauri 双端全屏能力。 - 扩展运行时文件下载适配、Tauri 环境识别和原生全屏命令，继续保持业务代码运行时边界。 - 加固 ONLYOFFICE 消息桥的同源下载、签名地址隔离和保存为能力校验，并更新桌面发布检查。 - 增加连续数据库迁移、50MB 上传限制、OnlyOffice 中文文案与开发启动路由校验。 - 补充协作、通知、权限、路由、运行时、布局和 OnlyOffice 相关测试及模块说明文档。
This commit is contained in:
Cheng Zhou
@@ -0,0 +1,174 @@
|
||||
import { beforeEach, describe, expect, it, vi } from "vitest";
|
||||
|
||||
const apiGet = vi.fn();
|
||||
const apiPost = vi.fn();
|
||||
const apiPut = vi.fn();
|
||||
const apiPatch = vi.fn();
|
||||
const apiDelete = vi.fn();
|
||||
|
||||
vi.mock("./axios", () => ({ apiGet, apiPost, apiPut, apiPatch, apiDelete }));
|
||||
|
||||
describe("collaboration API", () => {
|
||||
beforeEach(() => vi.clearAllMocks());
|
||||
|
||||
it("keeps editor configuration outside request dedupe and desktop cache", async () => {
|
||||
const { fetchCollaborationEditorConfig } = await import("./collaboration");
|
||||
fetchCollaborationEditorConfig("study-1", "file-1");
|
||||
expect(apiGet).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/editor-config",
|
||||
{
|
||||
cache: false,
|
||||
disableRequestDedupe: true,
|
||||
disableNetworkRetry: true,
|
||||
suppressErrorMessage: true,
|
||||
},
|
||||
);
|
||||
});
|
||||
|
||||
it("uses an independent collaboration namespace", async () => {
|
||||
const { createCollaborationFile, fetchCollaborationFiles } = await import("./collaboration");
|
||||
createCollaborationFile("study-1", { title: "方案", file_type: "word" });
|
||||
fetchCollaborationFiles("study-1", { keyword: "方案" });
|
||||
expect(apiPost).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files",
|
||||
{ title: "方案", file_type: "word" },
|
||||
);
|
||||
expect(apiGet).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files",
|
||||
{ params: { keyword: "方案" } },
|
||||
);
|
||||
});
|
||||
|
||||
it("records a completed Save As operation for audit", async () => {
|
||||
const { recordCollaborationExport } = await import("./collaboration");
|
||||
recordCollaborationExport("study-1", "file-1", "xlsx");
|
||||
expect(apiPost).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/exports",
|
||||
{ file_type: "xlsx" },
|
||||
);
|
||||
});
|
||||
|
||||
it("records a completed local download separately from workspace Save As", async () => {
|
||||
const { recordCollaborationDownload } = await import("./collaboration");
|
||||
recordCollaborationDownload("study-1", "file-1", "xlsx");
|
||||
expect(apiPost).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/downloads",
|
||||
{ file_type: "xlsx" },
|
||||
);
|
||||
});
|
||||
|
||||
it("copies and downloads collaboration files through authenticated endpoints", async () => {
|
||||
const { copyCollaborationFile, downloadCollaborationFile } = await import("./collaboration");
|
||||
copyCollaborationFile("study-1", "file-1");
|
||||
downloadCollaborationFile("study-1", "file-1");
|
||||
expect(apiPost).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/copy",
|
||||
);
|
||||
expect(apiGet).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/download",
|
||||
{
|
||||
responseType: "blob",
|
||||
cache: false,
|
||||
suppressErrorMessage: true,
|
||||
},
|
||||
);
|
||||
});
|
||||
|
||||
it("always reloads revision history without cache or pending-request reuse", async () => {
|
||||
const { fetchCollaborationRevisions } = await import("./collaboration");
|
||||
fetchCollaborationRevisions("study-1", "file-1");
|
||||
expect(apiGet).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/revisions",
|
||||
{ cache: false, disableRequestDedupe: true },
|
||||
);
|
||||
});
|
||||
|
||||
it("supports naming, copying, and deleting a selected historical revision", async () => {
|
||||
const { copyCollaborationRevision, deleteCollaborationRevision, updateCollaborationRevision } = await import("./collaboration");
|
||||
updateCollaborationRevision("study-1", "file-1", "revision-2", { change_summary: "送审版" });
|
||||
copyCollaborationRevision("study-1", "file-1", "revision-2", { title: "方案-R2.docx", folder_id: "folder-2" });
|
||||
deleteCollaborationRevision("study-1", "file-1", "revision-2");
|
||||
expect(apiPatch).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/revisions/revision-2",
|
||||
{ change_summary: "送审版" },
|
||||
);
|
||||
expect(apiPost).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/revisions/revision-2/copy",
|
||||
{ title: "方案-R2.docx", folder_id: "folder-2" },
|
||||
);
|
||||
expect(apiDelete).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/revisions/revision-2",
|
||||
);
|
||||
});
|
||||
|
||||
it("keeps share tokens in a redacted request header and public requests outside auth recovery", async () => {
|
||||
const {
|
||||
fetchCollaborationShareLink,
|
||||
fetchPublicCollaborationShareMetadata,
|
||||
updateCollaborationShareLink,
|
||||
verifyPublicCollaborationSharePassword,
|
||||
} = await import("./collaboration");
|
||||
fetchCollaborationShareLink("study-1", "file-1");
|
||||
updateCollaborationShareLink("study-1", "file-1", {
|
||||
enabled: true,
|
||||
access_mode: "EDIT",
|
||||
expiry_policy: "SEVEN_DAYS",
|
||||
password_mode: "SET",
|
||||
password: "1234",
|
||||
});
|
||||
fetchPublicCollaborationShareMetadata("share-secret");
|
||||
verifyPublicCollaborationSharePassword("share-secret", "1234");
|
||||
|
||||
expect(apiGet).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/share-link",
|
||||
{ cache: false, disableRequestDedupe: true },
|
||||
);
|
||||
expect(apiPut).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/share-link",
|
||||
expect.objectContaining({ enabled: true, expiry_policy: "SEVEN_DAYS", password: "1234" }),
|
||||
);
|
||||
const publicConfig = expect.objectContaining({
|
||||
headers: { "X-CTMS-Share-Token": "share-secret" },
|
||||
publicRequest: true,
|
||||
cache: false,
|
||||
disableRequestDedupe: true,
|
||||
disableNetworkRetry: true,
|
||||
suppressErrorMessage: true,
|
||||
invalidateCache: false,
|
||||
});
|
||||
expect(apiGet).toHaveBeenCalledWith("/api/v1/collaboration/shares/metadata", publicConfig);
|
||||
expect(apiPost).toHaveBeenCalledWith(
|
||||
"/api/v1/collaboration/shares/access",
|
||||
{ password: "1234" },
|
||||
publicConfig,
|
||||
);
|
||||
});
|
||||
|
||||
it("supports edit-request approval and contact ownership transfer", async () => {
|
||||
const {
|
||||
createCollaborationEditRequest,
|
||||
fetchCollaborationEditRequests,
|
||||
resolveCollaborationEditRequest,
|
||||
transferCollaborationOwnership,
|
||||
} = await import("./collaboration");
|
||||
createCollaborationEditRequest("study-1", "file-1");
|
||||
fetchCollaborationEditRequests("study-1", "file-1");
|
||||
resolveCollaborationEditRequest("study-1", "file-1", "request-1", "APPROVED");
|
||||
transferCollaborationOwnership("study-1", "file-1", "user-2");
|
||||
expect(apiPost).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/edit-requests",
|
||||
);
|
||||
expect(apiGet).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/edit-requests",
|
||||
{ cache: false, disableRequestDedupe: true },
|
||||
);
|
||||
expect(apiPost).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/edit-requests/request-1/resolve",
|
||||
{ status: "APPROVED" },
|
||||
);
|
||||
expect(apiPost).toHaveBeenCalledWith(
|
||||
"/api/v1/studies/study-1/collaboration/files/file-1/transfer-ownership",
|
||||
{ new_owner_id: "user-2" },
|
||||
);
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user