حزمة التقارير

# حزمة التقارير

اربط مهارتين معاً بحيث تصل أرقام المالك المتكررة من تلقاء نفسها، مع سياق كافٍ للتصرف بناءً عليه: `report-builder` للحزمة نفسها، و `business-pulse` للصورة الشاملة.

لدى المالكين بالفعل التقرير الذي يريدونه في أذهانهم. ما لا يملكونه هو وصول التقرير يوم الإثنين دون أن يضطروا للبحث عنه بأنفسهم. هذه هي مهمتنا الأساسية هنا.

## الخطوة 1 — حزمة التقارير (report-builder)

استدعِ `report-builder`. إنه يمتلك المواصفات وسحب البيانات والحسابات والمصنف — لا تعيد بناء أي من ذلك هنا.

- **المدخلات:** وصف المالك للحزمة، أو اسم حزمة محفوظة. - **المخرجات:** ملخص دردشة ومصنف XLSX وتعريف محفوظ.

يتحقق `report-builder` من تعريفاته المحفوظة أولاً. إذا كانت الحزمة موجودة بالفعل، فسيعيد التشغيل دون إعادة مقابلة المالك. إن لم تكن موجودة، فسيبني المواصفات ويؤكدها مرة واحدة.

**بوابة — تأكيد المواصفات.** تحصل الحزمة الجديدة تماماً على تأكيد واحد من المالك قبل التشغيل. الحزمة التي لها بالفعل تعريف محفوظ لا تحصل عليه. إعادة السؤال عن تقرير عرّفه المالك الشهر الماضي هي أسرع طريقة لجعل هذا الأمر يبدو معطلاً.

## الخطوة 2 — لقطة السياق (business-pulse)

بعد تشغيل الحزمة، استدعِ `business-pulse` للفترة نفسها.

- **المدخلات:** الفترة التي غطتها الحزمة. - **المخرجات:** السيولة والاتجاهات البيعية والخط الأنابيب وقائمة المراقبة والأمر الواحد الذي يحتاج انتباهاً.

النبض هو السياق، وليس تقريراً ثانياً. إنه يجيب عن السؤال الذي تثيره الحزمة دائماً: الأرقام تحركت، لكن هل الأعمال بحالة جيدة؟

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

## الخطوة 3 — التسليم كشيء واحد

رسالة واحدة، بهذا الترتيب: ملخص الحزمة، ثم النبض في سطرين أو ثلاثة، ثم المصنف.

راي أوكونكوو في Okonkwo Mechanical يحصل على حزمة يوم الإثنين — الإيرادات حسب الفريق مقابل العام الماضي، AR التقادم، العمالة كنسبة مئوية من الإيرادات — وتحتها: السيولة بمبلغ 61,400 دولار أمريكي، فاتورتان متأخرتان عن 60 يوماً، شاحنة واحدة لا تزال معطلة. يقرأ كليهما في تسعين ثانية ويعرف ما هي خطة يوم الإثنين.

لا تُرسل أبداً تسليمين منفصلين. وصول حزمة ونبض بشكل منفصل يعني شيئين للقراءة؛ معاً فهو إحاطة واحدة.

اعرض تلك الإحاطة كتصنيع HTML واحد باستخدام نمط التصنيع الداخلي (`../../shared/artifact-style.md`) — إضافياً لملخص الدردشة والمصنف، وليس استبدالاً. المقاييس الرئيسية للحزمة هي لوحات إحصائية مع مقارناتها كأسطر سياق؛ صفوف التقرير المجمعة هي جدول بـ tabular-nums؛ سياق النبض يجلس في لوحته الخاصة أدناه، مع عناصر قائمة المراقبة التي تحمل حبوب الحالة (تحذير أو حرج)؛ مصادر أسفل مسماة في سطر تذييل هادئ واحد.

## الخطوة 4 — تعيين الإيقاع، مرة واحدة

**عرض الجدول الزمني مرة واحدة فقط، بعد تشغيل وجده المالك مفيداً.** وليس قبلها — جدول زمني معروض على حزمة لم يرها أحد بعد هو عرض اشتراك.

اسأل بصراحة: "هل تريد هذا كل صباح يوم الإثنين؟" عند الموافقة، احفظ الجدول الزمني مع تعريف التقرير في `report-builder` وأكد في سطر واحد: "تم الحفظ. سيعمل هذا كل صباح يوم الإثنين."

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

عند عدم الموافقة أو الصمت، أسقطها ولا تسأل مرة أخرى.

في التشغيل التفاعلي فقط — لا أبداً في التشغيل المجدول — أنهِ بسطر واحد عما تم تسليمه، ثم الخطوة التالية الأكثر صلة والحد الأقصى لخطوتين أخريين قريبتين:

- إذا أثارت الحزمة سؤالاً عن السيولة: "توقع السيولة" يشغل `cash-flow-snapshot`. - إذا أشار النبض إلى AR متأخر: "من يدين لي بالمال" يشغل `invoice-chase`. - لتغيير ما تتابعه الحزمة: "بناء تقرير لي" يشغل `report-builder`.

ثلاثة عروض كحد أقصى. لا تكرر أبداً عرضاً رفضه المالك في هذه الجلسة.

## الخطوة 5 — التعامل مع التشغيل الضعيف دون إيقافه

يحدث التشغيل المجدول سواء كانت كل موصل صحية أم لا. إذا كان المصدر معطلاً، يضع `report-builder` علامة على هذا المقياس "n/a" ويسمي المصدر؛ الحزمة تُشحن على أي حال.

**لا تتخطَّ أبداً تسليماً مجدولاً لأن البيانات كانت غير كاملة.** حزمة بفجوة واحدة وملاحظة مفيدة. الإثنين الصامت يقرأ كأن المكون معطل، والمالك يتوقف عن توقعه.

إذا لم يكن لدى المالك موصلات على الإطلاق، فمسار CSV هو الحزمة. اطلب التصدير مرة واحدة، شغّل التقرير المطابق من الملف، والحافظ على الجدول الزمني.

## ما لا يجب فعله

- **لا تُعيد مقابلة المالك عن حزمة محفوظة.** تحقق من التعريف المحفوظ أولاً، في كل تشغيل. - **لا تعيد بناء منطق التقرير هنا.** `report-builder` يملك المواصفات والرياضيات والمصنف. - **لا تعيد حساب أرقام النبض.** `business-pulse` يملكها، لذا توجد مجموعة أرقام واحدة. - **لا تعرض الجدول الزمني مرتين.** مرة واحدة، بعد تشغيل مفيد، ثم أبداً لا مرة أخرى. - **لا تسأل أي شيء في تشغيل مجدول.** مجدول يعني أنه يصل دون أن يكون المالك في الحلقة. - **لا تتخطَّ تشغيلاً لأن موصل فشل.** شحنه مع تسمية الفجوة. - **لا تسلّم الحزمة و**