T04: DMS plugin backend — folders + files + preview + OnlyOffice + shares + search + bulk — 106 tests, 97.90% coverage

app/plugins/builtins/__init__.py

@@ -7,8 +7,9 @@ Subdirectory plugins (tags, permissions, entity_links) export their plugin
 class via __init__.py so the registry can discover them as packages.
 """
 
+from app.plugins.builtins.dms import DmsPlugin
 from app.plugins.builtins.entity_links import EntityLinksPlugin
 from app.plugins.builtins.permissions import PermissionsPlugin
 from app.plugins.builtins.tags import TagsPlugin
 
-__all__ = ["TagsPlugin", "PermissionsPlugin", "EntityLinksPlugin"]
+__all__ = ["TagsPlugin", "PermissionsPlugin", "EntityLinksPlugin", "DmsPlugin"]

app/plugins/builtins/dms/__init__.py

@@ -0,0 +1,5 @@
+"""DMS builtin plugin."""
+
+from app.plugins.builtins.dms.plugin import DmsPlugin
+
+__all__ = ["DmsPlugin"]

app/plugins/builtins/dms/migrations/0001_initial.sql

@@ -0,0 +1,30 @@
+-- DMS plugin initial migration: creates folders and files tables
+CREATE TABLE IF NOT EXISTS folders (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name VARCHAR(255) NOT NULL,
+    parent_id UUID REFERENCES folders(id) ON DELETE CASCADE,
+    tenant_id UUID NOT NULL,
+    created_by UUID NOT NULL,
+    deleted_at TIMESTAMPTZ,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+CREATE INDEX IF NOT EXISTS ix_folders_parent ON folders(parent_id);
+CREATE INDEX IF NOT EXISTS ix_folders_tenant ON folders(tenant_id);
+
+CREATE TABLE IF NOT EXISTS files (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name VARCHAR(255) NOT NULL,
+    folder_id UUID REFERENCES folders(id) ON DELETE SET NULL,
+    tenant_id UUID NOT NULL,
+    uploaded_by UUID NOT NULL,
+    mime_type VARCHAR(255) NOT NULL,
+    size_bytes BIGINT NOT NULL,
+    storage_path VARCHAR(1024) NOT NULL,
+    deleted_at TIMESTAMPTZ,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+CREATE INDEX IF NOT EXISTS ix_files_folder ON files(folder_id);
+CREATE INDEX IF NOT EXISTS ix_files_tenant ON files(tenant_id);
+CREATE INDEX IF NOT EXISTS ix_files_name ON files(name);

app/plugins/builtins/dms/models.py

@@ -0,0 +1,67 @@
+"""Folder and File models for the DMS plugin."""
+
+from __future__ import annotations
+
+import uuid
+from datetime import datetime
+
+from sqlalchemy import DateTime, ForeignKey, Index, Integer, String, UniqueConstraint
+from sqlalchemy.dialects.postgresql import UUID as PGUUID
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.core.db import Base, TenantMixin
+
+
+class Folder(Base, TenantMixin):
+    """Folder entity — hierarchical, tenant-scoped, soft-deletable."""
+
+    __tablename__ = "folders"
+    __table_args__ = (
+        UniqueConstraint(
+            "tenant_id",
+            "name",
+            "parent_id",
+            name="uq_folders_tenant_name_parent",
+            # Partial uniqueness only for non-deleted folders is handled at app level
+        ),
+        Index("ix_folders_parent", "parent_id"),
+        Index("ix_folders_tenant", "tenant_id"),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        PGUUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    name: Mapped[str] = mapped_column(String(255), nullable=False)
+    parent_id: Mapped[uuid.UUID | None] = mapped_column(
+        PGUUID(as_uuid=True),
+        ForeignKey("folders.id", ondelete="CASCADE"),
+        nullable=True,
+    )
+    created_by: Mapped[uuid.UUID] = mapped_column(PGUUID(as_uuid=True), nullable=False)
+    deleted_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
+
+
+class File(Base, TenantMixin):
+    """File entity — stored on disk, tenant-scoped, soft-deletable."""
+
+    __tablename__ = "files"
+    __table_args__ = (
+        Index("ix_files_folder", "folder_id"),
+        Index("ix_files_tenant", "tenant_id"),
+        Index("ix_files_name", "name"),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        PGUUID(as_uuid=True), primary_key=True, default=uuid.uuid4
+    )
+    name: Mapped[str] = mapped_column(String(255), nullable=False)
+    folder_id: Mapped[uuid.UUID | None] = mapped_column(
+        PGUUID(as_uuid=True),
+        ForeignKey("folders.id", ondelete="SET NULL"),
+        nullable=True,
+    )
+    uploaded_by: Mapped[uuid.UUID] = mapped_column(PGUUID(as_uuid=True), nullable=False)
+    mime_type: Mapped[str] = mapped_column(String(255), nullable=False)
+    size_bytes: Mapped[int] = mapped_column(Integer, nullable=False)
+    storage_path: Mapped[str] = mapped_column(String(1024), nullable=False)
+    deleted_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)

app/plugins/builtins/dms/plugin.py

@@ -0,0 +1,28 @@
+"""DMS plugin — folders, files, preview, OnlyOffice, internal sharing, search, bulk ops."""
+
+from __future__ import annotations
+
+from app.plugins.base import BasePlugin
+from app.plugins.manifest import PluginManifest, PluginRouteDef
+
+
+class DmsPlugin(BasePlugin):
+    """DMS plugin for document management: folders, files, preview, sharing."""
+
+    manifest = PluginManifest(
+        name="dms",
+        version="1.0.0",
+        display_name="DMS",
+        description="Document management: folder hierarchy, file upload, PDF preview, OnlyOffice edit sessions, internal sharing, search, bulk ops.",
+        dependencies=["permissions"],
+        routes=[
+            PluginRouteDef(
+                path="/api/v1/dms",
+                module="app.plugins.builtins.dms.routes",
+                router_attr="router",
+            ),
+        ],
+        events=[],
+        migrations=["0001_initial.sql"],
+        permissions=[],
+    )

app/plugins/builtins/dms/schemas.py

@@ -0,0 +1,70 @@
+"""Pydantic schemas for the DMS plugin."""
+
+from __future__ import annotations
+
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class FolderCreate(BaseModel):
+    name: str = Field(..., min_length=1, max_length=255)
+    parent_id: str | None = None
+
+
+class FolderUpdate(BaseModel):
+    name: str | None = Field(None, min_length=1, max_length=255)
+    parent_id: str | None = None
+
+
+class FolderResponse(BaseModel):
+    id: str
+    name: str
+    parent_id: str | None = None
+    created_by: str
+    deleted_at: datetime | None = None
+    path: str = ""
+    children: list[dict] = []
+
+
+class FileMetadataResponse(BaseModel):
+    id: str
+    name: str
+    folder_id: str | None = None
+    uploaded_by: str
+    mime_type: str
+    size_bytes: int
+    storage_path: str
+    deleted_at: datetime | None = None
+    created_at: datetime | None = None
+    updated_at: datetime | None = None
+
+
+class FileUpdate(BaseModel):
+    name: str | None = Field(None, min_length=1, max_length=255)
+    folder_id: str | None = None
+
+
+class ShareRequest(BaseModel):
+    user_ids: list[str] = Field(default_factory=list)
+    group_ids: list[str] = Field(default_factory=list)
+    access_level: str = Field("read", pattern="^(read|write)$")
+
+
+class ShareRemoveRequest(BaseModel):
+    user_id: str | None = None
+    group_id: str | None = None
+
+
+class BulkMoveRequest(BaseModel):
+    file_ids: list[str] = Field(..., min_length=1)
+    target_folder_id: str | None = None
+
+
+class BulkDeleteRequest(BaseModel):
+    file_ids: list[str] = Field(..., min_length=1)
+
+
+class OnlyOfficeConfig(BaseModel):
+    document: dict
+    editorConfig: dict  # noqa: N815