/* ===================================================================== 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