CEL.HRM.5 · Calendar + Hangfire + Outlook · Final plan
Google Calendar-এর মতো একটা calendar: Event, Task আর Schedule Job তৈরি করা যাবে; attendee-দের নিজের calendar-এ দেখাবে; নির্দিষ্ট দিন আগে Hangfire reminder পাঠাবে; আর Outlook calendar-এও দেখাবে। Holiday, Leave আর Birthday আগের data থেকেই দেখাবে। পুরো feature মাত্র ২টা নতুন table দিয়ে।
মূল নীতি: Database-ই একমাত্র সত্য, Hangfire শুধু সময়মতো কাজ চালায়।
LastReminderAt দিয়ে, আর কাকে Outlook-এর কোন version পাঠানো হয়েছে তা থাকবে attendee-র InviteSentSequence-এ। কোন job কখন চলেছে বা fail করেছে তা Hangfire dashboard-এ দেখা যাবে। শুধু একটা জিনিস পাওয়া যাবে না: “অমুক তারিখে কাকে কোন mail গেছে”-এর স্থায়ী history।বাঁ পাশে checkbox দিয়ে প্রতিটা layer চালু বা বন্ধ করা যাবে। শুধু প্রথম তিনটা নতুন table-এ থাকে; বাকিগুলো আগের data থেকে পড়া হয়, নতুন করে কিছু save হয় না।
| Layer | কোথা থেকে আসে | কে দেখে | Edit |
|---|---|---|---|
| Event | CalendarItem (ItemType = 1) | Organizer ও attendee | Organizer |
| Task | CalendarItem (ItemType = 2) | Organizer, assignee | Organizer; assignee শুধু status ও remarks |
| Schedule Job | CalendarItem (ItemType = 3) | শুধু HR / admin | HR / admin |
| Weekly holiday / Holiday | WeeklyHoliday ও AttnNationalHoliday (HR-এর setup থেকে সরাসরি, যেকোনো বছর) | সবাই (নিজের location-এর) | — |
| Leave | Leave entry (approved) | শুধু নিজের | — |
| Attendance | DAILYATTNPROCESS (Present / Late / Absent ...) | শুধু নিজের | — |
| Birthday / Anniversary | Employee.BirthDate, joining date থেকে হিসাব | নিজের department | — |
এই project-এর নিয়ম মেনে: কোনো IDENTITY নেই (ID আসবে tc.GenerateID দিয়ে), audit column আগের table-গুলোর মতোই। Hangfire-এর নিজের table আলাদা HangFire schema-তে থাকবে, Hangfire নিজেই সেগুলো বানায় ও সামলায়।
| Column | Type | Null | অর্থ |
|---|---|---|---|
| মূল তথ্য | |||
| CalendarItemIDPK | INT | না | GenerateID দিয়ে |
| ItemType | TINYINT | না | ১ = Event, ২ = Task, ৩ = Schedule Job |
| Title | NVARCHAR(250) | না | শিরোনাম |
| Description | NVARCHAR(MAX) | হ্যাঁ | বিস্তারিত |
| Location | NVARCHAR(500) | হ্যাঁ | জায়গা বা Teams / Zoom link (Outlook invite-এর Location-এ যায়) |
| Color | VARCHAR(20) | হ্যাঁ | যেমন #534AB7 |
| Priority | TINYINT | হ্যাঁ | ১ Low, ২ Normal, ৩ High (মূলত Task-এর জন্য; Outlook invite-এর importance-এও যায়) |
| সময় ও repeat | |||
| StartDateTime | DATETIME | না | শুরু (Task-এ assign-এর তারিখ; Schedule Job-এ প্রথম run) |
| EndDateTime | DATETIME | না | শেষ (Task-এ due date; Schedule Job-এ Start থেকে End = তৈরি হওয়া task-এর মেয়াদ) |
| IsAllDay | BIT | না | সারাদিন |
| RecurrenceRule | VARCHAR(500) | হ্যাঁ | RRULE, যেমন FREQ=WEEKLY;BYDAY=TH;UNTIL=20261231T000000 (Outlook-এরও একই format)। NULL = repeat নেই |
| RecurrenceEndDate | DATETIME | হ্যাঁ | শেষ occurrence-এর তারিখ (save-এর সময় হিসাব করে রাখা হয়, যাতে calendar খুললে সব পুরোনো series load না হয়)। NULL = শেষ নেই |
| ExceptionDates | VARCHAR(MAX) | হ্যাঁ | Repeat-এর যে দিনগুলো বাতিল বা আলাদা করে বদলানো, comma দিয়ে: 2026-10-15,2026-10-22 |
| Reminder ও Schedule Job (Hangfire) | |||
| ReminderOffsets | VARCHAR(100) | হ্যাঁ | কত মিনিট আগে, comma দিয়ে: 4320,60 = ৩ দিন ও ১ ঘণ্টা আগে। NULL = reminder নেই |
| ReminderChannel | TINYINT | হ্যাঁ | ১ Bell, ২ Mail, ৩ দুটোই |
| NextTriggerAt | DATETIME | হ্যাঁ | Hangfire প্রতি মিনিটে এটাই দেখে। Event / Task-এ = পরের reminder-এর সময়; Schedule Job-এ = পরের run-এর সময়। NULL = আর কিছু বাকি নেই |
| SourceItemIDFK | INT | হ্যাঁ | এই Task কোন Schedule Job বানিয়েছে |
| SourceOccurrence | DATETIME | হ্যাঁ | Job-এর কোন run থেকে। (SourceItemID, SourceOccurrence) UNIQUE — একই run দুইবার task বানাতে পারবে না |
| Outlook | |||
| OutlookSequence | INT | না | প্রতিবার সময় / তথ্য / attendee বদলালে +১। Outlook এটা দেখে বোঝে এটা আগের entry-র update |
| OutlookEventID | NVARCHAR(200) | হ্যাঁ | Graph mode-এ Outlook-এর event ID। ICS mode-এ খালি থাকে; Graph চালুর সময় table বদলাতে হবে না |
| অবস্থা ও audit | |||
| PayrollTypeID | INT | না | Data scope (project-এর নিয়ম) |
| Status | TINYINT | না | ১ Active, ২ Cancelled, ৩ Completed |
| CreatedBy / CreatedDate | INT / DATETIME | না | Audit। CreatedBy-ই organizer |
| ModifiedBy / ModifiedDate | INT / DATETIME | হ্যাঁ | Audit |
CreatedBy-ই organizer; আর organizer নিজেও attendee table-এ Role = Organizer হিসেবে থাকে (তার EmployeeID সেখানে)ExceptionDates-এ যায় আর একটা আলাদা নতুন item তৈরি হয়; link রাখার column লাগে না| Column | Type | Null | অর্থ |
|---|---|---|---|
| কে | |||
| AttendeeIDPK | INT | না | GenerateID দিয়ে |
| CalendarItemIDFK | INT | না | কোন item |
| AttendeeType | TINYINT | না | ১ Employee, ২ User, ৩ Department (Department শুধু Schedule Job-এর target হিসেবে; Event / Task-এ department বাছালে save-এর সময় সবাই আলাদা row হয়ে যায়) |
| EmployeeID | INT | হ্যাঁ | AttendeeType = ১ হলে |
| UserID | INT | হ্যাঁ | AttendeeType = ২ হলে (যেমন EmployeeID ছাড়া admin) |
| DepartmentID | INT | হ্যাঁ | AttendeeType = ৩ হলে |
| NVARCHAR(200) | হ্যাঁ | Save-এর সময়ের email (Outlook invite-এর জন্য) | |
| Role | TINYINT | না | ১ Organizer, ২ Required, ৩ Optional, ৪ Assignee (organizer-এর row save-এর সময় নিজে থেকে যোগ হয়) |
| প্রতি জনের আলাদা তথ্য (আপনার design-এর grid) | |||
| TitleOverride | NVARCHAR(250) | হ্যাঁ | এই জনের জন্য আলাদা title (খালি = মূলটা) |
| SubjectOverride | NVARCHAR(250) | হ্যাঁ | আলাদা subject |
| FromOverride / ToOverride | DATETIME | হ্যাঁ | আলাদা তারিখ |
| উত্তর ও কাজ | |||
| ResponseStatus | TINYINT | না | ০ Pending, ১ Accepted, ২ Declined, ৩ Tentative |
| TaskStatus | TINYINT | হ্যাঁ | Task-এর জন্য: ০ Not started, ১ In progress, ২ Done |
| Remarks / RemarksDate | NVARCHAR(2000) / DATETIME | হ্যাঁ | Employee-র মন্তব্য |
| IsRead / ReadDate | BIT / DATETIME | না / হ্যাঁ | খুলে দেখেছে কিনা |
| Hangfire ও Outlook-এর হিসাব | |||
| LastReminderAt | DATETIME | হ্যাঁ | শেষ যে reminder-টা এই জনকে গেছে তার নির্ধারিত সময়। এটাই একই reminder দুইবার যাওয়া আটকায় |
| InviteSentSequence | INT | হ্যাঁ | Outlook-এর কোন version এই জনকে পাঠানো হয়েছে। NULL = এখনো পাঠানো হয়নি |
| Status | TINYINT | না | ১ Active, ২ Removed (সরিয়ে দিলে Outlook cancel পাঠানোর জন্য row মুছে না ফেলে Removed করা হয়) |
| CreatedBy / CreatedDate / ModifiedBy / ModifiedDate | — | — | Audit |
BasicBaseObject-এ আগে থেকেই Sequence আর Status (EnumStatus) আছে। নাম মিলে গিয়ে বিভ্রান্তি যাতে না হয়, তাই Outlook-এর column-এর নাম রাখা হয়েছে OutlookSequence, আর নতুন BO দুটো AuditTrailBase থেকে বানিয়ে নিজস্ব Status enum ব্যবহার করবে।C#-এ HRM.BO-এ enum হিসেবে থাকবে; DB-তে TINYINT।
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. */
প্রতিটা ধাপের পাশে রঙিন tag বলে দেয় কাজটা কে করছে।
ছোট quick-create popup (title + সময়)। “More options” চাপলে পুরো form খোলে।
Type, title, শুরু-শেষ, সারাদিন, repeat, location, color, priority, guests / assignee (প্রয়োজনে প্রতি জনের আলাদা title / তারিখ), reminder (যেমন ৩ দিন আগে) ও কীভাবে (Bell / Mail / দুটোই)।
Token থেকে user; Task হলে assign করার অধিকার (HR, বা assignee-র Line Manager); RRULE ও reminder parse করে যাচাই; শেষ ≥ শুরু; guest-এর সংখ্যা সীমার মধ্যে।
CalendarItem + সব CalendarItemAttendee (organizer নিজে Role = Organizer row; department বাছালে সবাই আলাদা row)। RecurrenceEndDate, NextTriggerAt হিসাব; OutlookSequence = 1।
NotifyAttendees(itemId, Created) আর (client-এর config-এ Outlook চালু থাকলে) SyncOutlook(itemId) enqueue। User সাথে সাথে উত্তর পায়, অপেক্ষা করতে হয় না।
Bell notification + mail (“আপনাকে invite / task দেওয়া হয়েছে”)। Outlook invite আলাদা job-এ যায় (Workflow D)।
প্রত্যেকে calendar খুললে feed API তাকে তার item-গুলো দেয়।
জিজ্ঞেস করে: “শুধু এটা / এটা ও পরেরগুলো / সবগুলো”।
ExceptionDates-এ তারিখ যোগ + বদলানো তথ্য দিয়ে আলাদা নতুন itemএটা ও পরেরগুলো → মূলটার UNTIL আগের দিনে, বাকিটার জন্য নতুন seriesসবগুলো → মূল item বদলায়সময় / তথ্য / attendee বদলালে OutlookSequence + 1। NextTriggerAt নতুন করে হিসাব। সরানো attendee মুছে না ফেলে Status = Removed। Cancel হলে item-এর Status = Cancelled, NextTriggerAt = NULL।
NotifyAttendees(itemId, Updated / Cancelled) + SyncOutlook(itemId)। Outlook-এ একই entry বদলে যায় বা সরে যায়।
calendar-dispatcher recurring job, একসাথে দুইটা চলে না।
NextTriggerAt ≤ এখন?HangfireRepeat ও সব offset মিলিয়ে পরের সময় হিসাব করে: UPDATE … SET NextTriggerAt = @next WHERE ID = @id AND NextTriggerAt = @old। ০ row update হলে অন্য কেউ আগেই নিয়েছে, বাদ।
Server বন্ধ ছিল আর event শুরু হয়ে গেছে, বা grace সময় পেরিয়ে গেছে।
SendReminder(itemId, triggerAt) enqueue।
আগে claim: UPDATE … SET LastReminderAt = @triggerAt WHERE AttendeeID = @id AND (LastReminderAt IS NULL OR LastReminderAt < @triggerAt)। ১ row হলে ReminderChannel অনুযায়ী bell / mail পাঠায়। পাঠাতে ব্যর্থ হলে LastReminderAt আগের মানে ফেরত দিয়ে throw করে, Hangfire পরে আবার চেষ্টা করে (সর্বোচ্চ ৩ বার)। যারা আগেই পেয়েছে তারা আর পায় না।
appsettings: Calendar:OutlookSync।
যাদের InviteSentSequence NULL বা < OutlookSequence → mail-এ METHOD:REQUEST, UID = hrm-{ItemID}@{domain}, SEQUENCE। পাঠানোর পরে InviteSentSequence = OutlookSequence।
Removed attendee (যার আগে invite গেছে) বা item Cancelled → METHOD:CANCEL। Outlook থেকে entry সরে যায়।
প্রতি attendee-র InviteSentSequence আপডেট। কোনো mail ব্যর্থ হলে job throw করে, Hangfire পরে আবার চেষ্টা করে; error ও retry Hangfire dashboard-এ দেখা যায়। যারা আগেই পেয়েছে তারা আবার পায় না।
OutlookEventID না থাকলে create, থাকলে PATCH (attendee তালিকাসহ), Cancelled হলে cancel। Exchange নিজেই সবার Outlook-এ invite পাঠায়। চাইলে Outlook-এর Accept / Decline পড়ে ResponseStatus-এ আনা যায়।
নিজের item, holiday, leave, birthday সব একসাথে।
ResponseStatus update (শুধু নিজের row, ID token থেকে)। Declined হলে আর reminder যায় না। Organizer bell-এ জানতে পারে।
খুললে IsRead, ReadDate। In progress / Done + remarks → TaskStatus, Remarks, RemarksDate। Organizer bell-এ জানতে পারে।
ItemType = 3। Job-এর নিজের Title, Description, Location, Color, Priority, Reminder = যে task তৈরি হবে তার template; Start → End = task-এর মেয়াদ; attendee row (Employee / Department) = target; RRULE = কবে কবে চলবে। NextTriggerAt = প্রথম run।
কিছু তৈরি না করে দেখায় “এই মুহূর্তে চালালে এই ১২ জন task পাবে”।
একই calendar-dispatcher: ItemType = 3 এবং NextTriggerAt ≤ এখন → UPDATE … WHERE NextTriggerAt = @old দিয়ে পরের run-এর তারিখ বসায় → RunScheduleJob(itemId, occurrence) enqueue।
(SourceItemID, SourceOccurrence) দিয়ে খোঁজে। Job Active কিনা আর HR-এর permission আছে কিনা আবার দেখে।
SourceItemID, SourceOccurrence সহ) + attendee (এই মুহূর্তের active employee, PayrollTypeID অনুযায়ী)Workflow A-এর ধাপ ৫ থেকে: notification, Outlook, reminder।
Hangfire-এ শুধু ID pass হয়; সব তথ্য DB-তে থাকে। তাই schedule দুই জায়গায় থাকে না।
| Job | ধরন | কী করে | Retry |
|---|---|---|---|
| calendar-dispatcher | Recurring, প্রতি মিনিটে | 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-forget | Created / Updated / Cancelled / Task assigned / RSVP / Remarks-এর notification | ৩ |
| SyncOutlook(itemId) | Fire-and-forget | ICS বা Graph দিয়ে Outlook-এ পাঠানো | ৩ |
| RunScheduleJob(itemId, occurrence) | Fire-and-forget | Schedule Job থেকে Task তৈরি | ৩ |
| বাদ দেওয়া হয়েছে | শুধু নিজের birthday দেখা যায়, তাই অন্যদের জানানোর digest আর নেই | — |
// 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());
প্রতি client-এর নিজের appsettings.json-এ বাছাই: Calendar:OutlookSync = None | Ics | Graph।
MailSender দিয়েই; Azure লাগে নাtext/calendar; method=REQUEST → Outlook আসল meeting invite দেখায়, Accept করলে calendar-এ বসেMETHOD:CANCELMailSender-এ calendar AlternateView পাঠানোর একটা নতুন method লাগবে (এখন শুধু attachment আছে)। ICS তৈরি হবে Ical.Net দিয়েhrm-calendar@client.com)-এ একটা event, attendee হিসেবে সবার emailOutlookEventID column আগে থেকেই রাখা আছে, তাই Graph চালুর সময় table বদলাতে হবে নাCalendars.ReadWrite (application)appsettings.json-এ commit করা যাবে না.github/copilot-instructions.md অনুযায়ী Azure-সংক্রান্ত কাজের (Mode B) আগে azmcp_bestpractices_get tool ব্যবহার করতে হবে। Mode B শুরুর আগে tool-টা enable করতে হবে।HRM.UI/Controllers/Calendar/CalendarController.cs, [Route("api/Calendar")], [Authorize]। User / EmployeeID সবসময় token থেকে।
| Method | Route | কাজ | কে |
|---|---|---|---|
| GET | getFeed?fromDate=&toDate=&layers= | দেখা যাওয়া সময়ের সব layer একসাথে (repeat expand করে) | সবাই |
| GET | getItem/{id} | একটা item + attendee | Organizer / attendee |
| POST | saveItem | Create / update (item + attendee একসাথে) | Event: সবাই; Task: HR / Line Manager; update: organizer / HR |
| POST | cancelItem/{id} | Cancel for everyone; repeat-এর জন্য ?occurrenceStart=&scope= (1 = শুধু এটা, 2 = এটা ও পরেরগুলো) | Organizer / HR |
| POST | respond | { calendarItemID, responseStatus } — RSVP | Attendee (নিজের) |
| POST | updateTaskStatus | { calendarItemID, taskStatus, remarks } | Assignee (নিজের) |
| POST | markRead/{id} | IsRead = 1 | Attendee (নিজের) |
| GET | getMyTasks?taskStatus= | আমার task তালিকা | সবাই |
| GET | getUpcoming?days=7 | Sidebar / dashboard: সামনের দিনগুলো + open task সংখ্যা | সবাই |
| GET | getOptions | এই login কী করতে পারে (event তৈরি, task assign, birthday) | সবাই |
| POST | previewTargets | Schedule Job-এর test run | HR |
| POST | runNow/{id} | Schedule Job এখনই চালানো | HR |
আপনার design-এর form, calendar আর legend রেখে Google Calendar-এর মতো সাজানো। FullCalendar v6 (month / week / day / list, drag) আগেই project-এ আছে।
এই app-এ menu লুকালেই endpoint সুরক্ষিত হয় না — সব check API-তে।
| কাজ | কে পারবে |
|---|---|
| Event তৈরি ও যে কাউকে invite | সব employee |
| অন্যকে Task assign | HR (যে কাউকে), Line Manager (শুধু নিজের team-কে) |
| Item দেখা | শুধু organizer ও attendee |
| Birthday layer | নিজের department-এর |
| Schedule Job | শুধু HR / admin |
| Edit / Cancel | শুধু organizer ও HR |
| RSVP, task status, remarks, read | শুধু নিজের attendee row |
PayrollTypeID সহMakeSQL-এ %u; কখনো %q না, ; নতুন লাইন)NextTriggerAt = @old শর্তে update — একজনই জেতেLastReminderAt claimUX_CalendarItem_Source UNIQUEInviteSentSequenceRedirectAllMailTo খালি থাকলে mail যায় না"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-এর নিরাপদ জায়গায়।
Calendar)আগে এগুলো Logic config-এ রাখার কথা ছিল; প্রতি client-এর deployment-এর নিজের appsettings.json আছে, তাই এখন সেখানেই।
| Key | মান | শুরুতে |
|---|---|---|
| OutlookSync | None | Ics | Graph | Ics |
| ScheduleJobsEnabled | true | false | true |
এগুলো আর setting না, code-এ স্থির: সব employee event বানাতে পারে; Line Manager নিজের team-কে task দিতে পারে (HR যে কাউকে); birthday / anniversary শুধু নিজেরটা দেখা যায়। Daily birthday digest বাদ।
Graph mode (Phase ৫) এলে Graph অংশ (TenantId, ClientId, OrganizerMailbox) যোগ হবে; secret / certificate এখানে না।
Hangfire.AspNetCore, Hangfire.SqlServer (1.8.x), Ical.Net; Graph mode-এ Microsoft.Graph + Azure.IdentityCalendar_DB_Changes.sql চালানো; Hangfire-এর জন্য DB user-এর DDL অধিকার, অথবা Install.sql হাতে চালানোdeploy.ps1-এর web.config rule-এ <add input="{REQUEST_URI}" pattern="/hangfire" negate="true" />appsettings.json-এর Calendar section client অনুযায়ী ঠিক করাHRM.UI-এর ভেতরেইপ্রতিটা phase শেষে কিছু একটা ব্যবহারযোগ্য অবস্থায় থাকবে। File-এর নাম project-এর বিদ্যমান ধাঁচ মেনে।
web.config rule + IIS settingIcal.Net), ExceptionDates, “শুধু এই দিনটা” (তারিখ বাদ + আলাদা নতুন item)NextTriggerAt হিসাব (save ও প্রতিবার পাঠানোর পরে)CalendarDispatcher (reminder অংশ) + SendReminder + NotifyAttendeesHRM.UI/BackgroundJobs/Calendar/*.csCalendar config section, dev-এ mail redirectMailSender-এ calendar AlternateView পাঠানোর methodHRM.BO/Mail/MailSender.csIcal.Net): REQUEST / CANCEL, UID, SEQUENCE, RRULE, time zoneSyncOutlook job — ICS mode (InviteSentSequence দিয়ে)SourceItemID / SourceOccurrence সহ)CalendarDispatcher-এর Schedule Job অংশ + RunScheduleJobazmcp_bestpractices_get) enable করা — repo-র নিয়মSyncOutlook-এ Graph path: create / patch / cancel, OutlookEventID ব্যবহারResponseStatus-এ আনাCalendar:OutlookSync = Graphএগুলোর উপর ভিত্তি করেই পুরো plan সাজানো। সব কিছুতে best practice মানা হবে।
আগে ICS invite (Mode A)। বাকি সব development শেষ হলে Microsoft Graph (Mode B, Phase ৫)।
সব employee নিজে event বানিয়ে যে কাউকে invite করতে পারবে।
HR যে কাউকে; Line Manager নিজের team-কে।
শুধু নিজের department-এর birthday দেখাবে।
মাত্র ২টা table; notification log table নেই। CalendarItem-এ ২৬ column (Location, ReminderChannel, Priority, OutlookEventID সহ)।
এই plan review হওয়ার পরে, অনুমতি পেলে তবেই শুরু।