خطة الموقع

يُكتب PLAN.md في اللحظة التي ينتهي فيها البناء الأول للمشروع، ويُقصد به أن يصف الموقع دائماً كما هو الآن — وليس سجلاً لكل ما حدث له (هذا ما تخصصه علامة تبويب الإصدارات وسجل التغييرات). تحوّل شاشة خطة الموقع ملف Markdown هذا إلى واجهة حقيقية: جدول للصفحات، وقائمة للوحدات، وقائمة مراجعة للأسئلة المفتوحة، ونص عادي للحقائق التجارية والهوية والقرارات.

قبل انتهاء أي بناء، لا يوجد ما يُقرأ بعد: تعرض الشاشة "لا توجد خطة بعد"، وتوضح بجلاء أن الخطة يكتبها البناء الأول للمشروع، وتوجد رابطاً يعيدك إلى صفحة المشروع الخاصة بدلاً من عرض جدول فارغ.

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

الأدوات التي تُضاف لاحقاً من الكيت (إضافة إلى الخطة) تنضم إلى قائمة الوحدات بحالة "مخطط لها" مع رابط "عرض في الكيت"، حتى لو كان نص الخطة قد كُتب قبل إضافتها.

أسفل العنوان، يوضح سطر واحد متى حُدّثت الخطة آخر مرة: "تم تحديث الخطة في 2 أكتوبر، 3:04 م". يأتي هذا الوقت من آخر مرة قاس فيها aiKit الملفات الفعلية للموقع، وهذا يحدث بعد كل تغيير (تعديل عبر الدردشة، أو تثبيت، أو إضافة من الكيت، أو استعادة، أو تعديل يدوي للخطة، أو نشر من أداة ذكاء اصطناعي أخرى).

في الأعلى، بعد إنشاء الخطة: شريط نسبة الإنجاز الكلية، وتحته ثلاث بطاقات: الصفحات المنشأة (من أصل الصفحات المخططة)، والوحدات المنشأة (من أصل الوحدات المختارة)، والأسئلة المُجابة (من أصل الأسئلة المفتوحة في الخطة). كل بطاقة زر يمرّر الصفحة إلى القسم الذي تحسبه. لا يعتمد أي من هذا على ما يكتبه نص الخطة: تُعتبر الصفحة منشأة فقط عندما يجدها aiKit في الملفات الفعلية للموقع، وتُعتبر الوحدة منشأة فقط من تقرير البناء المتحقق منه أو من الوحدة الموجودة في الملفات، ويُعتبر السؤال مُجابًا عندما يُحدَّد سطره كمُنجز في الخطة أو عندما يجيب العميل عنه في صفحة الأسئلة الخاصة به.

أمران يجعلان الخطة تتأخر عن الموقع، وتوضح الشاشة أيهما: إما أن مرور الذكاء الاصطناعي الذي يعيد كتابة الخطة بعد أي تغيير لم يكتمل ("لم تُحدَّث الخطة المكتوبة بعد آخر تغيير"، مع السبب)، أو أن الموقع لديه نسخة أحدث من النسخة التي قيست عليها الخطة ("تغيّر الموقع بعد آخر تحديث للخطة"). في الحالتين يظهر زر "تحديث الخطة". لا تشغّله الصفحة من تلقاء نفسها عند فتحها (فتح الصفحة لا يستخدم الذكاء الاصطناعي أبدًا)؛ فالمحرك يدمج كل تغيير في الخطة في الخلفية بالفعل، والزر موجود لحالة تأخر ذلك الدمج. يدمج "تحديث الخطة" أحدث تغيير في الخطة المكتوبة ويعيد قياس الموقع. وإذا لم يكتمل ذلك، يبقى الشريط موضحًا ما الذي حدث، ويمكنك الضغط على "تحديث الخطة" مرة أخرى أو تعديل الخطة يدويًا.

تمنح بطاقة الصحة الموقع درجة من 100 بناءً على قواعد يتحقق منها aiKit في الملفات الفعلية، لا بناءً على رأي الذكاء الاصطناعي: عنوان صفحة أو وصف بحث مفقود أو مكرر، صفحة بلا عنوان رئيسي أو بأكثر من عنوان، رابط يشير إلى صفحة غير موجودة، صفحة لا يرتبط بها شيء وتتجاهلها القائمة، صور بلا وصف لقارئات الشاشة، صفحات قصيرة جدًا، نموذج بلا جهة لإرسال بياناته، ووحدة طلبها الملخص غير موجودة على الموقع. تحدد كل مشكلة الصفحة المعنية وسبب أهميتها، ولها زر "إصلاح": يرسل "إصلاح" التعليمات الجاهزة للمشكلة كطلب ويسلّمها إلى الذكاء الاصطناعي، ويظهر الزر "تم طلب الإصلاح" أثناء العمل، ويُعاد قياس الدرجة عند تطبيق التغيير. صفِّ القائمة حسب الخطورة باستخدام أعداد "عالية" و"متوسطة" و"منخفضة"، ويلغي "عرض الكل" التصفية.

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

اضغط على أي صفحة (في خريطة الموقع أو في قائمة الصفحات) لفتح تفاصيلها بجانب الخطة. يتغير شريط العنوان إلى ?page=/about، فيفتح الرابط الصفحة نفسها لأي شخص في الفريق. تعرض التفاصيل شكل الصفحة في Google (العنوان والعنوان الإلكتروني والوصف)، وأقسامها وعناوينها الرئيسية، وعدد الكلمات، والصور وعدد التي لا تحمل وصفًا، ونماذجها والوحدة التي تشغّل كل منها، وهل وافق العميل عليها، وآخر تغيير: متى تم، ومن طلبه، وما الذي طُلب.

يعرض السجل النسخ التي يحتفظ بها aiKit (الأصلية وأحدث 10 نسخ)، من الأحدث إلى الأقدم: رقمها، ونوع التغيير (البناء الأول، محادثة، تثبيت، وحدة، نشر، استعادة، تعديل الخطة)، ووقته، وما طُلب، ومن طلبه، والصفحات التي تغيرت (اضغط على صفحة لفتح تفاصيلها). تُوسم الأحدث بـ"النسخة الحالية"، ولأي نسخة أقدم زر "استعادة هذه النسخة"، الذي يسأل أولًا ويحفظ الحالة الحالية قبل إعادة الموقع إليها، لذلك يمكن التراجع عن الاستعادة. تظهر أول ثلاث نسخ، ويعرض "عرض الكل" الباقي.

يقارن قسم "حقائق النشاط التجاري" الهاتف والبريد الإلكتروني والعنوان وساعات العمل في ملف العميل مع نص الصفحات المنشأة (الصفحة الرئيسية وصفحة التواصل أولًا). تعرض كل حقيقة "موجودة على الموقع" أو "غير موجودة على الموقع" (مع عدد الصفحات التي جرى فحصها، لأن الموقع قد يعرض قيمة قديمة)، ورابط "تعديل في ملف العميل" يُبقي ملف العميل المصدر الموثوق.

• الصفحات — جدول يضم: الصفحة، والمسار، والغرض، والحالة (منشأة أو مخططة)، مع رابط "عرض" حقيقي إلى الصفحة المباشرة بمجرد أن تكون منشأة والموقع منشورًا.
• الوحدات والأدوات — كل وحدة تذكرها الخطة، ولكل منها شارة "منشأة" أو "مخططة" وملاحظتها الخاصة.
• حقائق النشاط التجاري — ساعات العمل، والعنوان، والخدمات، والأسعار، وأي معلومة واقعية عن النشاط، مكتوبة كنص عادي.
• العلامة التجارية — لوحة الألوان، والنبرة، وأي ملاحظات على الأسلوب سجلتها الخطة.
• القرارات — قرارات فعلية اتُّخذت ولا ينبغي إعادة فتحها في التعديل التالي.
• الأسئلة المفتوحة — قائمة مراجعة بالأمور التي لم تُحسم بعد فعلًا، ويُظهر كل سؤال إما "تمت الإجابة" أو "ما زال مفتوحًا".

لكل بطاقة قسم الزران نفسهما. يفتح زر "تعديل" تنسيق Markdown الخام لذلك القسم في حقل نص بسيط، ويحفظه مباشرة في PLAN.md — وهذه كتابة فعلية وفورية (عبر نقطة الوصول PUT الخاصة بالمشروع)، لكنها لا تُشغّل بناءً أو نشرًا عمدًا؛ فهي تغيّر فقط ما تقوله وثيقة الخطة، تمامًا كتعديل أي ملاحظة أخرى.

«اطلب تغييرًا» مختلف عن قصد: يفتح نموذجًا صغيرًا («ما التغيير الذي تريده في <section>؟»)، وعند إرساله يُضاف طلب حقيقي إلى تبويب الملاحظات في المشروع — بعنوان «خطة الموقع — <Section>: …» — تمامًا مثل أي دبوس أو طلب تعديل سريع، مع دورة حالته الخاصة ورابط «عرض الطلب» بعد إرساله. استخدم «تعديل» عندما تصحّح نص الخطة نفسه أو تعيد كتابته بنفسك؛ واستخدم «اطلب تغييرًا» عندما تريد تحديث الموقع الفعلي (وبالتالي الخطة) ليتطابق مع ذلك.

تتكون الخطة من طبقتين. تُحسب القياسات (الصفحات والعناوين والأقسام والروابط والنماذج والوحدات والحالة الصحية) بواسطة الكود من الملفات الفعلية بعد كل تغيير، لذلك لا يمكن أن تنحرف عن الواقع. أما الخطة المكتوبة (الأهداف، ووقائع العمل، والعلامة التجارية، والقرارات، والأسئلة المفتوحة) فيُحافظ على تحديثها عبر مراجعة بالذكاء الاصطناعي تعمل بعد كل تغيير، وتعيد كتابة الأجزاء التي مسّها التغيير فقط. ولا تضيف هذه المراجعة أي سجل تغييرات أو مدخلات مؤرخة؛ فسجل التغييرات محفوظ في قسم السجل.

إذا فشلت مراجعة الذكاء الاصطناعي، تبقى الخطة المكتوبة كما كانت بدلاً من إعادة كتابتها جزئياً، ويُسجَّل الفشل، وتعرض الشاشة زر تحديث الخطة (انظر أعلاه) بدلاً من عرض خطة قديمة دون أن يلاحظ أحد.

يحتوي شريط بجانب الخطة على الإجراءات (على الهاتف يتحول الشريط إلى زر "نسخ رابط العميل" بعرض كامل أسفل شريط التقدم، وتُطوى بقية الإجراءات تحت "إجراءات أخرى (3)"). يقوم زر "مشاركة مع العميل" بنسخ رابط للقراءة فقط (aikit.ai/p/<project>/plan) — بلا أدوات للفريق، ولا أزرار تعديل، ولا أي محتوى داخلي. يفتح "عرض الموقع المباشر" الموقع المنشور مباشرةً، أو يُظهر الشريط عبارة "غير منشور بعد" إن لم يكن كذلك. يعرض "الملفات" العدد الفعلي للملفات مع قائمة قابلة للتوسيع تضم مسار كل ملف وحجمه. يقوم "تنزيل الخطة" بتنزيل ملف PLAN.md الحالي الفعلي كملف .md حقيقي، مطابق تماماً لما تقرؤه الشاشة، وليس ملخصاً مُعاد إنشاؤه.

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

في تبويب الصفحات والموافقات، المحمي برمز الوصول نفسه الذي يستخدمونه لإرسال الملاحظات (دون تسجيل دخول منفصل)، يرى العميل شريط التقدم نفسه، وخريطة الموقع لصفحاته، وقائمة الصفحات مع روابط "عرض"، والوحدات، والوقائع التجارية، والعلامة التجارية، والقرارات، والأسئلة المفتوحة، إضافةً إلى سطر "تم تحديث الخطة". لا يحصل العميل على الحالة الصحية، ولا تعليمات الإصلاح، ولا السجل، ولا من طلب ماذا، ولا قائمة الملفات، ولا أي زر تعديل أو "اطلب تغييراً".

يُحذف على الخادم كل ما يُعلّمه الفريق لنفسه قبل إرسال الصفحة، في كل الأقسام: أي سطر يحتوي على "(internal)" أو "[internal]" أو "(staff only)"، وأي سطر يبدأ بـ "Internal:" أو "Staff only:"، وأي قسم عنوانه Internal أو Staff only، والتعليقات المخفية. لا تصل هذه الأسطر إلى متصفح العميل أبداً، ولا حتى في بيانات الشبكة الخاصة بالصفحة.

لكل صفحة مبنية زر موافقة. يكتب العميل اسمه (وملاحظة اختيارية) ويوافق؛ وترتبط الموافقة بالمحتوى الدقيق لتلك الصفحة، لذلك إذا تغيّرت الصفحة لاحقاً تظهر عبارة "تغيّرت منذ موافقتك" ويُطلب الموافقة مجدداً. لا يستطيع الموافقة إلا من يستخدم رمز وصول العميل. وإذا فتحتَ رابط العميل وأنت مسجّل الدخول كفريق، ترى حالة موافقة كل صفحة دون زر موافقة، حتى لا يوافق أحد نيابةً عن العميل. في خطة الموقع الداخلية للفريق، تظهر الصفحات المعتمدة بعبارة "وافق عليها العميل"، والصفحات التي تغيّرت بعبارة "تغيّرت منذ الموافقة".

يوجد زر "إرسال ملاحظات" في الأسفل: إذا كان الموقع منشوراً، يفتح الموقع المباشر الفعلي مع تفعيل طبقة الملاحظات مسبقاً (باستخدام رمز الوصول الخاص بالعميل)؛ وإذا لم يكن منشوراً بعد، ينتقل إلى صفحة "آخر التحديثات" الخاصة به بدلاً من ذلك.