وثيقة التصميم
الدرس 26 من 38 · التصميم · 4 دقيقة و40 ثانية
الفيديو الأصلي باللغة الإنجليزية. إذا تعذّر تشغيله هنا، شاهده على موقع المؤلف. التفريغ النصي العربي الكامل أدناه.
الموارد
- شرائح الفيديو
- وثيقة التصميم العام لتطبيق FullSnack
- المادة: مستندات التصميم في Google بواسطة Malte Ubl
- المادة: مواصفات وظيفية غير مؤلمة بواسطة جويل سبولسكي
- المادة: كيفية كتابة وثيقة تصميم برامج جيدة بواسطة أنجيلا تشانغ
التفريغ النصي
[00:03] سننهي هذه الوحدة من خلال التحدث قليلاً عن مستندات التصميم. هذه المستندات تشبه نوعًا ما المستندات غير الرسمية حيث نصف حلنا لمشكلة بمستوى معين من التفاصيل، ومن ثم يمكننا مشاركة تلك الوثائق مع أصحاب المصلحة المختلفين أو مع فريقنا والحصول على تعليقات حول الحل. هناك أساسا مستويين من التفاصيل من هذه الوثائق. هناك مستندات تصميم عالية المستوى على مستندات التصميم منخفضة المستوى. إنها متشابهة جدًا من حيث الهيكل، ولكن مستندات التصميم عالية المستوى تكون أكثر ملاءمة عندما تريد وصف بنية كاملة أو شيء يتطلب المزيد والمزيد من السياق ومستندات تصميم منخفضة المستوى رائعة عندما تحاول وصف كيفية تنفيذ ميزة معينة في هذا النوع من المستندات.
[00:46] يمكنك تضمين شفرة زائفة أو قد تتضمن واجهات برمجة تطبيقات وهمية أو أنواع بيانات وهمية وما إلى ذلك. ربما يكون لدى الشركة التي تعمل فيها بالفعل نوعًا من القالب أو الهيكل الذي يرغبون في استخدامه لمستندات التصميم الخاصة بك. ولكن إذا لم يكن لديك واحد، يمكنني أن أوصي واحد أنه بسيط جدا. يحتوي على عدد من الأقسام المختلفة، لكنه لا يزال هيكلًا بسيطًا جدًا لوثيقة التصميم الخاصة بنا، والأقسام الرئيسية هي نظرة عامة. سنبدأ بما لا يزيد عن فقرة أو فقرتين تصف ما يدور حوله المستند.
[01:18] قسم السياق. عندما نشرح كل شيء في كل سياق ضروري لفهم المستند وقد يتضمن هذا القسم أي مخططات لسياق النظام مثل تلك التي رأيناها في الوحدة السابقة. الأهداف وغير أهداف الحل. لذلك هذا سوف يصف ما هي الأشياء داخل وخارج نطاق هذه المشكلة بالذات. تصميم عالي المستوى، والذي في حالة المعمارية، يمكننا تضمين مخطط الحاوية الخاص بنا. يمكننا أيضًا تضمين، يمكننا أيضًا وصف المعمارية باستخدام الأبعاد الأربعة للهندسة المعمارية التي رأيناها في الفيديو السابق وأي بدائل قد نكون فكرنا فيها أثناء وضع هذا التصميم.
[01:55] لذلك قد تشمل هذه أي أطر أو مكتبات أو تقنيات قررت عدم الذهاب معها ولماذا لم تذهب معهم. قسم يصف التصميم التفصيلي، والذي عادة ما يكون فقط في مستندات التصميم ذات المستوى المنخفض، وهذا هو المكان الذي قد ندرج فيه شيفرةًا زائفًا وربما بعض الرسوم البيانية ذات المستوى المنخفض، وهو جدول زمني سيشمل المدة التي تعتقد أن المشروع سيستغرقها أو كم من الوقت سيستغرق لتنفيذ هذا التصميم. وبطبيعة الحال، كلما كان المشروع أكبر، كلما كان من الصعب تقدير ذلك. ولكن على الأقل ينبغي لنا أن تشمل أفضل تخمين لدينا، أي مخاطر والأسئلة المفتوحة التي قد تكون لدينا وعلى التذييل، بما في ذلك وصلات إلى الوثائق الأخرى ذات الصلة أيضا.
[02:37] حتى هنا لدينا مثال على وثيقة تصميم عالية المستوى التي وضعت معا لFullSnack. لدينا لمحة موجزة عن المشكلة. لدينا بعض السياق. نحن، بما في ذلك مخطط سياق النظام الذي رأيناه سابقًا، وأهداف النظام وغير أهدافه، والتصميم عالي المستوى، والذي يصف المعمارية على مستوى عالٍ. حتى هنا نرى الرسم البياني الحاوية التي نرسمها في وقت سابق. هذا هو نسخة أكثر مصقول من الرسم البياني حاوية، ونحن أيضا وصف النمط المعماري للتطبيق لدينا ورأى المكونات الرئيسية التي هي وحدات.
[03:11] هذه هي الطريقة التي سنقوم بها بتقسيم التطبيق إلى وحدات مختلفة، مكدسات التكنولوجيا، بما في ذلك بعض القرارات التي اتخذناها. ثم نرى البدائل التي نعتبرها أي أطر أخرى ربما نكون قد نظرنا فيها لهذا المشروع ولماذا لم نختار الذهاب مع تلك الخيارات. يتضمن الجدول الزمني، مرة أخرى، أفضل تخمين لكيفية تنفيذ هذه النماذج. بالنظر إلى قيودنا لمدة أربعة أشهر، قد تقول إن هذا جدول زمني متفائل، لكنه ما لدينا وهذه مشاريع وهمية حتى نتمكن من الحلم قليلاً ثم بعض المخاطر والأسئلة المفتوحة.
[03:47] وأخيرا، التذييل الذي يلعب لبعض الوثائق الأخرى التي تحدثنا عنها في وقت سابق من الدورة، مثل متطلباتنا وثيقة نموذج المجال وفكرة أننا عملنا على القطعة الأخيرة من المشورة التي لدي عندما يتعلق الأمر كتابة مستندات التصميم هو الاحتفاظ بها قصيرة قدر الإمكان. قد يكون من المغري، خاصة عندما نعمل على هذه المشاريع الكبيرة، محاولة تضمين أكبر قدر ممكن من المعلومات في الوثائق.
[04:12] ولكن هذا سيستغرق أولاً وقبل كل شيء قدراً هائلاً من الوقت، وثانياً، سيقلل من فرص قيام الناس بقراءتها بالفعل. ونريد من الناس قراءتها لأننا نريد الحصول على ردود فعل عليها. هذا هو أحد الأسباب الرئيسية وراء كتابة المستند في المقام الأول وهذا كل شيء.
[04:28] لقد وصلنا إلى نهاية الوحدة الثالثة. الآن نحن ذاهبون إلى الاستيلاء على هذا هو وثيقة التصميم ونحن في طريقنا لاستخدامه كخطة أولية لتنفيذ المشروع، وهو ما نحن ذاهبون لنرى في الوحدة التالية من الدورة.