يرسم وكيلك خريطة لنظامك بأكمله، وتُحمَّل في كل جلسة لاحقة.

القواعد الثلاث للخريطة

• تُرسم البنية مرة واحدة، في الجذر. لا تعيد اللوحة رسم الأسلاك أبدًا؛ بل تحمل تفاصيلها الخاصة وإجراءاتها فقط. التكرار هو منشأ الانحراف، لذا لا يوجد تكرار من الأساس.
• القيم لا توجد في أي مكان في الخريطة. لا منافذ ولا حدود ولا أسعار ولا أعداد — الصفحة تشير إلى مكان وجود الرقم، لا إلى ما هو. الخريطة التي تحمل قيمًا تصبح خاطئة خلال أسبوع.
• من يغيّر سلكًا يحدّث الخريطة في الجلسة نفسها. يحمل الجذر سطرًا — تم التحقق في <التاريخ> مقابل <الشيء> — ويثق القارئ بالخريطة إلى هذا الحد بالضبط.

ما تحتويه الخريطة الجذرية، بالترتيب

• ما هو المشروع، في جملتين، وسطر التحقق.
• الرسم التخطيطي: مربعات وأسهم، سهم واحد لكل سلك مع ما ينتقل عليه. الاتجاه أهم من أي شيء آخر في الصفحة.
• الأسلاك، مُدرجة: من يبدأ، ما ينتقل، وما لا ينتقل أبدًا. هذا هو القسم الذي يكشف الأكاذيب.
• المخازن: كل مكان توجد فيه الحالة، ما يحتويه، وما لا يحتويه أبدًا.
• الفهرس: كل لوحة بالاسم، وكل إجراء حسب اللوحة والقسم.

ما تحتويه اللوحة

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

خريطة جذرية، في شكلها

my-app-map — verified 2026-09-04 against commit a1b2c3d and the live containers

  browser ──(requests, session cookie)──▶ api ──(SQL)──▶ postgres
                                          │
                                          └──(jobs)──▶ worker ──(files)──▶ object store

Wires: the browser never talks to the worker; the worker never reads a cookie.
Stores: postgres (users, orders — never card numbers) · object store (uploads).
Plates: my-app-map-api · my-app-map-worker · my-app-map-data · my-app-map-ops
Procedures: deploy → my-app-map-ops, deploy · restore → my-app-map-data, restore