9.1 نظرة عامة

يوفّر البرنامج خادماً داخلياً مدمجاً يعمل من نفس العملية، ويقدّم:

  • تطبيق ويب لفريق العمل (صفحات المرضى والوصفات والمسودات والدفعات) بالعربية والإنجليزية.
  • واجهة REST على المسار /api/* للقراءة والكتابة ضمن الشبكة المحلية.
البند القيمة
المنفذ الافتراضي 4545
المصادقة ترويسة x-api-key على كل مسارات /api/*
النطاق الشبكة المحلية (LAN)
دخول تطبيق الويب POST /api/signin باسم المستخدم وكلمة المرور

9.2 أهم نقاط النهاية

الطريقة المسار الوظيفة
POST /api/signin تسجيل دخول المستخدم
GET / POST / PUT /api/patients قراءة وإضافة وتعديل المرضى
GET /api/patients/<hashkey> مريض واحد برقم الملف
GET /api/patientinfo/<hashkey> زيارات المريض
POST / PUT /api/patientinfo إضافة/تعديل زيارة
GET /api/stats إحصاءات العيادة
GET /api/debts · /api/on-receive الديون والمبالغ عند الاستلام
GET /api/bank-transactions حركات الخزنة
GET /api/lenses أنواع العدسات
GET /api/employees الموظفون
GET / POST /api/drafts المسودات

9.3 الاستيراد والتصدير

  • Excel هو المسار الرسمي لتبادل البيانات: المرضى، الزيارات، الخزنة، أنواع العدسات والمخزون، عبر نظام استيراد واحد موحّد.
  • Webhooks: لا توجد webhooks حالياً؛ التكامل يتم عبر REST أو ملفات Excel.
  • الأجهزة الخارجية: جهاز قياس العدسات Nidek يُقرأ محلياً عبر المنفذ التسلسلي (لا يمر عبر الشبكة).

9.4 الحصول على مفاتيح التكامل

توثيق التكامل الكامل ومفتاح الواجهة (API key) يُطلبان من فريق الدعم عبر قنوات الدعم.