مرحباً — Le Piramidi

مرحباً بكم في Le Piramidi

يسعدنا وجودكم هنا. هذه هي بوابة واجهة برمجة التطبيقات الرسمية لـ Le Piramidi — منصة آمنة متعددة اللغات مصممة لتشغيل خدماتنا الرقمية بموثوقية وعناية.

البيئة production المنفذ 3000 الحالة سليم اللغات EN · AR · IT

MongoDB

متصل

قاعدة بيانات المستندات مع إعادة اتصال تلقائية وملفات المستخدمين

Redis

متصل

عميل ذاكرة مؤقتة مع إعادة محاولة تصاعدية

WebSocket

متصل

الاتصالات النشطة: 0

Socket.io مع مصادقة JWT عند الاتصال

رفع الملفات

متصل

الحد الأقصى: 5 MB (images), 20 MB (drawings)

المسموح: image/jpeg, image/png, image/gif, image/webp, image/bmp, image/tiff, image/heic, image/heif, image/avif

ما يشغّل Le Piramidi

القدرات الأساسية المطبّقة وجاهزة لمنتجاتنا وفرقنا.

طبقة الأمان

رؤوس أمان Helmet
CORS مع قائمة مصادر مسموحة
تحديد معدل الطلبات على مسارات المصادقة والعامة
حماية JWT Bearer

تعدد اللغات

الإنجليزية والعربية والإيطالية
رسائل أخطاء API مترجمة
دعم RTL للعربية
اكتشاف Accept-Language

المصادقة

تسجيل مستخدمين مع أدوار
تسجيل دخول آمن وإصدار JWT
تشفير bcrypt لكلمات المرور
مصادقة WebSocket

وحدات الخدمة الميدانية

المستخدمون والمشاريع والمركبات والمهام
صلاحيات حسب الدور للمسؤول والعامل
جداول دوام مع سياج جغرافي وتسجيل دخول/خروج
دعم webhook لدخول السياج الجغرافي

تجربة المطوّر

تحقق Zod للبيئة والطلبات
معالجة مركزية للأخطاء
سجلات منظمة في الإنتاج
إيقاف تدريجي عند SIGTERM / SIGINT

نقاط نهاية API

المسارات والقنوات التي يوفّرها هذا الخادم.

الطريقة	المسار	الوصف	الحالة
`GET`	`/`	صفحة الترحيب Le Piramidi	فعّال
`GET`	`/health`	لوحة صحة النظام والتبعيات	فعّال
`POST`	`/api/v1/auth/register`	إنشاء حساب مستخدم جديد	فعّال
`POST`	`/api/v1/auth/login`	المصادقة والحصول على رمز JWT	فعّال
`GET`	`/api/v1/auth/me`	إرجاع ملف المستخدم المصادق	فعّال
`POST`	`/api/v1/auth/users`	إنشاء مستخدمين (للمسؤولين فقط) مع تعيين الدور	فعّال
`GET`	`/api/v1/users`	قائمة المستخدمين (للمسؤولين فقط)	فعّال
`GET`	`/api/v1/users/:id`	جلب ملف مستخدم (ذاتي أو للمسؤول)	فعّال
`PATCH`	`/api/v1/users/:id`	تحديث مستخدم بسياسات حسب الدور	فعّال
`DELETE`	`/api/v1/users/:id`	إلغاء تفعيل مستخدم (للمسؤولين فقط)	فعّال
`GET`	`/api/v1/projects`	قائمة المشاريع (الكل أو المعيّن)	فعّال
`POST`	`/api/v1/projects`	إنشاء مشروع مع سياج جغرافي (للمسؤولين)	فعّال
`GET`	`/api/v1/projects/:id`	جلب مشروع حسب المعرّف	فعّال
`PATCH`	`/api/v1/projects/:id`	تحديث مشروع (للمسؤولين فقط)	فعّال
`DELETE`	`/api/v1/projects/:id`	حذف مشروع (للمسؤولين فقط)	فعّال
`GET`	`/api/v1/vehicles`	قائمة مركبات الأسطول	فعّال
`POST`	`/api/v1/vehicles`	تسجيل مركبة (للمسؤولين فقط)	فعّال
`PATCH`	`/api/v1/vehicles/:id`	تحديث مركبة (للمسؤولين فقط)	فعّال
`DELETE`	`/api/v1/vehicles/:id`	حذف مركبة (للمسؤولين فقط)	فعّال
`GET`	`/api/v1/worker/shifts`	قائمة ورديات المشروع اليومية للعامل النشط	فعّال
`GET`	`/api/v1/worker/shifts/reports`	أرشيف تقارير الورديات المكتملة للعامل النشط	فعّال
`POST`	`/api/v1/files/profiles`	رفع صورة الملف الشخصي مع ضغط WebP للمستخدمين المصادق عليهم	فعّال
`GET`	`/api/v1/files/:category/:filename`	بث آمن للملفات حسب الفئة للمستخدمين المصادق عليهم	فعّال
`WS`	`/socket.io`	قناة فورية — مرّر JWT Bearer عند الاتصال	فعّال

الطريقة

المسار

الوصف

الحالة

GET

/

صفحة الترحيب Le Piramidi

فعّال

GET

/health

لوحة صحة النظام والتبعيات

فعّال

POST

/api/v1/auth/register

إنشاء حساب مستخدم جديد

فعّال

POST

/api/v1/auth/login

المصادقة والحصول على رمز JWT

فعّال

GET

/api/v1/auth/me

إرجاع ملف المستخدم المصادق

فعّال

POST

/api/v1/auth/users

إنشاء مستخدمين (للمسؤولين فقط) مع تعيين الدور

فعّال

GET

/api/v1/users

قائمة المستخدمين (للمسؤولين فقط)

فعّال

GET

/api/v1/users/:id

جلب ملف مستخدم (ذاتي أو للمسؤول)

فعّال

PATCH

/api/v1/users/:id

تحديث مستخدم بسياسات حسب الدور

فعّال

DELETE

/api/v1/users/:id

إلغاء تفعيل مستخدم (للمسؤولين فقط)

فعّال

GET

/api/v1/projects

قائمة المشاريع (الكل أو المعيّن)

فعّال

POST

/api/v1/projects

إنشاء مشروع مع سياج جغرافي (للمسؤولين)

فعّال

GET

/api/v1/projects/:id

جلب مشروع حسب المعرّف

فعّال

PATCH

/api/v1/projects/:id

تحديث مشروع (للمسؤولين فقط)

فعّال

DELETE

/api/v1/projects/:id

حذف مشروع (للمسؤولين فقط)

فعّال

GET

/api/v1/vehicles

قائمة مركبات الأسطول

فعّال

POST

/api/v1/vehicles

تسجيل مركبة (للمسؤولين فقط)

فعّال

PATCH

/api/v1/vehicles/:id

تحديث مركبة (للمسؤولين فقط)

فعّال

DELETE

/api/v1/vehicles/:id

حذف مركبة (للمسؤولين فقط)

فعّال

GET

/api/v1/worker/shifts

قائمة ورديات المشروع اليومية للعامل النشط

فعّال

GET

/api/v1/worker/shifts/reports

أرشيف تقارير الورديات المكتملة للعامل النشط

فعّال

POST

/api/v1/files/profiles

رفع صورة الملف الشخصي مع ضغط WebP للمستخدمين المصادق عليهم

فعّال

GET

/api/v1/files/:category/:filename

بث آمن للملفات حسب الفئة للمستخدمين المصادق عليهم

فعّال

WS

/socket.io

قناة فورية — مرّر JWT Bearer عند الاتصال

فعّال

راقب صحة الخدمة عبر GET /health أو اطلب JSON باستخدام ?format=json. GET /health · ?format=json