# User & Minds API
SUMMARY: إدارة الحساب — التسجيل، تسجيل الدخول، إنشاء العقول، قائمة العقول، حذف العقول. محمية بـ JWT.

KEY CONTEXT:
Auth: JWT (from /register or /login)
Register: POST /register { email, password, display_name? } → returns JWT
Login: POST /login { email, password } → returns JWT
Create mind: POST /minds { name, description? } → returns mind_key (shown once!)
List minds: GET /minds
Delete mind: DELETE /minds/:id (irreversible — deletes all memories!)
JWT expires after 7 days. Mind Key never expires.
Mind Key is shown only once at creation — save it permanently.

User & Minds API
تتولى User & Minds API إدارة الحسابات. تستخدم هذه النقاط مصادقة JWT
(وليس Mind Keys) لأنها تعمل على مستوى الحساب، لا على مستوى العقل.
نقاط نهاية المصادقة
POST /register
إنشاء حساب مستخدم جديد.
[CODE BLOCK]
الاستجابة:
[CODE BLOCK]
POST /login
تسجيل الدخول إلى حساب موجود.
[CODE BLOCK]
الاستجابة: مثل .
نقاط نهاية العقول
POST /minds
إنشاء عقل جديد. يُرجع Mind Key — احفظه فورًا، فهو يُعرض مرة واحدة فقط.
[CODE BLOCK]
الاستجابة:
[CODE BLOCK]
> [!CRITICAL]
> يُعرض  مرة واحدة فقط. إذا فقدته، لا يمكنك استرداده —
> يجب حذف العقل وإنشاء واحد جديد (مما يفقد جميع الذكريات المخزّنة).
GET /minds
قائمة بجميع العقول للمستخدم الحالي.
[CODE BLOCK]
الاستجابة:
[CODE BLOCK]
DELETE /minds/:id
حذف عقل نهائيًا.
[CODE BLOCK]
> [!WARNING]
> حذف العقل لا يمكن التراجع عنه. جميع الذكريات والمهام وسجل الدردشة
> والسكربتات في ذلك العقل تُفقد نهائيًا. صدّر أولًا عبر
>  إذا كنت بحاجة إلى نسخة احتياطية.
نمط العقول المتعددة
يستفيد معظم المستخدمين من عقول متعددة لعزل السياقات:
[CODE BLOCK]
استخدم Mind Keys مختلفة في جلسات LLM مختلفة للحفاظ على عزل السياقات.
أمان الحساب
متطلبات كلمة المرور
- 6 أحرف كحد أدنى
- لا حد أقصى (استخدم مدير كلمات مرور)
- تُخزَّن كـ bcrypt hash (أبدًا كنص صريح)
انتهاء JWT
تنتهي JWTs بعد 7 أيام. عند انتهائها، استدعِ  مرة أخرى.
أمان Mind Key
لا تنتهي Mind Keys أبدًا. إذا تعرّض Mind Key للاختراق:
1. أنشئ عقلًا جديدًا عبر 
2. حدّث إعدادات LLM بـ Mind Key الجديد
3. احذف العقل المخترق عبر 
الخطوات التالية
- المصادقة — دليل المصادقة الكامل
- Mind Key مقابل JWT — دليل القرار
- Sharing API — مشاركة العقول مع مستخدمين آخرين