دليل الرصد السريع V16

التشغيل المحلي السريع

إذا أردت الرصد اليدوي وصوت المتصفح فقط، لا تحتاج حساب Cloudflare ولا D1.

npm install
npm run dev

يمكن أيضًا استخدام start-local.command على macOS أو start-local.bat على Windows.

الحسابات والحفظ السحابي Cloudflare D1

V16 تسمح لكل زميل بحساب مستقل. التسجيل ذاتي لكن الحساب يبقى بانتظار موافقة المدير.

npx wrangler login
npx wrangler d1 create rasd-fast-db

انسخ database_id الذي يظهر، ثم أضف كتلة D1 الموجودة في ملف wrangler.d1-example.jsonc إلى wrangler.jsonc.

npm run db:migrate:remote
npx wrangler secret put AUTH_SECRET
npx wrangler secret put ADMIN_SETUP_KEY
npm run deploy

بعد النشر افتح الموقع واضغط إعداد المدير لأول مرة، ثم استخدم رمز ADMIN_SETUP_KEY.

كيف يعمل الحفظ؟

كل ضغطة تحفظ فورًا داخل المتصفح. عند وجود حساب معتمد، تتم مزامنة الرصد مع D1 بعد فترة قصيرة وبشكل مجمع لتقليل عدد الطلبات. إذا انقطع الإنترنت لا يتوقف العمل؛ يبقى الرصد محليًا وتُستأنف المزامنة عند رجوع الشبكة.

لا يُرفع ملف Excel نفسه إلى D1، وبيانات المشروع السحابية لا تحتوي أسماء الطلاب أو أرقام السجل المدني؛ تحفظ حالة الرصد مرتبة حسب بنية الملف.

Cloudflare Workers AI

ميزة الذكاء الاصطناعي مستقلة عن حسابات D1. من أرادها يستخدم حساب Cloudflare الخاص به أو مفتاح مزود خارجي. عند نفاد حصة Cloudflare اليومية (3036) يتعطل زر AI حتى التجدد، أما ضغط الخدمة المؤقت (3040) فلا يعتبر نفاد رصيد.