كتب architectural design documentation
اذا لم تجد ما تبحث عنه يمكنك استخدام كلمات أكثر دقة.
توثيق المعمارية التصميم (معلومة)
توثيق المعمارية هو تصنيف آخر لملف التصميم. تشتق ملفات المعمارية بطريقة ما من ملفات تصميم الكود. تتضمن وثائق المعمارية القليل عن الشيفرة البرمجية نفسها، ولا تصف كيفية برمجة أجزاء معينة من الكود أو حتى سبب وجودها، بل تصف المتطلبات العامة التي تحفّز وجود تلك الأجزاء من الكود. وثيقة المعمارية الجيدة تكون ذات تفاصيل قليلة لكنها تصف المتطلبات بكثافة. وقد تقترح منهجية للتصميم الأولي، لكنها لا تتضمن تفاصيل كثيرة عنه.
من أصناف مستندات التصميم تلك المستخدمة لأغراض المقارنة أو الدراسات. وغالباً ما تكون بهيئة ورقة بيضاء. وتركز على جانب محدد من النظام وتقترح طرقاً بديلة. فقد ينصب تركيزها على واجهة التطبيق أو شيفرة البرمجة أو التصميم أو حتى على مستوى المعمارية. تلخص هذه المستندات بديلاً أو أكثر وتعدد إيجابيات وسلبيات كل منها. يجب أن توضح أيضاً تكلفة كل حل من الحلول المقترحة. تهدف الدراسات غالباً إلى ابتكار الحلول واستنباطها بدلاً من فرض وجهة نظر محددة. ويقبل في هذه الدراسات عدم الخروج باستنتاجات أو أن يكون الاستنتاج أن ليس ثمة بديل من البدائل أفضل من الأساس لتبرير إجراء تغيير. ينبغي التعامل مع هذه الدراسات على أنها مبتغى علمي وليس وسيلة تسويق.
من أهم أجزاء وثيقة التصميم في عملية تطوير البرمجيات ما يعرف بوثيقة تصميم قاعدة البيانات. وتتضمن عناصر التصميم المفاهيمي والمنطقي والفيزيائي. تتضمن هذه الوثيقة معلومات أساسية يحتاج إليها الأشخاص الذين يتعاملون مع قاعدة البيانات. إن الهدف من تحضير وثيقة تصميم قاعدة البيانات هو إنشاء مصدر مشترك لجميع المشاركين، وهم:
- مصمم قاعدة البيانات
- مبرمج قاعدة البيانات
- مدير قاعدة البيانات
- مصمم البرنامج
- مبرمج البرنامج
عند الحديث عن نظم قواعد البيانات المترابطة، يجب أن يتضمن التوثيق ما يلي:
- مخطط كيان-علاقة (محسن وتتضمن المعلومات التالية وتعريفات واضحة لكل منها):
- مجموعة الكائن وخصائصها
- العلاقات وخصائصها
- المفاتيح المرشحة لكل مجموعة كائن
- الخصائص والقيود
- مخطط العلاقات، بما في ذلك المعلومات التالية:
- الجداول، الخصائص ومزاياها
- العروض
- القيود، كـالمفاتيح الأساسية primary keys والمفاتيح الثانوية foreign keys
- أصول القيود المرجعية
- السياسة المتتالية للقيود المرجعية
- المفاتيح الأساسية
من الأهمية بمكان شمول كافة المعلومات التي يمكن للجميع استخدامها. كما أنه من الضروري تحديث الوثائق عند إجراء أي تغيير على قاعدة البيانات.
