包简介

Smart Face Authentication Package for Laravel

README 文档

README

هذا المشروع عبارة عن Package لـ Laravel تتيح تسجيل الدخول والتحقق من الهوية باستخدام بصمة الوجه (Face Recognition) باستخدام مكتبة face-api.js.

📂 هيكل الحزمة (Package Structure)

face-login-package/
├─ composer.json                 # تعريف الحزمة والاعتمادات
├─ src/
│  ├─ FaceLoginServiceProvider.php # مزود الخدمة (تسجيل الرواتس، الفيو، والميجريشن)
│  ├─ Http/
│  │  └─ Controllers/
│  │     └─ FaceLoginController.php # المنطق الخلفي (المطابقة، الجلسات، الانتهاكات)
│  ├─ Models/
│  │  ├─ FaceDescriptor.php      # مودل تخزين بصمات الوجوه (Vectors)
│  │  └─ FaceViolation.php        # مودل لتسجيل محاولات الدخول الخاطئة أو الانتحال
│  ├─ database/
│  │  └─ migrations/              # جداول قاعدة البيانات
│  ├─ resources/
│  │  └─ views/                  # صفحات تسجيل الدخول والتسجيل (Blade)
│  └─ routes/
│     └─ web.php                 # روابط الحزمة
└─ README.md                     # ملف الشرح (هذا الملف)

🚀 التثبيت والاستخدام (Installation)

1. الإضافة إلى مشروعك

إذا كانت الحزمة مخزنة محلياً، أضف هذا الجزء لملف composer.json في مشروعك الأساسي:

"repositories": [
    {
        "type": "path",
        "url": "../pacakge"
    }
],

ثم قم بتشغيل:

composer require el-dakhly/smart-face-auth:dev-main

2. تشغيل الـ Migrations

قم بإنشاء الجداول المطلوبة في قاعدة البيانات:

php artisan migrate

3. نشر الملفات (اختياري)

إذا كنت ترغب في تعديل الصفحات (Views) لتناسب تصميمك:

php artisan vendor:publish --tag=face-login-views

🛠 المتطلبات الأساسية (Prerequisites)

الحزمة تعتمد على نماذج الذكاء الاصطناعي الخاصة بـ face-api.js. يجب عليك توفير الملفات في المسار التالي داخل مشروعك الرئيسي:

قم بإنشاء مجلد: public/face-api-login/models/
حمل ملفات الأوزان (Weights) من Weights Files:
- tiny_face_detector_model-weights_manifest.json
- face_landmark_68_model-weights_manifest.json
- face_recognition_model-weights_manifest.json
- بالإضافة إلى ملفات الـ .bin المصاحبة لها.

🛣 الروابط (Routes)

توفر الحزمة الروابط التالية تلقائياً:

الاسم (Route Name)	الرابط (URL)	الطريقة (Method)	الوصف
`face.login.form`	`/face-auth/login`	`GET`	عرض صفحة الدخول بالوجه
`face.login.submit`	`/face-auth/login`	`POST`	معالجة بيانات الوجه للدخول
`face.register.form`	`/face-auth/register`	`GET`	عرض صفحة تسجيل البصمة
`face.register.store`	`/face-auth/register`	`POST`	حفظ بصمات الوجه الجديدة
`face.verify.session`	`/face-auth/verify-session`	`POST`	التحقق المستمر من الجلسة
`face.report.violation`	`/face-auth/report-violation`	`POST`	تسجيل مخالفة (انتحال/أكثر من وجه)

💡 ملاحظات تقنية

المطابقة: يتم استخدام مسافة التباعد (Euclidean Distance) بمقدار 0.6. إذا كنت تريد دقة أعلى، قلل الرقم (مثلاً 0.5).
التوافق: الحزمة تحاول تلقائياً استدعاء دالة authenticated من الـ LoginController الأساسي في مشروعك إذا كانت موجودة لضمان توافق التحويلات (Redirects) بعد الدخول.
الأمان: يتم تسجيل FaceViolation تلقائياً عند اكتشاف وجه مختلف أثناء التحقق من الجلسة، ويتم تسجيل خروج المستخدم فوراً.

تم التطوير بواسطة Eng Ahmed El Dakhly - 01030326810 💻

el-dakhly/smart-face-auth 适用场景与选型建议

el-dakhly/smart-face-auth 是一款基于 Blade 开发的 Composer 扩展包，目前已累计 2 次下载、GitHub Stars 达 0，最近一次更新时间为 2025 年 12 月 25 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 el-dakhly/smart-face-auth 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 el-dakhly/smart-face-auth 我们能提供哪些服务？

定制开发 / 二次开发

基于 el-dakhly/smart-face-auth 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

el-dakhly/smart-face-auth

包简介