QR উপস্থিতি — কী কী হলো ও কীভাবে ব্যবহার করবেন
================================================

বসানোর নিয়ম: জিপের সব ফাইল প্রজেক্টের একই পথে বদলে দিন/যোগ করুন (Teacher/ ফোল্ডারের নামে বড় T — আপনার প্রজেক্টে যেমন আছে তেমন রাখুন)।
ডাটাবেজে হাতে কিছু করতে হবে না — প্রয়োজনীয় কলাম/টেবিল (QR টোকেন, স্ক্যান লগ) প্রথমবার চালানোর সময় নিজে তৈরি হবে।

কীভাবে কাজ করে
  1) আইডি কার্ড: স্টুডেন্ট ও টিচারের কার্ডে এখন একটা QR কোড থাকবে (কার্ড প্রথমবার খুললেই সবার গোপন QR টোকেন তৈরি হয়)।
     QR-এর ভেতরে নাম/ফোন নয়, শুধু একটা অচেনা কোড — ছবি তুলে কেউ অন্য কিছু বের করতে পারবে না।
     নতুন স্টুডেন্ট যোগ করলে: অ্যাডমিন ▸ QR এটেন্ডেন্স স্ক্যান পেজের হলুদ বাটন "QR কোড তৈরি করুন" চেপে নতুনদের কার্ড আবার প্রিন্ট করুন।
  2) শিক্ষকের প্যানেল ▸ "QR স্ক্যানে উপস্থিতি": "ক্যামেরা চালু করুন" চেপে ফোনের ক্যামেরার সামনে স্টুডেন্টের কার্ড ধরুন।
     স্ক্যান হলেই "উপস্থিত ✔" দেখাবে (ছবি, নাম, ক্লাস, রোল, সময়সহ) এবং বিপ করবে। একই কার্ড দুবার ধরলেও একবারই গোনা হয়।
     শিক্ষক শুধু নিজের ক্লাস-সেকশনের স্টুডেন্ট স্ক্যান করতে পারবেন (গেটে ডিউটির জন্য অ্যাডমিন "সব ক্লাস" চালু করে দিতে পারেন)।
  3) অ্যাডমিন ▸ QR এটেন্ডেন্স স্ক্যান: একই স্ক্যানার (ক্যামেরা বা USB/ব্লুটুথ স্ক্যানার), সঙ্গে সেটিংস।
  4) অভিভাবকের SMS: স্টুডেন্টের দিনের প্রথম স্ক্যানের পরপরই (সেকেন্ডের মধ্যে) গার্ডিয়ানের নম্বরে SMS যায়:
     "প্রিয় অভিভাবক, আপনার সন্তান ... আজ ... তারিখে ...-এ স্কুলে উপস্থিত হয়েছে।" — লেখাটা অ্যাডমিন বদলাতে পারবেন, চাইলে SMS বন্ধও রাখতে পারবেন।
     ⚠ আসল ফোনে SMS যেতে অ্যাডমিন ▸ SMS সেটিংসে গেটওয়ে (URL ও API key) দেওয়া থাকতে হবে; না থাকলে শুধু SMS লগে "ডেমো" হিসেবে জমা হয়।
  5) ড্যাশবোর্ড ও রিপোর্ট: স্ক্যান করা উপস্থিতি অন্য উপস্থিতির সাথেই জমা হয়, তাই অ্যাডমিন ড্যাশবোর্ডের "আজ উপস্থিত" সংখ্যায় নিজে থেকে উঠে যায়।
     নতুন পেজ "উপস্থিতি রিপোর্ট" (অ্যাডমিন ও শিক্ষক): ক্লাস বেছে প্রত্যেক স্টুডেন্টের এই মাসে ও এ বছরে কত দিন উপস্থিত/দেরি/অনুপস্থিত/ছুটি ও %।
     স্টুডেন্টের নিজের পোর্টালে: "এই মাসে ... দিন, এ বছরে ... দিন উপস্থিত"।

লাগবে
  * ফোনের ক্যামেরা চালাতে সাইটটা https (নিরাপদ লিংক) দিয়ে খুলতে হবে (লোকালহোস্টে http-ও চলে)।
  * ইন্টারনেট (স্ক্যানার ও QR আঁকার ছোট টুল লোড হয়)।
  * সফটওয়্যারের প্যাকেজে "QR / বায়োমেট্রিক এটেন্ডেন্স" ফিচারটি থাকা (শিক্ষকের পেজের জন্য)।

আগের একটা সমস্যাও ঠিক হয়েছে
  * আগে QR/ডিভাইসে নেওয়া উপস্থিতিতে স্কুলের আইডি সেভ হতো না, তাই ড্যাশবোর্ডের "আজ উপস্থিত" গণনায় আসত না। এখন আসবে।
  * কেউ ভুল করে আগে "অনুপস্থিত" হয়ে থাকলে, পরে কার্ড স্ক্যান করলে সেটা "উপস্থিত"-এ ঠিক হয়ে যাবে (এবং SMS যাবে)।
