واجهة برمجة التطبيقات (API)
منصة تدبير للمؤشرات المالية
تحلّل المنصة القوائم المالية للمنشآت، وتحسب منها 14 مؤشرًا ماليًا في الربحية والنشاط والمديونية والتدفق النقدي، ثم تقارنها بالمعايير القطاعية المعتمدة ومتوسط المنشآت المشابهة، وتقدّم تقارير مفصّلة بخلاصة تنفيذية لكل منشأة أو محفظة.
مجموعات الواجهة
المصادقة
تسجيل الدخول برمز التحقق، وإدارة جلسة المستخدم.
/api/v1/auth
البيانات المرجعية
الأنشطة والمدن وأحجام المنشآت، ونموذج إدخال القوائم المالية.
/api/v1/lookups
المنشآت
تسجيل المنشأة وبياناتها الأساسية ونشاطها.
/api/v1/companies
القوائم المالية
إدخال القوائم لكل سنة مالية، وحساب المؤشرات منها.
/api/v1/accounts
التقارير
تقرير المنشأة، ومقارنة السوق، والمقارنة عبر السنوات، وتقرير المحفظة.
/api/v1/reports
المحافظ
تجميع عدة منشآت في محفظة واحدة وتحليلها مجتمعة.
/api/v1/portfolios
الاشتراكات
الباقات المتاحة واشتراك المستخدم وصلاحياته.
/api/v1/subscriptions
لوحة الإدارة
المعايير القطاعية، ونصوص التحليل، والمستخدمين والباقات.
/api/v1/admin
بنية وتقنيات الخادم (Backend Stack)
بيئة التشغيل، بوحدات ES Modules.
لغة المشروع بالكامل، بأنواع صارمة.
خادم HTTP والتوجيه والوسائط.
طبقة الوصول إلى قاعدة البيانات (ORM).
قاعدة البيانات العلائقية.
إرسال رموز التحقق بالبريد الإلكتروني.
رفع ملفات القوائم المالية.
الاختبارات الآلية للمؤشرات والمسارات.
مسار الطلب عبر طبقات الخادم
المسارات
استقبال الطلب والتحقق من مدخلاته.
routes
الوسائط
المصادقة، وصلاحيات الباقة، ومعالجة الأخطاء.
middleware
الخدمات
منطق التطبيق: المنشآت والاشتراكات والملفات.
services
النطاق المالي
حساب المؤشرات، والمقارنة بالمعايير، وصياغة التحليل.
domain
البيانات
التخزين والاستعلامات.
Prisma · MySQL
معلومات الاستخدام
- العنوان الأساسي
/api/v1- صيغة البيانات
- JSON في الطلبات والاستجابات
- المصادقة
- رمز في الترويسة
Authorization: Bearer <token> - اللغة
- العربية افتراضيًا، وتُحدَّد بالترويسة
Accept-Language - فحص الحالة
- /up