خبرة في استخدام ESPD. النظام الموحد لتوثيق البرنامج وثائق برنامج ESPD

حدد مرسوم لجنة الدولة لاتحاد الجمهوريات الاشتراكية السوفياتية للمعايير بتاريخ 18 ديسمبر 1978 رقم 3350 الموعد النهائي للتقديم

من 01.01.1980

تحدد هذه المواصفة القياسية الدولية المتطلبات العامة لتصميم وثائق البرنامج لـ أجهزة الكمبيوتروالمجمعات والأنظمة ، بغض النظر عن غرضها ونطاقها ووفقًا لمعايير النظام الموحد لتوثيق البرامج (ESPD) لأي طريقة لتنفيذ المستندات على ناقلات البيانات المختلفة.

يتوافق المعيار مع ST SEV 2088-80 من حيث المتطلبات العامة لتصميم جزء المعلومات (انظر الملحق المرجعي)

1. المتطلبات العامة

1.1 يمكن تقديم وثيقة السياسة على أنواع مختلفة من ناقلات البيانات.

1.2 تتكون وثيقة البرنامج من الأجزاء الشرطية التالية:

    لقب؛

    معلوماتية؛

    أساسي؛

    تسجيل التغييرات.

1.3 يتم تحديد قواعد إعداد المستند وأجزائه على كل ناقل بيانات بواسطة معايير ESPD لقواعد إعداد المستندات على ناقلات البيانات المقابلة.

2. جزء العنوان

2.1. يتكون جزء العنوان من ورقة الموافقة وصفحة العنوان. تم وضع قواعد تصميم ورقة الموافقة وصفحة العنوان وفقًا لـ GOST 19.104-78.

3. جزء المعلومات

3.1. يجب أن يتكون الجزء الإعلامي من تعليق توضيحي ومحتوى.

3.2 تم تحديد الحاجة إلى تضمين جزء المعلومات في أنواع مختلفة من وثائق البرنامج من خلال معايير ESPD ذات الصلة لهذه الوثائق.

3.3 يوفر التعليق التوضيحي معلومات حول الغرض من المستند وملخصًا لجزءه الرئيسي.

    تعيين عنصر هيكلي (رقم القسم ، القسم الفرعي ، إلخ) ؛

    اسم العنصر الهيكلي

    عنوان العنصر الهيكلي على حامل البيانات (مثل رقم الصفحة ورقم الملف وما إلى ذلك).

تم تحديد قواعد تعيين العناصر الهيكلية للجزء الرئيسي من المستند وعناوينها بواسطة معايير ESPD لقواعد معالجة المستندات على ناقلات البيانات المقابلة.

4. الجزء الرئيسي

4.1 تكوين وهيكل الجزء الرئيسي وثيقة سياسةمن خلال معايير ESPD للوثائق ذات الصلة.

5. جزء من تسجيل التغييرات

5.1 يتم تسجيل كل تغيير في وثيقة البرنامج في هذا الجزء وفقًا لمتطلبات GOST 19.603-78.

مرجع الملحق

بيانات المعلومات حول الامتثال لـ GOST 19.105-78 ST SEV 2088-80

ثانية. 3 GOST 19.105-78 يتوافق مع Sec. 4 (البنود 4.2 ، 4.3) ST SEV 2088-80.

(مقدمة بالإضافة إلى ذلك التعديل رقم 1)

* إعادة إصدار (نوفمبر 1987) مع التعديل رقم 1 المعتمد في سبتمبر 1981 (IUS 11-81)

تنقسم معايير ESPD (مثل معايير GOST الأخرى) إلى مجموعات ،

الأحكام العامة;

المعايير الأساسية ؛

قواعد تنفيذ الوثائق ؛

قواعد التنفيذ الوثائق التشغيلية;

قواعد توزيع وثائق البرنامج ؛

مجموعات الاحتياطي

معايير أخرى.

يتضمن ESPD GOSTs التالية:

GOST 19.001-77 ESPD. الأحكام العامة.

GOST 19.005-85 ESPD. ف مخططات الخوارزميات والبرامج. التعيينات الرسومية الشرطية وقواعد التنفيذ.

GOST 19.101-77 ESPD. أنواع البرامج ووثائق البرنامج.

GOST 19.102-77 ESPD. مراحل التطور.

GOST 19.103-77 ESPD. تسمية البرامج ووثائق البرنامج.

GOST 19.104-78 ESPD. النقوش الأساسية.

GOST 19.105-78 ESPD. المتطلبات العامة لوثائق البرنامج.

GOST 19.106-78 ESPD. متطلبات وثائق البرنامج في شكل مطبوع.

GOST 19.201 78 ESPD. مهمة فنية. متطلبات المحتوى والتصميم.

GOST 19.202-78 ESPD. تخصيص. متطلبات المحتوى والتصميم.

GOST 19.301-79 ESPD. إجراءات وطرق الاختبار.

GOST 19.401-78 ESPD. نص البرنامج. متطلبات المحتوى والتصميم.

GOST 19.402-78 ESPD. وصف البرنامج.

GOST 19.403-79 ESPD. قائمة حاملي الأصول.

GOST 19.404-79 ESPD. ملاحظة توضيحية. متطلبات المحتوى والتصميم.

GOST 19.501-78 ESPD. استمارة. متطلبات المحتوى والتصميم.

GOST 19.502-78 ESPD. وصف التطبيق. متطلبات المحتوى والتصميم.

GOST 19.503-79 ESPD. دليل مبرمج النظام. متطلبات المحتوى والتصميم.

GOST 19.504-79 ESPD. دليل المبرمج. متطلبات المحتوى والتصميم.

GOST 19.505-79 ESPD. دليل المشغل. متطلبات المحتوى والتصميم.

GOST 19.506-79 ESPD. وصف اللغة. متطلبات المحتوى والتصميم.

GOST 19.507-79 ESPD. قائمة مستندات التشغيل.

GOST 19.508-79 ESPD. كتيب الصيانة. متطلبات المحتوى والتصميم.

GOST 19.601-78 ESPD. قواعد عامةالازدواجية والمحاسبة والتخزين.

GOST 19.602-78 ESPD. قواعد النسخ والمحاسبة وتخزين وثائق البرنامج المطبوعة.

GOST 19.603-78 ESPD. القواعد العامة لإجراء التغييرات.

GOST 19.604-78 ESPD. قواعد لإجراء تغييرات على مستندات البرنامج التي تتم طباعتها.


قمة

GOST 19.105-78 * (المتطلبات العامة لوثائق البرنامج)

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

  • يحدد هذا المعيار المتطلبات العامة لتنفيذ مستندات البرنامج لأجهزة الكمبيوتر والمجمعات والأنظمة ، بغض النظر عن الغرض منها ونطاقها ووفقًا لمعايير نظام توثيق البرنامج الموحد (ESPD) لأي طريقة لتنفيذ المستندات على ناقلات البيانات المختلفة.
  • تتكون وثيقة البرنامج من الأجزاء الشرطية التالية:
    • لقب؛
    • معلوماتية؛
    • أساسي؛
    • تسجيل التغييرات.
  • يتكون جزء العنوان من ورقة الموافقة وصفحة العنوان. تم وضع قواعد تصميم ورقة الموافقة وصفحة العنوان وفقًا لـ GOST 19.104-78.
  • جزء المعلوماتيجب أن تتكون من ملخص ومحتوى.
    • تم تحديد الحاجة إلى تضمين جزء المعلومات في أنواع مختلفة من وثائق البرنامج من خلال معايير ESPD ذات الصلة لهذه الوثائق.
    • يوفر التعليق التوضيحي معلومات حول الغرض من المستند وملخصًا لجزءه الرئيسي.
    • يتضمن المحتوى قائمة إدخالات حول العناصر الهيكلية للجزء الرئيسي من المستند ، ويتضمن كل منها:
      • تعيين عنصر هيكلي (رقم القسم ، القسم الفرعي ، إلخ) ؛
      • اسم العنصر الهيكلي
      • عنوان العنصر الهيكلي على حامل البيانات (مثل رقم الصفحة ورقم الملف وما إلى ذلك).
  • تم تحديد تكوين وهيكل الجزء الرئيسي من وثيقة البرنامج من خلال معايير ESPD للوثائق ذات الصلة.
  • جزء من تسجيل التغييرات(يجب أن تكون موجودة في كل وثيقة سياسة)
    • يتم تسجيل كل تغيير في وثيقة البرنامج في هذا الجزء وفقًا لمتطلبات GOST 19.603-78.
قمة
==================================
GOST 19.106-78 * (المتطلبات العامة لوثائق البرنامج المطبوعة
طريق)
من هذا GOST نحصل عليهقواعد عامة للنسخة المطبوعةوثائق السياسة. فيما يلي أهم الأقسام.
  • يحدد هذا المعيار القواعد الخاصة بتنفيذ مستندات البرنامج لأجهزة الكمبيوتر والمجمعات والأنظمة ، بغض النظر عن الغرض منها ونطاقها ووفقًا لمعايير نظام توثيق البرنامج الموحد (ESPD) للطريقة المطبوعة للتنفيذ.
  • لا ينطبق المعيار على وثيقة البرنامج "نص البرنامج".
  • تم إنشاء تكوين وهيكل وثيقة البرنامج وفقًا لـ GOST 19.105-78.
  • وثيقة السياسة قيد التنفيذعلى جانب واحد من الورقة ، على فترتين ؛ مسموح به بعد فاصل زمني واحد أو واحد ونصف.
  • يتم إعداد وثائق البرنامج:
    • على أوراق بتنسيق A4 (GOST 2.301-68) - عند عمل مستند مكتوب على الآلة الكاتبة أو بخط اليد (النموذج 1). يسمح بالتصميم على أوراق A3.


  • مواد وثيقة البرنامج مرتبة بالتسلسل التالي:
    • جزء العنوان:
      • ورقة الموافقة (غير مدرجة في العدد الإجمالي لأوراق المستندات) ؛
      • صفحة عنوان الكتاب(الصفحة الأولى من الوثيقة) ؛
    • جزء المعلومات:
      • حاشية. ملاحظة؛
      • ورقة المحتوى
    • الجزء الرئيسي:
      • نص المستند (بالأشكال والجداول وما إلى ذلك) ؛
      • التطبيقات ؛
      • قائمة المصطلحات ، قائمة الاختصارات ، قائمة الأشكال ، قائمة الجداول ، فهرس الموضوع ، قائمة الوثائق المرجعية ؛
    • جزء التسجيل:
      • تغيير ورقة التسجيل.
  • يتم وضع الملخص في صفحة منفصلة (مرقمة) بعنوان "ملخص" ولا يتم ترقيمها كمقطع.
    • يشير التعليق التوضيحي إلى إصدار البرنامج ، ويحدد بإيجاز الغرض من المستند ومحتواه. إذا كان المستند يتكون من عدة أجزاء ، فإن التعليق التوضيحي يشير إلى العدد الإجمالي للأجزاء.
  • يتم وضع محتوى المستند في صفحة منفصلة (مرقمة) (صفحات) بعد التعليق التوضيحي ، مع توفير العنوان "المحتويات" ، وليس مرقمًا كقسم ويتم تضمينه في العدد الإجمالي لصفحات المستند.
  • تتم كتابة عناوين الأقسام بأحرف كبيرة وتوضع بشكل متماثل فيما يتعلق بالحدود اليمنى واليسرى للنص.
  • تتم كتابة العناوين الفرعية من الفقرة بأحرف صغيرة (باستثناء الأحرف الكبيرة الأولى).
  • لا يُسمح باستخدام الواصلة في العناوين. لا تضع نقطة في نهاية العنوان.
  • يجب أن تكون المسافة بين العنوان والنص التالي ، وكذلك بين عناوين القسم والقسم الفرعي ، مساوية لـ:
    • عند تنفيذ مستند بطريقة مطبوعة - فترتان.
  • بالنسبة للأقسام والأقسام الفرعية ، التي يكتب نصها على نفس الصفحة مثل نص القسم السابق ، يجب أن تكون المسافة بين آخر سطر من النص والعنوان التالي مساوية:
    • عند تنفيذ مستند بطريقة مكتوبة على الآلة الكاتبة - ثلاث فواصل زمنية مطبوعة.
  • يجب ترقيم الأقسام والأقسام الفرعية والفقرات والفقرات الفرعية بالأرقام العربية بنقطة.
  • يجب أن يكون هناك ترقيم مستمر داخل القسم لجميع الأقسام الفرعية والفقرات والفقرات الفرعية المدرجة في هذا القسم.
  • يتضمن ترقيم الأقسام الفرعية رقم القسم والرقم التسلسلي للقسم الفرعي المتضمن في هذا القسم ، مفصولة بنقطة (2.1 ؛ 3.1 ، إلخ).
  • في حالة وجود أقسام وأقسام فرعية ، تتم إضافة الرقم التسلسلي للفقرة والفقرة الفرعية (3.1.1 ، 3.1.1.1 ، إلخ) إلى رقم القسم الفرعي بعد النقطة.

مثال على هيكل نص وثيقة البرنامج وترقيم الأقسام والأقسام الفرعية والفقرات والفقرات الفرعية.

  • يجب أن يكون نص الوثيقة قصيرًا وواضحًا ويستبعد احتمال سوء التفسير.
  • يجب أن تكون المصطلحات والتعريفات موحدة ومتوافقة مع المعايير المعمول بها ، وفي حالة عدم وجودها - مقبولة بشكل عام في الأدبيات العلمية والتقنية ، ويجب تقديمها في قائمة المصطلحات.
  • يمكن تقديم التفسيرات الضرورية لنص الوثيقة بواسطة الحواشي السفلية.
    • تتم الإشارة إلى الحاشية السفلية برقم مع وضع قوس على مستوى خط القطع العلوي للخط ، على سبيل المثال: "جهاز الطباعة 2) ..." أو "الورق 5)".
    • إذا كانت الحاشية تشير إلى كلمة واحدة ، يتم وضع علامة الحاشية السفلية بجوار هذه الكلمة مباشرة ، ولكن إذا كانت تشير إلى الجملة ككل ، فعندئذٍ في نهاية الجملة. يتم وضع نص الحاشية السفلية في نهاية الصفحة ويتم فصله عن النص الرئيسي بخط بطول 3 سم مرسوم على الجانب الأيسر من الصفحة.
  • الرسوم التوضيحية إذا كانوا في هذا المستندأكثر من واحد ، مرقمة بالأرقام العربية داخل المستند بأكمله.
  • يتم ترقيم الصيغ في المستند ، إذا كان هناك أكثر من واحد ، بأرقام عربية ، يتم وضع الرقم مع الجانب الأيمنالصفحة ، بين قوسين على مستوى الصيغة.
  • يجب إعطاء معنى الرموز والمعاملات العددية المضمنة في الصيغة مباشرة أسفل الصيغة. تتم طباعة قيمة كل حرف في سطر جديد بالترتيب الذي وردت به في الصيغة. يجب أن يبدأ السطر الأول من فك التشفير بكلمة "where" ، بدون نقطتين بعدها.
  • يُسمح بالإشارات إلى المعايير (باستثناء معايير المؤسسة) في مستندات البرنامج ، تحديدوغيرها من الوثائق (على سبيل المثال ، وثائق السلطات إشراف الدولةوقواعد ومعايير Gosstroy لاتحاد الجمهوريات الاشتراكية السوفياتية). عند الإشارة إلى المعايير والمواصفات ، يشار إلى تعيينها.
  • يجب عليك الرجوع إلى المستند ككل أو إلى أقسامه (مع الإشارة إلى تسمية المستند واسمه ورقم واسم القسم أو الملحق). للإشارات المتكررة إلى قسم أو تطبيق ، يشار فقط إلى الرقم.
  • تشير الملاحظات على النص والجداول إلى البيانات المرجعية والتفسيرية فقط.
    • ملاحظة واحدة غير مرقمة. بعد كلمة "ملاحظة" ضع نقطة.
    • يجب ترقيم العديد من الملاحظات على التوالي بالأرقام العربية بنقطة. بعد كلمة "ملاحظة" ضع علامة النقطتين.
  • لا يُسمح باختصارات الكلمات في النص والتعليقات التوضيحية أسفل الرسوم التوضيحية.
  • يمكن وضع مواد أو جداول أو نصوص ذات طبيعة مساعدة مصورة في شكل تطبيقات.
  • يجب أن يبدأ كل تطبيق في صفحة جديدة بكلمة "ملحق" في الزاوية اليمنى العليا وأن يكون له عنوان موضوعي مكتوب بشكل متماثل مع النص بأحرف كبيرة.(في النهاية ، لإنشاء مشروع ، نحتاج فقط إلى ورقة تسجيل التغيير).
    • يحدد هذا المعيار القواعد لإجراء تغييرات على مستندات البرنامج المنصوص عليها في معايير نظام توثيق البرنامج الموحد (ESPD) والتي يتم إجراؤها في شكل مطبوع.
    نظرًا للكم الهائل من المعلومات في GOST ولتوفير مساحة على هذه الصفحة ، أوصيك بمشاهدتها بنفسك GOST 19.604-78 * . مثال على التصميم النهائي"تغيير ورقة السجل"يمكنك الاطلاع على أي وثيقة سياسة متوفرة في قسم التنزيل

    قمة
    ==================================

حدد مرسوم لجنة الدولة لاتحاد الجمهوريات الاشتراكية السوفياتية للمعايير بتاريخ 18 ديسمبر 1978 رقم 3350 الموعد النهائي للتقديم

من 01.01.1980

يحدد هذا المعيار المتطلبات العامة لتنفيذ مستندات البرنامج لأجهزة الكمبيوتر والمجمعات والأنظمة ، بغض النظر عن الغرض منها ونطاقها ووفقًا لمعايير نظام توثيق البرنامج الموحد (ESPD) لأي طريقة لتنفيذ المستندات على ناقلات البيانات المختلفة.

يتوافق المعيار مع ST SEV 2088-80 من حيث المتطلبات العامة لتصميم جزء المعلومات (انظر الملحق المرجعي).

واحد . المتطلبات العامة

3. جزء المعلومات

3.1 . يجب أن يتكون الجزء الإعلامي من تعليق توضيحي ومحتوى.

3.2 تم تحديد الحاجة إلى تضمين جزء المعلومات في أنواع مختلفة من وثائق البرنامج من خلال معايير ESPD ذات الصلة لهذه الوثائق.

3.3 . يوفر التعليق التوضيحي معلومات حول الغرض من المستند وملخصًا لجزءه الرئيسي.

3.4 . يتضمن المحتوى قائمة إدخالات حول العناصر الهيكليةالنص الأساسي للوثيقة ، ويتضمن كل منها:

تعيين عنصر هيكلي (رقم القسم ، القسم الفرعي ، إلخ) ؛

اسم العنصر الهيكلي

عنوان العنصر الهيكلي على حامل البيانات (مثل رقم الصفحة ورقم الملف وما إلى ذلك) ؛

تم تحديد قواعد تعيين العناصر الهيكلية للجزء الرئيسي من المستند وعناوينها بواسطة معايير ESPD لقواعد معالجة المستندات على ناقلات البيانات المقابلة.

في تقريري ، أعتمد على:

  • مقال "التوحيد في الميدان أدوات البرمجيات"V.V. Vasyutkovich - رئيس القسم و S.
  • مقال "الارتباط واستخدام المعايير لتنظيم دورات حياة الأنظمة" بقلم EZ Zinder ؛
  • نصوص GOST والمعايير الأخرى.

1. القضايا الرئيسية في تطوير البرمجيات

عندما يتلقى مطور مبرمج مهمة برمجة بشكل أو بآخر ، تظهر أسئلة أمامه ، قبل مدير المشروع ، وأمام فريق المشروع بأكمله:

  • ما الذي يجب عمله بجانب البرنامج نفسه؟
  • ما الذي يجب توثيقه وكيف؟
  • ماذا تنقل للمستخدمين ، وماذا؟ خدمات الحماية او المرافقة؟
  • كيف تدير هذه العملية برمتها؟
  • ما الذي يجب تضمينه في مهمة البرمجة نفسها؟

بالإضافة إلى الأسئلة المذكورة أعلاه ، هناك أسئلة أخرى.

تمت الإجابة على هذه الأسئلة والعديد من الأسئلة الأخرى من خلال معايير الدولة لتوثيق البرنامج؟ مجموعة من معايير السلسلة التاسعة عشر من GOST ESPD. ولكن حتى ذلك الحين ، كان لدى المبرمجين الكثير من الشكاوى حول هذه المعايير. هناك حاجة إلى تكرار شيء ما في الوثائق عدة مرات (كما يبدو - بشكل غير مبرر) ، ولم يتم توفير الكثير ، مثل عكس تفاصيل برامج التوثيق التي تعمل مع قاعدة بيانات متكاملة.

لا يزال حاليا قضايا الساعةبشأن وجود نظام ينظم توثيق مرافق البرمجيات (PS).

2. الخصائص العامة للدولة

أساس الإطار التنظيمي المحلي في مجال توثيق PS هو مجموعة معايير النظام الموحد لتوثيق البرنامج (ESPD). تم تطوير الجزء الرئيسي والأكثر من مجمع ESPD في السبعينيات والثمانينيات. الآن هذا المجمع عبارة عن نظام للمعايير المشتركة بين دول رابطة الدول المستقلة (GOST) ، يعمل في الإقليم الاتحاد الروسيعلى أساس اتفاق بين الدول بشأن التوحيد القياسي.

تغطي معايير ESPD بشكل أساسي ذلك الجزء من التوثيق الذي تم إنشاؤه أثناء تطوير PS ، والذي يرتبط ، في الغالب ، بتوثيق الخصائص الوظيفية لـ PS. وتجدر الإشارة إلى أن معايير ESPD (GOST 19) استشارية بطبيعتها. ومع ذلك ، ينطبق هذا أيضًا على جميع معايير PS الأخرى (GOST 34 ، ISO / IEC International Standard ، إلخ). الحقيقة هي أنه وفقًا لقانون الاتحاد الروسي "بشأن التوحيد القياسي" ، تصبح هذه المعايير إلزامية على أساس العقد - أي عندما تتم الإشارة إليها في عقد تطوير (توريد) PS.

عند الحديث عن حالة ESPD ككل ، يمكن القول أن معظم معايير ESPD قديمة.

من بين أوجه القصور الرئيسية ESPDيمكن أن يعزى:

  • التوجه إلى نموذج واحد "متتالي" دورة الحياة(LC) بس ؛
  • عدم وجود توصيات واضحة بشأن توثيق خصائص جودة PS ؛
  • عدم وجود ارتباط منهجي مع أنظمة محلية أخرى لمعايير دورة الحياة وتوثيق المنتج بشكل عام ، على سبيل المثال ، ESKD ؛
  • نهج غامض لتوثيق PS كمنتج قابل للتسويق ؛
  • عدم وجود توصيات للتوثيق الذاتي لـ PS ، على سبيل المثال ، في شكل قوائم على الشاشة وأدوات مساعدة المستخدم عبر الإنترنت ("help") ؛
  • عدم وجود توصيات بشأن تكوين ومحتوى وتنفيذ الوثائق المرتقبة لـ PS ، بما يتماشى مع توصيات المعايير الدولية والإقليمية.

لذلك ، يجب مراجعة ESPD بالكامل بناءً على معيار ISO / IEC 12207-95 لعمليات دورة حياة PS ، وستتم مناقشة هذا المعيار بمزيد من التفصيل لاحقًا).

يجب أن يقال أنه مع مجمع ESPD ، المسؤول القاعدة المعياريةيشمل الاتحاد الروسي في مجال توثيق PS وفي المجالات ذات الصلة عددًا من المعايير الواعدة (المستوى المحلي والمستوى بين الدول والمستوى الدولي).

المعيار الدولي ISO / IEC 12207: 1995-08-01لتنظيم دورة حياة المنتجات البرمجيات(PO) - معيار يبدو غامضًا جدًا ، ولكنه جديد تمامًا وجزئيًا "عصري".

معايير معقدة غوست 34للخلق والتنمية أنظمة مؤتمتة(AC) - معمم ، ولكن يُنظر إليه على أنه صارم جدًا في هيكل دورة الحياة و وثائق المشروع. لكن الكثيرين يعتبرون هذه المعايير بيروقراطية إلى درجة كونها ضارة ومحافظة إلى درجة عفا عليها الزمن. إلى أي مدى يكون الأمر كذلك ، وإلى أي مدى يظل GOST 34 يعمل مع الفائدة ، من المفيد معرفة ذلك.

في مقالته ، يسهب EZ Zinder بالتفصيل في المنهجية Oracle CDM(طريقة التطوير المخصصة) لتطوير التطبيق نظم المعلوماتتحت الطلب - مادة محددة ، مفصلة بمستوى الفراغات في مستندات التصميم ، مصممة للاستخدام المباشر في مشاريع NPP القائمة على أدوات Oracle.

2.1. مقدمة موجزة عن معايير ESPD

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

  • تقدم معايير ESPD عنصر التبسيط في عملية توثيق PS ؛
  • تكوين وثائق البرنامج المنصوص عليها في معايير ESPD ليس "جامدًا" على الإطلاق كما يبدو للبعض: تسمح المعايير بإضافة أنواع إضافية إلى مجموعة التوثيق لـ PS
  • تسمح معايير ESPD ، بالإضافة إلى ذلك ، بتغيير هيكل ومحتوى أنواع PD بناءً على متطلبات العميل والمستخدم.

في الوقت نفسه ، يمكن أن يتوافق أسلوب تطبيق المعايير مع النمط العام الحديث لتكييف المعايير مع تفاصيل المشروع: يختار العميل ومدير المشروع مجموعة فرعية من المعايير و PDs المناسبة في المشروع ، ويكمل المحدد المحدد PD مع الأقسام الضرورية واستبعاد الأقسام غير الضرورية ، اربط إنشاء هذه المستندات بمخطط LC المستخدم في المشروع.

تنقسم معايير ESPD (مثل معايير GOST الأخرى) إلى مجموعات مذكورة في الجدول:

تم تصميم معيار ESPD وفقًا لميزة التصنيف:

يجب أن يتكون تعيين معيار ESPD من:

  • رقم 19 (مخصص لفئة معايير ESPD) ؛
  • رقم واحد (بعد النقطة) يشير إلى رمز مجموعة تصنيف المعايير المشار إليها في الجدول ؛
  • رقم مكون من رقمين (بعد الشرطة) يشير إلى السنة التي تم فيها تسجيل المعيار.

قائمة وثائق ESPD

  1. GOST 19.001-77 ESPD. الأحكام العامة.
  2. GOST 19.101-77 ESPD. أنواع البرامج ووثائق البرنامج.
  3. GOST 19.102-77 ESPD. مراحل التطور.
  4. GOST 19.103-77 ESPD. تسمية البرامج ووثائق البرنامج.
  5. GOST 19.104-78 ESPD. النقوش الأساسية.
  6. GOST 19.105-78 ESPD. المتطلبات العامة لوثائق البرنامج.
  7. GOST 19.106-78 ESPD. متطلبات وثائق البرنامج في شكل مطبوع.
  8. GOST 19.201-78 ESPD. مهمة فنية. متطلبات المحتوى والتصميم.
  9. GOST 19.202-78 ESPD. تخصيص. متطلبات المحتوى والتصميم.
  10. GOST 19.301-79 ESPD. إجراءات وطرق الاختبار.
  11. GOST 19.401-78 ESPD. نص البرنامج. متطلبات المحتوى والتصميم.
  12. GOST 19.402-78 ESPD. وصف البرنامج.
  13. GOST 19.404-79 ESPD. ملاحظة توضيحية. متطلبات المحتوى والتصميم.
  14. GOST 19.501-78 ESPD. استمارة. متطلبات المحتوى والتصميم.
  15. GOST 19.502-78 ESPD. وصف التطبيق. متطلبات المحتوى والتصميم.
  16. GOST 19.503-79 ESPD. دليل مبرمج النظام. متطلبات المحتوى والتصميم.
  17. GOST 19.504-79 ESPD. دليل المبرمج.
  18. GOST 19.505-79 ESPD. دليل المشغل.
  19. GOST 19.506-79 ESPD. وصف اللغة.
  20. GOST 19.508-79 ESPD. مرشد اعمال صيانة. متطلبات المحتوى والتصميم.
  21. GOST 19.604-78 ESPD. قواعد لإجراء تغييرات على مستندات البرنامج التي تتم طباعتها.
  22. GOST 19.701-90 ESPD. مخططات الخوارزميات والبرامج والبيانات والأنظمة. الاتفاقيات وقواعد التنفيذ.
  23. GOST 19.781-90. توفير برمجيات نظم معالجة المعلومات.

المصطلحات والتعريفات

من بين جميع معايير ESPD ، سنركز فقط على تلك التي يمكن استخدامها كثيرًا في الممارسة العملية.

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

GOST (ST SEV) 19.201-78 (1626-1679). ESPD. مهمة فنية. متطلبات المحتوى والتصميم. (أعيد إصداره في نوفمبر 1987 مع المراجعة 1).

تحتوي الشروط المرجعية (TOR) على مجموعة من متطلبات PS ويمكن استخدامها كمعيار للتحقق من البرنامج المطور وقبوله. لذلك ، تم تجميعه بالكامل (مع الأخذ في الاعتبار إمكانية إدخال أقسام إضافية) ومقبول من قبل العميل والمطور ، يعتبر TOR أحد المستندات الأساسية لمشروع PS.

يجب أن تحتوي الاختصاصات على الأقسام التالية:

  • المقدمة؛
  • أسباب التنمية؛
  • الغرض من التنمية ؛
  • متطلبات البرنامج أو منتج البرنامج ؛
  • متطلبات توثيق البرامج;
  • المؤشرات الفنية والاقتصادية.
  • مراحل ومراحل التطوير ؛
  • إجراءات المراقبة والقبول ؛
  • في مهمة فنيةمسموح بالتطبيقات.

اعتمادًا على ميزات البرنامج أو منتج البرنامج ، يُسمح بتوضيح محتوى الأقسام أو إدخال أقسام جديدة أو دمج بعضها.

المعيار التالي
GOST (ST SEV) 19.101-77 (1626-1679). ESPD. أنواع البرامج ووثائق البرنامج (أعيد إصدارها في نوفمبر 1987 مع المراجعة 1).
يحدد أنواع البرامج ووثائق البرامج لأجهزة الكمبيوتر والمجمعات والأنظمة بغض النظر عن الغرض منها ونطاقها.

أنواع البرامج

أنواع وثائق السياسة

نوع وثيقة السياسة

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

أنواع المستندات التشغيلية

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

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

اعتمادًا على طريقة التنفيذ وطبيعة التطبيق ، يتم تقسيم مستندات البرنامج إلى نسخة أصلية ومكررة ونسخة (GOST 2.102-68) ، مخصصة لتطوير البرنامج وصيانته وتشغيله.

أنواع وثائق البرنامج التي تم تطويرها في مراحل مختلفة ورموزها

رمز نوع الوثيقة نوع المستند مراحل التطور
التصميم الأولي مشروع تقني مشروع العمل
مكون مركب
- تخصيص - - ! +
05 قائمة الحائزين الأصليين - - - ?
12 نص البرنامج - - + ?
13 وصف البرنامج - - ? ?
20 بيان الوثائق التشغيلية - - ? ?
30 استمارة - - ? ?
31 وصف التطبيق - - ? ?
32 دليل مبرمج النظام - - ? ?
33 دليل المبرمج - - ? ?
34 دليل المشغل - - ? ?
35 وصف اللغة - - ? ?
46 دليل الخدمة - - ? ?
51 برنامج الاختبار ومنهجيته - - ? ?
81 ملاحظة توضيحية ? ? - -
90-99 وثائق أخرى ? ? ? ?

يجوز الجمع أنواع معينةالمستندات التشغيلية (باستثناء بيان المستندات التشغيلية والنموذج). يشار إلى الحاجة إلى دمج هذه الوثائق في الاختصاصات. يتم تعيين اسم وتعيين أحد المستندات المدمجة للمستند المدمج. يجب أن تحتوي المستندات المدمجة على المعلومات التي يجب تضمينها في كل مستند مدمج.

GOST 19.102-77. ESPD. مراحل التطور.

يحدد مراحل تطوير البرامج وتوثيق البرامج لأجهزة الكمبيوتر والمجمعات والأنظمة بغض النظر عن الغرض منها ونطاقها

مراحل التطور ومراحل ومحتوى العمل

مراحل التطور

مراحل العمل

مهمة فنية الأساس المنطقي للحاجة إلى تطوير البرنامج صياغة المشكلة.
مجموعة من المواد المصدر.
اختيار وتبرير معايير فعالية وجودة البرنامج المطور.
تبرير الحاجة إلى العمل البحثي.
عمل بحثي تحديد هيكل بيانات الإدخال والإخراج.
الاختيار الأولي لطرق حل المشكلات.
تبرير ملاءمة استخدام البرامج المطورة مسبقًا.
تحديد متطلبات الوسائل التقنية.
تبرير الاحتمال الأساسي لحل المشكلة.
تطوير واعتماد الاختصاصات تحديد متطلبات البرنامج.
تطوير دراسة جدوى لتطوير البرنامج.
التعريف بمراحل ومراحل وشروط تطوير البرنامج وتوثيقه.
اختيار لغات البرمجة.
تحديد الحاجة للعمل البحثي في ​​المراحل اللاحقة.
التنسيق والموافقة على الاختصاصات.
التصميم الأولي تطوير مشروع التصميم التطوير الأولي لهيكل بيانات المدخلات والمخرجات.
صقل طرق حل المشكلة.
تطوير وصف عامخوارزمية حل المشكلات.
تطوير دراسة الجدوى.
الموافقة على تصميم المفهوم
تنسيق واعتماد مشروع التصميم
مشروع تقني تطوير مشروع تقني صقل هيكل بيانات المدخلات والمخرجات.
تطوير خوارزمية لحل المشكلة.
تحديد شكل تمثيل بيانات المدخلات والمخرجات.
تعريف دلالات اللغة ونحوها.
تطوير هيكل البرنامج.
التعريف النهائي لتكوين الأجهزة.
الموافقة على المشروع الفني وضع خطة عمل لتطوير وتنفيذ البرامج.
تطوير مذكرة توضيحية.
التنسيق والموافقة على المشروع الفني.
مشروع العمل تطوير البرنامج برمجة وتصحيح البرنامج
تطوير وثائق البرنامج تطوير وثائق البرنامج وفقًا لمتطلبات GOST 19.101-77.
تجارب البرنامج تطوير وتنسيق واعتماد البرنامج وطرق الاختبار.
إجراء اختبارات الحالة الأولية والاختبارات المشتركة بين الأقسام والقبول وأنواع أخرى من الاختبارات.
تصحيح وثائق البرنامج والبرنامج بناءً على نتائج الاختبار.
تطبيق اعداد ونقل البرنامج إعداد ونقل وثائق البرنامج والبرنامج للصيانة و (أو) الإنتاج.
تسجيل واعتماد قانون نقل برنامج الصيانة و (أو) الإنتاج.
تحويل البرنامج إلى صندوق الخوارزميات والبرامج.

ملحوظات:

  1. يُسمح باستبعاد المرحلة الثانية من التطوير ، وفي الحالات المبررة تقنيًا - المرحلتان الثانية والثالثة. يشار إلى الحاجة إلى هذه المراحل في الاختصاصات.
  2. يُسمح بدمج واستبعاد مراحل العمل و (أو) محتواها ، وكذلك تقديم مراحل العمل الأخرى على النحو المتفق عليه مع العميل.

GOST 19.103-77 ESPD. تسمية البرامج ووثائق البرنامج

يتم تعيين رمز مطور الدولة ورمز مطور المؤسسة بالطريقة المحددة.

  • يتم تعيين رقم التسجيل بترتيب تصاعدي ، بدءًا من 00001 إلى 99999 ، لكل منظمة تطوير.
  • رقم إصدار البرنامج أو رقم المراجعة. رقم المستند من هذا النوع ، يتم تعيين رقم جزء المستند بترتيب تصاعدي من 01 إلى 99. (إذا كان المستند يتكون من جزء واحد ، فلن تتم الإشارة إلى الواصلة والرقم التسلسلي للجزء).
  • يجب أن يتطابق رقم إصدار المواصفات وبيان المستندات التشغيلية للبرنامج مع رقم إصدار البرنامج نفسه.

GOST 19.105-78 ESPD. المتطلبات العامة لوثائق البرنامج

يحدد هذا المعيار المتطلبات العامة لتنفيذ مستندات البرنامج لأجهزة الكمبيوتر والمجمعات والأنظمة ، بغض النظر عن الغرض منها ونطاقها ووفقًا لمعايير نظام توثيق البرنامج الموحد (ESPD) لأي طريقة لتنفيذ المستندات على ناقلات البيانات المختلفة.

يمكن تقديم وثيقة البرنامج على أنواع مختلفة من ناقلات البيانات وتتكون من الأجزاء الشرطية التالية:
لقب؛
معلوماتية؛
أساسي.

يتم تحديد قواعد إعداد المستند وأجزائه على كل ناقل بيانات بواسطة معايير ESPD لقواعد إعداد المستندات على ناقلات البيانات المقابلة.

GOST 19.106-78 ESPD. متطلبات وثائق البرنامج في شكل مطبوع

يتم إعداد وثائق البرنامج:

  • على أوراق A4 (GOST 2.301-68) عند إعداد مستند مكتوب على الآلة الكاتبة أو بخط اليد ؛
  • يُسمح بالتسجيل على أوراق بتنسيق A3 ؛
  • باستخدام طريقة الآلة في تنفيذ المستندات ، يُسمح بالانحرافات في حجم الأوراق المقابلة لتنسيقات A4 و A3 ، والتي تحددها إمكانيات الوسائل التقنية المستخدمة ؛ على أوراق تنسيقات A4 و A3 ، المنصوص عليها في خصائص الإخراج لأجهزة إخراج البيانات ، عند عمل مستند بواسطة الجهاز ؛
  • على أوراق من التنسيقات المطبعية عند عمل مستند بطريقة مطبعية.

يتم تنفيذ موقع مواد وثيقة البرنامج بالتسلسل التالي:

جزء العنوان:

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

يتم عمل قائمة المصطلحات وتعريفاتها ، قائمة الاختصارات ، الملاحق ، فهرس الموضوع ، قائمة الوثائق المرجعية إذا لزم الأمر.

يركز المعيار التالي على توثيق منتج التطوير الناتج:

GOST 19.402-78 ESPD. وصف البرنامج

يمكن استكمال تكوين وثيقة "وصف البرنامج" في محتواها بأقسام وفقرات مأخوذة من معايير الوثائق والمبادئ التوجيهية الوصفية الأخرى: GOST 19.404-79 ESPD. ملاحظة توضيحية ، GOST 19.502-78 ESPD. وصف التطبيق GOST 19.503-79 ESPD. دليل مبرمج النظام ، GOST 19.504-79 ESPD. دليل المبرمج ، GOST 19.505-79 ESPD. دليل المشغل.

هناك أيضًا مجموعة من المعايير التي تحدد متطلبات إصلاح مجموعة البرامج الكاملة و PD التي تم إصدارها لنقل PS. إنها تنشئ مستندات محاسبية موجزة ويمكن أن تكون مفيدة في تبسيط الاقتصاد الكامل للبرامج و PD (بعد كل شيء ، غالبًا ما تحتاج فقط إلى ترتيب الأمور!). هناك أيضًا معايير تحدد قواعد الاحتفاظ بالمستندات في "اقتصاد" PS.

يجب علينا أيضا تسليط الضوء

GOST 19.301-79 ESPD. برنامج ومنهجية الاختبار ، والتي (في شكل مُعدّل) يمكن استخدامها لتطوير وثائق التخطيط وإجراء اختبار العمل لتقييم جاهزية PS وجودتها.

أخيرًا ، العام الأخير من اعتماد المعيار.

GOST 19.701-90 ESPD. مخططات الخوارزميات والبرامج والبيانات والأنظمة. التعيينات الرسومية الشرطية وقواعد التنفيذ.

يضع قواعد تنفيذ الرسوم البيانية المستخدمة لتمثيل أنواع مختلفة من مهام معالجة البيانات ووسائل حلها ، ويتوافق تمامًا مع ISO 5807: 1985.

إلى جانب ESPD على المستوى بين الولايات ، هناك معياران آخران مرتبطان أيضًا بتوثيق PS وتم اعتمادهما منذ وقت ليس ببعيد ، مثل معظم GOST ESPD.

GOST 19781-90 توفير برمجيات لأنظمة معالجة المعلومات. المصطلحات والتعريفات. تم تطويره ليحل محل GOST 19.781-83 و GOST 19.004-80 ويحدد المصطلحات والتعريفات للمفاهيم في مجال البرمجيات (البرمجيات) لأنظمة معالجة البيانات (DPS) المستخدمة في جميع أنواع الوثائق والمؤلفات المدرجة في نطاق عمل التقييس أو باستخدام نتائج هذه الأعمال.

GOST 28388-89 أنظمة معالجة المعلومات. وثائق حاملات البيانات المغناطيسية. ترتيب التنفيذ والمناولة. لا تنطبق فقط على البرامج ، ولكن أيضًا على التصميم ووثائق التصميم التكنولوجية وغيرها من وثائق التصميم المنفذة على وسائط مغناطيسية.

2.2. معايير GOST 34 المعقدة

تم تصميم GOST 34 في أواخر الثمانينيات كمجموعة شاملة من الوثائق المترابطة المشتركة بين القطاعات. الدوافع والنتائج التي تم الحصول عليها موصوفة أدناه في "ميزات" GOST 34. أهداف التوحيد هي من أنواع مختلفة (أي!) وجميع أنواع مكوناتها ، وليس فقط البرامج وقواعد البيانات.

تم تصميم المجمع للتفاعل بين العميل والمطور. على غرار ISO12207 ، يشترط أن يتمكن العميل من تطوير AS لنفسه (إذا أنشأ قسمًا متخصصًا لهذا الغرض). ومع ذلك ، فإن صياغة GOST 34 لا تركز على مثل هذا الانعكاس الصريح ، وإلى حد ما ، متماثل لأفعال كلا الطرفين ، مثل ISO12207. نظرًا لأن GOST 34 يركز بشكل أساسي على محتوى وثائق المشروع ، فإن توزيع الإجراءات بين الأطراف يتم عادةً بناءً على هذا المحتوى.

من بين جميع مجموعات المستندات الموجودة والتي لم يتم تنفيذها ، سنستند فقط إلى المجموعة 0 "الأحكام العامة" والمجموعة 6 "إنشاء وتشغيل وتطوير AS". يمكن اعتبار المعايير الأكثر شيوعًا GOST 34.601-90 (مراحل إنشاء NPP) و GOST 34.602-89 (TOR لإنشاء NPP) و القواعد الارشادية RD 50-34.698-90 (متطلبات محتوى المستندات). تنص المعايير على مراحل ومراحل العمل لإنشاء عامل تشغيل AS ، ولكنها لا تنص صراحةً على عمليات شاملة.

بالنسبة للحالة العامة لتطوير NPP ، يتم عرض مراحل ومراحل GOST 34 في الجدول:

1. FT - تشكيل متطلبات الاتحاد الأفريقي. 1.1 التفتيش على المرفق وتبرير الحاجة إلى إنشاء وحدة مفصلية ؛
1.2 تشكيل متطلبات المستخدم للاتحاد الأفريقي ؛
1.3 تسجيل تقرير عن العمل المنجز وتطبيق لتطوير الاتحاد الأفريقي (المواصفات التكتيكية والفنية) ؛
2. RK - تطوير مفهوم الاتحاد الأفريقي. 2.1. دراسة الكائن
2.2. القيام بالأعمال البحثية اللازمة.
2.3 تطوير متغيرات مفهوم AU التي تلبي متطلبات المستخدم
2.4 إعداد تقرير عن الأعمال المنجزة
3. المعارف التقليدية - الإبداع التقني للاتحاد الأفريقي. 3.1. تطوير واعتماد اختصاصات المهمة.
4. EP - مشروع تصميم. 4.1 تطوير حلول التصميم الأولية للنظام وأجزائه ؛
4.2 تطوير وثائق الاتحاد الأفريقي وأجزائه.
5. TP - التصميم الفني. 5.1 تطوير حلول التصميم للنظام وأجزائه ؛
5.2 تطوير وثائق NPP وأجزائها ؛
5.3 تطوير وتنفيذ وثائق توريد المنتجات لاقتناء محطات الطاقة النووية و / أو متطلبات تقنية(المواصفات الفنية) لتطويرها ؛
5.4. تطوير مهام التصميم في الأجزاء المجاورة لمشروع كائن الأتمتة.
6. RD - وثائق العمل. 6.1 تطوير وثائق العمل للنظام وأجزائه ؛
6.2 تطوير أو تكييف البرامج.
7. VD - التكليف. 7.1 إعداد كائن الأتمتة لتشغيل الاتحاد الأفريقي ؛
7.2 تدريب الموظفين ؛
7.3. مجموعة كاملة من مكبرات الصوت مع المنتجات الموردة (البرامج و الوسائل التقنيةوأنظمة البرمجيات والأجهزة ومنتجات المعلومات) ؛
7.4. أعمال البناء والتركيب.
7.5 أعمال التكليف
7.6. إجراء الاختبارات الأولية ؛
7.7 إجراء عملية تجريبية ؛
7.8 إجراء اختبارات القبول.
8. س - مرافقة المتحدثين. 8.1 أداء العمل وفقًا لالتزامات الضمان ؛
8.2 خدمة ما بعد الضمان.

يتم وصف محتوى الوثائق التي تم تطويرها في كل مرحلة. يحدد هذا إمكانية الفصل ، على مستوى المحتوى ، العمل الشامل الذي يتم تنفيذه بالتوازي أو بالتتابع (أي في الواقع - العمليات) والمهام المكونة لها. يمكن استخدام مثل هذه التقنية عند إنشاء ملف تعريف لمعايير دورة حياة المشروع ، والذي يتضمن مجموعات فرعية متفق عليها من معايير GOST 34 و ISO12207.

الدافع الرئيسي: حل مشكلة "برج بابل".

في الثمانينيات ، نشأ الوضع الذي مختلف الصناعاتومجالات النشاط ، سوء التنسيق أو عدم الاتساق NTD - تم استخدام "التوثيق المعياري والفني". هذا جعل من الصعب دمج الأنظمة وضمان عملها المشترك الفعال. كانت هناك العديد من المجمعات وأنظمة المعايير التي حددت متطلبات أنواع مختلفةكما.

أظهرت ممارسة تطبيق المعايير أنها تستخدم أساسًا (ولكن ليس وفقًا لتعريفات صارمة) نظامًا واحدًا من المفاهيم ، وهناك العديد من الأشياء المشتركة للتوحيد القياسي ، ومع ذلك ، لا يتم تنسيق متطلبات المعايير فيما بينها ، فهناك اختلافات في تكوين ومحتوى الأعمال ، والاختلافات في التعيين والتكوين والمحتوى وتنسيق المستندات ، إلخ.

بالطبع ، يعكس هذا الموقف جزئيًا التنوع الطبيعي لشروط تطوير AS ، وأهداف المطورين ، والنهج والأساليب المستخدمة.

في ظل هذه الظروف ، كان من الممكن تحليل مثل هذا التنوع ثم المضي قدمًا ، على سبيل المثال ، بإحدى طريقتين متعارضتين إلى حد كبير:

  1. تطوير نظام مفاهيمي ومصطلحي معمم ، وخطة تطوير عامة ، ومجموعة مشتركة من الوثائق بمحتواها وتعريفها على أنها إلزامية لجميع الاتحادات الموحدة ؛
  2. حدد أيضًا نظامًا مفاهيميًا ومصطلحيًا مشتركًا ، وهو مجمع معمم متطلبات النظام، مجموعة من معايير الجودة ، ولكنها توفر أقصى قدر من الحرية في اختيار مخطط التطوير ، وتكوين المستندات والجوانب الأخرى ، وفرض حد أدنى فقط متطلبات الزاميةمن شأنه أن يسمح:
    • تحديد مستوى جودة النتيجة ؛
    • اختيار تلك الأساليب المحددة (مع نماذج دورة حياتها ، ومجموعة من المستندات ، وما إلى ذلك) الأكثر ملاءمة لظروف التطوير وتتوافق مع تقنيات المعلومات المستخدمة ؛
    • العمل ، وبالتالي ، مع الحد الأدنى من القيود على الإجراءات الفعالة لمصمم NPP.

اختار مطورو مجموعة المعايير 34 طريقة قريبة من أول ما سبق ، أي أنهم اتخذوا مسارًا أقرب إلى مخططات طرق محددة من معايير مثل ISO12207. ومع ذلك ، بسبب القواسم المشتركة للقاعدة المفاهيمية ، تظل المعايير قابلة للتطبيق في مجموعة واسعة جدًا من الحالات.

يتم تحديد درجة القدرة على التكيف رسميًا من خلال الاحتمالات:

  • حذف مرحلة التصميم الأولي والجمع بين مراحل "التصميم الفني" و "التوثيق التفصيلي" ؛
  • حذف الخطوات ودمج وحذف معظم المستندات وأقسامها ؛
  • أدخل مستندات إضافيةوأقسام الوثائق والعمل.
  • ديناميكيًا إنشاء ما يسمى ب. CHTZ - الاختصاصات الخاصة - إنه مرن تمامًا لتشكيل دورة حياة AS ؛ كقاعدة عامة ، يتم استخدام هذه التقنية على مستوى الوحدات الكبيرة (الأنظمة الفرعية والمجمعات) ، والتي من أجلها يعتبر إنشاء CTZ مبررًا ، ولكن لا توجد أسباب مهمة للحد بشدة من هذه الطريقة في إدارة دورة الحياة .

المراحل والمراحل التي تقوم بها المنظمات - يتم تحديد المشاركين في إنشاء الاتحاد الأفريقي في العقود والاختصاصات ، وهي قريبة من نهج ISO.

من المؤكد أن إدخال مصطلح واحد محدد نوعيًا ووجود تصنيف معقول بدرجة كافية للمصنفات والوثائق وأنواع الدعم وما إلى ذلك. يساهم GOST 34 في إرساء أكثر اكتمالاً وعالية الجودة لأنظمة مختلفة حقًا ، وهو أمر مهم بشكل خاص في بيئة يتم فيها تطوير أنظمة متكاملة أكثر وأكثر تعقيدًا ، على سبيل المثال ، من نوع CAD-CAM ، والتي تتضمن التحكم في العملية نظام ، نظام تحكم آلي ، مصمم CAD ، تقني CAD ، ASNI وأنظمة أخرى.

تم تحديد العديد من الأحكام الهامة التي تعكس ميزات AS كهدف للتوحيد القياسي ، على سبيل المثال: "في الحالة العامة ، يتكون AS من البرامج والأجهزة (PTC) ، والمجمعات البرمجية والمنهجية (PMC) والمكونات الفردية لـ الدعم التنظيمي والتقني والبرمجيات والمعلوماتية ".

أدى الفصل بين مفاهيم PTK و AS إلى توحيد المبدأ الذي يقضي بأن AS ليس "IS مع قاعدة بيانات" ، ولكن:

  • "النظام التنظيمي والتقني الذي يوفر تطوير الحلول القائمة على الأتمتة عمليات المعلوماتفي مختلف مجالات النشاط (الإدارة والتصميم والإنتاج وما إلى ذلك) أو مجموعاتها "(وفقًا لـ RD 50-680-88) ، وهو أمر مهم بشكل خاص في جوانب إعادة هندسة الأعمال ؛
  • "نظام يتكون من موظفين ومجموعة من الوسائل لأتمتة أنشطته ، وتنفيذ تكنولوجيا المعلومات لأداء الوظائف المحددة" (وفقًا لـ GOST 34.003-90).

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

الدرجة الإجبارية:

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

الوثيقة الرئيسية للتفاعل بين الأطراف هي الاختصاصات - الاختصاصات لإنشاء AS. المعارف التقليدية هو الرئيسي مصدر وثائقمن أجل إنشاء الاتحاد الأفريقي وقبوله ، تحدد الشروط المرجعية أهم نقاط التفاعل بين العميل والمطور. في الوقت نفسه ، تم تطوير TOR بواسطة منظمة المطورين (وفقًا لـ GOST 34.602-89) ، لكن العميل يصدر رسميًا TOR للمطور (وفقًا لـ RD 50-680-88).

2.3 معايير الدولة للاتحاد الروسي (GOST R)

في الاتحاد الروسي ، هناك عدد من المعايير من حيث توثيق PS ، تم تطويرها على أساس التطبيق المباشر لمعايير ISO الدولية. هو - هي؟ أحدث المعايير بحلول وقت اعتمادها. بعضها موجه مباشرة إلى مديري المشاريع أو مديري خدمات المعلومات. ومع ذلك ، فهي غير معروفة بشكل غير معقول بين المهنيين. هنا هو عرضهم.

GOST R ISO / IEC 9294-93تكنولوجيا المعلومات. دليل إدارة وثائق البرامج. يتوافق المعيار تمامًا مع المعيار الدولي ISO / IEC TO 9294: 1990 ويضع توصيات لـ حكم جيدتوثيق PS للمديرين المسؤولين عن إنشائها. الغرض من المعيار هو المساعدة في تحديد استراتيجية لتوثيق نظام التشغيل ؛ اختيار معايير التوثيق ؛ اختيار إجراءات التوثيق ؛ تحديد الموارد اللازمة ؛ وضع خطط التوثيق.

GOST R ISO / IEC 9126-93تكنولوجيا المعلومات. تقييم منتجات البرمجيات. خصائص الجودة والمبادئ التوجيهية لاستخدامها. يتوافق المعيار تمامًا مع المعيار الدولي ISO / IEC 9126: 1991. في سياقها ، تُفهم خاصية الجودة على أنها "مجموعة من خصائص (سمات) منتج برمجي ، يتم بموجبها وصف وتقييم جودته". يحدد المعيار ست خصائص معقدة تصف جودة PS (البرامج ومنتجات البرامج) بأقل قدر من الازدواجية: وظائف؛ الموثوقية؛ التطبيق العملي. نجاعة؛ قابلية الصيانة؛ إمكانية التنقل. تشكل هذه الخصائص الأساس لمزيد من التنقيح ووصف جودة PS.

GOST R ISO 9127-94نظم معالجة المعلومات. وثائق المستخدم ومعلومات التعبئة والتغليف لحزم برامج المستهلك. يتوافق المعيار تمامًا مع المعيار الدولي ISO 9127: 1989. لأغراض هذه المواصفة القياسية الدولية ، يتم تعريف حزمة برامج المستهلك (SP) على أنها "منتج برمجي مصمم وبيعه لأداء وظيفة معينة ؛ برنامج والوثائق المرتبطة به معبأة للبيع كوحدة". تُفهم وثائق المستخدم على أنها وثائق تزود المستخدم النهائي بمعلومات عن تثبيت البرنامج وتشغيله. تُفهم المعلومات الموجودة على العبوة على أنها المعلومات المستنسخة على العبوة الخارجية لـ PP. والغرض منه هو تزويد المشترين المحتملين بالمعلومات الأولية حول PP.

GOST R ISO / IEC 8631-94تكنولوجيا المعلومات. يبني البرنامج و الاتفاقياتلعرضهم. يصف تمثيل الخوارزميات الإجرائية.

2.4 المعيار الدولي ISO / IEC 12207: 1995-08-01

تم إعداد الإصدار الأول من ISO12207 في عام 1995 من قبل اللجنة الفنية المشتركة ISO / IEC JTC1 " تكنولوجيا المعلومات، اللجنة الفرعية SC7 ، هندسة البرمجيات ".

بحكم التعريف ، ISO12207 هو المعيار الأساسي لعمليات دورة حياة البرامج ، ويركز على أنواع مختلفة (أي!) من البرامج وأنواع مشاريع AS ، حيث يتم تضمين البرامج كجزء. المعيار يحدد الاستراتيجية و ترتيب عامفي إنشاء وتشغيل البرنامج ، فإنه يغطي دورة حياة البرنامج من وضع تصور للأفكار إلى إكمال دورة الحياة.

ملاحظات معيارية مهمة جدًا:

  1. يجب أن تكون العمليات المستخدمة أثناء دورة حياة البرنامج متوافقة مع العمليات المستخدمة أثناء دورة حياة البرنامج AS. (ومن ثم ، فإن ملاءمة الاستخدام المشترك لمعايير AS والبرمجيات واضحة.)
  2. يجب الاتفاق على إضافة عمليات وأنشطة ومهام فريدة أو محددة في العقد المبرم بين الطرفين. يُفهم العقد بالمعنى الواسع: من العقد القانوني إلى الاتفاق غير الرسمي ، يمكن تعريف الاتفاقية من قبل طرف واحد كمهمة محددة لنفسه.
  3. لا يحتوي المعيار بشكل أساسي على طرق عمل محددة ، خاصة - إعداد الحلول أو التوثيق. يصف بنية عمليات دورة حياة البرنامج ، لكنه لا يحدد بالتفصيل كيفية تنفيذ أو أداء الخدمات والمهام المضمنة في العمليات ، ولا يقصد به وصف اسم أو تنسيق أو محتوى دقيق للوثائق الناتجة. يتم اتخاذ قرارات من هذا النوع باستخدام المعيار.

التعاريف القياسية:

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

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

يركز معيار ISO12207 بشكل متساوٍ على تنظيم إجراءات كل من الطرفين: المورد (المطور) والمشتري (المستخدم) ؛ يمكن تطبيقها بالتساوي عندما يكون كلا الطرفين من نفس المنظمة.

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

يصف معيار ISO12207:

  1. 5 عمليات رئيسية لدورة حياة البرنامج:
    • عملية الاستحواذ. يحدد إجراءات المؤسسة الشرائية التي تحصل على AS أو منتج برمجي أو خدمة برمجية.
    • عملية التسليم. يحدد أنشطة المؤسسة الموردة التي تزود العميل بنظام أو منتج برمجي أو خدمة برمجية.
    • عمليات التطوير. يحدد إجراءات مطور المؤسسة ، الذي يطور مبدأ إنشاء منتج برمجي ومنتج برمجي.
    • عملية التشغيل. يحدد إجراءات مؤسسة المشغل ، والتي توفر صيانة النظام (وليس فقط البرنامج) أثناء تشغيله لصالح المستخدمين. على عكس الإجراءات التي يحددها المطور في تعليمات التشغيل (يتم توفير هذا النشاط للمطور في المعايير الثلاثة قيد النظر) ، فإن إجراءات المشغل لاستشارة المستخدمين ، وتلقي التعليقات ، وما إلى ذلك ، والتي يخطط لها نفسه ويتولى المسؤوليات المقابلة ، عازمون.
    • عملية المتابعة. يحدد إجراءات موظفي الصيانة الذين يقدمون صيانة منتج البرنامج ، وهو إدارة تعديلات منتج البرنامج ، والحفاظ على حالته الحالية وملاءمته الوظيفية ، بما في ذلك تثبيت منتج البرنامج وإزالته على نظام الكمبيوتر.
  2. 8 عمليات مساعدة تدعم تنفيذ عملية أخرى ، كونها جزءًا لا يتجزأ من دورة الحياة الكاملة لمنتج البرنامج ، وتضمن الجودة المناسبة لمشروع البرنامج:
    • حل المشكلة؛
    • توثيق؛
    • إدارة التكوين؛
    • ضمان الجودة ، والذي يستخدم نتائج العمليات المتبقية لفريق ضمان الجودة والتي تشمل:
      • عملية التحقق؛
      • عملية التصديق
      • عملية التقييم المشتركة ؛
      • عملية التدقيق.
  3. 4 عمليات تنظيمية:
    • عملية الادارة؛
    • عملية إنشاء البنية التحتية ؛
    • عملية التحسين
    • عملية التعلم.

ويلي ذلك عملية تفصيل محددة تحدد الخطوات الرئيسية المطلوبة لتكييف المعيار وفقًا لظروف مشروع معين.

لا تُفهم عملية التحسين هنا على أنها تحسين AS أو البرنامج ، ولكن تحسين عمليات الاستحواذ والتطوير وضمان الجودة وما إلى ذلك ، التي يتم تنفيذها فعليًا في المنظمة.

لا توجد مراحل أو مراحل أو مراحل ، مما يعطي درجة القدرة على التكيف الموضحة أدناه.

يتم تحديد الطبيعة "الديناميكية" للمعيار من خلال طريقة تسلسل العمليات والمهام ، حيث تستدعي إحدى العمليات الأخرى ، أو جزء منها ، حسب الحاجة.

  • قد يؤدي تنفيذ عملية الاستحواذ من حيث تحليل وتحديد متطلبات النظام أو البرنامج إلى تنفيذ المهام المقابلة لعملية التطوير ؛
  • في عملية التوريد ، يجب على المورد إدارة المقاولين من الباطن وفقًا لعملية الاستحواذ وإجراء التحقق والتأهيل مقابل العمليات ذات الصلة ؛
  • قد تتطلب الصيانة تطوير النظام والبرمجيات ، والتي تتم في إطار عملية التطوير.

تسمح لك هذه الشخصية بتنفيذ أي نموذج لدورة الحياة.

هناك 11 فئة من خصائص الجودة في تحليل متطلبات البرامج التي يتم استخدامها لاحقًا في ضمان الجودة.

عند القيام بذلك ، يجب على المطور إنشاء وتوثيق كمتطلبات برمجية:

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

    (من المثير للاهتمام والمهم أن تتوافق هذه الخصائص وما شابهها بشكل جيد مع خصائص الاتحاد الأفريقي ، المنصوص عليها في GOST 34 حسب نوع دعم النظام.)

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

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

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

لهذا السبب ، من المفيد اعتبار ISO12207 كمعيار مركزي ، يتم اعتبار أحكامه بمثابة مجموعة "أساسية" أولية من الأحكام في عملية بناء ملف مواصفات معايير LC لمشروع معين. هذا "النواة" يمكن أن يحدد البرنامج ونموذج دورة حياة AS ، مفهوم ضمان الجودة ، نموذج إدارة المشروع

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

في الوقت الحالي ، أعد معهد أبحاث المعايير لعموم روسيا مقترحات لتحسين وتطوير مجموعة من المعايير لتوثيق PS.

معلومات مرجعية

لشراء المعايير في مجال التوثيق ، نوصي بالاتصال بالمنظمات التالية:

    IPK "دار نشر المعايير"، قسم التوزيع الإقليمي لـ NTD (متجر "المعايير") ، 17961 ، موسكو ، شارع. دونسكايا ، د .8 ، هاتف. 236-50-34 ، 237-00-02 ، فاكس / هاتف. 236-34-48 (بخصوص GOST و GOST R).