skill

تصميم قاعدة الكود

مفردات مشتركة لتصميم الوحدات العميقة. تستخدم عندما يرغب المستخدم في تصميم أو تحسين واجهة وحدة نمطية، أو إيجاد فرص للتعميق، أو تحديد مكان الفصل، أو جعل الكود أكثر قابلية للاختبار أو التنقل بواسطة الذكاء الاصطناعي، أو عندما تحتاج مهارة أخرى إلى مفردات الوحدة العميقة.

mattpocock692,475+ تثبيتموثوق

نبذة

# تصميم قاعدة الكود

صمم **وحدات عميقة (deep modules)**: الكثير من السلوك خلف واجهة صغيرة، توضع عند نقطة فصل واضحة (clean seam)، وقابلة للاختبار من خلال تلك الواجهة. استخدم هذه اللغة وهذه المبادئ أينما يتم تصميم الكود أو إعادة هيكلته. الهدف هو تحقيق الفائدة للمستدعين (callers)، والتمركز للمطورين (maintainers)، وقابلية الاختبار للجميع.

## مسرد المصطلحات

استخدم هذه المصطلحات بدقة: لا تستبدلها ب "component" أو "service" أو "API" أو "boundary". الاتساق في اللغة هو الهدف الأساسي.

**الوحدة (Module)**: أي شيء له واجهة وتطبيق. مصمم ليكون مستقلا عن الحجم: يمكن أن يكون دالة، أو صنفا، أو حزمة، أو شريحة تمتد عبر طبقات. _تجنب_: unit, component, service.

**الواجهة (Interface)**: كل ما يجب أن يعرفه المستدعي لاستخدام الوحدة بشكل صحيح: توقيع النوع (type signature)، وأيضا الثوابت (invariants)، وقيود الترتيب (ordering constraints)، وأنماط الأخطاء (error modes)، والتكوين المطلوب (required configuration)، وخصائص الأداء (performance characteristics). _تجنب_: API, signature (ضيقة جدا، تشير فقط إلى السطح على مستوى النوع).

**التطبيق (Implementation)**: ما بداخل الوحدة، وهو جسم الكود الخاص بها. يختلف عن **المحول (Adapter)**: يمكن أن يكون الشيء محولا صغيرا بتطبيق كبير (مستودع Postgres) أو محولا كبيرا بتطبيق صغير (محاكاة في الذاكرة). استخدم "adapter" عندما تكون نقطة الفصل هي الموضوع؛ و"implementation" بخلاف ذلك.

**العمق (Depth)**: الفائدة عند الواجهة. مقدار السلوك الذي يمكن للمستدعي (أو الاختبار) ممارسته لكل وحدة من الواجهة التي يتعين عليه تعلمها. الوحدة تكون **عميقة (deep)** عندما يكون هناك قدر كبير من السلوك خلف واجهة صغيرة، و**ضحلة (shallow)** عندما تكون الواجهة معقدة تقريبا مثل التطبيق.

**نقطة الفصل (Seam)** _(مايكل فيذرز)_: مكان يمكنك فيه تغيير السلوك دون التعديل في ذلك المكان؛ وهو *الموقع* الذي توجد فيه واجهة الوحدة. تحديد مكان نقطة الفصل هو قرار تصميمي بحد ذاته، يختلف عما يوضع خلفها. _تجنب_: boundary (مثقلة بالمعنى في سياق DDD's bounded context).

**المحول (Adapter)**: شيء ملموس يحقق واجهة عند نقطة فصل. يصف *الدور* (ما هي الفتحة التي يملأها)، وليس الجوهر (ما بداخله).

**الفائدة (Leverage)**: ما يحصل عليه المستدعون من العمق. قدرة أكبر لكل وحدة من الواجهة التي يتعلمونها. تطبيق واحد يعود بالفائدة عبر N موقع استدعاء و M اختبار.

**التمركز (Locality)**: ما يحصل عليه المطورون من العمق. تتمركز التغييرات والأخطاء والمعرفة والتحقق في مكان واحد بدلا من الانتشار عبر المستدعين. إصلاح مرة واحدة، يتم إصلاحه في كل مكان.

## عميق مقابل ضحل

**وحدة عميقة (Deep module)** = واجهة صغيرة + الكثير من التطبيق:

``` ┌─────────────────────┐ │ Small Interface │ ← Few methods, simple params ├─────────────────────┤ │ │ │ Deep Implementation│ ← Complex logic hidden │ │ └─────────────────────┘ ```

**وحدة ضحلة (Shallow module)** = واجهة كبيرة + القليل من التطبيق (تجنب):

``` ┌─────────────────────────────────┐ │ Large Interface │ ← Many methods, complex params ├─────────────────────────────────┤ │ Thin Implementation │ ← Just passes through └─────────────────────────────────┘ ```

عند تصميم واجهة، اسأل:

- هل يمكنني تقليل عدد الطرق (methods)؟ - هل يمكنني تبسيط المعلمات (parameters)؟ - هل يمكنني إخفاء المزيد من التعقيد بالداخل؟

## المبادئ

- **العمق هو خاصية للواجهة، وليس للتطبيق.** يمكن أن تتكون الوحدة العميقة داخليا من أجزاء صغيرة، قابلة للمحاكاة (mockable)، وقابلة للتبديل (swappable)؛ لكنها ليست جزءا من الواجهة. يمكن أن تحتوي الوحدة على **نقاط فصل داخلية (internal seams)** (خاصة بتطبيقها، وتستخدمها اختباراتها الخاصة) بالإضافة إلى **نقطة الفصل الخارجية (external seam)** عند واجهتها. - **اختبار الحذف.** تخيل حذف الوحدة. إذا اختفى التعقيد، فقد كانت مجرد تمرير. إذا ظهر التعقيد مرة أخرى عبر N مستدع، فقد كانت تؤدي دورها. - **الواجهة هي سطح الاختبار.** المستدعون والاختبارات يعبرون نفس نقطة الفصل. إذا كنت ترغب في الاختبار *ما وراء* الواجهة، فمن المحتمل أن شكل الوحدة خاطئ. - **محول واحد يعني نقطة فصل افتراضية. محولان يعني نقطة فصل حقيقية.** لا تقدم نقطة فصل إلا إذا كان هناك شيء يتغير بالفعل عبرها.

## التصميم من أجل قابلية الاختبار

الواجهات الجيدة تجعل الاختبار طبيعيا:

1. **تقبل التبعيات، لا تنشئها.**

```typescript // Testable function processOrder(order, paymentGateway) {}

// Hard to test function processOrder(order) { const gateway = new StripeGateway(); } ```

2. **إرجاع النتائج، لا تنتج آثارا جانبية.**

```typescript // Testable function calculateDiscount(cart): Discount {}

// Hard to test function applyDiscount(cart): void { cart.total -= discount; } ```

3. **مساحة سطح صغيرة.** عدد أقل من الطرق = عدد أقل من الاختبارات المطلوبة. عدد أقل من المعلمات = إعداد اختبار أبسط.

## العلاقات

- تحتوي **الوحدة (Module)** على واجهة واحدة بالضبط (السطح الذي تقدمه للمستدعين والاختبارات). - **العمق (Depth)** هو خاصية للوحدة، ويقاس مقابل واجهتها. - **نقطة الفصل (Seam)** هي المكان الذي توجد فيه واجهة الوحدة. - **المحول (Adapter)** يجلس عند نقطة فصل ويحقق الواجهة. - ينتج **العمق (Depth)** **فائدة (Leverage)** للمستدعين و**تمركزا (Locality)** للمطورين.

## الأطر المرفوضة

- **العمق كنسبة من التطبيق**

التثبيت

شغل هذا الأمر

npx skills add mattpocock/skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/engineering/codebase-design` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة تصميم قاعدة الكود؟

مفردات مشتركة لتصميم الوحدات العميقة. تستخدم عندما يرغب المستخدم في تصميم أو تحسين واجهة وحدة نمطية، أو إيجاد فرص للتعميق، أو تحديد مكان الفصل، أو جعل الكود أكثر قابلية للاختبار أو التنقل بواسطة الذكاء الاصطناعي، أو عندما تحتاج مهارة أخرى إلى مفردات الوحدة العميقة.

كيف أثبت تصميم قاعدة الكود؟

شغل هذا الأمر في الطرفية:

npx skills add mattpocock/skills
مع أي أدوات ذكاء اصطناعي تعمل تصميم قاعدة الكود؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور تصميم قاعدة الكود؟

طورها mattpocock.

هل تصميم قاعدة الكود مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التصميم والإبداع.

كل بدائل تصميم قاعدة الكود ←
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
اشوني
مقابلة مكثفة لصقل خطة أو تصميم.1,242,904+
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/agent-browser
متصفح الوكيل
أداة سطر أوامر لأتمتة المتصفح لوكلاء الذكاء الاصطناعي. تستخدم عندما يحتاج المستخدم إلى التفاعل مع مواقع الويب، بما في ذلك التنقل بين الصفحات، وملء الن…969,165+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
رسوم متحركة هايبر فريمز
جميع المعارف المتعلقة بالرسوم المتحركة ل HyperFrames — قواعد الحركة الذرية، مخططات المشاهد متعددة المراحل، انتقالات المشاهد، تقنيات تصميم الحركة الأوس…943,098+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نموذج أولي
أنشئ نموذجا أوليا مؤقتا للإجابة على سؤال تصميمي. استخدمه عندما يرغب المستخدم في التحقق مما إذا كان نموذج الحالة أو المنطق صحيحا، أو لاستكشاف الشكل الذ…853,069+
skillclaude_appclaude_codeclaude_api
npx skills add designed-by-ai/skills
تصميم تطبيقات الجوال
صمم شاشات تطبيقات الجوال باستخدام Sleek، وقم بتحرير مشاريع Sleek، وطبق تصميماتها في React Native أو HTML.700,496+
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/agent-skills
إرشادات تصميم الويب
مراجعة كود واجهة المستخدم (UI) للتأكد من امتثاله لإرشادات واجهة الويب. يستخدم عند طلب "مراجعة واجهة المستخدم الخاصة بي"، "التحقق من إمكانية الوصول"، "…676,924+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التصميم والإبداع