<!-- 
تعليمات النموذج الذكي: املأ الحقول التي تحمل [ أضف التفاصيل... ] بناءً على سياق المشروع.

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

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

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

إرشادات الكتابة:

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

*  سجل السعة لكل فترة لا إجمالًا. فمن له ألف يوم عمل متاحة وهو مشغول تمامًا في الشهر الذي يُنفَّذ فيه العمل لا سعة له البتة، والرقم الإجمالي يخفي ذلك بالضبط.

*  سجل الطلب من الخطة لا مما يؤديه الفريق حاليًا. عمود الطلب هو ما يشترطه الجدول والنطاق، وعمود التوفر هو الموجود. وتسجيل الرقم نفسه في العمودين أشيع سبب لخطأ مصفوفة السعة، لأنه يجعل المصفوفة توافق الخطة بدل الواقع.

*  سجل القيود بوصفها نتائج لا صفات. فعبارة «أتمتة الاختبارات نقطة فشل وحيدة لأن شخصًا واحدًا يمسكها» قابلة للتصرف، وعبارة «أتمتة الاختبارات مخاطرة» ليست كذلك.

*  وحين تُغطَّى فجوة بمتعهد أو بمورد مشترك، سجل العقد أو الاتفاق الذي يغطيها. فالفجوة المملوءة على فهم أن أحدًا سيساعد ليست مغطاة، ويظهر الفرق في الأسبوع الذي يحتاج فيه المساعدة إلى مكان آخر.

ملاحظات التخصيص:

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

*  وحين تعمل المؤسسة أداة لتخصيص الموارد، قد تكون المصفوفة مقتطفًا لا مصدر الحقيقة. فسجل ذلك، حتى لا يتعامل القارئ مع مقتطف قديم على أنه حالي.

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

*  قد تدير المصفوفة وظيفة تخصيص الموارد أو تخطيط القوى العاملة، وعندئذٍ يُشار إليها بدل تكرار جانب التوفر.

إرشادات الأعمدة، حسب العمود:

صفوف السعة حسب المورد:

*  **المعرف:** معرف الدور الوظيفي، يُستخدم في قسم الطلب وقسم الفجوة ليُقارَن الصفوف الثلاثة ببعضها.

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

*  **الفترة:** الفترة التي يغطيها الصف، نفسها في كل الجدول.

*  **إجمالي المتاح:** السعة الموجودة في الفترة قبل أي تخصيص، بالوحدة المعلنة للمصفوفة.

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

*  **المتبقي:** ما بقي بعد التخصيص، وهو الرقم الذي يملكه المخطط فعلًا

*  **القيود أو نقاط الفشل الوحيدة:** ما يحدّ من هذا المورد، كموقع أو مؤهل يملكه شخص واحد أو ترخيص أو أداة لا يملكها إلا شخص واحد أو مدة إشعار. سجل النتيجة لا الصفة.

*  **ملاحظات:** ما يغير كيفية قراءة الصف، كوظيفة شاغرة معروفة أو إجازة مخططة أو مورد مشترك مع محفظة أخرى.

صفوف الطلب:

*  **المعرف:** معرف الدور الذي يليه الطلب، مطابقًا للمعرف المستخدم في قسم السعة.

*  **الدور الوظيفي:** الدور الذي يقع عليه الطلب، بنفس التسمية المستخدمة في قسم السعة. يجب أن تكون القائمتان واحدة، وإلا استبعدت المقارنة ضمنًا الأدوار الواردة في إحداهما فقط، وهي عادةً الأدوار التي بها مشكلة.

*  **الفترة:** الفترة التي يقع فيها الطلب.

*  **السعة المطلوبة:** ما يشترطه النطاق والجدول الزمني في تلك الفترة.

*  **مصدر الطلب:** أي جزء من الخطة ينشئه، كـ مخرج أو حزمة عمل

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

صفوف تحليل الفجوة:

*  **الدور الوظيفي:** الدور الذي تنطبق عليه الفجوة.

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

*  **الفترة:** الفترة التي تقع فيها الفجوة.

*  **الحل المخطط:** كيف ستُغلق الفجوة، بالتكليف أو بمتعهد أو بنقل العمل بين الفترات أو بتقليل النطاق أو بقبول المخاطر.

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

*  **تاريخ الحل:** متى يُتوقع أن يكون الحل قائمًا. فهذا ما يخبر القارئ بأن الخطة ما زالت مجدية، فسجله بدل ترك الصف مفتوحًا، وحين يمر التاريخ دون حل فصعّد بدل نقل التاريخ.

صفوف الاحتياطي:

*  **الدور الوظيفي:** الدور الذي ينطبق عليه الاحتياطي.

*  **نوع الاحتياطي:** هل هو احتياطي سعة أم وقت أم نطاق. والثلاثة غير قابلة للمبادلة: احتياطي الوقت يُنفق مرة واحدة، واحتياطي السعة يُنفق على أي شيء، واحتياطي النطاق يقلّل المخرج.

*  **مقدار الاحتياطي:** حجم الاحتياطي بالوحدة المعلنة.

*  **كيف سيُستخدم:** ما الذي يحميه الاحتياطي، حتى لا يُستهلك بهدوء على شيء لم يُحتجز لأجله.
-->


<h3 align="left">{{اسم_الشركة}}</h3>
<h2 align="left">{{الوحدة_التنظيمية}} - {{فترة_التخطيط}}</h2>
<h1 align="center">مصفوفة سعة الموارد</h1>

| **تاريخ الإعداد:** {{التاريخ_الحالي}} | **مدير البرنامج:** {{اسم_مدير_البرنامج}} | **إعداد:** {{معد_الوثيقة}} |
| :--- | :--- | :--- |

---

## 1. أساس المصفوفة
<!-- ما الذي تغطيه هذه المصفوفة وبأي وحدة وعلى أي فترات. سجل الوحدة مرة واحدة واستخدمها في كل الجدول. وسجل المستوى الذي تُدار عليه، فمصفوفة المحفظة تُستخدم للقرار بين المبادرات ومصفوفة المشروع للحكم على جدوى خطة واحدة. وسجل ما إذا كانت مصدر الحقيقة أم مقتطفًا من أداة تخصيص موارد، حتى لا يتعامل القارئ مع مقتطف قديم على أنه حالي. -->

**نطاق المصفوفة ومستواها:** [ أضف التفاصيل... ]

**وحدة قياس السعة:** [ أضف التفاصيل... ]

**الفترات المشمولة:** [ أضف التفاصيل... ]

**مصدر الحقيقة أم مقتطف:** [ أضف التفاصيل... ]

**مالك المصفوفة:** [ أضف التفاصيل... ]

**آخر تحديث:** [ أضف التفاصيل... ]

---

## 2. السعة حسب المورد
<!-- ما هو متاح، بالوحدة نفسها وفي كل فترة. عمود المخصص هو ما يُهمل أكثر من غيره، وبدونه يصبح المتاح هو الإجمالي، وهو ليس ما يستطيع المشروع استخدامه. وسجل السعة لكل فترة لا إجمالًا، فمن له سعة كبيرة متاحة وهو مشغول تمامًا في الشهر الذي يُنفَّذ فيه العمل لا سعة له البتة. وسجل القيود بوصفها نتائج لا صفات. وحين يشغل الدور أكثر من شخص فسجل الدور مرة واحدة واذكر التقسيم في الملاحظات، فالصف لكل شخص يخفي إجمالي سعة الدور. أضف صفوفًا أو احذفها حسب الحاجة. -->

| المعرف | الدور أو الفريق | الفترة | إجمالي المتاح | المخصص | المتبقي | القيود أو نقاط الفشل الوحيدة | ملاحظات |
| ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |

---

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

| المعرف | الدور الوظيفي | الفترة | السعة المطلوبة | مصدر الطلب | الأولوية |
| ---: | ---: | ---: | ---: | ---: | ---: |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |

---

## 4. تحليل الفجوة
<!-- الفرق بين المطلوب والمتبقي، وهو المؤشر الرئيسي الذي يبحث عنه القارئ في المصفوفة كلها. اذكره رقمًا بإشارة حتى لا تُقرأ زيادة على أنها نقص. وسجل حلًا مخططًا، وسجلًا مالكًا له على حدة، فالفجوة التي لها حل ولا مالك هي فجوة يتمنى حلها، وهي أشيع طريقة يُعتمد عليها في مصفوفة سعة بعد أن تصير غير صالحة. وتاريخ الحل هو ما يخبر القارئ بأن الخطة ما زالت مجدية، فسجله بدل ترك الصف مفتوحًا. أضف صفوفًا أو احذفها حسب الحاجة. -->

| الدور الوظيفي | الفجوة | الفترة | الحل المخطط | مالك الحل | تاريخ الحل |
| ---: | ---: | ---: | ---: | ---: | ---: |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |

---

## 5. الاحتياطي
<!-- ما تحتفظ به الخطة، وما الذي يحميه هذا الاحتياطي. أنواع الاحتياطي الثلاثة غير قابلة للمبادلة: احتياطي الوقت يُنفق مرة واحدة، واحتياطي السعة يُنفق على أي شيء، واحتياطي النطاق يقلّل المخرج. وسجل أي نوع كل احتياطي، فالخطة التي لا تحتفظ باحتياطي نطاق وتذكر أنها تملك مهلة فائضة هي خطة يكون احتياطيها هو العمل المقطوع. وسجل ما الذي يحميه كل احتياطي حتى لا يُستهلك بهدوء على شيء لم يُحتجز لأجله. أضف صفوفًا أو احذفها حسب الحاجة. -->

| الدور الوظيفي | نوع الاحتياطي | مقدار الاحتياطي | كيف سيُستخدم |
| ---: | ---: | ---: | ---: |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |
| [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] | [ أضف التفاصيل... ] |

---

## 6. الاعتماد والموافقات

| الدور | الاسم | التوقيع | التاريخ |
| ---: | ---: | ---: | ---: |
| **مسؤول تخطيط الموارد** | {{اسم_مسؤول_تخطيط_الموارد}} | _______________________ | [.... -.... -.... ] |
| **مدير البرنامج** | {{اسم_مدير_البرنامج}} | _______________________ | [.... -.... -.... ] |
| **مدير مكتب إدارة المشاريع** | {{اسم_مدير_مكتب_إدارة_المشاريع}} | _______________________ | [.... -.... -.... ] |
---

<div align="left" style="margin-top: 20px; font-size: 12px; color: #7f8c8d;">
  <span>سجل التدقيق الإلكتروني: Hash SHA256: {{رمز_تجزئة_التدقيق_SHA256}}</span> <br>
 <strong>النموذج:</strong> مصفوفة سعة الموارد | <strong>المرجع:</strong> PMO-00.04 <br>
 <i>تاريخ الإنشاء: {{وقت_الإنشاء}}، بواسطة <a href="https://github.com/fakhruldeen/Tasleemat/" style="color: #7f8c8d;">تسليمات</a></i>
</div>
</div>

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://tasleemat.pmo/schemas/completed/PMO-00.04.schema.json",
  "title": "Completed Resource Capacity Matrix Data Contract",
  "description": "Additive structural schema validating completed Resource Capacity Matrix artifact data payloads (PMO-00.04).",
  "type": "object",
  "properties": {
    "artifact_id": {
      "type": "string",
      "const": "PMO-00.04"
    },
    "metadata": {
      "type": "object",
      "properties": {
        "project_name": {
          "type": "string",
          "minLength": 1
        },
        "project_code": {
          "type": "string"
        },
        "date_prepared": {
          "type": "string",
          "format": "date"
        },
        "project_manager": {
          "type": "string",
          "minLength": 1
        },
        "prepared_by": {
          "type": "string",
          "minLength": 1
        },
        "version": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "draft",
            "baselined",
            "in_review",
            "approved"
          ]
        }
      },
      "required": [
        "project_name",
        "date_prepared",
        "project_manager",
        "prepared_by"
      ]
    },
    "matrix_basis": {
      "type": "object",
      "properties": {
        "matrix_scope_and_level": {
          "type": "string",
          "minLength": 1,
          "description": "What this matrix covers and at what level it is maintained, whether portfolio-wide across initiatives, program-wide across components, or for a single project. The level decides what the matrix is used to decide: a portfolio matrix decides between initiatives, a project matrix decides whether one plan is credible, and reading either as the other produces a confident wrong answer."
        },
        "capacity_unit_of_measure": {
          "type": "string",
          "minLength": 1,
          "description": "The unit used for every figure in the matrix, whether person-days, full-time equivalents, or hours per period. State it once and use it throughout: a matrix whose rows use different units cannot be added up, and the total at the foot of it is then arithmetically meaningless rather than merely approximate."
        },
        "periods_covered": {
          "type": "string",
          "minLength": 1,
          "description": "The periods the matrix covers, matching those of the schedule it is compared against. Where the matrix is annual and the schedule is weekly, the comparison has to be done by hand every time and is therefore not done, which is how a quarterly shortfall survives to become a delivery failure."
        },
        "source_of_truth_or_extract": {
          "type": "string",
          "minLength": 1,
          "description": "Whether this matrix is the authoritative record or an extract from a resourcing tool. Record which, because a reader who treats a stale extract as current will plan against capacity that was reallocated weeks ago, and the error surfaces only when the work cannot be staffed."
        },
        "matrix_owner": {
          "type": "string",
          "minLength": 1,
          "description": "The single role accountable for the matrix as a whole, which is normally not the owner of any one resource in it. Where this is blank, the matrix has contributors but nobody who notices that a row has not been updated since the reorganisation."
        },
        "last_updated": {
          "type": "string",
          "minLength": 1,
          "description": "The date the matrix was last reconciled against the plan, and against which version of the schedule. Without it a reader cannot tell a current matrix from an abandoned one, and the two are indistinguishable on the page."
        }
      },
      "required": [
        "matrix_scope_and_level",
        "capacity_unit_of_measure",
        "periods_covered",
        "source_of_truth_or_extract",
        "matrix_owner",
        "last_updated"
      ]
    },
    "capacity_by_resource": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1,
          "description": "The identifier for the resource role, used in the demand and gap sections so the three can be compared row against row. Without a shared identifier the comparison is done by eye, and two similarly named roles are the ones most often confused."
        },
        "resource_role_or_team": {
          "type": "string",
          "minLength": 1,
          "description": "The role or team, named as the work requires it rather than as the organisation chart draws it. A matrix organised by existing departments can never show a gap, because it only ever lists what is already there, and the absence of a needed capability reads as its absence from the plan rather than from the organisation."
        },
        "period": {
          "type": "string",
          "minLength": 1,
          "description": "The period the row covers, using the same periods throughout the matrix. Capacity recorded per period rather than in total is what makes the matrix usable, because a resource with a thousand person-days available who is fully committed in the month the work is needed has no capacity at all."
        },
        "total_available": {
          "type": "string",
          "minLength": 1,
          "description": "The capacity that exists in the period, before any allocation, in the unit declared for the matrix. This is a figure about the organisation rather than about the project, and recording it here is what allows the reader to see how much of it is actually available."
        },
        "allocated": {
          "type": "string",
          "minLength": 1,
          "description": "The capacity already committed elsewhere in the portfolio. This is the column most often left out, and without it the available figure is the total, which is not what the project can use. It is also the column that reveals a resource being shared between initiatives without either owner knowing."
        },
        "remaining": {
          "type": "string",
          "minLength": 1,
          "description": "What is left after allocation, which is the figure the planner actually has. Where this is negative, the matrix has found a real problem; where it is silently recorded as zero because nobody wanted to write a negative number, the problem has been hidden instead of solved."
        },
        "constraints_or_single_points_of_failure": {
          "type": "string",
          "minLength": 1,
          "description": "What limits this resource: a location, a qualification held by one person, a licence, a tool only one person can operate, or a notice period. Record the consequence rather than the adjective, because \"test automation is a single point of failure because one person holds it\" can be acted on, while \"test automation is a risk\" cannot."
        },
        "notes": {
          "type": "string",
          "minLength": 1,
          "description": "Anything that changes how the row should be read, such as a known vacancy, planned leave, or a resource shared with another portfolio. Where a role is filled by more than one person, record the role once and note the split here, since a row per person hides the total capacity of the role."
        }
      },
      "required": [
        "id",
        "resource_role_or_team",
        "period",
        "total_available",
        "allocated",
        "remaining",
        "constraints_or_single_points_of_failure",
        "notes"
      ]
    },
    "demand_by_resource": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1,
          "description": "The resource role the demand is for, matching the ID used in the capacity section so the two can be set against each other."
        },
        "resource_role": {
          "type": "string",
          "minLength": 1,
          "description": "The role the demand falls on, using the same naming as the capacity section. The two must be the same list, or the comparison in the gap section silently excludes roles that appear in only one of them, which are usually the ones in trouble."
        },
        "period": {
          "type": "string",
          "minLength": 1,
          "description": "The period the demand falls in. A demand recorded with no period cannot be compared with a capacity figure that has one, and is therefore dropped from the comparison without anyone deciding to drop it."
        },
        "required_capacity": {
          "type": "string",
          "minLength": 1,
          "description": "What the scope and schedule require in the period. Record the figure the plan was built on rather than the figure currently being achieved, since the second is a consequence of the first being wrong and reporting it back as the requirement makes the shortfall disappear from the plan."
        },
        "source_of_demand": {
          "type": "string",
          "minLength": 1,
          "description": "Which part of the plan generates it, such as a named deliverable, work package, or activity. A demand that cannot be traced to something in the plan cannot be challenged, and demands that cannot be challenged only ever grow."
        },
        "priority": {
          "type": "string",
          "minLength": 1,
          "description": "Whether the demand is essential, or could be deferred or descoped. Without a priority a gap has no remedy, because the available responses are to add capacity, move the work, or reduce it, and nothing in the matrix says which of those the programme would accept."
        }
      },
      "required": [
        "id",
        "resource_role",
        "period",
        "required_capacity",
        "source_of_demand",
        "priority"
      ]
    },
    "gap_analysis": {
      "type": "object",
      "properties": {
        "resource_role": {
          "type": "string",
          "minLength": 1,
          "description": "The role the gap applies to, using the same naming as the sections above. Where a role appears in the demand but not the capacity, the gap is the whole requirement rather than a shortfall, and that case is worth distinguishing because it is a different problem."
        },
        "gap": {
          "type": "string",
          "minLength": 1,
          "description": "The difference between required and remaining, stated as a signed number so that a surplus is not read as a shortfall. This is the figure the whole matrix exists to produce, and a matrix that records only the totals has omitted the only number anyone reads."
        },
        "period": {
          "type": "string",
          "minLength": 1,
          "description": "The period the gap falls in. A gap in a period with no demand in it is a different problem from a gap in a period the work needs, and reporting both as \"a gap\" sends the reader looking for the wrong remedy."
        },
        "resolution_planned": {
          "type": "string",
          "minLength": 1,
          "description": "How the gap will be closed: recruitment, a contractor, moving work between periods, reducing scope, or accepting the risk. Where the gap is covered by a contractor or a shared resource, record the contract or agreement that covers it, because a gap filled on the understanding that someone will help is not covered at all."
        },
        "resolution_owner": {
          "type": "string",
          "minLength": 1,
          "description": "Who is accountable for closing the gap. A gap with a planned resolution and no owner is a gap being wished away, and it is the most common way a capacity matrix comes to be relied upon long after it was last true."
        },
        "resolution_date": {
          "type": "string",
          "minLength": 1,
          "description": "By when the resolution is expected to be in place. This is what tells the reader whether the plan is still feasible, so record it rather than leaving the row open, and where the date has passed without resolution, escalate rather than moving the date."
        }
      },
      "required": [
        "resource_role",
        "gap",
        "period",
        "resolution_planned",
        "resolution_owner",
        "resolution_date"
      ]
    },
    "contingency": {
      "type": "object",
      "properties": {
        "resource_role": {
          "type": "string",
          "minLength": 1,
          "description": "The role the contingency applies to, or \"plan\" where the buffer is held across all roles rather than against one."
        },
        "contingency_type": {
          "type": "string",
          "minLength": 1,
          "description": "Whether the buffer is in capacity, in time, or in scope. The three are not interchangeable: time contingency can be spent once, capacity contingency can be spent on anything, and scope contingency reduces the deliverable. A plan that holds no scope contingency and states only that it has float is a plan whose contingency is the work being cut."
        },
        "contingency_amount": {
          "type": "string",
          "minLength": 1,
          "description": "The size of the buffer, in the declared unit. Record it as a figure rather than a percentage, because a percentage of a demand that was never reconciled produces a number that looks precise and is not."
        },
        "how_it_would_be_used": {
          "type": "string",
          "minLength": 1,
          "description": "What the buffer protects, recorded so it cannot be quietly consumed on something it was not held for. A contingency with no stated use is the first thing cut in a difficult month, which is precisely the month it was held for."
        }
      },
      "required": [
        "resource_role",
        "contingency_type",
        "contingency_amount",
        "how_it_would_be_used"
      ]
    }
  },
  "required": [
    "artifact_id",
    "metadata",
    "matrix_basis",
    "capacity_by_resource",
    "demand_by_resource",
    "gap_analysis",
    "contingency"
  ]
}

{
  "_llm_instructions": "Fill in the 'project_title' and 'date_prepared' properties, and the 'value' property of each field, based on the provided project context. Reference parameters.md for global project variables.",
  "form_name": "Resource Capacity Matrix",
  "document_reference": "PMO-00.04",
  "project_title": "",
  "date_prepared": "",
  "fields": {
    "f01_Matrix_Scope_and_Level": {
      "section": "Matrix Basis",
      "label": "Matrix Scope and Level",
      "guidance": "What this matrix covers and at what level it is maintained, whether portfolio-wide across initiatives, program-wide across components, or for a single project. The level decides what the matrix is used to decide: a portfolio matrix decides between initiatives, a project matrix decides whether one plan is credible, and reading either as the other produces a confident wrong answer.",
      "value": ""
    },
    "f02_Capacity_Unit_of_Measure": {
      "section": "Matrix Basis",
      "label": "Capacity Unit of Measure",
      "guidance": "The unit used for every figure in the matrix, whether person-days, full-time equivalents, or hours per period. State it once and use it throughout: a matrix whose rows use different units cannot be added up, and the total at the foot of it is then arithmetically meaningless rather than merely approximate.",
      "value": ""
    },
    "f03_Periods_Covered": {
      "section": "Matrix Basis",
      "label": "Periods Covered",
      "guidance": "The periods the matrix covers, matching those of the schedule it is compared against. Where the matrix is annual and the schedule is weekly, the comparison has to be done by hand every time and is therefore not done, which is how a quarterly shortfall survives to become a delivery failure.",
      "value": ""
    },
    "f04_Source_of_Truth_or_Extract": {
      "section": "Matrix Basis",
      "label": "Source of Truth or Extract",
      "guidance": "Whether this matrix is the authoritative record or an extract from a resourcing tool. Record which, because a reader who treats a stale extract as current will plan against capacity that was reallocated weeks ago, and the error surfaces only when the work cannot be staffed.",
      "value": ""
    },
    "f05_Matrix_Owner": {
      "section": "Matrix Basis",
      "label": "Matrix Owner",
      "guidance": "The single role accountable for the matrix as a whole, which is normally not the owner of any one resource in it. Where this is blank, the matrix has contributors but nobody who notices that a row has not been updated since the reorganisation.",
      "value": ""
    },
    "f06_Last_Updated": {
      "section": "Matrix Basis",
      "label": "Last Updated",
      "guidance": "The date the matrix was last reconciled against the plan, and against which version of the schedule. Without it a reader cannot tell a current matrix from an abandoned one, and the two are indistinguishable on the page.",
      "value": ""
    },
    "f07_ID": {
      "section": "Capacity by Resource",
      "label": "ID",
      "guidance": "The identifier for the resource role, used in the demand and gap sections so the three can be compared row against row. Without a shared identifier the comparison is done by eye, and two similarly named roles are the ones most often confused.",
      "value": ""
    },
    "f08_Resource_Role_or_Team": {
      "section": "Capacity by Resource",
      "label": "Resource Role or Team",
      "guidance": "The role or team, named as the work requires it rather than as the organisation chart draws it. A matrix organised by existing departments can never show a gap, because it only ever lists what is already there, and the absence of a needed capability reads as its absence from the plan rather than from the organisation.",
      "value": ""
    },
    "f09_Period": {
      "section": "Capacity by Resource",
      "label": "Period",
      "guidance": "The period the row covers, using the same periods throughout the matrix. Capacity recorded per period rather than in total is what makes the matrix usable, because a resource with a thousand person-days available who is fully committed in the month the work is needed has no capacity at all.",
      "value": ""
    },
    "f10_Total_Available": {
      "section": "Capacity by Resource",
      "label": "Total Available",
      "guidance": "The capacity that exists in the period, before any allocation, in the unit declared for the matrix. This is a figure about the organisation rather than about the project, and recording it here is what allows the reader to see how much of it is actually available.",
      "value": ""
    },
    "f11_Allocated": {
      "section": "Capacity by Resource",
      "label": "Allocated",
      "guidance": "The capacity already committed elsewhere in the portfolio. This is the column most often left out, and without it the available figure is the total, which is not what the project can use. It is also the column that reveals a resource being shared between initiatives without either owner knowing.",
      "value": ""
    },
    "f12_Remaining": {
      "section": "Capacity by Resource",
      "label": "Remaining",
      "guidance": "What is left after allocation, which is the figure the planner actually has. Where this is negative, the matrix has found a real problem; where it is silently recorded as zero because nobody wanted to write a negative number, the problem has been hidden instead of solved.",
      "value": ""
    },
    "f13_Constraints_or_Single_Points_of_Failure": {
      "section": "Capacity by Resource",
      "label": "Constraints or Single Points of Failure",
      "guidance": "What limits this resource: a location, a qualification held by one person, a licence, a tool only one person can operate, or a notice period. Record the consequence rather than the adjective, because \"test automation is a single point of failure because one person holds it\" can be acted on, while \"test automation is a risk\" cannot.",
      "value": ""
    },
    "f14_Notes": {
      "section": "Capacity by Resource",
      "label": "Notes",
      "guidance": "Anything that changes how the row should be read, such as a known vacancy, planned leave, or a resource shared with another portfolio. Where a role is filled by more than one person, record the role once and note the split here, since a row per person hides the total capacity of the role.",
      "value": ""
    },
    "f15_ID": {
      "section": "Demand by Resource",
      "label": "ID",
      "guidance": "The resource role the demand is for, matching the ID used in the capacity section so the two can be set against each other.",
      "value": ""
    },
    "f16_Resource_Role": {
      "section": "Demand by Resource",
      "label": "Resource Role",
      "guidance": "The role the demand falls on, using the same naming as the capacity section. The two must be the same list, or the comparison in the gap section silently excludes roles that appear in only one of them, which are usually the ones in trouble.",
      "value": ""
    },
    "f17_Period": {
      "section": "Demand by Resource",
      "label": "Period",
      "guidance": "The period the demand falls in. A demand recorded with no period cannot be compared with a capacity figure that has one, and is therefore dropped from the comparison without anyone deciding to drop it.",
      "value": ""
    },
    "f18_Required_Capacity": {
      "section": "Demand by Resource",
      "label": "Required Capacity",
      "guidance": "What the scope and schedule require in the period. Record the figure the plan was built on rather than the figure currently being achieved, since the second is a consequence of the first being wrong and reporting it back as the requirement makes the shortfall disappear from the plan.",
      "value": ""
    },
    "f19_Source_of_Demand": {
      "section": "Demand by Resource",
      "label": "Source of Demand",
      "guidance": "Which part of the plan generates it, such as a named deliverable, work package, or activity. A demand that cannot be traced to something in the plan cannot be challenged, and demands that cannot be challenged only ever grow.",
      "value": ""
    },
    "f20_Priority": {
      "section": "Demand by Resource",
      "label": "Priority",
      "guidance": "Whether the demand is essential, or could be deferred or descoped. Without a priority a gap has no remedy, because the available responses are to add capacity, move the work, or reduce it, and nothing in the matrix says which of those the programme would accept.",
      "value": ""
    },
    "f21_Resource_Role": {
      "section": "Gap Analysis",
      "label": "Resource Role",
      "guidance": "The role the gap applies to, using the same naming as the sections above. Where a role appears in the demand but not the capacity, the gap is the whole requirement rather than a shortfall, and that case is worth distinguishing because it is a different problem.",
      "value": ""
    },
    "f22_Gap": {
      "section": "Gap Analysis",
      "label": "Gap",
      "guidance": "The difference between required and remaining, stated as a signed number so that a surplus is not read as a shortfall. This is the figure the whole matrix exists to produce, and a matrix that records only the totals has omitted the only number anyone reads.",
      "value": ""
    },
    "f23_Period": {
      "section": "Gap Analysis",
      "label": "Period",
      "guidance": "The period the gap falls in. A gap in a period with no demand in it is a different problem from a gap in a period the work needs, and reporting both as \"a gap\" sends the reader looking for the wrong remedy.",
      "value": ""
    },
    "f24_Resolution_Planned": {
      "section": "Gap Analysis",
      "label": "Resolution Planned",
      "guidance": "How the gap will be closed: recruitment, a contractor, moving work between periods, reducing scope, or accepting the risk. Where the gap is covered by a contractor or a shared resource, record the contract or agreement that covers it, because a gap filled on the understanding that someone will help is not covered at all.",
      "value": ""
    },
    "f25_Resolution_Owner": {
      "section": "Gap Analysis",
      "label": "Resolution Owner",
      "guidance": "Who is accountable for closing the gap. A gap with a planned resolution and no owner is a gap being wished away, and it is the most common way a capacity matrix comes to be relied upon long after it was last true.",
      "value": ""
    },
    "f26_Resolution_Date": {
      "section": "Gap Analysis",
      "label": "Resolution Date",
      "guidance": "By when the resolution is expected to be in place. This is what tells the reader whether the plan is still feasible, so record it rather than leaving the row open, and where the date has passed without resolution, escalate rather than moving the date.",
      "value": ""
    },
    "f27_Resource_Role": {
      "section": "Contingency",
      "label": "Resource Role",
      "guidance": "The role the contingency applies to, or \"plan\" where the buffer is held across all roles rather than against one.",
      "value": ""
    },
    "f28_Contingency_Type": {
      "section": "Contingency",
      "label": "Contingency Type",
      "guidance": "Whether the buffer is in capacity, in time, or in scope. The three are not interchangeable: time contingency can be spent once, capacity contingency can be spent on anything, and scope contingency reduces the deliverable. A plan that holds no scope contingency and states only that it has float is a plan whose contingency is the work being cut.",
      "value": ""
    },
    "f29_Contingency_Amount": {
      "section": "Contingency",
      "label": "Contingency Amount",
      "guidance": "The size of the buffer, in the declared unit. Record it as a figure rather than a percentage, because a percentage of a demand that was never reconciled produces a number that looks precise and is not.",
      "value": ""
    },
    "f30_How_It_Would_Be_Used": {
      "section": "Contingency",
      "label": "How It Would Be Used",
      "guidance": "What the buffer protects, recorded so it cannot be quietly consumed on something it was not held for. A contingency with no stated use is the first thing cut in a difficult month, which is precisely the month it was held for.",
      "value": ""
    }
  }
}