HRM-10/HRM.UI/docs/calendar-plan.html

922 lines
90 KiB
HTML
Raw Normal View History

2026-11-03 13:06:00 +06:00
<!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>