حِصّة

منصة بتجمع الأساتذة والمدارس في الأردن مع طلابهم. كل أستاذ إله صفحة فيها موادّه، والطالب بيختار صفّه ومادته وأستاذه وبيشترك.

الموجود حاليًا:

• صفحات عامة، دخول برقم الموبايل، وموافقة ولي الأمر للطلاب تحت 18.
• الطالب: بيختار الصف، بعدين المادة، بعدين الأستاذ. بيشترك بـ CliQ (بيكتب رقم الحوالة والأستاذ بأكّد) أو بكود تفعيل. بيحضر الفيديو، بينزّل الملفات (عليها علامة مائية برقمه جوّا الـ PDF)، بيحل الاختبارات (عدد محاولات محدود) وبسلّم أوراق العمل صورة أو PDF.
• الأستاذ: يا بيسجّل لحاله وبيرفع وثائقه للتوثيق، يا مدرسته بتضيفه برقمه. بيرفع فيديو أو PDF أو ورقة عمل أو اختبار أو حصة مباشرة، بأكّد الدفعات، بيصحّح أوراق العمل، وبشوف طلابه.
• المدرسة: بتضيف أساتذتها برقم الموبايل وبتشوف طلابهم. لما الفريق يوثّق المدرسة، صفحات أساتذتها بتنزل.
• الإدارة (فريق حِصّة): نظرة عامة على المنصة، توثيق الأساتذة (الوثائق) والمدارس، الطلاب، كل الدفعات، وإخفاء التقييمات.
• تقييمات حقيقية من الطلاب المشتركين بس، وفيديو محمي عن طريق Bunny Stream.
• حذف الحساب من الإعدادات.

التشغيل على جهازك

npm install
npm run dev

افتح http://localhost:3000. بدون مفاتيح Supabase التطبيق بيشتغل بنسخة تجريبية ببيانات نموذجية:

• أي رقم أردني (مثلا 791234567) وكود الدخول 482913.
• دخول الأساتذة بيفتح لوحة أ. خالد العمري، ودخول المدارس بيفتح "مدارس النخبة".
• لوحة الإدارة: /login/admin بأي رقم.
• أستاذ ضافته المدرسة للتجربة: سجّل أستاذ جديد بالرقم 785554433، وصفحته بتنفتح تحت المدرسة فورًا.
• كود تفعيل للتجربة: HS-KHALED-02.
• اختبار جاهز للتجربة: "اختبار قصير: قواعد الاشتقاق" عند أ. خالد.
• التعديلات بالنسخة التجريبية بتنحفظ بالذاكرة وبتروح لما يرجع السيرفر يشتغل.

ربط Supabase (التشغيل الحقيقي)

1. اعمل مشروع على https://supabase.com (الخطة المجانية بتكفي للبداية).
2. من SQL Editor شغّل ملفات supabase/migrations/ بالترتيب (0001 و0002 و0003)، وبعدها supabase/seed.sql إذا بدك البيانات النموذجية.
3. من Authentication → Providers فعّل Phone، واربطه بمزوّد رسائل (Twilio أو MessageBird أو Vonage).
4. انسخ .env.example لـ .env.local وعبّي القيم من Project Settings → API.
5. npm run build && npm start.

الفيديو (Bunny Stream)

1. اعمل حساب على https://bunny.net، وافتح Stream واعمل Video Library.
2. من إعدادات المكتبة خذ Library ID و API Key، وحطهم بـ BUNNY_LIBRARY_ID و BUNNY_STREAM_API_KEY.
3. من Security فعّل Embed view token authentication، وانسخ Token authentication key لـ BUNNY_TOKEN_KEY.
4. يفضّل كمان تحدد Allowed referrers لدومين المنصة.

الأستاذ بيرفع الفيديو من المتصفح مباشرة لـ Bunny (السيرفر بيوقّع الرفع بس)، والطالب بيشوفه برابط بينتهي بعد 3 ساعات وعليه علامة مائية باسمه. بدون هالمفاتيح، رفع الفيديو بيكون مسكّر وباقي المنصة بتشتغل عادي.

توثيق الأستاذ وربطه بصفحته

الأستاذ بيعمل حساب من /signup/teacher، وبتظهرله صفحة التوثيق: بيرفع صورته وهويته وشهاداته. الوثائق بتنحفظ بـ bucket خاص (teacher-docs) وما بشوفها غير الأدمن.

لمراجعة الوثائق من SQL Editor (والملفات نفسها من Storage → teacher-docs):

select p.full_name, p.phone, d.kind, d.file_name, d.storage_path, d.status
from public.teacher_documents d join public.profiles p on p.id = d.user_id
where d.status = 'pending' order by d.created_at;

-- قبول أو رفض مع سبب
update public.teacher_documents set status = 'approved' where id = '...';
update public.teacher_documents set status = 'rejected', note = 'الصورة مش واضحة' where id = '...';

بعد ما تقبل الوثائق، اربط الأستاذ بصفحته وانقل صورته:

update public.profiles set role = 'teacher', consent = 'not_needed' where phone = '962791234567';
update public.teachers set user_id = p.id, photo_url = p.photo_url, verified = true
from (select id, photo_url from public.profiles where phone = '962791234567') p
where slug = 'khaled-omari';

البنية

المسار	شو فيه
app/	الصفحات (Next.js App Router) و app/actions/ للعمليات على السيرفر
lib/data.ts	كل قراءة بيانات، بتشتغل على Supabase أو على البيانات النموذجية
lib/session.ts	مين داخل، وتحويل اللي مش داخل لصفحة الدخول
supabase/	الجداول وسياسات الحماية (RLS) والبيانات النموذجية
prototype/	النموذج التفاعلي الأصلي، مرجع للتصميم
docs/	التحليل وقائمة الإضافات

الحماية

• كل جدول عليه Row Level Security: الطالب بيشوف اشتراكاته بس، والأستاذ بيشوف طلابه وموادّه بس.
• الطالب ما بيقدر يغيّر دوره أو موافقته، والأستاذ ما بيقدر يوثّق حاله (trigger protect_fields).
• ملفات الـ PDF بـ bucket خاص، والسيرفر بيعطي رابط بينتهي بعد 10 دقايق بعد ما يتأكد من الاشتراك.
• الطالب تحت 18 ما بتنفتحله المواد قبل موافقة ولي الأمر (قانون حماية البيانات الشخصية رقم 24 لسنة 2023).
• أجوبة الاختبارات ما بتوصل لجهاز الطالب: التصحيح بيصير بقاعدة البيانات (submit_quiz)، والجواب الصح بيظهر بس بعد التسليم.
• التقييم للمشترك بس، مرة وحدة لكل أستاذ، والاسم بينحط من حسابه مش من الطلب. متوسط التقييم بيتحدّث لحاله.

الجاي

المرحلة 3: الدفع الإلكتروني (CliQ والمحافظ) وتجديد الاشتراك التلقائي. بعدها: الحصص المباشرة، تقرير ولي الأمر الأسبوعي على الواتساب، والمساعد الذكي. التفاصيل بخطة البناء.