HRM-10/HRM.UI/docs/calendar-plan.html
Mohaimen Hasan 838b8d4480 first commit
2026-11-03 13:06:00 +06:00

922 lines
90 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html lang="bn">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>HRM Calendar Plan</title>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Hind+Siliguri:wght@400;500;600&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
<style>
:root {
--bg: #F7F6F2; --surface: #FFFFFF; --text: #2C2C2A; --muted: #5F5E5A; --hint: #888780;
--line: #D3D1C7; --line-soft: #E8E6DE; --arrow: #888780; --code-bg: #F4F3EE;
--teal-bg: #E1F5EE; --teal-bd: #0F6E56; --teal-tx: #085041;
--purple-bg: #EEEDFE; --purple-bd: #534AB7; --purple-tx: #3C3489;
--coral-bg: #FAECE7; --coral-bd: #993C1D; --coral-tx: #712B13;
--pink-bg: #FBEAF0; --pink-bd: #993556; --pink-tx: #72243E;
--blue-bg: #E6F1FB; --blue-bd: #185FA5; --blue-tx: #0C447C;
--gray-bg: #F1EFE8; --gray-bd: #5F5E5A; --gray-tx: #2C2C2A;
--yes-bg: #EAF3DE; --yes-tx: #27500A; --yes-bd: #97C459;
--no-bg: #FCEBEB; --no-tx: #791F1F; --no-bd: #F09595;
--loop-bg: #FAEEDA; --loop-tx: #633806; --loop-bd: #EF9F27;
}
* { box-sizing: border-box; }
html { -webkit-print-color-adjust: exact; print-color-adjust: exact; scroll-behavior: smooth; }
body { margin: 0; background: var(--bg); color: var(--text);
font-family: "Hind Siliguri", "Noto Sans Bengali", "Segoe UI", sans-serif; font-size: 16px; line-height: 1.65; }
code, pre, .mono { font-family: "JetBrains Mono", Consolas, monospace; }
code { font-size: .86em; background: var(--code-bg); border: 1px solid var(--line-soft); border-radius: 4px; padding: 0 5px; }
a { color: var(--blue-bd); }
.page { max-width: 960px; margin: 0 auto; padding: 40px 16px 72px; }
header .eyebrow { font-size: 13px; color: var(--hint); margin: 0 0 4px; }
header h1 { font-size: 32px; font-weight: 600; margin: 0 0 8px; line-height: 1.3; }
header .lead { color: var(--muted); margin: 0 0 22px; max-width: 760px; }
.stats { display: grid; grid-template-columns: repeat(4, 1fr); gap: 12px; margin-bottom: 24px; }
.stat { background: var(--surface); border: 1px solid var(--line); border-radius: 12px; padding: 14px 16px; }
.stat b { display: block; font-size: 28px; font-weight: 600; line-height: 1.2; }
.stat span { color: var(--muted); font-size: 14px; }
.stat.teal b { color: var(--teal-bd); } .stat.purple b { color: var(--purple-bd); }
.stat.blue b { color: var(--blue-bd); } .stat.coral b { color: var(--coral-bd); }
nav.toc { background: var(--surface); border: 1px solid var(--line); border-radius: 12px; padding: 16px 20px; margin-bottom: 8px; }
nav.toc h2 { font-size: 15px; font-weight: 600; margin: 0 0 8px; color: var(--muted); }
nav.toc ol { margin: 0; padding: 0; list-style: none; columns: 2; column-gap: 24px; }
nav.toc li { margin: 3px 0; break-inside: avoid; }
nav.toc a { color: var(--text); text-decoration: none; border-bottom: 1px solid var(--line); }
nav.toc a:hover { border-color: var(--text); }
section { margin-top: 48px; }
section > h2 { font-size: 24px; font-weight: 600; margin: 0 0 6px; display: flex; align-items: baseline; gap: 10px; }
section > h2 .n { font-size: 14px; font-weight: 600; color: #fff; background: var(--text); border-radius: 6px; padding: 1px 9px; }
section > p.sub { color: var(--muted); margin: 0 0 18px; }
h3 { font-size: 18px; font-weight: 600; margin: 26px 0 10px; }
h4 { font-size: 16px; font-weight: 600; margin: 0 0 8px; }
.card { background: var(--surface); border: 1px solid var(--line); border-radius: 12px; padding: 16px 18px; break-inside: avoid; }
.grid2 { display: grid; grid-template-columns: 1fr 1fr; gap: 14px; }
.grid3 { display: grid; grid-template-columns: repeat(3, 1fr); gap: 14px; }
.card ul, .plain { margin: 0; padding-left: 18px; color: var(--muted); }
.card li, .plain li { margin: 3px 0; }
.callout { border-radius: 10px; padding: 12px 16px; border: 1px solid; margin: 14px 0; break-inside: avoid; }
.callout.info { background: var(--blue-bg); border-color: #85B7EB; color: var(--blue-tx); }
.callout.warn { background: var(--loop-bg); border-color: var(--loop-bd); color: var(--loop-tx); }
.callout.ok { background: var(--yes-bg); border-color: var(--yes-bd); color: var(--yes-tx); }
.callout strong { font-weight: 600; }
.table-wrap { overflow-x: auto; border: 1px solid var(--line); border-radius: 12px; background: var(--surface); }
table { width: 100%; border-collapse: collapse; font-size: 14px; }
th, td { text-align: left; padding: 8px 12px; border-bottom: 1px solid var(--line-soft); vertical-align: top; }
th { background: var(--gray-bg); font-weight: 600; font-size: 13px; color: var(--muted); white-space: nowrap; }
tr:last-child td { border-bottom: 0; }
td.col { font-family: "JetBrains Mono", Consolas, monospace; font-size: 13px; white-space: nowrap; color: var(--text); }
td.type { font-family: "JetBrains Mono", Consolas, monospace; font-size: 12px; color: var(--muted); white-space: nowrap; }
td.nul { font-size: 12px; color: var(--hint); white-space: nowrap; }
tr.grp td { background: #FBFAF7; font-weight: 600; font-size: 13px; color: var(--muted); padding-top: 10px; }
.pk { font-size: 11px; font-weight: 600; padding: 0 6px; border-radius: 4px; background: var(--loop-bg); color: var(--loop-tx); border: 1px solid var(--loop-bd); margin-left: 4px; }
.fk { font-size: 11px; font-weight: 600; padding: 0 6px; border-radius: 4px; background: var(--blue-bg); color: var(--blue-tx); border: 1px solid #85B7EB; margin-left: 4px; }
.tbl-head { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; margin: 26px 0 10px; }
.tbl-head h3 { margin: 0; font-family: "JetBrains Mono", Consolas, monospace; font-size: 18px; }
.tbl-head .tag { font-size: 12px; padding: 1px 9px; border-radius: 999px; border: 1px solid; }
pre { background: var(--code-bg); border: 1px solid var(--line); border-radius: 12px; padding: 16px 18px;
font-size: 12.5px; line-height: 1.55; overflow-x: auto; margin: 0; white-space: pre; }
pre .c { color: #888780; } pre .k { color: #534AB7; } pre .s { color: #0F6E56; }
.chip { display: inline-flex; align-items: center; font-size: 12px; font-weight: 500; padding: 1px 9px;
border-radius: 999px; border: 1px solid; white-space: nowrap; }
.a-user { background: var(--teal-bg); border-color: var(--teal-bd); color: var(--teal-tx); }
.a-api { background: var(--gray-bg); border-color: var(--gray-bd); color: var(--gray-tx); }
.a-hf { background: var(--purple-bg); border-color: var(--purple-bd); color: var(--purple-tx); }
.a-out { background: var(--blue-bg); border-color: var(--blue-bd); color: var(--blue-tx); }
.a-emp { background: var(--pink-bg); border-color: var(--pink-bd); color: var(--pink-tx); }
.a-hr { background: var(--coral-bg); border-color: var(--coral-bd); color: var(--coral-tx); }
.legend { display: flex; flex-wrap: wrap; gap: 8px; margin: 0 0 14px; }
.wf { background: var(--surface); border: 1px solid var(--line); border-radius: 16px; padding: 18px 18px 20px; margin-top: 18px; break-inside: avoid-page; }
.wf-head { display: flex; align-items: baseline; gap: 10px; flex-wrap: wrap; margin-bottom: 14px; }
.wf-head .letter { font-weight: 600; font-size: 14px; color: #fff; background: var(--purple-bd); border-radius: 6px; padding: 1px 9px; }
.wf-head h3 { margin: 0; font-size: 19px; }
.wf-head small { color: var(--muted); font-size: 14px; }
.fs { display: grid; grid-template-columns: 34px 1fr; gap: 12px; align-items: start;
border: 1px solid var(--line-soft); border-radius: 10px; padding: 10px 14px; background: #FDFDFB; break-inside: avoid; }
.fs .num { width: 30px; height: 30px; border-radius: 50%; display: grid; place-items: center; font-weight: 600;
font-size: 14px; background: var(--text); color: #fff; margin-top: 2px; }
.fs .t { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
.fs .t b { font-weight: 600; font-size: 16px; }
.fs p { margin: 2px 0 0; color: var(--muted); font-size: 14.5px; }
.fs.dec { border: 1.5px dashed var(--gray-bd); background: var(--surface); }
.fs.dec .num { background: var(--surface); color: var(--gray-tx); border: 1.5px solid var(--gray-bd); border-radius: 6px; transform: rotate(45deg); width: 24px; height: 24px; margin: 5px 0 0 3px; }
.fs.dec .num span { transform: rotate(-45deg); font-size: 12px; }
.br { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 8px; }
.br span { font-size: 13px; padding: 3px 10px; border-radius: 8px; border: 1px solid; }
.br .y { background: var(--yes-bg); color: var(--yes-tx); border-color: var(--yes-bd); }
.br .n { background: var(--no-bg); color: var(--no-tx); border-color: var(--no-bd); }
.br .l { background: var(--loop-bg); color: var(--loop-tx); border-color: var(--loop-bd); }
.ar { height: 22px; position: relative; }
.ar::before { content: ""; position: absolute; left: 30px; top: 2px; bottom: 7px; width: 2px; background: var(--arrow); }
.ar::after { content: ""; position: absolute; left: 25px; bottom: 1px; border-left: 6px solid transparent; border-right: 6px solid transparent; border-top: 7px solid var(--arrow); }
.ui { display: grid; grid-template-columns: 210px 1fr; border: 1px solid var(--line); border-radius: 12px; overflow: hidden; background: var(--surface); }
.ui-side { border-right: 1px solid var(--line); padding: 14px; background: #FBFAF7; font-size: 14px; }
.ui-btn { display: inline-block; background: var(--purple-bd); color: #fff; border-radius: 999px; padding: 6px 16px; font-weight: 500; margin-bottom: 14px; }
.ui-mini { display: grid; grid-template-columns: repeat(7, 1fr); gap: 2px; font-size: 11px; text-align: center; color: var(--muted); margin-bottom: 14px; }
.ui-mini i { font-style: normal; padding: 2px 0; border-radius: 50%; }
.ui-mini i.today { background: var(--purple-bd); color: #fff; }
.ui-layer { display: flex; align-items: center; gap: 8px; margin: 4px 0; }
.ui-layer .sq { width: 12px; height: 12px; border-radius: 3px; }
.ui-side h5 { font-size: 13px; font-weight: 600; color: var(--muted); margin: 14px 0 4px; }
.ui-main { padding: 12px 14px 14px; min-width: 0; }
.ui-bar { display: flex; align-items: center; justify-content: space-between; gap: 8px; flex-wrap: wrap; margin-bottom: 10px; }
.ui-bar b { font-size: 18px; font-weight: 600; }
.seg { display: inline-flex; border: 1px solid var(--line); border-radius: 8px; overflow: hidden; font-size: 13px; }
.seg span { padding: 3px 10px; border-right: 1px solid var(--line); } .seg span:last-child { border-right: 0; }
.seg span.on { background: var(--purple-bg); color: var(--purple-tx); font-weight: 600; }
.cal { display: grid; grid-template-columns: repeat(7, minmax(0, 1fr)); border-top: 1px solid var(--line-soft); border-left: 1px solid var(--line-soft); font-size: 12px; }
.cal div { border-right: 1px solid var(--line-soft); border-bottom: 1px solid var(--line-soft); min-height: 64px; padding: 3px 4px; overflow: hidden; }
.cal div.h { min-height: 0; background: var(--gray-bg); text-align: center; font-weight: 600; color: var(--muted); }
.cal div.wk { background: #F6F5F0; }
.cal .d { color: var(--muted); font-size: 11px; }
.cal .e { display: block; border-radius: 4px; padding: 0 4px; margin-top: 2px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; font-size: 11px; }
.e.ev { background: var(--purple-bg); color: var(--purple-tx); } .e.tk { background: var(--teal-bg); color: var(--teal-tx); }
.e.lv { background: var(--loop-bg); color: var(--loop-tx); } .e.hd { background: var(--no-bg); color: var(--no-tx); }
.e.bd { background: var(--pink-bg); color: var(--pink-tx); }
.phase { border-radius: 14px; border: 1px solid var(--line); background: var(--surface); padding: 18px 20px; margin-top: 16px; break-inside: avoid-page; }
.phase-top { display: flex; align-items: baseline; gap: 10px; flex-wrap: wrap; margin-bottom: 10px; }
.phase-top .p { color: #fff; font-weight: 600; font-size: 13px; border-radius: 6px; padding: 1px 10px; }
.phase-top h3 { margin: 0; font-size: 19px; }
.phase-top small { color: var(--muted); }
.phase ol { margin: 0; padding-left: 22px; }
.phase ol li { margin: 6px 0; }
.phase ol li .files { display: block; font-size: 12.5px; color: var(--muted); font-family: "JetBrains Mono", Consolas, monospace; }
.done { margin-top: 12px; background: var(--yes-bg); border: 1px solid var(--yes-bd); color: var(--yes-tx); border-radius: 10px; padding: 10px 14px; font-size: 14.5px; }
.done strong { font-weight: 600; }
.done ul { margin: 4px 0 0; padding-left: 18px; }
footer { margin-top: 48px; text-align: center; font-size: 13px; color: var(--hint); }
@media (max-width: 760px) {
header h1 { font-size: 25px; }
.stats { grid-template-columns: 1fr 1fr; }
nav.toc ol { columns: 1; }
.grid2, .grid3 { grid-template-columns: 1fr; }
.ui { grid-template-columns: 1fr; }
.ui-side { border-right: 0; border-bottom: 1px solid var(--line); }
.cal div { min-height: 48px; }
}
@media print {
body { background: #fff; font-size: 14px; }
.page { max-width: none; padding: 0; }
nav.toc { display: none; }
section { margin-top: 28px; }
pre { white-space: pre-wrap; }
}
</style>
</head>
<body>
<div class="page">
<header>
<p class="eyebrow">CEL.HRM.5 · Calendar + Hangfire + Outlook · Final plan</p>
<h1>HRM Calendar — সম্পূর্ণ পরিকল্পনা</h1>
<p class="lead">Google Calendar-এর মতো একটা calendar: Event, Task আর Schedule Job তৈরি করা যাবে; attendee-দের নিজের calendar-এ দেখাবে; নির্দিষ্ট দিন আগে Hangfire reminder পাঠাবে; আর Outlook calendar-এও দেখাবে। Holiday, Leave আর Birthday আগের data থেকেই দেখাবে। পুরো feature মাত্র <strong>২টা নতুন table</strong> দিয়ে।</p>
<div class="stats">
<div class="stat teal"><b>২</b><span>নতুন table</span></div>
<div class="stat purple"><b>৫</b><span>Hangfire job</span></div>
<div class="stat blue"><b>২</b><span>Outlook mode (ICS / Graph)</span></div>
<div class="stat coral"><b>৫</b><span>Development phase</span></div>
</div>
</header>
<nav class="toc">
<h2>সূচিপত্র</h2>
<ol>
<li><a href="#s1">১. সংক্ষেপে কী বানাচ্ছি</a></li>
<li><a href="#s2">২. Calendar layer</a></li>
<li><a href="#s3">৩. Database schema (২টা table)</a></li>
<li><a href="#s4">৪. Enum মান</a></li>
<li><a href="#s5">৫. সম্পূর্ণ SQL script</a></li>
<li><a href="#s6">৬. Workflow</a></li>
<li><a href="#s7">৭. Hangfire job</a></li>
<li><a href="#s8">৮. Outlook integration</a></li>
<li><a href="#s9">৯. API endpoint</a></li>
<li><a href="#s10">১০. UI design</a></li>
<li><a href="#s11">১১. Permission ও নিরাপত্তা</a></li>
<li><a href="#s12">১২. Configuration ও deployment</a></li>
<li><a href="#s13">১৩. Development plan</a></li>
<li><a href="#s14">১৪. নেওয়া সিদ্ধান্ত</a></li>
</ol>
</nav>
<!-- ১ -->
<section id="s1">
<h2><span class="n">১</span>সংক্ষেপে কী বানাচ্ছি</h2>
<p class="sub">মূল নীতি: <strong>Database-ই একমাত্র সত্য</strong>, Hangfire শুধু সময়মতো কাজ চালায়।</p>
<div class="grid3">
<div class="card"><h4>Event ও Task</h4><ul><li>সময়, repeat, location, রঙ</li><li>Attendee / Assignee যোগ</li><li>সবার calendar-এ দেখায়</li><li>RSVP, task status, remarks</li></ul></div>
<div class="card"><h4>Reminder (Hangfire)</h4><ul><li>Creator ঠিক করে কতদিন আগে</li><li>একাধিক reminder (যেমন ৩ দিন + ১ ঘণ্টা)</li><li>Bell ও / অথবা Mail</li><li>Decline করলে reminder যায় না</li></ul></div>
<div class="card"><h4>Outlook</h4><ul><li>Invite সরাসরি Outlook calendar-এ</li><li>সময় বদলালে Outlook-এও বদলায়</li><li>Cancel করলে Outlook থেকে সরে যায়</li><li>ICS (সবার জন্য) বা Graph (M365)</li></ul></div>
</div>
<div class="callout info"><strong>Notification log table রাখা হয়নি (আপনার সিদ্ধান্ত অনুযায়ী)।</strong> তার বদলে duplicate আটকানো হবে attendee row-এর <code>LastReminderAt</code> দিয়ে, আর কাকে Outlook-এর কোন version পাঠানো হয়েছে তা থাকবে attendee-র <code>InviteSentSequence</code>-এ। কোন job কখন চলেছে বা fail করেছে তা Hangfire dashboard-এ দেখা যাবে। শুধু একটা জিনিস পাওয়া যাবে না: “অমুক তারিখে কাকে কোন mail গেছে”-এর স্থায়ী history।</div>
</section>
<!-- ২ -->
<section id="s2">
<h2><span class="n">২</span>Calendar layer</h2>
<p class="sub">বাঁ পাশে checkbox দিয়ে প্রতিটা layer চালু বা বন্ধ করা যাবে। শুধু প্রথম তিনটা নতুন table-এ থাকে; বাকিগুলো আগের data থেকে পড়া হয়, নতুন করে কিছু save হয় না।</p>
<div class="table-wrap"><table>
<thead><tr><th>Layer</th><th>কোথা থেকে আসে</th><th>কে দেখে</th><th>Edit</th></tr></thead>
<tbody>
<tr><td><span class="e ev chip" style="border:0">Event</span></td><td><code>CalendarItem</code> (ItemType = 1)</td><td>Organizer ও attendee</td><td>Organizer</td></tr>
<tr><td><span class="e tk chip" style="border:0">Task</span></td><td><code>CalendarItem</code> (ItemType = 2)</td><td>Organizer, assignee</td><td>Organizer; assignee শুধু status ও remarks</td></tr>
<tr><td><span class="chip a-hr">Schedule Job</span></td><td><code>CalendarItem</code> (ItemType = 3)</td><td>শুধু HR / admin</td><td>HR / admin</td></tr>
<tr><td><span class="e hd chip" style="border:0">Weekly holiday / Holiday</span></td><td><code>WeeklyHoliday</code> ও <code>AttnNationalHoliday</code> (HR-এর setup থেকে সরাসরি, যেকোনো বছর)</td><td>সবাই (নিজের location-এর)</td><td>—</td></tr>
<tr><td><span class="e lv chip" style="border:0">Leave</span></td><td>Leave entry (approved)</td><td>শুধু নিজের</td><td>—</td></tr>
<tr><td><span class="e lv chip" style="border:0">Attendance</span></td><td><code>DAILYATTNPROCESS</code> (Present / Late / Absent ...)</td><td>শুধু নিজের</td><td>—</td></tr>
<tr><td><span class="e bd chip" style="border:0">Birthday / Anniversary</span></td><td><code>Employee.BirthDate</code>, joining date থেকে হিসাব</td><td>নিজের department</td><td>—</td></tr>
</tbody>
</table></div>
</section>
<!-- ৩ -->
<section id="s3">
<h2><span class="n">৩</span>Database schema — মাত্র ২টা table</h2>
<p class="sub">এই project-এর নিয়ম মেনে: কোনো IDENTITY নেই (ID আসবে <code>tc.GenerateID</code> দিয়ে), audit column আগের table-গুলোর মতোই। Hangfire-এর নিজের table আলাদা <code>HangFire</code> schema-তে থাকবে, Hangfire নিজেই সেগুলো বানায় ও সামলায়।</p>
<div class="tbl-head"><h3>dbo.CalendarItem</h3><span class="tag a-user">Event · Task · Schedule Job — সব এক table-এ · ২৬ column</span></div>
<div class="table-wrap"><table>
<thead><tr><th>Column</th><th>Type</th><th>Null</th><th>অর্থ</th></tr></thead>
<tbody>
<tr class="grp"><td colspan="4">মূল তথ্য</td></tr>
<tr><td class="col">CalendarItemID<span class="pk">PK</span></td><td class="type">INT</td><td class="nul">না</td><td>GenerateID দিয়ে</td></tr>
<tr><td class="col">ItemType</td><td class="type">TINYINT</td><td class="nul">না</td><td>১ = Event, ২ = Task, ৩ = Schedule Job</td></tr>
<tr><td class="col">Title</td><td class="type">NVARCHAR(250)</td><td class="nul">না</td><td>শিরোনাম</td></tr>
<tr><td class="col">Description</td><td class="type">NVARCHAR(MAX)</td><td class="nul">হ্যাঁ</td><td>বিস্তারিত</td></tr>
<tr><td class="col">Location</td><td class="type">NVARCHAR(500)</td><td class="nul">হ্যাঁ</td><td>জায়গা বা Teams / Zoom link (Outlook invite-এর Location-এ যায়)</td></tr>
<tr><td class="col">Color</td><td class="type">VARCHAR(20)</td><td class="nul">হ্যাঁ</td><td>যেমন <code>#534AB7</code></td></tr>
<tr><td class="col">Priority</td><td class="type">TINYINT</td><td class="nul">হ্যাঁ</td><td>১ Low, ২ Normal, ৩ High (মূলত Task-এর জন্য; Outlook invite-এর importance-এও যায়)</td></tr>
<tr class="grp"><td colspan="4">সময় ও repeat</td></tr>
<tr><td class="col">StartDateTime</td><td class="type">DATETIME</td><td class="nul">না</td><td>শুরু (Task-এ assign-এর তারিখ; Schedule Job-এ প্রথম run)</td></tr>
<tr><td class="col">EndDateTime</td><td class="type">DATETIME</td><td class="nul">না</td><td>শেষ (Task-এ due date; Schedule Job-এ Start থেকে End = তৈরি হওয়া task-এর মেয়াদ)</td></tr>
<tr><td class="col">IsAllDay</td><td class="type">BIT</td><td class="nul">না</td><td>সারাদিন</td></tr>
<tr><td class="col">RecurrenceRule</td><td class="type">VARCHAR(500)</td><td class="nul">হ্যাঁ</td><td>RRULE, যেমন <code>FREQ=WEEKLY;BYDAY=TH;UNTIL=20261231T000000</code> (Outlook-এরও একই format)। NULL = repeat নেই</td></tr>
<tr><td class="col">RecurrenceEndDate</td><td class="type">DATETIME</td><td class="nul">হ্যাঁ</td><td>শেষ occurrence-এর তারিখ (save-এর সময় হিসাব করে রাখা হয়, যাতে calendar খুললে সব পুরোনো series load না হয়)। NULL = শেষ নেই</td></tr>
<tr><td class="col">ExceptionDates</td><td class="type">VARCHAR(MAX)</td><td class="nul">হ্যাঁ</td><td>Repeat-এর যে দিনগুলো বাতিল বা আলাদা করে বদলানো, comma দিয়ে: <code>2026-10-15,2026-10-22</code></td></tr>
<tr class="grp"><td colspan="4">Reminder ও Schedule Job (Hangfire)</td></tr>
<tr><td class="col">ReminderOffsets</td><td class="type">VARCHAR(100)</td><td class="nul">হ্যাঁ</td><td>কত মিনিট আগে, comma দিয়ে: <code>4320,60</code> = ৩ দিন ও ১ ঘণ্টা আগে। NULL = reminder নেই</td></tr>
<tr><td class="col">ReminderChannel</td><td class="type">TINYINT</td><td class="nul">হ্যাঁ</td><td>১ Bell, ২ Mail, ৩ দুটোই</td></tr>
<tr><td class="col">NextTriggerAt</td><td class="type">DATETIME</td><td class="nul">হ্যাঁ</td><td>Hangfire প্রতি মিনিটে এটাই দেখে। Event / Task-এ = পরের reminder-এর সময়; Schedule Job-এ = পরের run-এর সময়। NULL = আর কিছু বাকি নেই</td></tr>
<tr><td class="col">SourceItemID<span class="fk">FK</span></td><td class="type">INT</td><td class="nul">হ্যাঁ</td><td>এই Task কোন Schedule Job বানিয়েছে</td></tr>
<tr><td class="col">SourceOccurrence</td><td class="type">DATETIME</td><td class="nul">হ্যাঁ</td><td>Job-এর কোন run থেকে। <code>(SourceItemID, SourceOccurrence)</code> UNIQUE — একই run দুইবার task বানাতে পারবে না</td></tr>
<tr class="grp"><td colspan="4">Outlook</td></tr>
<tr><td class="col">OutlookSequence</td><td class="type">INT</td><td class="nul">না</td><td>প্রতিবার সময় / তথ্য / attendee বদলালে +১। Outlook এটা দেখে বোঝে এটা আগের entry-র update</td></tr>
<tr><td class="col">OutlookEventID</td><td class="type">NVARCHAR(200)</td><td class="nul">হ্যাঁ</td><td>Graph mode-এ Outlook-এর event ID। ICS mode-এ খালি থাকে; Graph চালুর সময় table বদলাতে হবে না</td></tr>
<tr class="grp"><td colspan="4">অবস্থা ও audit</td></tr>
<tr><td class="col">PayrollTypeID</td><td class="type">INT</td><td class="nul">না</td><td>Data scope (project-এর নিয়ম)</td></tr>
<tr><td class="col">Status</td><td class="type">TINYINT</td><td class="nul">না</td><td>১ Active, ২ Cancelled, ৩ Completed</td></tr>
<tr><td class="col">CreatedBy / CreatedDate</td><td class="type">INT / DATETIME</td><td class="nul">না</td><td>Audit। <code>CreatedBy</code>-ই organizer</td></tr>
<tr><td class="col">ModifiedBy / ModifiedDate</td><td class="type">INT / DATETIME</td><td class="nul">হ্যাঁ</td><td>Audit</td></tr>
</tbody>
</table></div>
<div class="grid2" style="margin-top:14px">
<div class="card"><h4>কিছু column কেন নেই</h4><ul>
<li><strong>Organizer:</strong> <code>CreatedBy</code>-ই organizer; আর organizer নিজেও attendee table-এ <code>Role = Organizer</code> হিসেবে থাকে (তার EmployeeID সেখানে)</li>
<li><strong>Visibility:</strong> নিয়ম সহজ — <strong>শুধু organizer ও attendee দেখে</strong>। পুরো department-কে দেখাতে চাইলে department invite করলেই হয়</li>
<li><strong>“শুধু এই দিনটা” edit:</strong> তারিখটা <code>ExceptionDates</code>-এ যায় আর একটা আলাদা নতুন item তৈরি হয়; link রাখার column লাগে না</li>
</ul></div>
<div class="card"><h4>Schedule Job-এর জন্য আলাদা column নেই</h4><ul>
<li>Job নিজেই task-এর <strong>template</strong>: তার Title, Description, Location, Color, Priority, Reminder দিয়েই task তৈরি হয়</li>
<li>Job-এর attendee-রাই target (Employee / Department)</li>
<li>RRULE বলে কবে কবে চলবে; Start → End = task-এর মেয়াদ</li>
<li>Outlook পাঠানো সফল হলো কিনা: Hangfire dashboard (fail হলে retry ও error সেখানে)</li>
</ul></div>
</div>
<div class="tbl-head"><h3>dbo.CalendarItemAttendee</h3><span class="tag a-emp">কারা আছে + প্রত্যেকের অবস্থা</span></div>
<div class="table-wrap"><table>
<thead><tr><th>Column</th><th>Type</th><th>Null</th><th>অর্থ</th></tr></thead>
<tbody>
<tr class="grp"><td colspan="4">কে</td></tr>
<tr><td class="col">AttendeeID<span class="pk">PK</span></td><td class="type">INT</td><td class="nul">না</td><td>GenerateID দিয়ে</td></tr>
<tr><td class="col">CalendarItemID<span class="fk">FK</span></td><td class="type">INT</td><td class="nul">না</td><td>কোন item</td></tr>
<tr><td class="col">AttendeeType</td><td class="type">TINYINT</td><td class="nul">না</td><td>১ Employee, ২ User, ৩ Department (Department শুধু Schedule Job-এর target হিসেবে; Event / Task-এ department বাছালে save-এর সময় সবাই আলাদা row হয়ে যায়)</td></tr>
<tr><td class="col">EmployeeID</td><td class="type">INT</td><td class="nul">হ্যাঁ</td><td>AttendeeType = ১ হলে</td></tr>
<tr><td class="col">UserID</td><td class="type">INT</td><td class="nul">হ্যাঁ</td><td>AttendeeType = ২ হলে (যেমন EmployeeID ছাড়া admin)</td></tr>
<tr><td class="col">DepartmentID</td><td class="type">INT</td><td class="nul">হ্যাঁ</td><td>AttendeeType = ৩ হলে</td></tr>
<tr><td class="col">Email</td><td class="type">NVARCHAR(200)</td><td class="nul">হ্যাঁ</td><td>Save-এর সময়ের email (Outlook invite-এর জন্য)</td></tr>
<tr><td class="col">Role</td><td class="type">TINYINT</td><td class="nul">না</td><td>১ Organizer, ২ Required, ৩ Optional, ৪ Assignee (organizer-এর row save-এর সময় নিজে থেকে যোগ হয়)</td></tr>
<tr class="grp"><td colspan="4">প্রতি জনের আলাদা তথ্য (আপনার design-এর grid)</td></tr>
<tr><td class="col">TitleOverride</td><td class="type">NVARCHAR(250)</td><td class="nul">হ্যাঁ</td><td>এই জনের জন্য আলাদা title (খালি = মূলটা)</td></tr>
<tr><td class="col">SubjectOverride</td><td class="type">NVARCHAR(250)</td><td class="nul">হ্যাঁ</td><td>আলাদা subject</td></tr>
<tr><td class="col">FromOverride / ToOverride</td><td class="type">DATETIME</td><td class="nul">হ্যাঁ</td><td>আলাদা তারিখ</td></tr>
<tr class="grp"><td colspan="4">উত্তর ও কাজ</td></tr>
<tr><td class="col">ResponseStatus</td><td class="type">TINYINT</td><td class="nul">না</td><td>০ Pending, ১ Accepted, ২ Declined, ৩ Tentative</td></tr>
<tr><td class="col">TaskStatus</td><td class="type">TINYINT</td><td class="nul">হ্যাঁ</td><td>Task-এর জন্য: ০ Not started, ১ In progress, ২ Done</td></tr>
<tr><td class="col">Remarks / RemarksDate</td><td class="type">NVARCHAR(2000) / DATETIME</td><td class="nul">হ্যাঁ</td><td>Employee-র মন্তব্য</td></tr>
<tr><td class="col">IsRead / ReadDate</td><td class="type">BIT / DATETIME</td><td class="nul">না / হ্যাঁ</td><td>খুলে দেখেছে কিনা</td></tr>
<tr class="grp"><td colspan="4">Hangfire ও Outlook-এর হিসাব</td></tr>
<tr><td class="col">LastReminderAt</td><td class="type">DATETIME</td><td class="nul">হ্যাঁ</td><td>শেষ যে reminder-টা এই জনকে গেছে তার নির্ধারিত সময়। এটাই একই reminder দুইবার যাওয়া আটকায়</td></tr>
<tr><td class="col">InviteSentSequence</td><td class="type">INT</td><td class="nul">হ্যাঁ</td><td>Outlook-এর কোন version এই জনকে পাঠানো হয়েছে। NULL = এখনো পাঠানো হয়নি</td></tr>
<tr><td class="col">Status</td><td class="type">TINYINT</td><td class="nul">না</td><td>১ Active, ২ Removed (সরিয়ে দিলে Outlook cancel পাঠানোর জন্য row মুছে না ফেলে Removed করা হয়)</td></tr>
<tr><td class="col">CreatedBy / CreatedDate / ModifiedBy / ModifiedDate</td><td class="type">—</td><td class="nul">—</td><td>Audit</td></tr>
</tbody>
</table></div>
<div class="callout warn"><strong>BO নিয়ে একটা কথা:</strong> <code>BasicBaseObject</code>-এ আগে থেকেই <code>Sequence</code> আর <code>Status</code> (EnumStatus) আছে। নাম মিলে গিয়ে বিভ্রান্তি যাতে না হয়, তাই Outlook-এর column-এর নাম রাখা হয়েছে <code>OutlookSequence</code>, আর নতুন BO দুটো <code>AuditTrailBase</code> থেকে বানিয়ে নিজস্ব Status enum ব্যবহার করবে।</div>
</section>
<!-- ৪ -->
<section id="s4">
<h2><span class="n">৪</span>Enum মান</h2>
<p class="sub">C#-এ <code>HRM.BO</code>-এ enum হিসেবে থাকবে; DB-তে TINYINT।</p>
<div class="grid3">
<div class="card"><h4>EnumCalendarItemType</h4><ul><li>1 Event</li><li>2 Task</li><li>3 ScheduleJob</li></ul></div>
<div class="card"><h4>EnumCalendarPriority</h4><ul><li>1 Low</li><li>2 Normal</li><li>3 High</li></ul></div>
<div class="card"><h4>EnumCalendarItemStatus</h4><ul><li>1 Active</li><li>2 Cancelled</li><li>3 Completed</li></ul></div>
<div class="card"><h4>EnumAttendeeType</h4><ul><li>1 Employee</li><li>2 User</li><li>3 Department</li></ul></div>
<div class="card"><h4>EnumAttendeeRole</h4><ul><li>1 Organizer</li><li>2 Required</li><li>3 Optional</li><li>4 Assignee</li></ul></div>
<div class="card"><h4>EnumResponseStatus</h4><ul><li>0 Pending</li><li>1 Accepted</li><li>2 Declined</li><li>3 Tentative</li></ul></div>
<div class="card"><h4>EnumCalendarTaskStatus</h4><ul><li>0 NotStarted</li><li>1 InProgress</li><li>2 Done</li></ul></div>
<div class="card"><h4>EnumReminderChannel</h4><ul><li>1 Bell</li><li>2 Mail</li><li>3 Both</li></ul></div>
<div class="card"><h4>EnumAttendeeStatus</h4><ul><li>1 Active</li><li>2 Removed</li></ul></div>
</div>
</section>
<!-- ৫ -->
<section id="s5">
<h2><span class="n">৫</span>সম্পূর্ণ SQL script</h2>
<p class="sub">Repo-র root-এ <code>Calendar_DB_Changes.sql</code> নামে রাখা হবে। আগের script-গুলোর মতোই guarded, তাই একাধিকবার চালালেও সমস্যা নেই।</p>
<pre><span class="c">/* =====================================================================
Calendar_DB_Changes.sql
HRM Calendar: Event / Task / Schedule Job + attendees (2 tables).
Re-runnable. IDs come from tc.GenerateID (no IDENTITY).
===================================================================== */</span>
<span class="k">SET</span> ANSI_NULLS <span class="k">ON</span>;
<span class="k">SET</span> QUOTED_IDENTIFIER <span class="k">ON</span>;
GO
<span class="c">/* ---------- 1. dbo.CalendarItem ---------- */</span>
<span class="k">IF</span> OBJECT_ID(N<span class="s">'dbo.CalendarItem'</span>, N<span class="s">'U'</span>) <span class="k">IS NULL</span>
<span class="k">BEGIN</span>
<span class="k">CREATE TABLE</span> dbo.CalendarItem (
CalendarItemID INT NOT NULL,
ItemType TINYINT NOT NULL, <span class="c">-- 1 Event, 2 Task, 3 ScheduleJob</span>
Title NVARCHAR(250) NOT NULL,
Description NVARCHAR(MAX) NULL,
Location NVARCHAR(500) NULL,
Color VARCHAR(20) NULL,
Priority TINYINT NULL, <span class="c">-- 1 Low, 2 Normal, 3 High</span>
StartDateTime DATETIME NOT NULL,
EndDateTime DATETIME NOT NULL,
IsAllDay BIT NOT NULL CONSTRAINT DF_CalendarItem_IsAllDay DEFAULT (0),
RecurrenceRule VARCHAR(500) NULL, <span class="c">-- RFC 5545 RRULE</span>
RecurrenceEndDate DATETIME NULL, <span class="c">-- NULL = never ends</span>
ExceptionDates VARCHAR(MAX) NULL, <span class="c">-- 'yyyy-MM-dd,yyyy-MM-dd'</span>
ReminderOffsets VARCHAR(100) NULL, <span class="c">-- minutes before, e.g. '4320,60'</span>
ReminderChannel TINYINT NULL, <span class="c">-- 1 Bell, 2 Mail, 3 Both</span>
NextTriggerAt DATETIME NULL, <span class="c">-- next reminder (Event/Task) or next run (ScheduleJob)</span>
SourceItemID INT NULL, <span class="c">-- task created by this ScheduleJob</span>
SourceOccurrence DATETIME NULL,
OutlookSequence INT NOT NULL CONSTRAINT DF_CalendarItem_OutlookSequence DEFAULT (0),
OutlookEventID NVARCHAR(200) NULL, <span class="c">-- Microsoft Graph event id (later phase)</span>
PayrollTypeID INT NOT NULL,
Status TINYINT NOT NULL CONSTRAINT DF_CalendarItem_Status DEFAULT (1), <span class="c">-- 1 Active, 2 Cancelled, 3 Completed</span>
CreatedBy INT NOT NULL,
CreatedDate DATETIME NOT NULL,
ModifiedBy INT NULL,
ModifiedDate DATETIME NULL,
<span class="k">CONSTRAINT</span> PK_CalendarItem <span class="k">PRIMARY KEY</span> (CalendarItemID),
<span class="k">CONSTRAINT</span> FK_CalendarItem_Source <span class="k">FOREIGN KEY</span> (SourceItemID) <span class="k">REFERENCES</span> dbo.CalendarItem (CalendarItemID),
<span class="k">CONSTRAINT</span> CK_CalendarItem_Dates <span class="k">CHECK</span> (EndDateTime >= StartDateTime),
<span class="k">CONSTRAINT</span> CK_CalendarItem_ItemType <span class="k">CHECK</span> (ItemType <span class="k">IN</span> (1, 2, 3)),
<span class="k">CONSTRAINT</span> CK_CalendarItem_Priority <span class="k">CHECK</span> (Priority <span class="k">IS NULL OR</span> Priority <span class="k">IN</span> (1, 2, 3)),
<span class="k">CONSTRAINT</span> CK_CalendarItem_Channel <span class="k">CHECK</span> (ReminderChannel <span class="k">IS NULL OR</span> ReminderChannel <span class="k">IN</span> (1, 2, 3)),
<span class="k">CONSTRAINT</span> CK_CalendarItem_Status <span class="k">CHECK</span> (Status <span class="k">IN</span> (1, 2, 3))
);
<span class="k">END</span>
GO
<span class="c">/* calendar feed: items overlapping a date range */</span>
<span class="k">IF NOT EXISTS</span> (<span class="k">SELECT</span> 1 <span class="k">FROM</span> sys.indexes <span class="k">WHERE</span> name = <span class="s">'IX_CalendarItem_Range'</span> <span class="k">AND</span> object_id = OBJECT_ID(<span class="s">'dbo.CalendarItem'</span>))
<span class="k">CREATE INDEX</span> IX_CalendarItem_Range <span class="k">ON</span> dbo.CalendarItem (StartDateTime, RecurrenceEndDate)
<span class="k">INCLUDE</span> (ItemType, Status, PayrollTypeID);
GO
<span class="c">/* Hangfire dispatcher: reminders and schedule-job runs that are due */</span>
<span class="k">IF NOT EXISTS</span> (<span class="k">SELECT</span> 1 <span class="k">FROM</span> sys.indexes <span class="k">WHERE</span> name = <span class="s">'IX_CalendarItem_NextTriggerAt'</span> <span class="k">AND</span> object_id = OBJECT_ID(<span class="s">'dbo.CalendarItem'</span>))
<span class="k">CREATE INDEX</span> IX_CalendarItem_NextTriggerAt <span class="k">ON</span> dbo.CalendarItem (NextTriggerAt)
<span class="k">INCLUDE</span> (ItemType)
<span class="k">WHERE</span> NextTriggerAt <span class="k">IS NOT NULL AND</span> Status = 1;
GO
<span class="c">/* one schedule-job run can create its task only once */</span>
<span class="k">IF NOT EXISTS</span> (<span class="k">SELECT</span> 1 <span class="k">FROM</span> sys.indexes <span class="k">WHERE</span> name = <span class="s">'UX_CalendarItem_Source'</span> <span class="k">AND</span> object_id = OBJECT_ID(<span class="s">'dbo.CalendarItem'</span>))
<span class="k">CREATE UNIQUE INDEX</span> UX_CalendarItem_Source <span class="k">ON</span> dbo.CalendarItem (SourceItemID, SourceOccurrence)
<span class="k">WHERE</span> SourceItemID <span class="k">IS NOT NULL</span>;
GO
<span class="c">/* ---------- 2. dbo.CalendarItemAttendee ---------- */</span>
<span class="k">IF</span> OBJECT_ID(N<span class="s">'dbo.CalendarItemAttendee'</span>, N<span class="s">'U'</span>) <span class="k">IS NULL</span>
<span class="k">BEGIN</span>
<span class="k">CREATE TABLE</span> dbo.CalendarItemAttendee (
AttendeeID INT NOT NULL,
CalendarItemID INT NOT NULL,
AttendeeType TINYINT NOT NULL, <span class="c">-- 1 Employee, 2 User, 3 Department</span>
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), <span class="c">-- 1 Active, 2 Removed</span>
CreatedBy INT NOT NULL,
CreatedDate DATETIME NOT NULL,
ModifiedBy INT NULL,
ModifiedDate DATETIME NULL,
<span class="k">CONSTRAINT</span> PK_CalendarItemAttendee <span class="k">PRIMARY KEY</span> (AttendeeID),
<span class="k">CONSTRAINT</span> FK_CalAtt_Item <span class="k">FOREIGN KEY</span> (CalendarItemID) <span class="k">REFERENCES</span> dbo.CalendarItem (CalendarItemID),
<span class="k">CONSTRAINT</span> CK_CalAtt_Target <span class="k">CHECK</span> (
(AttendeeType = 1 <span class="k">AND</span> EmployeeID <span class="k">IS NOT NULL</span>)
<span class="k">OR</span> (AttendeeType = 2 <span class="k">AND</span> UserID <span class="k">IS NOT NULL</span>)
<span class="k">OR</span> (AttendeeType = 3 <span class="k">AND</span> DepartmentID <span class="k">IS NOT NULL</span>))
);
<span class="k">END</span>
GO
<span class="c">/* same person / department only once per item */</span>
<span class="k">IF NOT EXISTS</span> (<span class="k">SELECT</span> 1 <span class="k">FROM</span> sys.indexes <span class="k">WHERE</span> name = <span class="s">'UX_CalAtt_Employee'</span> <span class="k">AND</span> object_id = OBJECT_ID(<span class="s">'dbo.CalendarItemAttendee'</span>))
<span class="k">CREATE UNIQUE INDEX</span> UX_CalAtt_Employee <span class="k">ON</span> dbo.CalendarItemAttendee (CalendarItemID, EmployeeID) <span class="k">WHERE</span> EmployeeID <span class="k">IS NOT NULL</span>;
GO
<span class="k">IF NOT EXISTS</span> (<span class="k">SELECT</span> 1 <span class="k">FROM</span> sys.indexes <span class="k">WHERE</span> name = <span class="s">'UX_CalAtt_User'</span> <span class="k">AND</span> object_id = OBJECT_ID(<span class="s">'dbo.CalendarItemAttendee'</span>))
<span class="k">CREATE UNIQUE INDEX</span> UX_CalAtt_User <span class="k">ON</span> dbo.CalendarItemAttendee (CalendarItemID, UserID) <span class="k">WHERE</span> UserID <span class="k">IS NOT NULL</span>;
GO
<span class="k">IF NOT EXISTS</span> (<span class="k">SELECT</span> 1 <span class="k">FROM</span> sys.indexes <span class="k">WHERE</span> name = <span class="s">'UX_CalAtt_Department'</span> <span class="k">AND</span> object_id = OBJECT_ID(<span class="s">'dbo.CalendarItemAttendee'</span>))
<span class="k">CREATE UNIQUE INDEX</span> UX_CalAtt_Department <span class="k">ON</span> dbo.CalendarItemAttendee (CalendarItemID, DepartmentID) <span class="k">WHERE</span> DepartmentID <span class="k">IS NOT NULL</span>;
GO
<span class="c">/* "my calendar": items where I am an attendee */</span>
<span class="k">IF NOT EXISTS</span> (<span class="k">SELECT</span> 1 <span class="k">FROM</span> sys.indexes <span class="k">WHERE</span> name = <span class="s">'IX_CalAtt_EmployeeLookup'</span> <span class="k">AND</span> object_id = OBJECT_ID(<span class="s">'dbo.CalendarItemAttendee'</span>))
<span class="k">CREATE INDEX</span> IX_CalAtt_EmployeeLookup <span class="k">ON</span> dbo.CalendarItemAttendee (EmployeeID, Status)
<span class="k">INCLUDE</span> (CalendarItemID, ResponseStatus, TaskStatus);
GO
<span class="k">IF NOT EXISTS</span> (<span class="k">SELECT</span> 1 <span class="k">FROM</span> sys.indexes <span class="k">WHERE</span> name = <span class="s">'IX_CalAtt_UserLookup'</span> <span class="k">AND</span> object_id = OBJECT_ID(<span class="s">'dbo.CalendarItemAttendee'</span>))
<span class="k">CREATE INDEX</span> IX_CalAtt_UserLookup <span class="k">ON</span> dbo.CalendarItemAttendee (UserID, Status)
<span class="k">INCLUDE</span> (CalendarItemID, ResponseStatus);
GO
<span class="c">/* 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. */</span></pre>
<div class="callout info">EmployeeID, UserID আর DepartmentID-এ ইচ্ছা করেই FK দেওয়া হয়নি, কারণ project-এর অন্য table-গুলোতেও এগুলো সাধারণত FK ছাড়াই রাখা হয়। চাইলে আপনার DB-র আসল table নাম দেখে FK যোগ করা যাবে।</div>
</section>
<!-- ৬ -->
<section id="s6">
<h2><span class="n">৬</span>Workflow</h2>
<p class="sub">প্রতিটা ধাপের পাশে রঙিন tag বলে দেয় কাজটা কে করছে।</p>
<div class="legend">
<span class="chip a-user">User (UI)</span><span class="chip a-api">HRM API</span><span class="chip a-hf">Hangfire</span>
<span class="chip a-out">Outlook</span><span class="chip a-emp">Employee</span><span class="chip a-hr">HR / Admin</span>
</div>
<!-- A -->
<div class="wf">
<div class="wf-head"><span class="letter">A</span><h3>Event বা Task তৈরি</h3><small>সবচেয়ে বেশি ব্যবহৃত flow</small></div>
<div class="fs"><div class="num">১</div><div><div class="t"><b>Calendar-এ তারিখে click করে</b><span class="chip a-user">User</span></div><p>ছোট quick-create popup (title + সময়)। “More options” চাপলে পুরো form খোলে।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">২</div><div><div class="t"><b>Form পূরণ করে</b><span class="chip a-user">User</span></div><p>Type, title, শুরু-শেষ, সারাদিন, repeat, location, color, priority, guests / assignee (প্রয়োজনে প্রতি জনের আলাদা title / তারিখ), reminder (যেমন ৩ দিন আগে) ও কীভাবে (Bell / Mail / দুটোই)।</p></div></div>
<div class="ar"></div>
<div class="fs dec"><div class="num"><span>৩</span></div><div><div class="t"><b>Permission ও data ঠিক আছে?</b><span class="chip a-api">API</span></div><p>Token থেকে user; Task হলে assign করার অধিকার (HR, বা assignee-র Line Manager); RRULE ও reminder parse করে যাচাই; শেষ ≥ শুরু; guest-এর সংখ্যা সীমার মধ্যে।</p><div class="br"><span class="y">হ্যাঁ → ধাপ ৪</span><span class="n">না → ভুলের বার্তা, form-এ ফেরত</span></div></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৪</div><div><div class="t"><b>এক transaction-এ save</b><span class="chip a-api">API</span></div><p><code>CalendarItem</code> + সব <code>CalendarItemAttendee</code> (organizer নিজে <code>Role = Organizer</code> row; department বাছালে সবাই আলাদা row)। <code>RecurrenceEndDate</code>, <code>NextTriggerAt</code> হিসাব; <code>OutlookSequence = 1</code>।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৫</div><div><div class="t"><b>Commit-এর পরে Hangfire-এ কাজ পাঠায়</b><span class="chip a-api">API</span><span class="chip a-hf">Hangfire</span></div><p><code>NotifyAttendees(itemId, Created)</code> আর (client-এর config-এ Outlook চালু থাকলে) <code>SyncOutlook(itemId)</code> enqueue। User সাথে সাথে উত্তর পায়, অপেক্ষা করতে হয় না।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৬</div><div><div class="t"><b>Attendee-দের জানানো হয়</b><span class="chip a-hf">Hangfire</span><span class="chip a-out">Outlook</span></div><p>Bell notification + mail (“আপনাকে invite / task দেওয়া হয়েছে”)। Outlook invite আলাদা job-এ যায় (Workflow D)।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৭</div><div><div class="t"><b>সবার calendar-এ দেখায়</b><span class="chip a-emp">Employee</span></div><p>প্রত্যেকে calendar খুললে feed API তাকে তার item-গুলো দেয়।</p></div></div>
</div>
<!-- B -->
<div class="wf">
<div class="wf-head"><span class="letter">B</span><h3>Edit বা Cancel</h3><small>শুধু organizer (আর HR)</small></div>
<div class="fs dec"><div class="num"><span>১</span></div><div><div class="t"><b>Repeat event?</b><span class="chip a-user">User</span></div><p>জিজ্ঞেস করে: “শুধু এটা / এটা ও পরেরগুলো / সবগুলো”।</p><div class="br"><span class="y">শুধু এটা → মূল item-এর <code>ExceptionDates</code>-এ তারিখ যোগ + বদলানো তথ্য দিয়ে আলাদা নতুন item</span><span class="l">এটা ও পরেরগুলো → মূলটার UNTIL আগের দিনে, বাকিটার জন্য নতুন series</span><span class="y">সবগুলো → মূল item বদলায়</span></div></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">২</div><div><div class="t"><b>পরিবর্তন save</b><span class="chip a-api">API</span></div><p>সময় / তথ্য / attendee বদলালে <code>OutlookSequence + 1</code>। <code>NextTriggerAt</code> নতুন করে হিসাব। সরানো attendee মুছে না ফেলে <code>Status = Removed</code>। Cancel হলে item-এর <code>Status = Cancelled</code>, <code>NextTriggerAt = NULL</code>।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৩</div><div><div class="t"><b>সবাইকে জানানো</b><span class="chip a-hf">Hangfire</span></div><p><code>NotifyAttendees(itemId, Updated / Cancelled)</code> + <code>SyncOutlook(itemId)</code>। Outlook-এ একই entry বদলে যায় বা সরে যায়।</p></div></div>
</div>
<!-- C -->
<div class="wf">
<div class="wf-head"><span class="letter">C</span><h3>Reminder (যেমন ৩ দিন আগে)</h3><small>Hangfire নিজে থেকে চালায়</small></div>
<div class="fs"><div class="num">১</div><div><div class="t"><b>প্রতি ১ মিনিটে dispatcher চলে</b><span class="chip a-hf">Hangfire</span></div><p><code>calendar-dispatcher</code> recurring job, একসাথে দুইটা চলে না।</p></div></div>
<div class="ar"></div>
<div class="fs dec"><div class="num"><span>২</span></div><div><div class="t"><b>কোনো Event / Task-এর <code>NextTriggerAt</code> ≤ এখন?</b><span class="chip a-hf">Hangfire</span></div><div class="br"><span class="y">হ্যাঁ → ধাপ ৩</span><span class="l">না → ১ মিনিট পরে আবার</span></div></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৩</div><div><div class="t"><b>পরের reminder-এর সময় বসায় (একজনই জেতে)</b><span class="chip a-hf">Hangfire</span></div><p>Repeat ও সব offset মিলিয়ে পরের সময় হিসাব করে: <code>UPDATE … SET NextTriggerAt = @next WHERE ID = @id AND NextTriggerAt = @old</code>। ০ row update হলে অন্য কেউ আগেই নিয়েছে, বাদ।</p></div></div>
<div class="ar"></div>
<div class="fs dec"><div class="num"><span>৪</span></div><div><div class="t"><b>খুব দেরি হয়ে গেছে?</b><span class="chip a-hf">Hangfire</span></div><p>Server বন্ধ ছিল আর event শুরু হয়ে গেছে, বা grace সময় পেরিয়ে গেছে।</p><div class="br"><span class="n">হ্যাঁ → এই reminder বাদ</span><span class="y">না → ধাপ ৫</span></div></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৫</div><div><div class="t"><b>Send job queue-তে</b><span class="chip a-hf">Hangfire</span></div><p><code>SendReminder(itemId, triggerAt)</code> enqueue।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৬</div><div><div class="t"><b>প্রতি attendee-কে পাঠায় (Declined বাদ)</b><span class="chip a-hf">Hangfire</span><span class="chip a-emp">Employee</span></div><p>আগে claim: <code>UPDATE … SET LastReminderAt = @triggerAt WHERE AttendeeID = @id AND (LastReminderAt IS NULL OR LastReminderAt &lt; @triggerAt)</code>। ১ row হলে <code>ReminderChannel</code> অনুযায়ী bell / mail পাঠায়। পাঠাতে ব্যর্থ হলে <code>LastReminderAt</code> আগের মানে ফেরত দিয়ে throw করে, Hangfire পরে আবার চেষ্টা করে (সর্বোচ্চ ৩ বার)। যারা আগেই পেয়েছে তারা আর পায় না।</p></div></div>
</div>
<!-- D -->
<div class="wf">
<div class="wf-head"><span class="letter">D</span><h3>Outlook-এ পাঠানো</h3><small>Create / Edit / Cancel-এর পরে</small></div>
<div class="fs dec"><div class="num"><span>১</span></div><div><div class="t"><b>Client-এর Outlook mode কী?</b><span class="chip a-hf">Hangfire</span></div><p>appsettings: <code>Calendar:OutlookSync</code>।</p><div class="br"><span class="n">None → থামে</span><span class="y">Ics → ধাপ ২</span><span class="l">Graph → ধাপ ৫</span></div></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">২</div><div><div class="t"><b>ICS: নতুন বা পুরোনো version পাওয়া attendee-দের invite</b><span class="chip a-hf">Hangfire</span><span class="chip a-out">Outlook</span></div><p>যাদের <code>InviteSentSequence</code> NULL বা <code>&lt; OutlookSequence</code> → mail-এ <code>METHOD:REQUEST</code>, <code>UID = hrm-{ItemID}@{domain}</code>, <code>SEQUENCE</code>। পাঠানোর পরে <code>InviteSentSequence = OutlookSequence</code>।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৩</div><div><div class="t"><b>ICS: সরানো attendee বা বাতিল item</b><span class="chip a-hf">Hangfire</span><span class="chip a-out">Outlook</span></div><p>Removed attendee (যার আগে invite গেছে) বা item Cancelled → <code>METHOD:CANCEL</code>। Outlook থেকে entry সরে যায়।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৪</div><div><div class="t"><b>ফলাফল লেখা</b><span class="chip a-hf">Hangfire</span></div><p>প্রতি attendee-র <code>InviteSentSequence</code> আপডেট। কোনো mail ব্যর্থ হলে job throw করে, Hangfire পরে আবার চেষ্টা করে; error ও retry Hangfire dashboard-এ দেখা যায়। যারা আগেই পেয়েছে তারা আবার পায় না।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৫</div><div><div class="t"><b>Graph (পরের phase): organizer mailbox-এ একটা event</b><span class="chip a-hf">Hangfire</span><span class="chip a-out">Outlook</span></div><p><code>OutlookEventID</code> না থাকলে create, থাকলে <code>PATCH</code> (attendee তালিকাসহ), Cancelled হলে cancel। Exchange নিজেই সবার Outlook-এ invite পাঠায়। চাইলে Outlook-এর Accept / Decline পড়ে <code>ResponseStatus</code>-এ আনা যায়।</p></div></div>
</div>
<!-- E -->
<div class="wf">
<div class="wf-head"><span class="letter">E</span><h3>Employee-র দিক</h3><small>ESS থেকে</small></div>
<div class="fs"><div class="num">১</div><div><div class="t"><b>Bell-এ notification দেখে, calendar বা My Tasks খোলে</b><span class="chip a-emp">Employee</span></div><p>নিজের item, holiday, leave, birthday সব একসাথে।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">২</div><div><div class="t"><b>Event-এ Yes / No / Maybe</b><span class="chip a-emp">Employee</span><span class="chip a-api">API</span></div><p><code>ResponseStatus</code> update (শুধু নিজের row, ID token থেকে)। Declined হলে আর reminder যায় না। Organizer bell-এ জানতে পারে।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৩</div><div><div class="t"><b>Task খোলে, status ও remarks দেয়</b><span class="chip a-emp">Employee</span><span class="chip a-api">API</span></div><p>খুললে <code>IsRead</code>, <code>ReadDate</code>। In progress / Done + remarks → <code>TaskStatus</code>, <code>Remarks</code>, <code>RemarksDate</code>। Organizer bell-এ জানতে পারে।</p></div></div>
</div>
<!-- F -->
<div class="wf">
<div class="wf-head"><span class="letter">F</span><h3>Schedule Job (নির্দিষ্ট দিনে নিজে থেকে task assign)</h3><small>শুধু HR / admin</small></div>
<div class="fs"><div class="num">১</div><div><div class="t"><b>Schedule Job তৈরি</b><span class="chip a-hr">HR</span></div><p><code>ItemType = 3</code>। Job-এর নিজের Title, Description, Location, Color, Priority, Reminder = যে task তৈরি হবে তার template; Start → End = task-এর মেয়াদ; attendee row (Employee / Department) = target; RRULE = কবে কবে চলবে। <code>NextTriggerAt</code> = প্রথম run।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">২</div><div><div class="t"><b>Test run</b><span class="chip a-hr">HR</span></div><p>কিছু তৈরি না করে দেখায় “এই মুহূর্তে চালালে এই ১২ জন task পাবে”।</p></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৩</div><div><div class="t"><b>সময় হলে dispatcher ধরে</b><span class="chip a-hf">Hangfire</span></div><p>একই <code>calendar-dispatcher</code>: <code>ItemType = 3</code> এবং <code>NextTriggerAt ≤ এখন</code> → <code>UPDATE … WHERE NextTriggerAt = @old</code> দিয়ে পরের run-এর তারিখ বসায় → <code>RunScheduleJob(itemId, occurrence)</code> enqueue।</p></div></div>
<div class="ar"></div>
<div class="fs dec"><div class="num"><span>৪</span></div><div><div class="t"><b>এই run-এর task আগেই তৈরি হয়েছে?</b><span class="chip a-hf">Hangfire</span></div><p><code>(SourceItemID, SourceOccurrence)</code> দিয়ে খোঁজে। Job Active কিনা আর HR-এর permission আছে কিনা আবার দেখে।</p><div class="br"><span class="l">হ্যাঁ (retry) → শুধু বাদ পড়া employee যোগ</span><span class="y">না → job-এর template থেকে নতুন Task item (<code>SourceItemID</code>, <code>SourceOccurrence</code> সহ) + attendee (এই মুহূর্তের active employee, PayrollTypeID অনুযায়ী)</span></div></div></div>
<div class="ar"></div>
<div class="fs"><div class="num">৫</div><div><div class="t"><b>বাকিটা সাধারণ Task-এর মতোই</b><span class="chip a-hf">Hangfire</span></div><p>Workflow A-এর ধাপ ৫ থেকে: notification, Outlook, reminder।</p></div></div>
</div>
</section>
<!-- ৭ -->
<section id="s7">
<h2><span class="n">৭</span>Hangfire job</h2>
<p class="sub">Hangfire-এ শুধু ID pass হয়; সব তথ্য DB-তে থাকে। তাই schedule দুই জায়গায় থাকে না।</p>
<div class="table-wrap"><table>
<thead><tr><th>Job</th><th>ধরন</th><th>কী করে</th><th>Retry</th></tr></thead>
<tbody>
<tr><td class="col">calendar-dispatcher</td><td>Recurring, প্রতি মিনিটে</td><td><code>NextTriggerAt ≤ এখন</code> এমন item: Event / Task হলে <code>SendReminder</code>, Schedule Job হলে <code>RunScheduleJob</code> enqueue</td><td>০ (পরের মিনিটে এমনিই চলবে); <code>DisableConcurrentExecution</code></td></tr>
<tr><td class="col">SendReminder(itemId, triggerAt)</td><td>Fire-and-forget</td><td>প্রতি attendee-কে bell / mail, <code>LastReminderAt</code> দিয়ে duplicate রোধ</td><td>৩</td></tr>
<tr><td class="col">NotifyAttendees(itemId, change)</td><td>Fire-and-forget</td><td>Created / Updated / Cancelled / Task assigned / RSVP / Remarks-এর notification</td><td>৩</td></tr>
<tr><td class="col">SyncOutlook(itemId)</td><td>Fire-and-forget</td><td>ICS বা Graph দিয়ে Outlook-এ পাঠানো</td><td>৩</td></tr>
<tr><td class="col">RunScheduleJob(itemId, occurrence)</td><td>Fire-and-forget</td><td>Schedule Job থেকে Task তৈরি</td><td>৩</td></tr>
<tr><td class="col"><s>daily-birthday-digest</s></td><td>বাদ দেওয়া হয়েছে</td><td>শুধু নিজের birthday দেখা যায়, তাই অন্যদের জানানোর digest আর নেই</td><td>—</td></tr>
</tbody>
</table></div>
<h3>Startup setup</h3>
<pre><span class="c">// Startup.ConfigureServices</span>
services.AddHangfire(cfg => cfg
.SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
.UseSimpleAssemblyNameTypeSerializer()
.UseRecommendedSerializerSettings()
.UseSqlServerStorage(
() => (DbConnection)ConnectionFactory.Default.CreateConnection(), <span class="c">// encrypted password আগের মতোই decrypt হয়</span>
<span class="k">new</span> SqlServerStorageOptions { SchemaName = <span class="s">"HangFire"</span>, PrepareSchemaIfNecessary = <span class="k">true</span> }));
services.AddHangfireServer(o => { o.WorkerCount = 4; o.Queues = <span class="k">new</span>[] { <span class="s">"calendar"</span>, <span class="s">"default"</span> }; });
<span class="c">// Startup.Configure — অবশ্যই UseSpa(...)-এর আগে</span>
app.UseHangfireDashboard(<span class="s">"/hangfire"</span>, <span class="k">new</span> DashboardOptions {
Authorization = <span class="k">new</span>[] { <span class="k">new</span> LocalRequestsOnlyAuthorizationFilter() } }); <span class="c">// শুধু server-এর localhost</span>
<span class="k">var</span> jobs = app.ApplicationServices.GetRequiredService&lt;IRecurringJobManager&gt;();
jobs.AddOrUpdate&lt;CalendarDispatcher&gt;(<span class="s">"calendar-dispatcher"</span>, j => j.Run(), Cron.Minutely());</pre>
<div class="callout warn"><strong>মনে রাখবেন:</strong> Job class-এর নাম বা namespace পরে বদলাবেন না, queue-তে থাকা পুরোনো job ভেঙে যাবে। Hangfire-এর সফল job-এর history কিছুদিন পর নিজে থেকে মুছে যায়; fail করা job dashboard-এ থেকে যায়।</div>
</section>
<!-- ৮ -->
<section id="s8">
<h2><span class="n">৮</span>Outlook integration</h2>
<p class="sub">প্রতি client-এর নিজের <code>appsettings.json</code>-এ বাছাই: <code>Calendar:OutlookSync = None | Ics | Graph</code>।</p>
<div class="grid2">
<div class="card">
<h4>Mode A — ICS invite (সব client-এর জন্য, আগে এটা)</h4>
<ul>
<li>এখনকার SMTP <code>MailSender</code> দিয়েই; Azure লাগে না</li>
<li>Mail-এ <code>text/calendar; method=REQUEST</code> → Outlook আসল meeting invite দেখায়, Accept করলে calendar-এ বসে</li>
<li>Update: একই UID, SEQUENCE + ১ → আগের entry-টাই বদলায়</li>
<li>Cancel: <code>METHOD:CANCEL</code></li>
<li>Outlook 365, on-premise Exchange, Gmail সবখানে চলে</li>
<li><strong>সীমা:</strong> একমুখী — Outlook-এর Accept / Decline HRM-এ আসে না, তাই HRM-এ RSVP বাটন থাকবে</li>
<li><strong>Code:</strong> <code>MailSender</code>-এ calendar <code>AlternateView</code> পাঠানোর একটা নতুন method লাগবে (এখন শুধু attachment আছে)। ICS তৈরি হবে <code>Ical.Net</code> দিয়ে</li>
</ul>
</div>
<div class="card">
<h4>Mode B — Microsoft Graph (Microsoft 365 client-দের জন্য)</h4>
<ul>
<li>একটা organizer mailbox (যেমন <code>hrm-calendar@client.com</code>)-এ একটা event, attendee হিসেবে সবার email</li>
<li>Exchange নিজেই সবার Outlook-এ invite পাঠায়; Accept / Decline HRM-এ ফিরিয়ে আনা যায়</li>
<li><code>OutlookEventID</code> column আগে থেকেই রাখা আছে, তাই Graph চালুর সময় table বদলাতে হবে না</li>
<li>Azure AD app registration, <code>Calendars.ReadWrite</code> (application)</li>
<li><strong>নিরাপত্তা:</strong> Exchange Application Access Policy দিয়ে শুধু ওই একটা mailbox-এ সীমিত রাখতে হবে</li>
<li>Secret / certificate <code>appsettings.json</code>-এ commit করা যাবে না</li>
<li>পুরোনো comment করা <strong>EWS</strong> code ব্যবহার করবেন না — Exchange Online থেকে EWS বন্ধ হচ্ছে</li>
</ul>
</div>
</div>
<div class="callout info"><strong>Repo-র নিয়ম:</strong> <code>.github/copilot-instructions.md</code> অনুযায়ী Azure-সংক্রান্ত কাজের (Mode B) আগে <code>azmcp_bestpractices_get</code> tool ব্যবহার করতে হবে। Mode B শুরুর আগে tool-টা enable করতে হবে।</div>
</section>
<!-- ৯ -->
<section id="s9">
<h2><span class="n">৯</span>API endpoint</h2>
<p class="sub"><code>HRM.UI/Controllers/Calendar/CalendarController.cs</code>, <code>[Route("api/Calendar")]</code>, <code>[Authorize]</code>। User / EmployeeID সবসময় token থেকে।</p>
<div class="table-wrap"><table>
<thead><tr><th>Method</th><th>Route</th><th>কাজ</th><th>কে</th></tr></thead>
<tbody>
<tr><td>GET</td><td class="col">getFeed?fromDate=&amp;toDate=&amp;layers=</td><td>দেখা যাওয়া সময়ের সব layer একসাথে (repeat expand করে)</td><td>সবাই</td></tr>
<tr><td>GET</td><td class="col">getItem/{id}</td><td>একটা item + attendee</td><td>Organizer / attendee</td></tr>
<tr><td>POST</td><td class="col">saveItem</td><td>Create / update (item + attendee একসাথে)</td><td>Event: সবাই; Task: HR / Line Manager; update: organizer / HR</td></tr>
<tr><td>POST</td><td class="col">cancelItem/{id}</td><td>Cancel for everyone; repeat-এর জন্য <code>?occurrenceStart=&amp;scope=</code> (1 = শুধু এটা, 2 = এটা ও পরেরগুলো)</td><td>Organizer / HR</td></tr>
<tr><td>POST</td><td class="col">respond</td><td><code>{ calendarItemID, responseStatus }</code> — RSVP</td><td>Attendee (নিজের)</td></tr>
<tr><td>POST</td><td class="col">updateTaskStatus</td><td><code>{ calendarItemID, taskStatus, remarks }</code></td><td>Assignee (নিজের)</td></tr>
<tr><td>POST</td><td class="col">markRead/{id}</td><td>IsRead = 1</td><td>Attendee (নিজের)</td></tr>
<tr><td>GET</td><td class="col">getMyTasks?taskStatus=</td><td>আমার task তালিকা</td><td>সবাই</td></tr>
<tr><td>GET</td><td class="col">getUpcoming?days=7</td><td>Sidebar / dashboard: সামনের দিনগুলো + open task সংখ্যা</td><td>সবাই</td></tr>
<tr><td>GET</td><td class="col">getOptions</td><td>এই login কী করতে পারে (event তৈরি, task assign, birthday)</td><td>সবাই</td></tr>
<tr><td>POST</td><td class="col">previewTargets</td><td>Schedule Job-এর test run</td><td>HR</td></tr>
<tr><td>POST</td><td class="col">runNow/{id}</td><td>Schedule Job এখনই চালানো</td><td>HR</td></tr>
</tbody>
</table></div>
</section>
<!-- ১০ -->
<section id="s10">
<h2><span class="n">১০</span>UI design</h2>
<p class="sub">আপনার design-এর form, calendar আর legend রেখে Google Calendar-এর মতো সাজানো। FullCalendar v6 (month / week / day / list, drag) আগেই project-এ আছে।</p>
<div class="ui">
<div class="ui-side">
<span class="ui-btn">+ Create</span>
<div class="ui-mini">
<i>S</i><i>M</i><i>T</i><i>W</i><i>T</i><i>F</i><i>S</i>
<i></i><i></i><i></i><i></i><i>1</i><i>2</i><i>3</i>
<i>4</i><i>5</i><i>6</i><i>7</i><i>8</i><i>9</i><i>10</i>
<i class="today">11</i><i>12</i><i>13</i><i>14</i><i>15</i><i>16</i><i>17</i>
</div>
<h5>My calendars</h5>
<div class="ui-layer"><span class="sq" style="background:#534AB7"></span>Events</div>
<div class="ui-layer"><span class="sq" style="background:#0F6E56"></span>Tasks</div>
<div class="ui-layer"><span class="sq" style="background:#EF9F27"></span>Leave</div>
<div class="ui-layer"><span class="sq" style="background:#E24B4A"></span>Holidays</div>
<div class="ui-layer"><span class="sq" style="background:#D4537E"></span>Birthdays</div>
<div class="ui-layer"><span class="sq" style="background:#B4B2A9"></span>My team</div>
<h5>Upcoming</h5>
<div style="color:var(--muted);font-size:13px">আজ ৩টা · My tasks (২)</div>
</div>
<div class="ui-main">
<div class="ui-bar"><b>← October 2026 →</b><span class="seg"><span>Today</span><span class="on">Month</span><span>Week</span><span>Day</span><span>List</span></span></div>
<div class="cal">
<div class="h">Sun</div><div class="h">Mon</div><div class="h">Tue</div><div class="h">Wed</div><div class="h">Thu</div><div class="h">Fri</div><div class="h">Sat</div>
<div></div><div></div><div></div><div></div><div><span class="d">1</span><span class="e ev">Weekly sync</span></div><div class="wk"><span class="d">2</span><span class="e hd">Weekly holiday</span></div><div class="wk"><span class="d">3</span></div>
<div><span class="d">4</span></div><div><span class="d">5</span><span class="e bd">Rahim birthday</span></div><div><span class="d">6</span></div><div><span class="d">7</span><span class="e lv">Leave (3 days)</span></div><div><span class="d">8</span><span class="e ev">Weekly sync</span><span class="e lv">Leave</span></div><div class="wk"><span class="d">9</span><span class="e lv">Leave</span></div><div class="wk"><span class="d">10</span></div>
<div><span class="d">11</span></div><div><span class="d">12</span><span class="e tk">Submit KPI</span></div><div><span class="d">13</span></div><div><span class="d">14</span></div><div><span class="d">15</span><span class="e ev">Weekly sync</span></div><div class="wk"><span class="d">16</span><span class="e hd">Weekly holiday</span></div><div class="wk"><span class="d">17</span></div>
</div>
</div>
</div>
<h3>আপনার design-এর তুলনায় যা যোগ বা বদল</h3>
<div class="grid2">
<div class="card"><h4>Layout</h4><ul>
<li>Form সবসময় খোলা না থেকে <strong>quick-create popup</strong> → “More options” → dialog / side drawer। Calendar পুরো জায়গা পায়</li>
<li>Legend (Weekly holiday, Holidays, Leave, Job/Event/Task) → বাঁ পাশে <strong>checkbox layer</strong></li>
<li>নিচের খালি অংশ → <strong>Upcoming / My Tasks</strong> list, filter সহ</li>
<li>Drag করে সরানো ও সময় বাড়ানো; week view-তে টেনে নতুন event</li>
<li>Event-এ click → popup: সময়, location, attendee ও তাদের status, Yes / No / Maybe, Edit / Delete</li>
</ul></div>
<div class="card"><h4>Form-এর ঘর</h4><ul>
<li>Type tab: Event / Task / Schedule Job (শেষটা শুধু HR)</li>
<li>শুরু ও শেষ তারিখ + সময়; “Entire day” <strong>একটা</strong> checkbox (design-এ দুটো আছে)</li>
<li>Repeat: হয় না / প্রতিদিন / প্রতি সপ্তাহে / প্রতি মাসে / প্রতি বছর / Custom + শেষ হবে (কখনো না / তারিখে / N বার পরে)</li>
<li>নতুন: Location / meeting link, Color, Priority</li>
<li>Guests: Employee / User / Department picker; Task হলে প্রতি জনের আলাদা title / subject / তারিখ (আপনার grid)</li>
<li>Notification: কতদিন / ঘণ্টা আগে (একাধিক যোগ করা যায়) + Bell / Mail / দুটোই</li>
<li>Outlook-এ যাবে কিনা client-এর config ঠিক করে, form-এ আলাদা toggle নেই</li>
</ul></div>
</div>
</section>
<!-- ১১ -->
<section id="s11">
<h2><span class="n">১১</span>Permission ও নিরাপত্তা</h2>
<p class="sub">এই app-এ menu লুকালেই endpoint সুরক্ষিত হয় না — সব check API-তে।</p>
<div class="table-wrap"><table>
<thead><tr><th>কাজ</th><th>কে পারবে</th></tr></thead>
<tbody>
<tr><td>Event তৈরি ও যে কাউকে invite</td><td>সব employee</td></tr>
<tr><td>অন্যকে Task assign</td><td>HR (যে কাউকে), Line Manager (শুধু নিজের team-কে)</td></tr>
<tr><td>Item দেখা</td><td>শুধু organizer ও attendee</td></tr>
<tr><td>Birthday layer</td><td>নিজের department-এর</td></tr>
<tr><td>Schedule Job</td><td>শুধু HR / admin</td></tr>
<tr><td>Edit / Cancel</td><td>শুধু organizer ও HR</td></tr>
<tr><td>RSVP, task status, remarks, read</td><td>শুধু নিজের attendee row</td></tr>
</tbody>
</table></div>
<div class="grid2" style="margin-top:14px">
<div class="card"><h4>Data সুরক্ষা</h4><ul>
<li>Feed শুধু সেই item দেয় যেখানে user-এর active attendee row আছে (organizer-ও attendee row), <code>PayrollTypeID</code> সহ</li>
<li>অন্যের leave-এ শুধু “Leave”, ধরন না</li>
<li>Birthday-তে বছর দেখাবে না</li>
</ul></div>
<div class="card"><h4>Code সুরক্ষা</h4><ul>
<li>Title, Description, Location → <code>MakeSQL</code>-এ <code>%u</code>; কখনো <code>%q</code> না</li>
<li>RRULE ও ReminderOffsets server-এ parse করে যাচাই, তারপর save</li>
<li>Mail-এ HTML-encode; ICS-এ text escape (<code>,</code> <code>;</code> নতুন লাইন)</li>
<li>Schedule Job শুধু task তৈরি করতে পারে, অন্য কোনো কাজ না</li>
<li>Guest সর্বোচ্চ সীমা (যেমন ৫০০)</li>
</ul></div>
<div class="card"><h4>Duplicate রোধ</h4><ul>
<li>Dispatcher: <code>NextTriggerAt = @old</code> শর্তে update — একজনই জেতে</li>
<li>Reminder: attendee-র <code>LastReminderAt</code> claim</li>
<li>Schedule Job: <code>UX_CalendarItem_Source</code> UNIQUE</li>
<li>Outlook: একই UID / Graph ID, <code>InviteSentSequence</code></li>
</ul></div>
<div class="card"><h4>Operation</h4><ul>
<li>Hangfire dashboard শুধু localhost</li>
<li>Dev PC থেকে আসল mail / invite বন্ধ: Development-এ <code>RedirectAllMailTo</code> খালি থাকলে mail যায় না</li>
<li>Server বন্ধ থাকলে পুরোনো reminder grace পেরোলে বাদ</li>
</ul></div>
</div>
</section>
<!-- ১২ -->
<section id="s12">
<h2><span class="n">১২</span>Configuration ও deployment</h2>
<div class="grid2">
<div>
<h3 style="margin-top:0">appsettings.json — নতুন section</h3>
<pre>"Calendar": {
"RemindersEnabled": true,
"SendMail": true,
"RedirectAllMailTo": "",
"ReminderGraceMinutes": 60,
"TimeZoneId": "Bangladesh Standard Time",
"IcsDomain": "hrm.client.com",
"OutlookSync": "Ics",
"MaxAttendees": 500,
"ScheduleJobsEnabled": true
}</pre>
<p style="color:var(--muted);font-size:14px">Graph-এর secret / certificate এখানে না, server-এর নিরাপদ জায়গায়।</p>
</div>
<div>
<h3 style="margin-top:0">প্রতি client-এর পছন্দ (appsettings <code>Calendar</code>)</h3>
<p style="color:var(--muted);font-size:14px">আগে এগুলো Logic config-এ রাখার কথা ছিল; প্রতি client-এর deployment-এর নিজের <code>appsettings.json</code> আছে, তাই এখন সেখানেই।</p>
<div class="table-wrap"><table>
<thead><tr><th>Key</th><th>মান</th><th>শুরুতে</th></tr></thead>
<tbody>
<tr><td class="col">OutlookSync</td><td>None | Ics | Graph</td><td>Ics</td></tr>
<tr><td class="col">ScheduleJobsEnabled</td><td>true | false</td><td>true</td></tr>
</tbody>
</table></div>
<p style="color:var(--muted);font-size:14px">এগুলো আর setting না, code-এ স্থির: সব employee event বানাতে পারে; Line Manager নিজের team-কে task দিতে পারে (HR যে কাউকে); birthday / anniversary শুধু নিজেরটা দেখা যায়। Daily birthday digest বাদ।</p>
<p style="color:var(--muted);font-size:14px">Graph mode (Phase ৫) এলে <code>Graph</code> অংশ (TenantId, ClientId, OrganizerMailbox) যোগ হবে; secret / certificate এখানে না।</p>
</div>
</div>
<h3>Deployment checklist</h3>
<div class="card"><ul>
<li>NuGet: <code>Hangfire.AspNetCore</code>, <code>Hangfire.SqlServer</code> (1.8.x), <code>Ical.Net</code>; Graph mode-এ <code>Microsoft.Graph</code> + <code>Azure.Identity</code></li>
<li><code>Calendar_DB_Changes.sql</code> চালানো; Hangfire-এর জন্য DB user-এর DDL অধিকার, অথবা <code>Install.sql</code> হাতে চালানো</li>
<li><code>deploy.ps1</code>-এর <code>web.config</code> rule-এ <code>&lt;add input="{REQUEST_URI}" pattern="/hangfire" negate="true" /&gt;</code></li>
<li>IIS: App Pool <strong>Start Mode = AlwaysRunning</strong>, <strong>Idle Time-out = 0</strong>; Site <strong>Preload Enabled = True</strong></li>
<li>Menu XML-এ Calendar (ও ESS-এ My Calendar / My Tasks) node যোগ করে upload</li>
<li><code>appsettings.json</code>-এর <code>Calendar</code> section client অনুযায়ী ঠিক করা</li>
<li>আলাদা deployment লাগবে না — সব <code>HRM.UI</code>-এর ভেতরেই</li>
</ul></div>
</section>
<!-- ১৩ -->
<section id="s13">
<h2><span class="n">১৩</span>Development plan</h2>
<p class="sub">প্রতিটা phase শেষে কিছু একটা ব্যবহারযোগ্য অবস্থায় থাকবে। File-এর নাম project-এর বিদ্যমান ধাঁচ মেনে।</p>
<div class="phase">
<div class="phase-top"><span class="p" style="background:var(--teal-bd)">Phase ১</span><h3>মূল calendar — Event ও Task</h3><small>Hangfire ছাড়াই</small></div>
<ol>
<li>DB script: ২টা table + index<span class="files">Calendar_DB_Changes.sql</span></li>
<li>BO + enum + service interface<span class="files">HRM.BO/Calendar/CalendarItem.cs · CalendarItemAttendee.cs · ICalendarService · Enums</span></li>
<li>DA (MakeSQL, TransactionContext)<span class="files">HRM.DA/DA/Calendar/CalendarItemDA.cs · CalendarItemAttendeeDA.cs</span></li>
<li>Service: Save (item + attendee এক transaction-এ), Get, Feed, Cancel, Respond, TaskStatus, MarkRead, MyTasks<span class="files">HRM.DA/Service/Calendar/CalendarService.cs</span></li>
<li>Feed-এ overlay: Holiday, Leave, Birthday (আগের service থেকে পড়া)<span class="files">HolidayCalendarService · Leave service · EmployeeService</span></li>
<li>DI + controller<span class="files">ServiceCollectionExtensions.cs · HRM.UI/Controllers/Calendar/CalendarController.cs</span></li>
<li>Angular: model, service, lazy module, calendar page (FullCalendar + layer sidebar + quick create + form dialog + detail popup), My Tasks<span class="files">_models/calendar · _services/calendar · src/app/calendar/</span></li>
<li>Menu XML + permission</li>
</ol>
<div class="done"><strong>শেষ হলে যা কাজ করবে:</strong><ul>
<li>৩ জন employee নিয়ে event বানালে ৩ জনের calendar-এ দেখায়</li>
<li>Holiday, leave, birthday layer দেখা যায় ও checkbox দিয়ে লুকানো যায়</li>
<li>RSVP, task status ও remarks কাজ করে; অন্যের item edit করা যায় না</li>
</ul></div>
</div>
<div class="phase">
<div class="phase-top"><span class="p" style="background:var(--purple-bd)">Phase ২</span><h3>Hangfire — reminder, notification ও repeat</h3></div>
<ol>
<li>NuGet + Startup setup + dashboard + <code>web.config</code> rule + IIS setting</li>
<li>Repeat: RRULE যাচাই ও save, feed-এ expand (<code>Ical.Net</code>), <code>ExceptionDates</code>, “শুধু এই দিনটা” (তারিখ বাদ + আলাদা নতুন item)</li>
<li><code>NextTriggerAt</code> হিসাব (save ও প্রতিবার পাঠানোর পরে)</li>
<li><code>CalendarDispatcher</code> (reminder অংশ) + <code>SendReminder</code> + <code>NotifyAttendees</code><span class="files">HRM.UI/BackgroundJobs/Calendar/*.cs</span></li>
<li><code>Calendar</code> config section, dev-এ mail redirect</li>
<li><s>(ঐচ্ছিক) daily birthday digest</s> — বাদ দেওয়া হয়েছে</li>
</ol>
<div class="done"><strong>শেষ হলে যা কাজ করবে:</strong><ul>
<li>৩ দিন আগের reminder ঠিক একবার যায়; app restart করলেও দুইবার যায় না</li>
<li>Decline করলে reminder যায় না; সময় বদলালে reminder নতুন সময়ে যায়</li>
<li>প্রতি সপ্তাহের event প্রতি সপ্তাহে দেখায় ও reminder পায়; একটা দিন বাতিল করা যায়</li>
</ul></div>
</div>
<div class="phase">
<div class="phase-top"><span class="p" style="background:var(--blue-bd)">Phase ৩</span><h3>Outlook — ICS (Mode A)</h3></div>
<ol>
<li><code>MailSender</code>-এ calendar <code>AlternateView</code> পাঠানোর method<span class="files">HRM.BO/Mail/MailSender.cs</span></li>
<li>ICS builder (<code>Ical.Net</code>): REQUEST / CANCEL, UID, SEQUENCE, RRULE, time zone</li>
<li><code>SyncOutlook</code> job — ICS mode (<code>InviteSentSequence</code> দিয়ে)</li>
</ol>
<div class="done"><strong>শেষ হলে যা কাজ করবে:</strong><ul>
<li>Invite Outlook calendar-এ আসে; সময় বদলালে Outlook-এর একই entry বদলায়</li>
<li>Cancel করলে Outlook থেকে সরে যায়; সরানো attendee cancel পায়</li>
</ul></div>
</div>
<div class="phase">
<div class="phase-top"><span class="p" style="background:var(--coral-bd)">Phase ৪</span><h3>Schedule Job</h3></div>
<ol>
<li>Job-এর template থেকে task তৈরি (<code>SourceItemID</code> / <code>SourceOccurrence</code> সহ)</li>
<li><code>CalendarDispatcher</code>-এর Schedule Job অংশ + <code>RunScheduleJob</code></li>
<li>HR-এর Schedule Job tab, test run, run now</li>
</ol>
<div class="done"><strong>শেষ হলে যা কাজ করবে:</strong><ul>
<li>প্রতি মাসের ১ তারিখে Sales department-এর সব active employee নিজে থেকে task পায়</li>
<li>Retry বা restart-এ duplicate task হয় না; নতুন join করা employee পরের মাসে পায়</li>
</ul></div>
</div>
<div class="phase">
<div class="phase-top"><span class="p" style="background:var(--gray-bd)">Phase ৫</span><h3>Outlook — Microsoft Graph (Mode B)</h3><small>সব কিছু শেষ হওয়ার পরে</small></div>
<ol>
<li>Azure tool (<code>azmcp_bestpractices_get</code>) enable করা — repo-র নিয়ম</li>
<li>Azure AD app registration, Exchange Application Access Policy (শুধু organizer mailbox)</li>
<li><code>SyncOutlook</code>-এ Graph path: create / patch / cancel, <code>OutlookEventID</code> ব্যবহার</li>
<li>Outlook-এর Accept / Decline পড়ে <code>ResponseStatus</code>-এ আনা</li>
<li>Client-এর appsettings <code>Calendar:OutlookSync = Graph</code></li>
</ol>
<div class="done"><strong>শেষ হলে যা কাজ করবে:</strong><ul>
<li>M365 client-এ invite সরাসরি Exchange থেকে যায়; Outlook-এ Accept করলে HRM-এও Accepted দেখায়</li>
</ul></div>
</div>
</section>
<!-- ১৪ -->
<section id="s14">
<h2><span class="n">১৪</span>নেওয়া সিদ্ধান্ত</h2>
<p class="sub">এগুলোর উপর ভিত্তি করেই পুরো plan সাজানো। সব কিছুতে best practice মানা হবে।</p>
<div class="grid2">
<div class="card"><h4>১. Outlook</h4><p style="margin:0;color:var(--muted)">আগে ICS invite (Mode A)। বাকি সব development শেষ হলে Microsoft Graph (Mode B, Phase ৫)।</p></div>
<div class="card"><h4>২. Event তৈরি</h4><p style="margin:0;color:var(--muted)">সব employee নিজে event বানিয়ে যে কাউকে invite করতে পারবে।</p></div>
<div class="card"><h4>৩. Task assign</h4><p style="margin:0;color:var(--muted)">HR যে কাউকে; Line Manager নিজের team-কে।</p></div>
<div class="card"><h4>৪. Birthday</h4><p style="margin:0;color:var(--muted)">শুধু নিজের department-এর birthday দেখাবে।</p></div>
<div class="card"><h4>৫. Table</h4><p style="margin:0;color:var(--muted)">মাত্র ২টা table; notification log table নেই। <code>CalendarItem</code>-এ ২৬ column (Location, ReminderChannel, Priority, OutlookEventID সহ)।</p></div>
<div class="card"><h4>৬. Development</h4><p style="margin:0;color:var(--muted)">এই plan review হওয়ার পরে, অনুমতি পেলে তবেই শুরু।</p></div>
</div>
</section>
<footer>CEL.HRM.5 · HRM Calendar · Final plan</footer>
</div>
</body>
</html>