التوثيق الداخلي: ما يكتبه مختبرك لنفسه لا ما يسلّمه المزوّد

ينتهي مشروع النظام وتُسلَّم أدلة المزوّد، فيُظن أن التوثيق اكتمل. لكن هذه الأدلة تشرح ما يفعله النظام، ولا تشرح كيف يعمل مختبرك أنت به — وهذه هي الوثيقة التي لا يكتبها أحد غيرك.

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

توثيقك أنت لا توثيق المزوّد

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

لماذا لا يكفي دليل النظام

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

بطاقات الخطوات للمهام المتكررة

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

إجراءات الاستثناءات

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

قرارات التهيئة ومبرراتها

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

ما يفعله الفريق عند التوقف

1. كيف يُعرف أن النظام متوقف لا بطيء فقط.
2. من يُبلَّغ أولًا داخليًا ثم خارجيًا.
3. نماذج بديلة جاهزة مطبوعة ومتوفرة.
4. الترقيم الاحتياطي ونطاقه المخصص.
5. ما يستمر وما يتوقف من الخدمات.
6. ترتيب الإدخال بعد العودة — الحرج أولًا.
7. المطابقة الإلزامية بمسؤول مسمّى.

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

القواعد المحلية

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

جهات التواصل والتصعيد

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

حزمة الملتحق الجديد

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

من يملك كل وثيقة

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

كيف تبقى محدَّثة

1. اربط التحديث بالتغيير لا بموعد دوري فقط.
2. اجعله خطوة في إجراء التغيير نفسه.
3. تاريخ آخر مراجعة ظاهر على كل وثيقة.
4. مراجعة قصيرة دورية للأكثر تغيّرًا.
5. باب لملاحظات المستخدمين على الوثائق.
6. حذف ما لم يعد صحيحًا فورًا لا لاحقًا.

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

أين تعيش الوثيقة

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

ما يجعل التوثيق عديم الفائدة

الصف الأول هو الفخ الأكبر: المشروع الطموح لكتابة «دليل شامل» ينتهي غالبًا بوثيقة ضخمة نصفها غير مكتمل ولا أحد يفتحها. ابدأ بخمس بطاقات لأكثر خمس مهام تكرارًا وثلاثة استثناءات، ثم أضف. التوثيق الصغير المستخدَم أنفع من الشامل المهجور.

نموذج فهرس التوثيق

قائمة تحقق

1. هل يوثّق فريقك كيف تعملون لا ما يفعله النظام؟
2. هل بدأت بالاستثناءات لا بالمسار الروتيني؟
3. هل بطاقات المهام صفحة واحدة وفي مكان الاستخدام؟
4. هل يُسجَّل مبرر كل قرار تهيئة وقت اتخاذه؟
5. هل إجراء التوقف مطبوع ومتاح خارج النظام؟
6. هل مُرّن الفريق على إجراء التوقف مرة على الأقل؟
7. هل ما يُعد حادثة معرَّف بأمثلة؟
8. هل حزمة الالتحاق مخصصة لكل دور لا موحّدة؟
9. هل لكل وثيقة مالك مكتوب عليها؟
10. هل تحمل كل وثيقة تاريخ آخر مراجعة؟
11. هل تحديث التوثيق خطوة داخل إجراء التغيير؟
12. هل تُحذَف الوثيقة الخاطئة فورًا لا عند جهوز البديل؟

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

الأسئلة الشائعة