feat(server): filter docs by access role (#12311)

close CLOUD-208

<!-- This is an auto-generated comment: release notes by coderabbit.ai -->
## Summary by CodeRabbit

- **New Features**
  - Enhanced document access control with batch permission checks, enabling efficient filtering of documents based on user roles and permissions.
  - Added detailed document-level role and permission management for workspace users.
- **Bug Fixes**
  - Improved accuracy in filtering search results to only display documents users have permission to read.
- **Tests**
  - Added comprehensive tests for document-level permission filtering and search result accuracy.
  - Introduced new mock utilities to support permission-related test scenarios.
- **Refactor**
  - Simplified and optimized permission logic for determining user roles and document access.
- **Documentation**
  - Updated type definitions for improved clarity in permission handling.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

packages/backend/server/src/__tests__/mocks/doc-user.mock.ts

@@ -0,0 +1,16 @@
+import type { WorkspaceDocUserRole } from '@prisma/client';
+import { Prisma } from '@prisma/client';
+
+import { Mocker } from './factory';
+
+export type MockDocUserInput = Prisma.WorkspaceDocUserRoleUncheckedCreateInput;
+
+export type MockedDocUser = WorkspaceDocUserRole;
+
+export class MockDocUser extends Mocker<MockDocUserInput, MockedDocUser> {
+  override async create(input: MockDocUserInput) {
+    return await this.db.workspaceDocUserRole.create({
+      data: input,
+    });
+  }
+}

packages/backend/server/src/__tests__/mocks/index.ts

@@ -7,6 +7,7 @@ export * from './workspace-user.mock';
 import { MockCopilotProvider } from './copilot.mock';
 import { MockDocMeta } from './doc-meta.mock';
 import { MockDocSnapshot } from './doc-snapshot.mock';
+import { MockDocUser } from './doc-user.mock';
 import { MockEventBus } from './eventbus.mock';
 import { MockMailer } from './mailer.mock';
 import { MockJobQueue } from './queue.mock';
@@ -24,6 +25,7 @@ export const Mockers = {
   UserSettings: MockUserSettings,
   DocMeta: MockDocMeta,
   DocSnapshot: MockDocSnapshot,
+  DocUser: MockDocUser,
 };
 
 export { MockCopilotProvider, MockEventBus, MockJobQueue, MockMailer };