CEL.HRM.5 · Calendar + Hangfire + Outlook · Final plan

HRM Calendar — সম্পূর্ণ পরিকল্পনা

Google Calendar-এর মতো একটা calendar: Event, Task আর Schedule Job তৈরি করা যাবে; attendee-দের নিজের calendar-এ দেখাবে; নির্দিষ্ট দিন আগে Hangfire reminder পাঠাবে; আর Outlook calendar-এও দেখাবে। Holiday, Leave আর Birthday আগের data থেকেই দেখাবে। পুরো feature মাত্র ২টা নতুন table দিয়ে।

২নতুন table
৫Hangfire job
২Outlook mode (ICS / Graph)
৫Development phase

১সংক্ষেপে কী বানাচ্ছি

মূল নীতি: Database-ই একমাত্র সত্য, Hangfire শুধু সময়মতো কাজ চালায়।

Event ও Task

  • সময়, repeat, location, রঙ
  • Attendee / Assignee যোগ
  • সবার calendar-এ দেখায়
  • RSVP, task status, remarks

Reminder (Hangfire)

  • Creator ঠিক করে কতদিন আগে
  • একাধিক reminder (যেমন ৩ দিন + ১ ঘণ্টা)
  • Bell ও / অথবা Mail
  • Decline করলে reminder যায় না

Outlook

  • Invite সরাসরি Outlook calendar-এ
  • সময় বদলালে Outlook-এও বদলায়
  • Cancel করলে Outlook থেকে সরে যায়
  • ICS (সবার জন্য) বা Graph (M365)
Notification log table রাখা হয়নি (আপনার সিদ্ধান্ত অনুযায়ী)। তার বদলে duplicate আটকানো হবে attendee row-এর LastReminderAt দিয়ে, আর কাকে Outlook-এর কোন version পাঠানো হয়েছে তা থাকবে attendee-র InviteSentSequence-এ। কোন job কখন চলেছে বা fail করেছে তা Hangfire dashboard-এ দেখা যাবে। শুধু একটা জিনিস পাওয়া যাবে না: “অমুক তারিখে কাকে কোন mail গেছে”-এর স্থায়ী history।

২Calendar layer

বাঁ পাশে checkbox দিয়ে প্রতিটা layer চালু বা বন্ধ করা যাবে। শুধু প্রথম তিনটা নতুন table-এ থাকে; বাকিগুলো আগের data থেকে পড়া হয়, নতুন করে কিছু save হয় না।

Layerকোথা থেকে আসেকে দেখেEdit
EventCalendarItem (ItemType = 1)Organizer ও attendeeOrganizer
TaskCalendarItem (ItemType = 2)Organizer, assigneeOrganizer; assignee শুধু status ও remarks
Schedule JobCalendarItem (ItemType = 3)শুধু HR / adminHR / admin
Weekly holiday / HolidayWeeklyHoliday ও AttnNationalHoliday (HR-এর setup থেকে সরাসরি, যেকোনো বছর)সবাই (নিজের location-এর)—
LeaveLeave entry (approved)শুধু নিজের—
AttendanceDAILYATTNPROCESS (Present / Late / Absent ...)শুধু নিজের—
Birthday / AnniversaryEmployee.BirthDate, joining date থেকে হিসাবনিজের department—

৩Database schema — মাত্র ২টা table

এই project-এর নিয়ম মেনে: কোনো IDENTITY নেই (ID আসবে tc.GenerateID দিয়ে), audit column আগের table-গুলোর মতোই। Hangfire-এর নিজের table আলাদা HangFire schema-তে থাকবে, Hangfire নিজেই সেগুলো বানায় ও সামলায়।

dbo.CalendarItem

Event · Task · Schedule Job — সব এক table-এ · ২৬ column
ColumnTypeNullঅর্থ
মূল তথ্য
CalendarItemIDPKINTনাGenerateID দিয়ে
ItemTypeTINYINTনা১ = Event, ২ = Task, ৩ = Schedule Job
TitleNVARCHAR(250)নাশিরোনাম
DescriptionNVARCHAR(MAX)হ্যাঁবিস্তারিত
LocationNVARCHAR(500)হ্যাঁজায়গা বা Teams / Zoom link (Outlook invite-এর Location-এ যায়)
ColorVARCHAR(20)হ্যাঁযেমন #534AB7
PriorityTINYINTহ্যাঁ১ Low, ২ Normal, ৩ High (মূলত Task-এর জন্য; Outlook invite-এর importance-এও যায়)
সময় ও repeat
StartDateTimeDATETIMEনাশুরু (Task-এ assign-এর তারিখ; Schedule Job-এ প্রথম run)
EndDateTimeDATETIMEনাশেষ (Task-এ due date; Schedule Job-এ Start থেকে End = তৈরি হওয়া task-এর মেয়াদ)
IsAllDayBITনাসারাদিন
RecurrenceRuleVARCHAR(500)হ্যাঁRRULE, যেমন FREQ=WEEKLY;BYDAY=TH;UNTIL=20261231T000000 (Outlook-এরও একই format)। NULL = repeat নেই
RecurrenceEndDateDATETIMEহ্যাঁশেষ occurrence-এর তারিখ (save-এর সময় হিসাব করে রাখা হয়, যাতে calendar খুললে সব পুরোনো series load না হয়)। NULL = শেষ নেই
ExceptionDatesVARCHAR(MAX)হ্যাঁRepeat-এর যে দিনগুলো বাতিল বা আলাদা করে বদলানো, comma দিয়ে: 2026-10-15,2026-10-22
Reminder ও Schedule Job (Hangfire)
ReminderOffsetsVARCHAR(100)হ্যাঁকত মিনিট আগে, comma দিয়ে: 4320,60 = ৩ দিন ও ১ ঘণ্টা আগে। NULL = reminder নেই
ReminderChannelTINYINTহ্যাঁ১ Bell, ২ Mail, ৩ দুটোই
NextTriggerAtDATETIMEহ্যাঁHangfire প্রতি মিনিটে এটাই দেখে। Event / Task-এ = পরের reminder-এর সময়; Schedule Job-এ = পরের run-এর সময়। NULL = আর কিছু বাকি নেই
SourceItemIDFKINTহ্যাঁএই Task কোন Schedule Job বানিয়েছে
SourceOccurrenceDATETIMEহ্যাঁJob-এর কোন run থেকে। (SourceItemID, SourceOccurrence) UNIQUE — একই run দুইবার task বানাতে পারবে না
Outlook
OutlookSequenceINTনাপ্রতিবার সময় / তথ্য / attendee বদলালে +১। Outlook এটা দেখে বোঝে এটা আগের entry-র update
OutlookEventIDNVARCHAR(200)হ্যাঁGraph mode-এ Outlook-এর event ID। ICS mode-এ খালি থাকে; Graph চালুর সময় table বদলাতে হবে না
অবস্থা ও audit
PayrollTypeIDINTনাData scope (project-এর নিয়ম)
StatusTINYINTনা১ Active, ২ Cancelled, ৩ Completed
CreatedBy / CreatedDateINT / DATETIMEনাAudit। CreatedBy-ই organizer
ModifiedBy / ModifiedDateINT / DATETIMEহ্যাঁAudit

কিছু column কেন নেই

  • Organizer: CreatedBy-ই organizer; আর organizer নিজেও attendee table-এ Role = Organizer হিসেবে থাকে (তার EmployeeID সেখানে)
  • Visibility: নিয়ম সহজ — শুধু organizer ও attendee দেখে। পুরো department-কে দেখাতে চাইলে department invite করলেই হয়
  • “শুধু এই দিনটা” edit: তারিখটা ExceptionDates-এ যায় আর একটা আলাদা নতুন item তৈরি হয়; link রাখার column লাগে না

Schedule Job-এর জন্য আলাদা column নেই

  • Job নিজেই task-এর template: তার Title, Description, Location, Color, Priority, Reminder দিয়েই task তৈরি হয়
  • Job-এর attendee-রাই target (Employee / Department)
  • RRULE বলে কবে কবে চলবে; Start → End = task-এর মেয়াদ
  • Outlook পাঠানো সফল হলো কিনা: Hangfire dashboard (fail হলে retry ও error সেখানে)

dbo.CalendarItemAttendee

কারা আছে + প্রত্যেকের অবস্থা
ColumnTypeNullঅর্থ
কে
AttendeeIDPKINTনাGenerateID দিয়ে
CalendarItemIDFKINTনাকোন item
AttendeeTypeTINYINTনা১ Employee, ২ User, ৩ Department (Department শুধু Schedule Job-এর target হিসেবে; Event / Task-এ department বাছালে save-এর সময় সবাই আলাদা row হয়ে যায়)
EmployeeIDINTহ্যাঁAttendeeType = ১ হলে
UserIDINTহ্যাঁAttendeeType = ২ হলে (যেমন EmployeeID ছাড়া admin)
DepartmentIDINTহ্যাঁAttendeeType = ৩ হলে
EmailNVARCHAR(200)হ্যাঁSave-এর সময়ের email (Outlook invite-এর জন্য)
RoleTINYINTনা১ Organizer, ২ Required, ৩ Optional, ৪ Assignee (organizer-এর row save-এর সময় নিজে থেকে যোগ হয়)
প্রতি জনের আলাদা তথ্য (আপনার design-এর grid)
TitleOverrideNVARCHAR(250)হ্যাঁএই জনের জন্য আলাদা title (খালি = মূলটা)
SubjectOverrideNVARCHAR(250)হ্যাঁআলাদা subject
FromOverride / ToOverrideDATETIMEহ্যাঁআলাদা তারিখ
উত্তর ও কাজ
ResponseStatusTINYINTনা০ Pending, ১ Accepted, ২ Declined, ৩ Tentative
TaskStatusTINYINTহ্যাঁTask-এর জন্য: ০ Not started, ১ In progress, ২ Done
Remarks / RemarksDateNVARCHAR(2000) / DATETIMEহ্যাঁEmployee-র মন্তব্য
IsRead / ReadDateBIT / DATETIMEনা / হ্যাঁখুলে দেখেছে কিনা
Hangfire ও Outlook-এর হিসাব
LastReminderAtDATETIMEহ্যাঁশেষ যে reminder-টা এই জনকে গেছে তার নির্ধারিত সময়। এটাই একই reminder দুইবার যাওয়া আটকায়
InviteSentSequenceINTহ্যাঁOutlook-এর কোন version এই জনকে পাঠানো হয়েছে। NULL = এখনো পাঠানো হয়নি
StatusTINYINTনা১ Active, ২ Removed (সরিয়ে দিলে Outlook cancel পাঠানোর জন্য row মুছে না ফেলে Removed করা হয়)
CreatedBy / CreatedDate / ModifiedBy / ModifiedDate——Audit
BO নিয়ে একটা কথা: BasicBaseObject-এ আগে থেকেই Sequence আর Status (EnumStatus) আছে। নাম মিলে গিয়ে বিভ্রান্তি যাতে না হয়, তাই Outlook-এর column-এর নাম রাখা হয়েছে OutlookSequence, আর নতুন BO দুটো AuditTrailBase থেকে বানিয়ে নিজস্ব Status enum ব্যবহার করবে।

৪Enum মান

C#-এ HRM.BO-এ enum হিসেবে থাকবে; DB-তে TINYINT।

EnumCalendarItemType

  • 1 Event
  • 2 Task
  • 3 ScheduleJob

EnumCalendarPriority

  • 1 Low
  • 2 Normal
  • 3 High

EnumCalendarItemStatus

  • 1 Active
  • 2 Cancelled
  • 3 Completed

EnumAttendeeType

  • 1 Employee
  • 2 User
  • 3 Department

EnumAttendeeRole

  • 1 Organizer
  • 2 Required
  • 3 Optional
  • 4 Assignee

EnumResponseStatus

  • 0 Pending
  • 1 Accepted
  • 2 Declined
  • 3 Tentative

EnumCalendarTaskStatus

  • 0 NotStarted
  • 1 InProgress
  • 2 Done

EnumReminderChannel

  • 1 Bell
  • 2 Mail
  • 3 Both

EnumAttendeeStatus

  • 1 Active
  • 2 Removed

৫সম্পূর্ণ SQL script

Repo-র root-এ Calendar_DB_Changes.sql নামে রাখা হবে। আগের script-গুলোর মতোই guarded, তাই একাধিকবার চালালেও সমস্যা নেই।

/* =====================================================================
   Calendar_DB_Changes.sql
   HRM Calendar: Event / Task / Schedule Job + attendees (2 tables).
   Re-runnable. IDs come from tc.GenerateID (no IDENTITY).
   ===================================================================== */
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,
        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),

        TitleOverride        NVARCHAR(250)   NULL,
        SubjectOverride      NVARCHAR(250)   NULL,
        FromOverride         DATETIME        NULL,
        ToOverride           DATETIME        NULL,

        ResponseStatus       TINYINT         NOT NULL CONSTRAINT DF_CalAtt_Response DEFAULT (0),
        TaskStatus           TINYINT         NULL,
        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

/* Hangfire tables (HangFire schema) are created by Hangfire itself on first start
   (PrepareSchemaIfNecessary = true). If the production DB user has no DDL rights,
   run Hangfire's Install.sql manually instead. */
EmployeeID, UserID আর DepartmentID-এ ইচ্ছা করেই FK দেওয়া হয়নি, কারণ project-এর অন্য table-গুলোতেও এগুলো সাধারণত FK ছাড়াই রাখা হয়। চাইলে আপনার DB-র আসল table নাম দেখে FK যোগ করা যাবে।

৬Workflow

প্রতিটা ধাপের পাশে রঙিন tag বলে দেয় কাজটা কে করছে।

User (UI)HRM APIHangfire OutlookEmployeeHR / Admin
A

Event বা Task তৈরি

সবচেয়ে বেশি ব্যবহৃত flow
১
Calendar-এ তারিখে click করেUser

ছোট quick-create popup (title + সময়)। “More options” চাপলে পুরো form খোলে।

২
Form পূরণ করেUser

Type, title, শুরু-শেষ, সারাদিন, repeat, location, color, priority, guests / assignee (প্রয়োজনে প্রতি জনের আলাদা title / তারিখ), reminder (যেমন ৩ দিন আগে) ও কীভাবে (Bell / Mail / দুটোই)।

৩
Permission ও data ঠিক আছে?API

Token থেকে user; Task হলে assign করার অধিকার (HR, বা assignee-র Line Manager); RRULE ও reminder parse করে যাচাই; শেষ ≥ শুরু; guest-এর সংখ্যা সীমার মধ্যে।

হ্যাঁ → ধাপ ৪না → ভুলের বার্তা, form-এ ফেরত
৪
এক transaction-এ saveAPI

CalendarItem + সব CalendarItemAttendee (organizer নিজে Role = Organizer row; department বাছালে সবাই আলাদা row)। RecurrenceEndDate, NextTriggerAt হিসাব; OutlookSequence = 1।

৫
Commit-এর পরে Hangfire-এ কাজ পাঠায়APIHangfire

NotifyAttendees(itemId, Created) আর (client-এর config-এ Outlook চালু থাকলে) SyncOutlook(itemId) enqueue। User সাথে সাথে উত্তর পায়, অপেক্ষা করতে হয় না।

৬
Attendee-দের জানানো হয়HangfireOutlook

Bell notification + mail (“আপনাকে invite / task দেওয়া হয়েছে”)। Outlook invite আলাদা job-এ যায় (Workflow D)।

৭
সবার calendar-এ দেখায়Employee

প্রত্যেকে calendar খুললে feed API তাকে তার item-গুলো দেয়।

B

Edit বা Cancel

শুধু organizer (আর HR)
১
Repeat event?User

জিজ্ঞেস করে: “শুধু এটা / এটা ও পরেরগুলো / সবগুলো”।

শুধু এটা → মূল item-এর ExceptionDates-এ তারিখ যোগ + বদলানো তথ্য দিয়ে আলাদা নতুন itemএটা ও পরেরগুলো → মূলটার UNTIL আগের দিনে, বাকিটার জন্য নতুন seriesসবগুলো → মূল item বদলায়
২
পরিবর্তন saveAPI

সময় / তথ্য / attendee বদলালে OutlookSequence + 1। NextTriggerAt নতুন করে হিসাব। সরানো attendee মুছে না ফেলে Status = Removed। Cancel হলে item-এর Status = Cancelled, NextTriggerAt = NULL।

৩
সবাইকে জানানোHangfire

NotifyAttendees(itemId, Updated / Cancelled) + SyncOutlook(itemId)। Outlook-এ একই entry বদলে যায় বা সরে যায়।

C

Reminder (যেমন ৩ দিন আগে)

Hangfire নিজে থেকে চালায়
১
প্রতি ১ মিনিটে dispatcher চলেHangfire

calendar-dispatcher recurring job, একসাথে দুইটা চলে না।

২
কোনো Event / Task-এর NextTriggerAt ≤ এখন?Hangfire
হ্যাঁ → ধাপ ৩না → ১ মিনিট পরে আবার
৩
পরের reminder-এর সময় বসায় (একজনই জেতে)Hangfire

Repeat ও সব offset মিলিয়ে পরের সময় হিসাব করে: UPDATE … SET NextTriggerAt = @next WHERE ID = @id AND NextTriggerAt = @old। ০ row update হলে অন্য কেউ আগেই নিয়েছে, বাদ।

৪
খুব দেরি হয়ে গেছে?Hangfire

Server বন্ধ ছিল আর event শুরু হয়ে গেছে, বা grace সময় পেরিয়ে গেছে।

হ্যাঁ → এই reminder বাদনা → ধাপ ৫
৫
Send job queue-তেHangfire

SendReminder(itemId, triggerAt) enqueue।

৬
প্রতি attendee-কে পাঠায় (Declined বাদ)HangfireEmployee

আগে claim: UPDATE … SET LastReminderAt = @triggerAt WHERE AttendeeID = @id AND (LastReminderAt IS NULL OR LastReminderAt < @triggerAt)। ১ row হলে ReminderChannel অনুযায়ী bell / mail পাঠায়। পাঠাতে ব্যর্থ হলে LastReminderAt আগের মানে ফেরত দিয়ে throw করে, Hangfire পরে আবার চেষ্টা করে (সর্বোচ্চ ৩ বার)। যারা আগেই পেয়েছে তারা আর পায় না।

D

Outlook-এ পাঠানো

Create / Edit / Cancel-এর পরে
১
Client-এর Outlook mode কী?Hangfire

appsettings: Calendar:OutlookSync।

None → থামেIcs → ধাপ ২Graph → ধাপ ৫
২
ICS: নতুন বা পুরোনো version পাওয়া attendee-দের inviteHangfireOutlook

যাদের InviteSentSequence NULL বা < OutlookSequence → mail-এ METHOD:REQUEST, UID = hrm-{ItemID}@{domain}, SEQUENCE। পাঠানোর পরে InviteSentSequence = OutlookSequence।

৩
ICS: সরানো attendee বা বাতিল itemHangfireOutlook

Removed attendee (যার আগে invite গেছে) বা item Cancelled → METHOD:CANCEL। Outlook থেকে entry সরে যায়।

৪
ফলাফল লেখাHangfire

প্রতি attendee-র InviteSentSequence আপডেট। কোনো mail ব্যর্থ হলে job throw করে, Hangfire পরে আবার চেষ্টা করে; error ও retry Hangfire dashboard-এ দেখা যায়। যারা আগেই পেয়েছে তারা আবার পায় না।

৫
Graph (পরের phase): organizer mailbox-এ একটা eventHangfireOutlook

OutlookEventID না থাকলে create, থাকলে PATCH (attendee তালিকাসহ), Cancelled হলে cancel। Exchange নিজেই সবার Outlook-এ invite পাঠায়। চাইলে Outlook-এর Accept / Decline পড়ে ResponseStatus-এ আনা যায়।

E

Employee-র দিক

ESS থেকে
১
Bell-এ notification দেখে, calendar বা My Tasks খোলেEmployee

নিজের item, holiday, leave, birthday সব একসাথে।

২
Event-এ Yes / No / MaybeEmployeeAPI

ResponseStatus update (শুধু নিজের row, ID token থেকে)। Declined হলে আর reminder যায় না। Organizer bell-এ জানতে পারে।

৩
Task খোলে, status ও remarks দেয়EmployeeAPI

খুললে IsRead, ReadDate। In progress / Done + remarks → TaskStatus, Remarks, RemarksDate। Organizer bell-এ জানতে পারে।

F

Schedule Job (নির্দিষ্ট দিনে নিজে থেকে task assign)

শুধু HR / admin
১
Schedule Job তৈরিHR

ItemType = 3। Job-এর নিজের Title, Description, Location, Color, Priority, Reminder = যে task তৈরি হবে তার template; Start → End = task-এর মেয়াদ; attendee row (Employee / Department) = target; RRULE = কবে কবে চলবে। NextTriggerAt = প্রথম run।

২
Test runHR

কিছু তৈরি না করে দেখায় “এই মুহূর্তে চালালে এই ১২ জন task পাবে”।

৩
সময় হলে dispatcher ধরেHangfire

একই calendar-dispatcher: ItemType = 3 এবং NextTriggerAt ≤ এখন → UPDATE … WHERE NextTriggerAt = @old দিয়ে পরের run-এর তারিখ বসায় → RunScheduleJob(itemId, occurrence) enqueue।

৪
এই run-এর task আগেই তৈরি হয়েছে?Hangfire

(SourceItemID, SourceOccurrence) দিয়ে খোঁজে। Job Active কিনা আর HR-এর permission আছে কিনা আবার দেখে।

হ্যাঁ (retry) → শুধু বাদ পড়া employee যোগনা → job-এর template থেকে নতুন Task item (SourceItemID, SourceOccurrence সহ) + attendee (এই মুহূর্তের active employee, PayrollTypeID অনুযায়ী)
৫
বাকিটা সাধারণ Task-এর মতোইHangfire

Workflow A-এর ধাপ ৫ থেকে: notification, Outlook, reminder।

৭Hangfire job

Hangfire-এ শুধু ID pass হয়; সব তথ্য DB-তে থাকে। তাই schedule দুই জায়গায় থাকে না।

Jobধরনকী করেRetry
calendar-dispatcherRecurring, প্রতি মিনিটেNextTriggerAt ≤ এখন এমন item: Event / Task হলে SendReminder, Schedule Job হলে RunScheduleJob enqueue০ (পরের মিনিটে এমনিই চলবে); DisableConcurrentExecution
SendReminder(itemId, triggerAt)Fire-and-forgetপ্রতি attendee-কে bell / mail, LastReminderAt দিয়ে duplicate রোধ৩
NotifyAttendees(itemId, change)Fire-and-forgetCreated / Updated / Cancelled / Task assigned / RSVP / Remarks-এর notification৩
SyncOutlook(itemId)Fire-and-forgetICS বা Graph দিয়ে Outlook-এ পাঠানো৩
RunScheduleJob(itemId, occurrence)Fire-and-forgetSchedule Job থেকে Task তৈরি৩
daily-birthday-digestবাদ দেওয়া হয়েছেশুধু নিজের birthday দেখা যায়, তাই অন্যদের জানানোর digest আর নেই—

Startup setup

// Startup.ConfigureServices
services.AddHangfire(cfg => cfg
    .SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
    .UseSimpleAssemblyNameTypeSerializer()
    .UseRecommendedSerializerSettings()
    .UseSqlServerStorage(
        () => (DbConnection)ConnectionFactory.Default.CreateConnection(),  // encrypted password আগের মতোই decrypt হয়
        new SqlServerStorageOptions { SchemaName = "HangFire", PrepareSchemaIfNecessary = true }));
services.AddHangfireServer(o => { o.WorkerCount = 4; o.Queues = new[] { "calendar", "default" }; });

// Startup.Configure — অবশ্যই UseSpa(...)-এর আগে
app.UseHangfireDashboard("/hangfire", new DashboardOptions {
    Authorization = new[] { new LocalRequestsOnlyAuthorizationFilter() } });   // শুধু server-এর localhost

var jobs = app.ApplicationServices.GetRequiredService<IRecurringJobManager>();
jobs.AddOrUpdate<CalendarDispatcher>("calendar-dispatcher", j => j.Run(), Cron.Minutely());
মনে রাখবেন: Job class-এর নাম বা namespace পরে বদলাবেন না, queue-তে থাকা পুরোনো job ভেঙে যাবে। Hangfire-এর সফল job-এর history কিছুদিন পর নিজে থেকে মুছে যায়; fail করা job dashboard-এ থেকে যায়।

৮Outlook integration

প্রতি client-এর নিজের appsettings.json-এ বাছাই: Calendar:OutlookSync = None | Ics | Graph।

Mode A — ICS invite (সব client-এর জন্য, আগে এটা)

  • এখনকার SMTP MailSender দিয়েই; Azure লাগে না
  • Mail-এ text/calendar; method=REQUEST → Outlook আসল meeting invite দেখায়, Accept করলে calendar-এ বসে
  • Update: একই UID, SEQUENCE + ১ → আগের entry-টাই বদলায়
  • Cancel: METHOD:CANCEL
  • Outlook 365, on-premise Exchange, Gmail সবখানে চলে
  • সীমা: একমুখী — Outlook-এর Accept / Decline HRM-এ আসে না, তাই HRM-এ RSVP বাটন থাকবে
  • Code: MailSender-এ calendar AlternateView পাঠানোর একটা নতুন method লাগবে (এখন শুধু attachment আছে)। ICS তৈরি হবে Ical.Net দিয়ে

Mode B — Microsoft Graph (Microsoft 365 client-দের জন্য)

  • একটা organizer mailbox (যেমন hrm-calendar@client.com)-এ একটা event, attendee হিসেবে সবার email
  • Exchange নিজেই সবার Outlook-এ invite পাঠায়; Accept / Decline HRM-এ ফিরিয়ে আনা যায়
  • OutlookEventID column আগে থেকেই রাখা আছে, তাই Graph চালুর সময় table বদলাতে হবে না
  • Azure AD app registration, Calendars.ReadWrite (application)
  • নিরাপত্তা: Exchange Application Access Policy দিয়ে শুধু ওই একটা mailbox-এ সীমিত রাখতে হবে
  • Secret / certificate appsettings.json-এ commit করা যাবে না
  • পুরোনো comment করা EWS code ব্যবহার করবেন না — Exchange Online থেকে EWS বন্ধ হচ্ছে
Repo-র নিয়ম: .github/copilot-instructions.md অনুযায়ী Azure-সংক্রান্ত কাজের (Mode B) আগে azmcp_bestpractices_get tool ব্যবহার করতে হবে। Mode B শুরুর আগে tool-টা enable করতে হবে।

৯API endpoint

HRM.UI/Controllers/Calendar/CalendarController.cs, [Route("api/Calendar")], [Authorize]। User / EmployeeID সবসময় token থেকে।

MethodRouteকাজকে
GETgetFeed?fromDate=&toDate=&layers=দেখা যাওয়া সময়ের সব layer একসাথে (repeat expand করে)সবাই
GETgetItem/{id}একটা item + attendeeOrganizer / attendee
POSTsaveItemCreate / update (item + attendee একসাথে)Event: সবাই; Task: HR / Line Manager; update: organizer / HR
POSTcancelItem/{id}Cancel for everyone; repeat-এর জন্য ?occurrenceStart=&scope= (1 = শুধু এটা, 2 = এটা ও পরেরগুলো)Organizer / HR
POSTrespond{ calendarItemID, responseStatus } — RSVPAttendee (নিজের)
POSTupdateTaskStatus{ calendarItemID, taskStatus, remarks }Assignee (নিজের)
POSTmarkRead/{id}IsRead = 1Attendee (নিজের)
GETgetMyTasks?taskStatus=আমার task তালিকাসবাই
GETgetUpcoming?days=7Sidebar / dashboard: সামনের দিনগুলো + open task সংখ্যাসবাই
GETgetOptionsএই login কী করতে পারে (event তৈরি, task assign, birthday)সবাই
POSTpreviewTargetsSchedule Job-এর test runHR
POSTrunNow/{id}Schedule Job এখনই চালানোHR

১০UI design

আপনার design-এর form, calendar আর legend রেখে Google Calendar-এর মতো সাজানো। FullCalendar v6 (month / week / day / list, drag) আগেই project-এ আছে।

+ Create
SMTWTFS 123 45678910 11121314151617
My calendars
Events
Tasks
Leave
Holidays
Birthdays
My team
Upcoming
আজ ৩টা · My tasks (২)
← October 2026 →TodayMonthWeekDayList
Sun
Mon
Tue
Wed
Thu
Fri
Sat
1Weekly sync
2Weekly holiday
3
4
5Rahim birthday
6
7Leave (3 days)
8Weekly syncLeave
9Leave
10
11
12Submit KPI
13
14
15Weekly sync
16Weekly holiday
17

আপনার design-এর তুলনায় যা যোগ বা বদল

Layout

  • Form সবসময় খোলা না থেকে quick-create popup → “More options” → dialog / side drawer। Calendar পুরো জায়গা পায়
  • Legend (Weekly holiday, Holidays, Leave, Job/Event/Task) → বাঁ পাশে checkbox layer
  • নিচের খালি অংশ → Upcoming / My Tasks list, filter সহ
  • Drag করে সরানো ও সময় বাড়ানো; week view-তে টেনে নতুন event
  • Event-এ click → popup: সময়, location, attendee ও তাদের status, Yes / No / Maybe, Edit / Delete

Form-এর ঘর

  • Type tab: Event / Task / Schedule Job (শেষটা শুধু HR)
  • শুরু ও শেষ তারিখ + সময়; “Entire day” একটা checkbox (design-এ দুটো আছে)
  • Repeat: হয় না / প্রতিদিন / প্রতি সপ্তাহে / প্রতি মাসে / প্রতি বছর / Custom + শেষ হবে (কখনো না / তারিখে / N বার পরে)
  • নতুন: Location / meeting link, Color, Priority
  • Guests: Employee / User / Department picker; Task হলে প্রতি জনের আলাদা title / subject / তারিখ (আপনার grid)
  • Notification: কতদিন / ঘণ্টা আগে (একাধিক যোগ করা যায়) + Bell / Mail / দুটোই
  • Outlook-এ যাবে কিনা client-এর config ঠিক করে, form-এ আলাদা toggle নেই

১১Permission ও নিরাপত্তা

এই app-এ menu লুকালেই endpoint সুরক্ষিত হয় না — সব check API-তে।

কাজকে পারবে
Event তৈরি ও যে কাউকে inviteসব employee
অন্যকে Task assignHR (যে কাউকে), Line Manager (শুধু নিজের team-কে)
Item দেখাশুধু organizer ও attendee
Birthday layerনিজের department-এর
Schedule Jobশুধু HR / admin
Edit / Cancelশুধু organizer ও HR
RSVP, task status, remarks, readশুধু নিজের attendee row

Data সুরক্ষা

  • Feed শুধু সেই item দেয় যেখানে user-এর active attendee row আছে (organizer-ও attendee row), PayrollTypeID সহ
  • অন্যের leave-এ শুধু “Leave”, ধরন না
  • Birthday-তে বছর দেখাবে না

Code সুরক্ষা

  • Title, Description, Location → MakeSQL-এ %u; কখনো %q না
  • RRULE ও ReminderOffsets server-এ parse করে যাচাই, তারপর save
  • Mail-এ HTML-encode; ICS-এ text escape (, ; নতুন লাইন)
  • Schedule Job শুধু task তৈরি করতে পারে, অন্য কোনো কাজ না
  • Guest সর্বোচ্চ সীমা (যেমন ৫০০)

Duplicate রোধ

  • Dispatcher: NextTriggerAt = @old শর্তে update — একজনই জেতে
  • Reminder: attendee-র LastReminderAt claim
  • Schedule Job: UX_CalendarItem_Source UNIQUE
  • Outlook: একই UID / Graph ID, InviteSentSequence

Operation

  • Hangfire dashboard শুধু localhost
  • Dev PC থেকে আসল mail / invite বন্ধ: Development-এ RedirectAllMailTo খালি থাকলে mail যায় না
  • Server বন্ধ থাকলে পুরোনো reminder grace পেরোলে বাদ

১২Configuration ও deployment

appsettings.json — নতুন section

"Calendar": {
  "RemindersEnabled": true,
  "SendMail": true,
  "RedirectAllMailTo": "",
  "ReminderGraceMinutes": 60,
  "TimeZoneId": "Bangladesh Standard Time",
  "IcsDomain": "hrm.client.com",
  "OutlookSync": "Ics",
  "MaxAttendees": 500,
  "ScheduleJobsEnabled": true
}

Graph-এর secret / certificate এখানে না, server-এর নিরাপদ জায়গায়।

প্রতি client-এর পছন্দ (appsettings Calendar)

আগে এগুলো Logic config-এ রাখার কথা ছিল; প্রতি client-এর deployment-এর নিজের appsettings.json আছে, তাই এখন সেখানেই।

Keyমানশুরুতে
OutlookSyncNone | Ics | GraphIcs
ScheduleJobsEnabledtrue | falsetrue

এগুলো আর setting না, code-এ স্থির: সব employee event বানাতে পারে; Line Manager নিজের team-কে task দিতে পারে (HR যে কাউকে); birthday / anniversary শুধু নিজেরটা দেখা যায়। Daily birthday digest বাদ।

Graph mode (Phase ৫) এলে Graph অংশ (TenantId, ClientId, OrganizerMailbox) যোগ হবে; secret / certificate এখানে না।

Deployment checklist

  • NuGet: Hangfire.AspNetCore, Hangfire.SqlServer (1.8.x), Ical.Net; Graph mode-এ Microsoft.Graph + Azure.Identity
  • Calendar_DB_Changes.sql চালানো; Hangfire-এর জন্য DB user-এর DDL অধিকার, অথবা Install.sql হাতে চালানো
  • deploy.ps1-এর web.config rule-এ <add input="{REQUEST_URI}" pattern="/hangfire" negate="true" />
  • IIS: App Pool Start Mode = AlwaysRunning, Idle Time-out = 0; Site Preload Enabled = True
  • Menu XML-এ Calendar (ও ESS-এ My Calendar / My Tasks) node যোগ করে upload
  • appsettings.json-এর Calendar section client অনুযায়ী ঠিক করা
  • আলাদা deployment লাগবে না — সব HRM.UI-এর ভেতরেই

১৩Development plan

প্রতিটা phase শেষে কিছু একটা ব্যবহারযোগ্য অবস্থায় থাকবে। File-এর নাম project-এর বিদ্যমান ধাঁচ মেনে।

Phase ১

মূল calendar — Event ও Task

Hangfire ছাড়াই
  1. DB script: ২টা table + indexCalendar_DB_Changes.sql
  2. BO + enum + service interfaceHRM.BO/Calendar/CalendarItem.cs · CalendarItemAttendee.cs · ICalendarService · Enums
  3. DA (MakeSQL, TransactionContext)HRM.DA/DA/Calendar/CalendarItemDA.cs · CalendarItemAttendeeDA.cs
  4. Service: Save (item + attendee এক transaction-এ), Get, Feed, Cancel, Respond, TaskStatus, MarkRead, MyTasksHRM.DA/Service/Calendar/CalendarService.cs
  5. Feed-এ overlay: Holiday, Leave, Birthday (আগের service থেকে পড়া)HolidayCalendarService · Leave service · EmployeeService
  6. DI + controllerServiceCollectionExtensions.cs · HRM.UI/Controllers/Calendar/CalendarController.cs
  7. Angular: model, service, lazy module, calendar page (FullCalendar + layer sidebar + quick create + form dialog + detail popup), My Tasks_models/calendar · _services/calendar · src/app/calendar/
  8. Menu XML + permission
শেষ হলে যা কাজ করবে:
  • ৩ জন employee নিয়ে event বানালে ৩ জনের calendar-এ দেখায়
  • Holiday, leave, birthday layer দেখা যায় ও checkbox দিয়ে লুকানো যায়
  • RSVP, task status ও remarks কাজ করে; অন্যের item edit করা যায় না
Phase ২

Hangfire — reminder, notification ও repeat

  1. NuGet + Startup setup + dashboard + web.config rule + IIS setting
  2. Repeat: RRULE যাচাই ও save, feed-এ expand (Ical.Net), ExceptionDates, “শুধু এই দিনটা” (তারিখ বাদ + আলাদা নতুন item)
  3. NextTriggerAt হিসাব (save ও প্রতিবার পাঠানোর পরে)
  4. CalendarDispatcher (reminder অংশ) + SendReminder + NotifyAttendeesHRM.UI/BackgroundJobs/Calendar/*.cs
  5. Calendar config section, dev-এ mail redirect
  6. (ঐচ্ছিক) daily birthday digest — বাদ দেওয়া হয়েছে
শেষ হলে যা কাজ করবে:
  • ৩ দিন আগের reminder ঠিক একবার যায়; app restart করলেও দুইবার যায় না
  • Decline করলে reminder যায় না; সময় বদলালে reminder নতুন সময়ে যায়
  • প্রতি সপ্তাহের event প্রতি সপ্তাহে দেখায় ও reminder পায়; একটা দিন বাতিল করা যায়
Phase ৩

Outlook — ICS (Mode A)

  1. MailSender-এ calendar AlternateView পাঠানোর methodHRM.BO/Mail/MailSender.cs
  2. ICS builder (Ical.Net): REQUEST / CANCEL, UID, SEQUENCE, RRULE, time zone
  3. SyncOutlook job — ICS mode (InviteSentSequence দিয়ে)
শেষ হলে যা কাজ করবে:
  • Invite Outlook calendar-এ আসে; সময় বদলালে Outlook-এর একই entry বদলায়
  • Cancel করলে Outlook থেকে সরে যায়; সরানো attendee cancel পায়
Phase ৪

Schedule Job

  1. Job-এর template থেকে task তৈরি (SourceItemID / SourceOccurrence সহ)
  2. CalendarDispatcher-এর Schedule Job অংশ + RunScheduleJob
  3. HR-এর Schedule Job tab, test run, run now
শেষ হলে যা কাজ করবে:
  • প্রতি মাসের ১ তারিখে Sales department-এর সব active employee নিজে থেকে task পায়
  • Retry বা restart-এ duplicate task হয় না; নতুন join করা employee পরের মাসে পায়
Phase ৫

Outlook — Microsoft Graph (Mode B)

সব কিছু শেষ হওয়ার পরে
  1. Azure tool (azmcp_bestpractices_get) enable করা — repo-র নিয়ম
  2. Azure AD app registration, Exchange Application Access Policy (শুধু organizer mailbox)
  3. SyncOutlook-এ Graph path: create / patch / cancel, OutlookEventID ব্যবহার
  4. Outlook-এর Accept / Decline পড়ে ResponseStatus-এ আনা
  5. Client-এর appsettings Calendar:OutlookSync = Graph
শেষ হলে যা কাজ করবে:
  • M365 client-এ invite সরাসরি Exchange থেকে যায়; Outlook-এ Accept করলে HRM-এও Accepted দেখায়

১৪নেওয়া সিদ্ধান্ত

এগুলোর উপর ভিত্তি করেই পুরো plan সাজানো। সব কিছুতে best practice মানা হবে।

১. Outlook

আগে ICS invite (Mode A)। বাকি সব development শেষ হলে Microsoft Graph (Mode B, Phase ৫)।

২. Event তৈরি

সব employee নিজে event বানিয়ে যে কাউকে invite করতে পারবে।

৩. Task assign

HR যে কাউকে; Line Manager নিজের team-কে।

৪. Birthday

শুধু নিজের department-এর birthday দেখাবে।

৫. Table

মাত্র ২টা table; notification log table নেই। CalendarItem-এ ২৬ column (Location, ReminderChannel, Priority, OutlookEventID সহ)।

৬. Development

এই plan review হওয়ার পরে, অনুমতি পেলে তবেই শুরু।