# User & Minds API

تتولى User & Minds API إدارة الحسابات. تستخدم هذه النقاط مصادقة JWT
(وليس Mind Keys) لأنها تعمل على مستوى الحساب، لا على مستوى العقل.

## نقاط نهاية المصادقة

### POST /register

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

```bash
curl -X POST https://synapse.schaefer.zone/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password",
    "display_name": "Michael"
  }'
```

الاستجابة:

```json
{
  "jwt": "eyJhbGci...",
  "user": {
    "id": "u_abc123",
    "email": "you@example.com",
    "display_name": "Michael",
    "created_at": "2026-06-27T..."
  }
}
```

### POST /login

تسجيل الدخول إلى حساب موجود.

```bash
curl -X POST https://synapse.schaefer.zone/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password"
  }'
```

الاستجابة: مثل `/register`.

## نقاط نهاية العقول

### POST /minds

إنشاء عقل جديد. يُرجع Mind Key — **احفظه فورًا**، فهو يُعرض مرة واحدة فقط.

```bash
curl -X POST https://synapse.schaefer.zone/minds \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Work Mind",
    "description": "Job-related memories"
  }'
```

الاستجابة:

```json
{
  "id": "m_xyz789",
  "name": "Work Mind",
  "description": "Job-related memories",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}
```

> [!CRITICAL]
> يُعرض `mind_key` مرة واحدة فقط. إذا فقدته، لا يمكنك استرداده —
> يجب حذف العقل وإنشاء واحد جديد (مما يفقد جميع الذكريات المخزّنة).

### GET /minds

قائمة بجميع العقول للمستخدم الحالي.

```bash
curl -H "Authorization: Bearer YOUR_JWT" \
     https://synapse.schaefer.zone/minds
```

الاستجابة:

```json
{
  "minds": [
    {
      "id": "m_xyz789",
      "name": "Work Mind",
      "description": "Job-related memories",
      "created_at": "2026-06-27T...",
      "memory_count": 142,
      "last_activity": "2026-06-27T..."
    }
  ]
}
```

### DELETE /minds/:id

حذف عقل نهائيًا.

```bash
curl -X DELETE -H "Authorization: Bearer YOUR_JWT" \
     https://synapse.schaefer.zone/minds/m_xyz789
```

> [!WARNING]
> حذف العقل **لا يمكن التراجع عنه**. جميع الذكريات والمهام وسجل الدردشة
> والسكربتات في ذلك العقل تُفقد نهائيًا. صدّر أولًا عبر
> `GET /memory/mind-export` إذا كنت بحاجة إلى نسخة احتياطية.

## نمط العقول المتعددة

يستفيد معظم المستخدمين من عقول متعددة لعزل السياقات:

```bash
# أنشئ عقولًا لسياقات مختلفة
curl -X POST .../minds -d '{"name": "work", "description": "Job"}'
# → mind_key: mk_work...

curl -X POST .../minds -d '{"name": "personal", "description": "Personal life"}'
# → mind_key: mk_personal...

curl -X POST .../minds -d '{"name": "project-synapse", "description": "Synapse dev"}'
# → mind_key: mk_synapse...
```

استخدم Mind Keys مختلفة في جلسات LLM مختلفة للحفاظ على عزل السياقات.

## أمان الحساب

### متطلبات كلمة المرور

- 6 أحرف كحد أدنى
- لا حد أقصى (استخدم مدير كلمات مرور)
- تُخزَّن كـ bcrypt hash (أبدًا كنص صريح)

### انتهاء JWT

تنتهي JWTs بعد **7 أيام**. عند انتهائها، استدعِ `/login` مرة أخرى.

### أمان Mind Key

لا تنتهي Mind Keys أبدًا. إذا تعرّض Mind Key للاختراق:

1. أنشئ عقلًا جديدًا عبر `POST /minds`
2. حدّث إعدادات LLM بـ Mind Key الجديد
3. احذف العقل المخترق عبر `DELETE /minds/:id`

## الخطوات التالية

- [المصادقة](/docs/getting-started/authentication) — دليل المصادقة الكامل
- [Mind Key مقابل JWT](/docs/getting-started/mind-key-vs-jwt) — دليل القرار
- [Sharing API](/docs/api/user) — مشاركة العقول مع مستخدمين آخرين