خمسة مستويات للغوص في نظام معقد

عندما تختلط كل مستويات السياق

ما الذي يمنع رؤية الصورة الكاملة حين تتوفر كل التفاصيل في آن واحد؟

لا يفصل المستودع العادي المعلومات بحسب المقياس: مجالات العمل، والعمليات، ونماذج البيانات، وترتيب الاستدعاءات، والبنية التحتية، وأسطر محددة من الكود — كلها تعرض في آن واحد. تضطر الذاكرة العاملة إلى الاحتفاظ بحقائق من مستويات مختلفة وإعادة بناء العلاقات بينها بنفسها. ينتقل الانتباه باستمرار بين بنية النظام والتفاصيل المحلية، لذا يتفكك الفهم بسرعة بعد أي انقطاع.

أولا — خريطة المسؤولية

أين تكمن المسؤولية؟

الركيزة الأولى هي خريطة المسؤولية. فهي تجمع وحدات التحكم والخدمات ونماذج البيانات ومهايئات البنية التحتية وسلاسل الاستدعاءات حول المجالات الرئيسية للنظام — وهي هيكل يمكن أن تربط به لاحقا العمليات والبيانات والكود.

تقسم Domain النظام لا حسب الطبقات التقنية، بل حسب مجالات مسؤولية ثابتة: الطلبات، والمدفوعات، والتواصل، والتحليلات. ومكان مئات الملفات المتساوية الأهمية، تظهر أول طوبولوجيا يمكن الإحاطة بها.

الخريطة تتحول إلى كتالوج للقدرات

ما الذي يستطيعه النظام؟

تظهر خريطة Domain أين تكمن المسؤولية، لكنها لا تخبر بعد بما يستطيع النظام فعله. ولمعرفة ذلك، ينفتح كل Domain على هيئة كتالوج Action — قدرات مسماة يوفرها لبقية النظام.

Action هو قدرة علنية مسماة تابعة لـ Domain. لا يعرض الكتالوج الدوال الداخلية، بل العمليات التي يوفرها Domain لبقية النظام، والعلاقات الموجهة بينها. تتحول كل Action إلى نقطة استدعاء واحدة: يختار الطرف المستدعي القدرة التي يحتاجها بحسب معناها، دون تجميع العملية من طرق منفصلة.

تثبيت حدود العملية

ماذا تتطلب العملية وبماذا تعد؟

أصبح للقدرة الآن اسم وموضع في النظام. ولاستخدامها بوصفها «صندوقا أسود»، لا بد من معرفة البيانات التي تقبلها بدقة، والنتيجة التي يتحتم عليها إرجاعها.

يجعل Contract حدود Action محددة النوع وغير ملتبسة. يصف Params كل ما تقبله العملية، ويصف Result كل ما يجب عليها إرجاعه. ويعتمد الكود المستدعي على هذا الوعد، لا على بنية Action الداخلية. ويمكن تغيير التنفيذ الفعلي ما دام المدخل والمخرج والسلوك القابل للملاحظة محافظين على التوافق.

توسيع العملية إلى سيناريو

كيف يتطور السيناريو؟

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

يجعل Pipeline سيناريو العمل الرئيسي خطيا ومرئيا: التحقق من المدخل، وحجز المخزون، وتنفيذ الدفع، وتجميع النتيجة. وهذا لا يعني غياب الأخطاء والتفرعات والتعويضات من الواقع؛ بل تحصل على موضع صريح بالنسبة إلى الخط الرئيسي. ولكل خطوة أيضا عقد محلي: فهي تعلن ما تقرؤه من Params وState وContext، وما تضيفه إلى State لأجل المراحل التالية.

الآن فقط — السلوك الفعلي

أين يقع السلوك الفعلي؟

يحدد Pipeline الموضع الدقيق للسلوك المطلوب، ويضيق منطقة البحث بشدة. ويمكن الآن فتح خطوة واحدة معروفة الغرض والمدخل والمخرج مسبقا، لا المستودع بأكمله ولا حتى Action بأكمله.

يصبح Code هو المستوى الخامس لا لأن التفاصيل غير مهمة، بل لأنها أصبحت الآن محاطة بالمعنى. فمن المعروف مسبقا أي Domain يملك هذا السلوك، وأي قدرة ينفذها Action، وبم يعد Contract، وأي موضع يشغله reserve_inventory داخل Pipeline. ويقرأ التنفيذ كإجابة محلية عن مهمة محددة، لا كمدخل إلى تحقيق لا ينتهي في المستودع.

@regular_aspect("Reserve inventory")@result_string("reservation_id", required=True)@context_requires("user.tenant_id", "env.inventory_region")async def reserve_inventory_aspect(    self, params, state, box, connections, ctx):    inventory = box.resolve(InventoryResource)    reservation_id = await inventory.reserve(        tenant_id=ctx.get("user.tenant_id"),        region=ctx.get("env.inventory_region"),        items=state["validated_items"],    )    return {"reservation_id": reservation_id}

لا تخفي المستويات الخمس الكود، ولا تختزل النظام إلى مخطط. بل تحافظ على المسار من النموذج العام إلى التفصيل. يبني المبتدئ سياقه تدريجيا، ويدير المعماري القواعد والحدود بدلا من كل ملف على حدة، ويؤدي وكيل AI عملا محليا ضمن قواعد معلنة: يصمم الإنسان لغة النظام، وتتصرف الآلة وفق هذه اللغة.