# 📱 SMS System সম্পূর্ণ ইনস্টলেশন সংক্ষিপ্তসার

আপনার বিদ্দা প্রজেক্টে **BulkSMSDhaka** ভিত্তিক SMS সিস্টেম যোগ করা হয়েছে।

## 📁 তৈরি ফাইল এবং ফোল্ডার

### কোর ফাইল (শুরু করতে হবে)

```
✓ classes/SMSService.php           - SMS পাঠানোর মেইন ক্লাস
✓ config/sms.php                   - SMS কনফিগারেশন (পরিবর্তিত)
✓ setup_sms_system.php             - ডাটাবেস টেবিল তৈরি করুন
```

### Admin Panel (ব্যবহার করুন)

```
✓ admin/send-sms.php               - স্টুডেন্টদের কাছে SMS পাঠান
✓ admin/sms-settings.php           - API Key কনফিগার করুন
✓ admin/sms-logs.php               - সব SMS এর রেকর্ড দেখুন
```

### উদাহরণ স্ক্রিপ্ট (রেফারেন্সের জন্য)

```
✓ examples/quick-sms.php           - দ্রুত শুরু করার উদাহরণ
✓ examples/send-result-notification.php - পরীক্ষা ফলাফল নোটিফিকেশন
✓ examples/send-fee-reminder.php   - ফি বকেয়া অনুস্মারক
```

### ডকুমেন্টেশন

```
✓ SMS_QUICK_START.md               - এই ফাইল (দ্রুত নির্দেশনা)
✓ SMS_SETUP_GUIDE_BN.md            - বিস্তারিত ডকুমেন্টেশন
```

## ⚡ শুরু করার ধাপ (৫ মিনিট)

### ধাপ 1: ডাটাবেস সেটআপ

টার্মিনালে চালান:
```bash
php setup_sms_system.php
```

### ধাপ 2: BulkSMSDhaka অ্যাকাউন্ট

1. https://bulksmsdhaka.net/register এ যান
2. অ্যাকাউন্ট তৈরি করুন
3. ৫০০ টাকা চার্জ করুন
4. Settings থেকে API Key কপি করুন

### ধাপ 3: API Key যোগ করুন

Admin এ:
```
Admin → SMS সেটিংস → 
  API Key পেস্ট করুন → 
  সংরক্ষণ করুন → 
  টেস্ট করুন (সবুজ হবে)
```

### ধাপ 4: পাঠান!

Admin এ:
```
Admin → এসএমএস পাঠান → 
  স্টুডেন্ট নির্বাচন করুন → 
  বার্তা লিখুন → 
  পাঠান
```

## 🎯 কী করতে পারেন

| কাজ | কোথায় |
|-----|--------|
| SMS পাঠান | Admin → এসএমএস পাঠান |
| API সেটআপ | Admin → SMS সেটিংস |
| লগ দেখুন | Admin → SMS লগ |
| বার্তা পাঠান | কোড লিখে `SMSService` ব্যবহার করুন |
| অটোমেট করুন | Cron জব বা Event Listener |

## 📊 ডাটাবেস টেবিল

```
sms_logs       - পাঠানো SMS এর রেকর্ড
sms_settings   - API কনফিগারেশন
sms_templates  - বার্তা টেমপ্লেট (ভবিষ্যতের জন্য)
sms_campaigns  - সম্মিলিত ক্যাম্পেইন (ভবিষ্যতের জন্য)
```

## 💻 কোডে ব্যবহার

```php
<?php
require_once('config/database.php');
require_once('classes/SMSService.php');

// সেটিংস নিন
$stmt = $pdo->prepare("SELECT key_name, value FROM sms_settings");
$stmt->execute();
$settings = [];
while ($row = $stmt->fetch()) {
    $settings[$row['key_name']] = $row['value'];
}

// সেবা শুরু করুন
$sms = new SMSService($settings['api_key'], $settings['caller_id'], $pdo);

// একটি নম্বরে পাঠান
$sms->send('01711111111', 'আপনার বার্তা');

// একাধিক নম্বরে পাঠান
$sms->send(['01711111111', '01822222222'], 'বার্তা');

// ক্লাসে পাঠান
$sms->sendToClass(5, 'বার্তা');

// স্টুডেন্টদের কাছে পাঠান
$sms->sendToStudents([1, 5, 10], 'বার্তা');

// ব্যালেন্স চেক করুন
$balance = $sms->getBalance();
echo $balance['balance']; // টাকায়
?>
```

## ⚠️ গুরুত্বপূর্ণ

### আগে করতে হবে:
- [ ] ডাটাবেস সেটআপ (php setup_sms_system.php)
- [ ] BulkSMSDhaka অ্যাকাউন্ট তৈরি
- [ ] API Key যোগ করা (Admin → SMS সেটিংস)
- [ ] API টেস্ট করা (সবুজ চেক দেখবেন)

### হতে পারে:
- ফোন নম্বর ফরম্যাট ত্রুটি → ০১ দিয়ে শুরু করুন
- ব্যালেন্স শেষ → ৫০০ টাকা চার্জ করুন
- API এরর → BulkSMSDhaka সাপোর্ট যোগাযোগ করুন

## 📞 সমর্থন

| সেবা | সম্পর্ক |
|-----|--------|
| API সমস্যা | BulkSMSDhaka: +8801682314951 |
| এই সিস্টেম | এই ডকুমেন্টেশন এবং কোড মন্তব্য দেখুন |

## 📚 আরও জানতে

- **দ্রুত শুরু:** `SMS_QUICK_START.md` পড়ুন
- **বিস্তারিত:** `SMS_SETUP_GUIDE_BN.md` পড়ুন
- **উদাহরণ:** `examples/` ফোল্ডারে দেখুন
- **কোড:** `classes/SMSService.php` মন্তব্য পড়ুন

## 🎊 আপনি প্রস্তুত!

এখন আপনি:
- ✓ স্টুডেন্টদের কাছে SMS পাঠাতে পারেন
- ✓ অভিভাবকদের নোটিফিকেশন দিতে পারেন
- ✓ পরীক্ষার ফলাফল জানাতে পারেন
- ✓ ফি অনুস্মারক পাঠাতে পারেন
- ✓ ইভেন্ট নোটিফিকেশন দিতে পারেন
- ✓ জরুরি বার্তা জানাতে পারেন

**আপনার প্রজেক্ট এখন সম্পূর্ণ SMS সক্ষম! 🚀**

---

**সংস্করণ:** ১.০  
**তৈরি:** জানুয়ারি ২০২৬  
**সম্পূর্ণ স্বয়ংক্রিয় সিস্টেম**
