update docs

web-server/database/02_schema.sql

@@ -9,6 +9,7 @@ IF OBJECT_ID(N'dbo.ApplicationPackages', N'U') IS NOT NULL
     OR OBJECT_ID(N'dbo.PackageVersions', N'U') IS NOT NULL
     OR OBJECT_ID(N'dbo.Applications', N'U') IS NOT NULL
     OR OBJECT_ID(N'dbo.Packages', N'U') IS NOT NULL
+    OR OBJECT_ID(N'dbo.Documents', N'U') IS NOT NULL
     OR OBJECT_ID(N'dbo.EmailConfirmationTokens', N'U') IS NOT NULL
     OR OBJECT_ID(N'dbo.Users', N'U') IS NOT NULL
 BEGIN
@@ -54,6 +55,37 @@ CREATE TABLE dbo.EmailConfirmationTokens
 );
 GO
 
+CREATE TABLE dbo.Documents
+(
+    Id UNIQUEIDENTIFIER NOT NULL
+        CONSTRAINT PK_Documents PRIMARY KEY CLUSTERED
+        CONSTRAINT DF_Documents_Id DEFAULT NEWSEQUENTIALID(),
+    Title NVARCHAR(200) NOT NULL,
+    Category NVARCHAR(50) NOT NULL
+        CONSTRAINT DF_Documents_Category DEFAULT N'other',
+    Summary NVARCHAR(1000) NULL,
+    Content NVARCHAR(MAX) NULL,
+    FilePath NVARCHAR(1000) NULL,
+    OriginalFileName NVARCHAR(260) NULL,
+    MimeType NVARCHAR(200) NULL,
+    FileSizeBytes BIGINT NULL,
+    CreatedByUserId UNIQUEIDENTIFIER NOT NULL,
+    CreatedAt DATETIME2(3) NOT NULL
+        CONSTRAINT DF_Documents_CreatedAt DEFAULT SYSUTCDATETIME(),
+    UpdatedAt DATETIME2(3) NULL,
+    CONSTRAINT FK_Documents_CreatedByUser
+        FOREIGN KEY (CreatedByUserId) REFERENCES dbo.Users(Id),
+    CONSTRAINT CK_Documents_Title_NotBlank CHECK (LEN(LTRIM(RTRIM(Title))) > 0),
+    CONSTRAINT CK_Documents_Category CHECK (
+        Category IN (N'introduction', N'guide', N'user-guide', N'technical', N'policy', N'other')
+    ),
+    CONSTRAINT CK_Documents_FileSizeBytes CHECK (FileSizeBytes IS NULL OR FileSizeBytes >= 0),
+    CONSTRAINT CK_Documents_HasReadableContent CHECK (
+        NULLIF(LTRIM(RTRIM(Content)), N'') IS NOT NULL OR FilePath IS NOT NULL
+    )
+);
+GO
+
 CREATE TABLE dbo.Packages
 (
     Id UNIQUEIDENTIFIER NOT NULL
@@ -164,6 +196,13 @@ CREATE INDEX IX_EmailConfirmationTokens_UserId
 ON dbo.EmailConfirmationTokens(UserId);
 GO
 
+CREATE INDEX IX_Documents_Category_UpdatedAt
+ON dbo.Documents(Category, UpdatedAt DESC, CreatedAt DESC);
+
+CREATE INDEX IX_Documents_CreatedByUserId
+ON dbo.Documents(CreatedByUserId);
+GO
+
 CREATE UNIQUE INDEX UX_Packages_PackageCode ON dbo.Packages(PackageCode);
 CREATE INDEX IX_Packages_CreatedByUserId ON dbo.Packages(CreatedByUserId);
 CREATE INDEX IX_Packages_PackageType ON dbo.Packages(PackageType);