> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# مجموعة تفضيلات التدقيق الإملائي (Spelling Preferences)

`spellingPreferences` تحفظ قاموس كل مستخدم: الكلمات التي أضافها المستخدم عبر "Add to dictionary" في المدقق الإملائي للمحرر. مستند واحد لكل مستخدم. المالك هو `web`، دون مخطط Mongoose؛ والشيفرة هي `services/web/app/src/Features/Spelling/LearnedWordsManager.mjs`.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف المستند، تنشئه عملية upsert. | `LearnedWordsManager.mjs:21-31` |
| `token` | String | معرّف المستخدم. رغم الاسم، تمرّر مسارات التدقيق الإملائي معرّف المستخدم المسجّل دخوله (`SessionManager.getLoggedInUserId`). | `LearnedWordsManager.mjs:23` |
| `learnedWords` | Array of String | الكلمات التي أضافها المستخدم. | `LearnedWordsManager.mjs:26` |

#### من يكتب فيها

| الشيفرة | ما الذي تفعله |
| - | - |
| `LearnedWordsManager.mjs:13-32` (`learnWord`) | `POST /spelling/learn` (`services/web/app/src/router.mjs:1037-1041`, `services/web/app/src/Features/Spelling/SpellingController.mjs:45-58`): تُجري `$addToSet` للكلمة مع upsert. وترفض إذا كانت القائمة ستتجاوز `Settings.maxDictionarySize` بايت. |
| `LearnedWordsManager.mjs:38-47` (`unlearnWord`) | `POST /spelling/unlearn` (`router.mjs:1043-1047`, `SpellingController.mjs:66-79`): تُجري `$pull` للكلمة. |
| `LearnedWordsManager.mjs:84-86` (`deleteUsersLearnedWords`) | تحذف المستند. غلافها الوحيد، `SpellingHandler.deleteUserDictionary` (`services/web/app/src/Features/Spelling/SpellingHandler.mjs:24-26`)، لا يستدعيه أي شيء في web أو وحداته. |

#### من يقرأ منها

| الشيفرة | ما الذي تفعله |
| - | - |
| `LearnedWordsManager.mjs:52-67` (`getLearnedWords`) | تُعيد الكلمات دون تكرار. |
| `services/web/app/src/Features/Project/ProjectController.mjs:671` | ترسل القاموس إلى المحرر عند فتح مشروع (`SpellingHandler.getUserDictionary`). |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `token` | `{ token: 1 }` | | `tools/migrations/20190912145027_create_spellingPreferences_indexes.mjs` |

#### ملاحظات

* الفهرس ليس فريدًا؛ تُبقي عملية upsert على `token` مستندًا واحدًا لكل مستخدم.
* حذف المستخدم لا يحذف هذا المستند.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.