ملاحظة العرض التوضيحي: نقطة نهاية تسجيل الدخول محمية بتحديات إثبات العمل التكيفية — يؤدي الفشل المتكرر إلى زيادة صعوبة إثبات العمل. تم تنفيذ واختبار تحديد معدل الطلب المدعوم بالذاكرة المؤقتة ولكنه غير مُفعل حاليًا في العرض المباشر؛ قم بتبديل createCacheClient في app.ts لتفعيله.

تنفيذ مرجعي للمصادقة من الصفر لـ Cloudflare Workers — تجزئة كلمة المرور بـ PBKDF2، جلسات الرمز المزدوج JWT، المقارنة في وقت ثابت، انتهاء الصلاحية المتحرك، ومكون إضافي قابل للإزالة للمراقبة — كل ذلك متصل مع Hono و Turso (مع تخزين اختياري لـ Valkey/Redis) و TypeScript صارم.

كل خيار تصميمي يعود إلى معيار: NIST SP 800-63B لبيانات الاعتماد، NIST SP 800-132 لاستخلاص المفاتيح، OWASP ASVS للتحقق، و RFC 8725 لأفضل ممارسات JWT.

تريد شحن منتج؟ استخدم Better Auth بدلاً من ذلك — فهو يغطي OAuth ومفاتيح المرور والمصادقة متعددة العوامل وتحديد معدل الطلب والمزيد من الصندوق مع نظام إضافات نشط. هذا المستودع موجود ليعلمك كيف تعمل المصادقة، وليس لاستبدال مكتبة إنتاجية.

لماذا هذا المستودع

• اقرأ الكود، وليس فقط الوثائق — كل خاصية أمنية (رفض آمن زمنياً، إلغاء مرتبط بالجلسة، تثبيت الخوارزمية) منفذة ومختبرة، وليست موصوفة فقط
• مراجع NIST + OWASP + RFC في جميع الأنحاء — تعلم لماذا وراء كل قرار
• أكثر من 630 اختباراً بما في ذلك مجموعات متجهات الهجوم (التلاعب بالرمز، الارتباك في الخوارزمية، حالات الحافة لـ Unicode)
• مكون إضافي للمراقبة — تسجيل تدقيق منظم، تحديات إثبات عمل تكيفية، واجهة برمجة تطبيقات للعمليات مُوثَّقة بواسطة وكيل، وبث أحداث WebSocket — يتم توصيله عبر وسيط Hono دون تعديل المصادقة الأساسية
• مبني للطرف — يعمل على Cloudflare Workers باستخدام Web Crypto API، بدون تبعيات Node.js
• Apache-2.0 — استنسخه، درّس به، تعلم منه

ما ستجده بالداخل

الخطوات التالية للإنتاج

هذا المشروع يتعمد حذف الميزات التي تقع خارج نطاقه التعليمي. إذا كنت توسّع هذا الكود نحو الإنتاج (أو تقيّم ما يتطلبه نظام مصادقة إنتاجي)، فإن الجداول أدناه تنظم الفجوات حسب مستوى الأولوية.

بالنسبة لمعظم المشاريع الواقعية، استخدم Better Auth بدلاً من بناء هذه بنفسك.

حرجة — أضف قبل المستخدمين الحقيقيين

أولوية عالية — ثقة الإنتاج

أولوية متوسطة — مع توسع المنتج

متقدم — مؤسسي / أمان عالي

كل هذه أسباب ممتازة لاستخدام Better Auth بدلاً من ذلك.

هيكل المستودع

.
├── apps/
│   └── cloudflare-workers/    # Example Worker + Hono routes
├── packages/
│   ├── core/                  # Auth services, middleware, crypto utilities
│   ├── infrastructure/        # DB client + utilities
│   ├── observability/         # Event emission, adaptive challenges, ops API (removable plugin)
│   ├── schemas/               # Zod schemas
│   └── types/                 # Shared TypeScript types
├── tools/
│   └── cli/                   # plctl — Go TUI for the /ops surface
└── docs/
    ├── adr/                   # Architecture Decision Records
    └── audits/                # Security audits

البدء

git clone https://github.com/vhscom/private-landing.git
cd private-landing
bun install
bun run dev

هذا كل شيء — لا حسابات، لا مفاتيح API، لا ملفات .env. خادم التطوير يبدأ بقاعدة بيانات SQLite محلية وأسرار مولَّدة. افتح http://localhost:8788 لتسجيل حساب واستكشاف تدفقات المصادقة.

لديك حساب Turso؟ ضع ملف .dev.vars في apps/cloudflare-workers/ (انظر .dev.vars.example) و bun run dev سيستخدم تلقائياً wrangler مع قاعدة البيانات البعيدة. استخدم bun run dev:local لفرض الخادم المحلي بغض النظر.

انظر CONTRIBUTING.md لتعليمات الاختبار والنشر.

الاستخدام مع الذكاء الاصطناعي

يتضمن هذا المستودع ملف CLAUDE.md الذي يوفر سياقاً للمساعدين الذكاء الاصطناعي. عند استخدام Claude Code أو Cursor أو أدوات تطوير مدعومة بالذكاء الاصطناعي مماثلة:

1. سيقرأ الذكاء الاصطناعي تلقائياً CLAUDE.md لسياق المشروع
2. سجلات القرارات المعمارية في docs/adr/ تشرح خيارات التصميم
3. تدقيقات الأمان في docs/audits/ توثق الوضع الأمني
4. الاختبارات توضح السلوك المتوقع والحالات الحافة

تم تصميم قاعدة الكود لتكون قابلة للقراءة من قبل الذكاء الاصطناعي مع حدود وحدة واضحة، أنواع شاملة، وتسمية وصفية.

الترخيص

Apache-2.0