HRM-10/db/Script/Calendar_DB_Changes.sql

145 lines
8.2 KiB
MySQL
Raw Normal View History

2026-11-03 13:06:00 +06:00
/* =====================================================================
Calendar_DB_Changes.sql
HRM Calendar (Google-Calendar-like): Event / Task / Schedule Job
items and their attendees. Two tables only.
- IDs are generated by the application (tc.GenerateID), no IDENTITY.
- Re-runnable: every object is created only if it does not exist yet.
- Run once per database, before deploying the Calendar code.
Hangfire's own tables (schema "HangFire") are NOT created here; Hangfire
creates them itself on first start (Phase 2). If the production DB user
has no DDL rights, run Hangfire's Install.sql manually at that point.
===================================================================== */
SET ANSI_NULLS ON;
SET QUOTED_IDENTIFIER ON;
GO
/* ---------- 1. dbo.CalendarItem ---------- */
IF OBJECT_ID(N'dbo.CalendarItem', N'U') IS NULL
BEGIN
CREATE TABLE dbo.CalendarItem (
CalendarItemID INT NOT NULL,
ItemType TINYINT NOT NULL, -- 1 Event, 2 Task, 3 ScheduleJob
Title NVARCHAR(250) NOT NULL,
Description NVARCHAR(MAX) NULL,
Location NVARCHAR(500) NULL,
Color VARCHAR(20) NULL,
Priority TINYINT NULL, -- 1 Low, 2 Normal, 3 High
StartDateTime DATETIME NOT NULL,
EndDateTime DATETIME NOT NULL,
IsAllDay BIT NOT NULL CONSTRAINT DF_CalendarItem_IsAllDay DEFAULT (0),
RecurrenceRule VARCHAR(500) NULL, -- RFC 5545 RRULE
RecurrenceEndDate DATETIME NULL, -- NULL = never ends
ExceptionDates VARCHAR(MAX) NULL, -- 'yyyy-MM-dd,yyyy-MM-dd'
ReminderOffsets VARCHAR(100) NULL, -- minutes before, e.g. '4320,60'
ReminderChannel TINYINT NULL, -- 1 Bell, 2 Mail, 3 Both
NextTriggerAt DATETIME NULL, -- next reminder (Event/Task) or next run (ScheduleJob)
SourceItemID INT NULL, -- task created by this ScheduleJob
SourceOccurrence DATETIME NULL,
OutlookSequence INT NOT NULL CONSTRAINT DF_CalendarItem_OutlookSequence DEFAULT (0),
OutlookEventID NVARCHAR(200) NULL, -- Microsoft Graph event id (later phase)
PayrollTypeID INT NOT NULL,
Status TINYINT NOT NULL CONSTRAINT DF_CalendarItem_Status DEFAULT (1), -- 1 Active, 2 Cancelled, 3 Completed
CreatedBy INT NOT NULL, -- organizer (UserID)
CreatedDate DATETIME NOT NULL,
ModifiedBy INT NULL,
ModifiedDate DATETIME NULL,
CONSTRAINT PK_CalendarItem PRIMARY KEY (CalendarItemID),
CONSTRAINT FK_CalendarItem_Source FOREIGN KEY (SourceItemID) REFERENCES dbo.CalendarItem (CalendarItemID),
CONSTRAINT CK_CalendarItem_Dates CHECK (EndDateTime >= StartDateTime),
CONSTRAINT CK_CalendarItem_ItemType CHECK (ItemType IN (1, 2, 3)),
CONSTRAINT CK_CalendarItem_Priority CHECK (Priority IS NULL OR Priority IN (1, 2, 3)),
CONSTRAINT CK_CalendarItem_Channel CHECK (ReminderChannel IS NULL OR ReminderChannel IN (1, 2, 3)),
CONSTRAINT CK_CalendarItem_Status CHECK (Status IN (1, 2, 3))
);
END
GO
/* calendar feed: items overlapping a date range */
IF NOT EXISTS (SELECT 1 FROM sys.indexes WHERE name = 'IX_CalendarItem_Range' AND object_id = OBJECT_ID('dbo.CalendarItem'))
CREATE INDEX IX_CalendarItem_Range ON dbo.CalendarItem (StartDateTime, RecurrenceEndDate)
INCLUDE (ItemType, Status, PayrollTypeID);
GO
/* Hangfire dispatcher: reminders and schedule-job runs that are due */
IF NOT EXISTS (SELECT 1 FROM sys.indexes WHERE name = 'IX_CalendarItem_NextTriggerAt' AND object_id = OBJECT_ID('dbo.CalendarItem'))
CREATE INDEX IX_CalendarItem_NextTriggerAt ON dbo.CalendarItem (NextTriggerAt)
INCLUDE (ItemType)
WHERE NextTriggerAt IS NOT NULL AND Status = 1;
GO
/* one schedule-job run can create its task only once */
IF NOT EXISTS (SELECT 1 FROM sys.indexes WHERE name = 'UX_CalendarItem_Source' AND object_id = OBJECT_ID('dbo.CalendarItem'))
CREATE UNIQUE INDEX UX_CalendarItem_Source ON dbo.CalendarItem (SourceItemID, SourceOccurrence)
WHERE SourceItemID IS NOT NULL;
GO
/* ---------- 2. dbo.CalendarItemAttendee ---------- */
IF OBJECT_ID(N'dbo.CalendarItemAttendee', N'U') IS NULL
BEGIN
CREATE TABLE dbo.CalendarItemAttendee (
AttendeeID INT NOT NULL,
CalendarItemID INT NOT NULL,
AttendeeType TINYINT NOT NULL, -- 1 Employee, 2 User, 3 Department
EmployeeID INT NULL,
UserID INT NULL,
DepartmentID INT NULL,
Email NVARCHAR(200) NULL,
Role TINYINT NOT NULL CONSTRAINT DF_CalAtt_Role DEFAULT (2), -- 1 Organizer, 2 Required, 3 Optional, 4 Assignee
TitleOverride NVARCHAR(250) NULL,
SubjectOverride NVARCHAR(250) NULL,
FromOverride DATETIME NULL,
ToOverride DATETIME NULL,
ResponseStatus TINYINT NOT NULL CONSTRAINT DF_CalAtt_Response DEFAULT (0), -- 0 Pending, 1 Accepted, 2 Declined, 3 Tentative
TaskStatus TINYINT NULL, -- 0 NotStarted, 1 InProgress, 2 Done
Remarks NVARCHAR(2000) NULL,
RemarksDate DATETIME NULL,
IsRead BIT NOT NULL CONSTRAINT DF_CalAtt_IsRead DEFAULT (0),
ReadDate DATETIME NULL,
LastReminderAt DATETIME NULL,
InviteSentSequence INT NULL,
Status TINYINT NOT NULL CONSTRAINT DF_CalAtt_Status DEFAULT (1), -- 1 Active, 2 Removed
CreatedBy INT NOT NULL,
CreatedDate DATETIME NOT NULL,
ModifiedBy INT NULL,
ModifiedDate DATETIME NULL,
CONSTRAINT PK_CalendarItemAttendee PRIMARY KEY (AttendeeID),
CONSTRAINT FK_CalAtt_Item FOREIGN KEY (CalendarItemID) REFERENCES dbo.CalendarItem (CalendarItemID),
CONSTRAINT CK_CalAtt_Target CHECK (
(AttendeeType = 1 AND EmployeeID IS NOT NULL)
OR (AttendeeType = 2 AND UserID IS NOT NULL)
OR (AttendeeType = 3 AND DepartmentID IS NOT NULL))
);
END
GO
/* same person / department only once per item */
IF NOT EXISTS (SELECT 1 FROM sys.indexes WHERE name = 'UX_CalAtt_Employee' AND object_id = OBJECT_ID('dbo.CalendarItemAttendee'))
CREATE UNIQUE INDEX UX_CalAtt_Employee ON dbo.CalendarItemAttendee (CalendarItemID, EmployeeID) WHERE EmployeeID IS NOT NULL;
GO
IF NOT EXISTS (SELECT 1 FROM sys.indexes WHERE name = 'UX_CalAtt_User' AND object_id = OBJECT_ID('dbo.CalendarItemAttendee'))
CREATE UNIQUE INDEX UX_CalAtt_User ON dbo.CalendarItemAttendee (CalendarItemID, UserID) WHERE UserID IS NOT NULL;
GO
IF NOT EXISTS (SELECT 1 FROM sys.indexes WHERE name = 'UX_CalAtt_Department' AND object_id = OBJECT_ID('dbo.CalendarItemAttendee'))
CREATE UNIQUE INDEX UX_CalAtt_Department ON dbo.CalendarItemAttendee (CalendarItemID, DepartmentID) WHERE DepartmentID IS NOT NULL;
GO
/* "my calendar": items where I am an attendee */
IF NOT EXISTS (SELECT 1 FROM sys.indexes WHERE name = 'IX_CalAtt_EmployeeLookup' AND object_id = OBJECT_ID('dbo.CalendarItemAttendee'))
CREATE INDEX IX_CalAtt_EmployeeLookup ON dbo.CalendarItemAttendee (EmployeeID, Status)
INCLUDE (CalendarItemID, ResponseStatus, TaskStatus);
GO
IF NOT EXISTS (SELECT 1 FROM sys.indexes WHERE name = 'IX_CalAtt_UserLookup' AND object_id = OBJECT_ID('dbo.CalendarItemAttendee'))
CREATE INDEX IX_CalAtt_UserLookup ON dbo.CalendarItemAttendee (UserID, Status)
INCLUDE (CalendarItemID, ResponseStatus);
GO