# تركيب نظام المراقبة على subdomain (Namecheap) — منفصل تماماً عن myclinikx

## المتطلبات (كلها متوفرة على استضافتك)
PHP (نفس بيئة myclinikx) · MySQL/MariaDB · cron · اتصال صادر HTTPS.

## الخطوات

### ١) أنشئ الـsubdomain
cPanel → Subdomains → مثلاً `monitor.myclinikx.com` بمجلد جذر مستقل (مثلاً `~/monitor`).
> **مهم:** مجلد مستقل تماماً، لا علاقة له بمجلد myclinikx.

### ٢) ارفع ملفات مجلد `live/` إلى جذر الـsubdomain
`ShiftLib.php, lib.php, ChatwootClient.php, Telegram.php, StateStore.php, webhook.php, cron.php, config.json, schema.sql, secrets.sample.php, chatid.php, healthcheck.php`

### ٣) قاعدة البيانات
cPanel → MySQL Databases → أنشئ قاعدة `bevatel_monitor` ومستخدماً بكامل الصلاحيات، ثم استورد `schema.sql` (phpMyAdmin → Import).

### ٤) الأسرار
```
cp secrets.sample.php secrets.php
```
واملأ في `secrets.php`: `chatwoot_token` (توكن الأدمن)، `db_*`، `webhook_secret` (سرّ عشوائي طويل)، ولاحقاً `telegram_bot` و`telegram_chat`.

### ٥) بوت تيليجرام
1. افتح [@BotFather](https://t.me/BotFather) → `/newbot` → خذ الـ**token** وضعه في `telegram_bot`.
2. أضف البوت إلى **جروب الإدارة** (كعضو)، وأرسل أي رسالة في الجروب.
3. افتح `https://monitor.myclinikx.com/chatid.php` → سيظهر لك `chat_id` الجروب → ضعه في `telegram_chat`.
   (للجروبات الكبيرة يبدأ بـ `-100…`)

### ٦) تسجيل الـwebhook في بيفاتيل (متاح لك كأدمن)
في Chatwoot: **Settings → Integrations → Webhooks → Add**:
- **URL:** `https://monitor.myclinikx.com/webhook.php?k=SECRET` (نفس `webhook_secret`)
- **Events:** `message_created`, `conversation_created`, `conversation_updated`, `conversation_status_changed`

### ٧) الـcron (كل دقيقة)
cPanel → Cron Jobs → أضف:
```
* * * * * /usr/bin/php ~/monitor/cron.php >/dev/null 2>&1
```
(عدّل مسار php ومجلد المشروع حسب استضافتك.)

### ٨) التحقق
افتح `https://monitor.myclinikx.com/healthcheck.php` → يجب أن ترى:
```
DB: OK
Chatwoot API: OK (N agents)
Telegram: OK (تحقق من الجروب)   ← ستصل رسالة اختبار للجروب
coverage now: داخل/خارج التغطية
```

## الأمان والخصوصية
- كل التعامل مع بيفاتيل **قراءة فقط** (GET). لا يعدّل النظام أي شيء عندهم.
- `secrets.php` يحوي الأسرار فقط (ملف PHP لا يُعرض كنص). `webhook.php` محمي بسرّ في الرابط.
- لا شيء من هذا يمسّ مشروع myclinikx.

## التشغيل التجريبي الآمن
- اضبط في البداية `telegram_chat` على **محادثتك الخاصة** مع البوت (وليس الجروب) لمراقبة التنبيهات يوماً، ثم انقله لجروب الإدارة.
- راقب `monitor.log` أول يوم للتأكد من التدفق.