রিপোর্ট মডিউল

Group Admin ও অনুমোদিত Manager-রা Reports মডিউলে সাত ধরনের রিপোর্টের তথ্য এক জায়গায় দেখতে, ফিল্টার ও এক্সপোর্ট করতে এবং প্রয়োজনীয় ব্যবস্থা নিতে পারেন।

Operator (রিসেলার)-রা Reports মডিউল ব্যবহার করতে পারেন না।

NOC কর্মীরা শুধু ইনভেন্টরি রিপোর্ট দেখতে পারেন।

---

মেনুর কাঠামো (ওয়্যারফ্রেম)

Reports ⬇
├── All Reports          (ড্যাশবোর্ড / দ্রুত ব্যবহারের কার্ড)
├── ⚠ Upcoming Suspension  (সক্রিয়, অপরিশোধিত, শিগগির মেয়াদ শেষ হবে)
├── Customer Reports  ⬇
│   ├── Due / Unpaid
│   ├── Expiring Packages
│   ├── Upcoming Suspension
│   ├── Active Customers
│   └── Inactive Customers
├── Finance Reports  ⬇
│   ├── Daily Collections
│   ├── Monthly Collections
│   ├── Outstanding Balance
│   └── Package-wise Revenue
├── Inventory Reports  ⬇
│   ├── Mikrotik / NAS Routers
│   ├── OLT Devices
│   ├── ONU Devices
│   └── Other Devices
├── Operator Reports  ⬇       [শুধু Group Admin]
│   ├── Operator Performance
│   ├── Operator Revenue
│   └── Operator Customers
├── Distributor Reports  ⬇
│   ├── Card Sales
│   ├── Card Stock
│   └── Distributor Commission
├── Gateway Reports  ⬇
│   ├── Transactions
│   ├── Failed Payments
│   └── Gateway Revenue
└── Custom Report            (একাধিক ফিল্টার দিয়ে ইচ্ছামতো অনুসন্ধান)

---

প্রবেশাধিকার তালিকা

ভূমিকা	গ্রাহক	অর্থ	ইনভেন্টরি	অপারেটর	ডিস্ট্রিবিউটর	গেটওয়ে	কাস্টম
Group Admin	✅	✅	✅	✅	✅	✅	✅
Manager (view-reports অনুমতিসহ)	✅	✅	✅	✅	✅	✅	✅
NOC	❌	❌	✅	❌	❌	❌	❌
Operator	❌	❌	❌	❌	❌	❌	❌

Manager-কে রিপোর্ট দেখার অনুমতি দিন

1. Staff → Managers মেনুতে যান।
2. সংশ্লিষ্ট Manager-এর পাশে Edit ক্লিক করুন।
3. Permissions অংশে View Reports নির্বাচন করুন।
4. Save ক্লিক করুন।

---

গ্রাহক রিপোর্ট

বকেয়া / অপরিশোধিত (/admin/reports/customer/due)

যেসব গ্রাহকের payment_status, paid নয় তাদের তালিকা দেখায়।

ফিল্টার: Expiry Date From/To, Operator, Package

সারির রং:

• 🔴 লাল—ইতিমধ্যে বকেয়া (মেয়াদ শেষের তারিখ পার হয়েছে)
• 🟠 কমলা—3 দিনের মধ্যে বকেয়া

প্রতি সারিতে দ্রুত ব্যবস্থার বাটন: 💬 Remind · 📦 Extend · 💰 Pay

---

মেয়াদ শেষ হতে যাওয়া প্যাকেজ (/admin/reports/customer/expiring)

নির্বাচিত সময়সীমা অথবা নিজের নির্ধারিত তারিখসীমার মধ্যে যেসব গ্রাহকের প্যাকেজের মেয়াদ শেষ হবে, তাদের দেখায়।

ফিল্টার: Quick Preset (7/15/30 দিন) অথবা Expiry Date From / To, Operator, Package

সারির রং:

• 🔴 লাল—মেয়াদ শেষ হয়েছে বা আজ শেষ হবে
• 🟠 কমলা—3 দিনের মধ্যে শেষ হবে
• 🔵 নীল—7 দিনের মধ্যে শেষ হবে

Days Left কলামে রংভিত্তিক ব্যাজ দেখা যায়।

---

শিগগির সংযোগ বন্ধ হবে এমন গ্রাহক (/admin/reports/customer/upcoming-suspension)

এটি ব্যবস্থা নেওয়ার জন্য সবচেয়ে কার্যকর রিপোর্ট। যেসব সক্রিয় গ্রাহক পেমেন্ট করেননি এবং যাদের প্যাকেজের মেয়াদ শিগগির শেষ হবে (বা ইতিমধ্যে হয়েছে), তাদের দেখায়। ব্যবস্থা না নিলে এই গ্রাহকদের সংযোগ সাময়িকভাবে বন্ধ হবে।

ফিল্টার: Window (বকেয়াসহ পরবর্তী 3/7/14/30 দিন) অথবা নিজের নির্ধারিত তারিখসীমা, Operator, Package

সারির রং:

• 🔴 লাল—ইতিমধ্যে বকেয়া
• 🟠 কমলা—1–3 দিন বাকি
• 🔵 নীল—4–14 দিন বাকি

দ্রুত ব্যবস্থার বাটন: 💬 Remind · 📦 Extend · 💰 Pay

পরামর্শ: রিপোর্টটি প্রতিদিন চালান এবং একসঙ্গে SMS রিমাইন্ডার পাঠিয়ে সব প্রভাবিত গ্রাহককে জানান।

---

সক্রিয় গ্রাহক (/admin/reports/customer/active)

status = active এমন সব গ্রাহক। ফিল্টার: Operator, Package।

নিষ্ক্রিয় গ্রাহক (/admin/reports/customer/inactive)

status = suspended বা disabled এমন সব গ্রাহক। ফিল্টার: Operator, Package।

---

আর্থিক রিপোর্ট

দৈনিক আদায় (/admin/reports/finance/daily)

দিন অনুযায়ী ভাগ করা সফল পেমেন্টের মোট পরিমাণ।

ফিল্টার: তারিখসীমা। কলাম: Date, Payment Count, Total Amount।

মাসিক আদায় (/admin/reports/finance/monthly)

ক্যালেন্ডার মাস অনুযায়ী ভাগ করা পেমেন্ট। আয়ের প্রবণতা বিশ্লেষণে কাজে লাগে।

মোট বকেয়া (/admin/reports/finance/outstanding)

অপরিশোধিত বিল থাকা গ্রাহক এবং প্রত্যেক গ্রাহকের বকেয়া পরিমাণ।

প্যাকেজভিত্তিক আয় (/admin/reports/finance/package-wise)

প্যাকেজের নাম অনুযায়ী মোট আয়ের বিস্তারিত হিসাব। সবচেয়ে লাভজনক প্যাকেজ চিহ্নিত করতে সহায়তা করে।

---

ইনভেন্টরি রিপোর্ট

NOC কর্মীরা এই চারটি রিপোর্ট দেখতে পারেন।

রিপোর্ট	URL
Mikrotik / NAS Routers	/admin/reports/inventory/mikrotik
OLT Devices	/admin/reports/inventory/olt
ONU Devices	/admin/reports/inventory/onu
Other Devices	/admin/reports/inventory/other

---

অপারেটর রিপোর্ট

শুধু Group Admin। প্রতিটি অপারেটরের আলাদা বিস্তারিত হিসাব দেখায়।

• Performance—প্রতি অপারেটরের গ্রাহকসংখ্যা এবং সক্রিয় ও নিষ্ক্রিয় গ্রাহকের ভাগ
• Revenue—প্রতি অপারেটরের মোট আদায়
• Customers—অপারেটর দিয়ে ফিল্টার করা গ্রাহকের পূর্ণ তালিকা

---

ডিস্ট্রিবিউটর রিপোর্ট

• Card Sales—ডিস্ট্রিবিউটরের বিক্রি করা রিচার্জ কার্ড
• Card Stock—প্রতি ডিস্ট্রিবিউটরের মজুতে থাকা কার্ড
• Commission—প্রতি ডিস্ট্রিবিউটরের প্রদেয় ও পরিশোধিত কমিশন

---

গেটওয়ে রিপোর্ট

• Transactions—সব পেমেন্ট গেটওয়ে লেনদেন (Successful / Pending / Failed)
• Failed Payments—শুধু ব্যর্থ লেনদেন, পরবর্তী ব্যবস্থা নেওয়ার জন্য উপযোগী
• Gateway Revenue—গেটওয়ে অনুযায়ী ভাগ করা মোট সফল আয়

---

তথ্য এক্সপোর্ট করুন

প্রতিটি রিপোর্টের পৃষ্ঠায় তিনটি এক্সপোর্ট বাটন ও একটি প্রিন্ট বাটন আছে:

বাটন	ফরম্যাট	বিবরণ
Export Excel	.xlsx	স্প্রেডশিট অ্যাপে বিশ্লেষণের জন্য সবচেয়ে উপযোগী
Export CSV	.csv	সব ধরনের অ্যাপে ব্যবহারের উপযোগী ফরম্যাট
Export PDF	.pdf	শেয়ার বা প্রিন্ট করার উপযোগী সাজানো টেবিল
🖨 Print	ব্রাউজার প্রিন্ট	প্রিন্ট ডায়ালগ খোলে

বর্তমানে প্রয়োগ করা ফিল্টার অনুসারেই তথ্য এক্সপোর্ট হয়—পর্দায় যা দেখছেন, সেটিই এক্সপোর্ট হবে।

---

সারির রঙের নির্দেশিকা

রং	অর্থ
🔴 table-danger (লাল)	বকেয়া / মেয়াদ শেষ
🟠 table-warning (কমলা)	3 দিনের মধ্যে মেয়াদ শেষ হবে
🔵 table-info (নীল)	7–14 দিনের মধ্যে মেয়াদ শেষ হবে
⬜ সাদা	জরুরি কোনো ব্যবস্থা দরকার নেই

---

দ্রুত ব্যবস্থা

গ্রাহকভিত্তিক রিপোর্টে দ্রুত ব্যবস্থা নেওয়ার বাটন দেখা যায়:

বাটন	কাজ
💬 Remind	গ্রাহকের নম্বর আগে থেকে বসানো SMS লেখার ফর্ম খোলে
📦 Extend	গ্রাহকের প্যাকেজ পরিবর্তন বা নবায়নের ফর্ম খোলে
💰 Pay	গ্রাহকের বিল বা পেমেন্ট আদায়ের পাতা খোলে