145 lines
8.2 KiB
Transact-SQL
145 lines
8.2 KiB
Transact-SQL
/* =====================================================================
|
|
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
|