دار الإكرام — نظام إدارة الحالات والصرف

موقع ثابت (HTML + JS modules) شغال على Supabase. مفيش build ولا npm في التشغيل.

الرفع

الريبو متوصل بـ Vercel، وأي push على main بينزل على الموقع لوحده (Framework: Other). ملف .vercelignore بيمنع رفع ملفات التجربة والاختبارات.

أول مرة

افتح الرابط ← هيطلب منك تعمل حساب المدير (اسمك + رقم تليفونك + رقم سري). بعد كده من الإعدادات → إضافة موظف تعمل حسابات الموظفين.

التطبيق على الموبايل

• أي موبايل: Chrome ← ⋮ ← «تثبيت التطبيق»، أو من الإعدادات ← «ثبّت التطبيق». على الآيفون: Safari ← مشاركة ← «إضافة إلى الشاشة الرئيسية».
• تطبيق أندرويد (APK): org.daralekram.app، مبني بـ Bubblewrap (Trusted Web Activity). بيفتح الموقع ملء الشاشة، وكل تحديث للموقع بيوصل للتطبيق لوحده.
  • المشروع ومفتاح التوقيع في ../android/ برّه الريبو. ماترفعش android.keystore ولا SIGNING-KEY-KEEP-SAFE.txt على GitHub، وخلّي منهم نسخة احتياطية.
  • .well-known/assetlinks.json هو اللي بيربط الموقع بالتطبيق. لو المفتاح اتغير، لازم الملف ده يتحدث بالبصمة الجديدة.
  • إعادة البناء: gradlew assembleRelease جوه ../android (بـ JDK بتاع Android Studio، ومعاه JAVA_TOOL_OPTIONS=-Djdk.net.unixdomain.tmpdir=C:\gtmp)، وبعدين zipalign وapksigner بالمفتاح.

التطوير

• app.js الشاشات · core.js المنطق (عليه اختبارات) · icons.js الأيقونات · demo.js بيانات وهمية للتجربة
• الاختبارات: npm test (Node 20+)
• التجربة على الجهاز: شغّل السيرفر المحلي وافتح http://localhost:5173/?demo
• المكتبات والخطوط في vendor/، بإصدارات ثابتة (supabase-js 2.117.1، SheetJS 0.18.5)
• لازم يشتغل على Chrome 109 (آخر نسخة بتشتغل على ويندوز ٧)
• التغييرات: CHANGELOG.md · أبحاث التصميم: docs/research/

Supabase

• Project: dar-alekram (jvgxldhshbyyuftjgfrw)
• الصلاحيات مقفولة بـ RLS. الموظف بيعلّم الاستلام عن طريق set_received() بس.
• مفيش مسح نهائي للحالات أو الكشوف: فيه عمود archived_at (أرشفة).
• إدارة الحسابات عن طريق Edge Function manage-users.
• فيه نسخ احتياطية قبل التعديلات الكبيرة في schemas اسمها backup_20260924 وbackup_20260926 (مش ظاهرة للـ API).
• calls: كل مكالمة سطر (ردّت / ماردتش / رقم غلط). المكالمة اللي اتسجلت بالغلط بتتعلّم cancelled_at (مابتتمسحش)، ودي الخانة الوحيدة اللي ينفع تتعدل. tasks: المهام اليدوية؛ المهام التلقائية بتتحسب في app.js (autoTasks).
• ملفات الحالات (PDF) في bucket خاص اسمه docs، و«قارن بالموقع» بيقرا النص بـ pdf.js من vendor/pdfjs (crossCheck في core.js).
• الصور في bucket خاص اسمه photos (مش public). الموظفين بس يشوفوها، والمكتب بس يرفع. مفيش مسح.