البنية النظيفة · خرائط ذهنية
البنية النظيفة. خريطة ذهنية قابلة للتحرير تضم فروعًا ملونة وأفكارًا فرعية وروابط. توضح الخطوط المنحنية العلاقات، وتظهر الأسهم حين يكون للاتجاه معنى.
تنظّم البنية النظيفة الشيفرة في طبقات متحدّة المركز (الكيانات، وحالات الاستخدام، ومحوّلات الواجهة، والأطر) تحت قاعدة واحدة: التبعيات تتجه إلى الداخل دائماً، فلا يعتمد الجوهر على أداة أبداً.
البنية النظيفة · خرائط ذهنية
لوحة MindMap التفاعلية لهذا الشرح — كل مسار وصف وسهم أعلاه جزء من مخطط QueryChart حقيقي يمكنك فتحه وتعديله.
كيفية قراءة الخريطة الذهنية
- ابدأ بالموضوع في المركز، ثم اتبع أحد الفروع الملونة لاستكشاف الأفكار المرتبطة به.
- توضح الخطوط المنحنية العلاقات، وتظهر الأسهم حين يكون للاتجاه معنى.
Business core
يجمع هذا الفرع “The innermost circle: objects and rules that exist no matter how the app is delivered — a customer, an invoice, the rule that an invoice cannot be paid twice.”, “The core never imports a framework”.
Use cases
يجمع هذا الفرع “Use cases orchestrate entities for one application scenario, such as “place an order”. They know about the app but nothing about screens or databases.”, “Because the database and UI are details, replacing them — a migration, a new front-end — leaves the entities and use cases untouched.”.
Adapters
يجمع هذا الفرع “Adapters translate between the use cases and the outside world: an HTTP controller turns a request into a use-case call, a presenter turns results into a screen.”, “Outer layers talk through the adapter, not to the core”.
Frameworks
يجمع هذا الفرع “The outermost ring: the tools. React, PostgreSQL, Express — details that can change without the core knowing or caring.”, “The dependency rule: source code dependencies always cross inward. The core declares what it needs (interfaces) and the outer rings implement them.”.
روابط بين الفروع
التبعيات تتجه إلى الداخل دائماً، وهذه القاعدة الواحدة هي هذه البنية نفسها.
الجوهر يعلن الواجهات؛ والحلقات الخارجية تنفّذها، والمحوّل هو خط التماس.
الكيانات وحالات الاستخدام مستقلة عن الأطر بحكم التصميم.
العائد هو قابلية الاستبدال: بدّل واجهة المستخدم أو قاعدة البيانات أو إطار الويب دون المساس بالجوهر.
البنية النظيفة تدور حول اتجاه التبعية، لا حول عدد الطبقات.
العلاقات الرئيسية والخلاصات
- التبعيات تتجه إلى الداخل دائماً، وهذه القاعدة الواحدة هي هذه البنية نفسها.
- الجوهر يعلن الواجهات؛ والحلقات الخارجية تنفّذها، والمحوّل هو خط التماس.
- الكيانات وحالات الاستخدام مستقلة عن الأطر بحكم التصميم.
- العائد هو قابلية الاستبدال: بدّل واجهة المستخدم أو قاعدة البيانات أو إطار الويب دون المساس بالجوهر.
- البنية النظيفة تدور حول اتجاه التبعية، لا حول عدد الطبقات.
متى تستخدم هذا الشرح المرئي
- تعليم قاعدة التبعية لفريق قبل أن يبني هيكل قاعدة شيفرة كبيرة.
- مراجعة بنية قائمة: فحالة استخدام تستورد مكتبة واجهة مستخدم أو قاعدة بيانات هي مخالفة للقاعدة، وهي مرئية على اللوحة.
- التخطيط لإعادة كتابة أو ترحيل، فاللوحة تبيّن أي الطبقات يجب أن تبقى وأيها يمكن استبداله.
كيف تعمل
عدّل الموضوع المركزي
غيّر اسم الموضوع ليناسب مشروعك أو درسك.
وسّع الفروع
حرر الأفكار وأضف أمثلة أو ملاحظات.
اربط الأفكار ذات الصلة
ارسم روابط بين الفروع، واستخدم الأسهم عندما يكون الاتجاه مهمًا.
الأسئلة الشائعة
ما هي البنية النظيفة؟
هي نمط معماري شاع بفضل Robert C. Martin، ينظّم الشيفرة في طبقات متحدّة المركز: الكيانات في المركز، ثم حالات الاستخدام، ثم محوّلات الواجهة، ثم الأطر وبرامج التشغيل عند الحافة. وقاعدتها الحاكمة هي أن تبعيات الشيفرة المصدرية تتجه إلى الداخل دائماً، فلا تعتمد قواعد العمل الجوهرية على آليات التقديم: واجهة المستخدم أو قاعدة البيانات أو إطار الويب.
ما هي قاعدة التبعية؟
تقول قاعدة التبعية إن تبعيات الشيفرة المصدرية يجب أن تعبر إلى الداخل دائماً: فللطبقة الخارجية أن تعتمد على طبقة داخلية، لا العكس أبداً. وعملياً، تعلن الطبقات الداخلية واجهات وتنفّذها الطبقات الخارجية، فلا تستورد شيفرة الجوهر شيئاً من الأدوات الموجودة عند الحافة. ويرسم الشرح المرئي هذا كمجموعة قائمة بذاتها لأن كل خاصية أخرى في هذه البنية تنبع منها.
ما الفرق بين البنية النظيفة والبنية الطبقية؟
البنية الطبقية تفصل المسؤوليات أيضاً، لكن تبعياتها تسري عادةً من الأعلى إلى الأسفل، فطبقة العرض تستدعي طبقة الخدمات، وهذه تستدعي طبقة البيانات. أما البنية النظيفة فتقلب ذلك: إذ يجلس جوهر العمل في المركز ويعتمد عليه كل ما عداه، فيكون اتجاه التبعية هو السمة المميّزة. وسهم الشرح المرئي المتجه إلى الجوهر هو هذا الفرق وقد صار مرئياً.
هل تستحق البنية النظيفة العناء في مشروع صغير؟
ليس دائماً، فالطقوس تكلّف أكثر مما تعيد حين تكون قواعد العمل تافهة أو حين يكون الفريق شخصاً واحداً. وهذا النمط يستحق كلفته حين يكون منطق العمل معقّداً بما يكفي ليعمّر أطول من الأدوات، أو حين يُرجّح تغيّر واجهة المستخدم أو قاعدة البيانات. ومربعات العائد في اللوحة تذكر المقايضة بصدق: فأمان الجوهر يُشترى بطبقات المحوّلات.
حرر هذه الخريطة الذهنية في QueryChart
افتح الخريطة على لوحة قابلة للتحرير. انقل الأفكار وأضف فروعًا وروابط.