التعيينات في البرنامج. مخططات الخوارزميات والبرامج ، والتسميات الرسومية الشرطية

GOST 19.701-90
(ISO 5807-85)

المجموعة T55

معيار الطريق السريع

نظام موحد لتوثيق البرنامج

مخططات الخوارزميات والبرامج والبيانات والأنظمة

التعيينات الشرطية وقواعد التنفيذ

النظام الموحد لتوثيق البرنامج. مخططات تدفق البيانات والبرنامج والنظام ومخططات شبكة البرامج ومخططات موارد النظام. رموز التوثيق واصطلاحات الخرائط الانسيابية

ISS 35.080 *
OKSTU 5004

____________________
* في فهرس "المواصفات الوطنية" 2012
ISS 01.080.50 و 35.080. - ملاحظة من الشركة المصنعة لقاعدة البيانات.

تاريخ التقديم 1992-01-01

بيانات المعلومات

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

المطورون

أ.مكرتوميان (مدير التطوير) ؛ ال شيرز ، د. تقنية. علوم؛ إيه إن سيروتكين ، كاند. IST. علوم؛ إل دي رايكوف ، كاند. تقنية. علوم؛ أ في لوبوفا ؛ مجموعة العمل المشتركة بين الإدارات على تطوير معايير ESPD

2 - تمت الموافقة عليها ووضعها موضع التنفيذ بموجب مرسوم لجنة الدولة لاتحاد الجمهوريات الاشتراكية السوفياتية بشأن إدارة جودة المنتجات والمعايير المؤرخ 26 كانون الأول / ديسمبر 1990 N 3294

3. تم تطوير هذا المعيار من خلال طريقة التطبيق المباشر للمعيار الدولي ISO 5807-85 * "معالجة المعلومات. الرموز والمصطلحات الخاصة بمخططات كتلة البيانات والبرامج والأنظمة ومخططات شبكات البرامج وموارد النظام"
________________
* يمكن الوصول إلى المستندات الدولية والأجنبية المذكورة في النص عن طريق الاتصال بخدمة دعم المستخدم. - ملاحظة من الشركة المصنعة لقاعدة البيانات.

4. استبدال GOST 19.002-80 ، GOST 19.003-80

5. الجمهورية. يناير 2010


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

لا ينطبق المعيار على شكل السجلات والرموز الموضوعة داخل أو بالقرب من الرموز وتخدم لتوضيح الوظائف التي يؤدونها.

متطلبات المعيار إلزامية.

1. أحكام عامة

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

1.1 تتكون مخططات الخوارزميات والبرامج والبيانات والأنظمة (المشار إليها فيما يلي باسم الرسوم البيانية) من رموز ذات معنى معين ونص توضيحي قصير وخطوط متصلة.

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

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

1) مخططات البيانات ؛

2) مخططات البرنامج ؛

3) مخططات النظام ؛

4) مخططات تفاعل البرنامج ؛

5) مخططات موارد النظام.

1.4 يستخدم المعيار المفاهيم التالية:

1) الرمز الرئيسي - رمز يُستخدم في الحالات التي يكون فيها النوع (نوع) العملية أو ناقل البيانات الدقيق غير معروف أو لا توجد حاجة لوصف ناقل البيانات الفعلي ؛

2) رمز محدد - رمز يُستخدم في الحالات التي يُعرف فيها النوع الدقيق (نوع) العملية أو ناقل البيانات ، أو عندما يكون من الضروري وصف ناقل البيانات الفعلي ؛

3) الرسم البياني - تمثيل رسومي لتعريف أو تحليل أو طريقة لحل مشكلة تستخدم الرموز لتمثيل العمليات والبيانات والتدفق والمعدات وما إلى ذلك.

2. وصف المخططات

2.1. مخطط البيانات

2.1.1. مخططات البيانات ترسم مسار البيانات من خلال حل المشكلات وتحديد خطوات المعالجة بالإضافة إلى وسائط التخزين المختلفة المستخدمة.

2.1.2. يتكون مخطط البيانات من:

1) رموز البيانات (يمكن أن تشير رموز البيانات أيضًا إلى نوع ناقل البيانات) ؛

2) رموز العملية التي يتعين إجراؤها على البيانات (يمكن أن تشير رموز العملية أيضًا إلى الوظائف التي يؤديها الكمبيوتر) ؛

3) رموز الخط التي تشير إلى تدفق البيانات بين العمليات و (أو) ناقلات البيانات ؛

2.1.3. تسبق رموز البيانات وتتبع رموز العملية. يبدأ مخطط البيانات وينتهي بأحرف البيانات (باستثناء الأحرف الخاصة المحددة في الفقرة 3.4).

2.2. مخطط البرنامج

2.2.1. مخططات البرنامج تمثل تسلسل العمليات في البرنامج.

2.2.2. يتكون مخطط البرنامج من:

1) رموز العملية التي تشير إلى عمليات معالجة البيانات الفعلية (بما في ذلك الرموز التي تحدد المسار الواجب اتباعه ، مع مراعاة الظروف المنطقية) ؛

2) رموز الخط التي تشير إلى التحكم في التدفق ؛

3) الأحرف الخاصة المستخدمة لتسهيل الكتابة والقراءة على الدائرة.

2.3 مخطط تشغيل النظام

2.3.1. تصور مخططات النظام التحكم في العمليات وتدفق البيانات في النظام.

2.3.2. يتكون مخطط تشغيل النظام من:

1) رموز البيانات التي تشير إلى وجود البيانات (قد تشير رموز البيانات أيضًا إلى نوع ناقل البيانات) ؛

2) رموز العملية التي تشير إلى العمليات التي سيتم إجراؤها على البيانات وكذلك تحديد المسار المنطقي الذي يجب اتباعه ؛

3) الرموز الخطية التي تشير إلى تدفق البيانات بين العمليات و (أو) ناقلات البيانات ، وكذلك التحكم في التدفق بين العمليات ؛

4) الأحرف الخاصة المستخدمة لتسهيل كتابة وقراءة المخطط الانسيابي.

2.4 مخطط تفاعل البرنامج

2.4.1. تُظهر مخططات تفاعل التطبيق مسار عمليات تنشيط التطبيق والتفاعلات مع البيانات المقابلة. يتم عرض كل برنامج في مخطط تفاعل البرنامج مرة واحدة فقط (في مخطط تشغيل النظام ، يمكن عرض البرنامج في أكثر من تدفق تحكم واحد).

2.4.2. يتكون مخطط تفاعل البرنامج من:

1) رموز البيانات التي تشير إلى وجود البيانات ؛

2) رموز العملية التي تشير إلى العمليات التي سيتم إجراؤها على البيانات ؛

3) الرموز الخطية التي تمثل التدفق بين العمليات والبيانات ، وكذلك بدء العمليات ؛

4) الأحرف الخاصة المستخدمة لتسهيل الكتابة والقراءة على الدائرة.

2.5 مخطط موارد النظام

2.5.1. تُظهر الرسوم التخطيطية لموارد النظام تكوين كتل البيانات وكتل المعالجة المطلوبة لحل مشكلة أو مجموعة من المهام.

2.5.2. يتكون مخطط موارد النظام من:

1) رموز البيانات التي تمثل أجهزة الإدخال والإخراج والتخزين للكمبيوتر ؛

2) رموز العملية التي تمثل المعالجات (وحدات المعالجة المركزية ، القنوات ، إلخ) ؛

3) الرموز الخطية التي تمثل نقل البيانات بين أجهزة الإدخال والإخراج والمعالجات ، وكذلك نقل التحكم بين المعالجات ؛

4) الأحرف الخاصة المستخدمة لتسهيل الكتابة والقراءة على الدائرة.

وترد أمثلة على تنفيذ المخططات في الملحق.

3. وصف الرموز

3.1 رموز البيانات

3.1.1. رموز البيانات الأساسية

3.1.1.1. البيانات

يعرض الرمز البيانات ، ولم يتم تعريف حامل البيانات.

3.1.1.2. البيانات المحفوظة

يعرض الرمز البيانات المخزنة في نموذج مناسب للمعالجة ، ولم يتم تعريف حامل البيانات.

3.1.2. رموز بيانات محددة

3.1.2.1. ذاكرة الوصول العشوائية

يعرض الرمز البيانات المخزنة في ذاكرة الوصول العشوائي.

3.1.2.2. تخزين متسلسل

يمثل الرمز البيانات المخزنة في جهاز تخزين متسلسل (شريط مغناطيسي ، شريط كاسيت ، شريط كاسيت).

3.1.2.3. جهاز تخزين الوصول المباشر

يمثل الرمز البيانات المخزنة في جهاز تخزين الوصول المباشر (قرص مغناطيسي ، أسطوانة مغناطيسية ، قرص مرن).

3.1.2.4. وثيقة

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

3.1.2.5. إدخال يدوي

يمثل الرمز البيانات التي تم إدخالها يدويًا أثناء المعالجة من أي نوع من الأجهزة (لوحة المفاتيح ، والمفاتيح ، والأزرار ، والقلم الضوئي ، وشرائط الباركود).

3.1.2.6. خريطة

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

3.1.2.7. شريط ورقي

يمثل الرمز البيانات المعروضة على الوسائط في شكل شريط ورقي.

3.1.2.8. عرض

يعرض الرمز البيانات المعروضة في شكل يمكن قراءته من قبل الإنسان على وسيط في شكل جهاز عرض (شاشة للرصد المرئي ، مؤشرات إدخال المعلومات).

3.2 رموز العملية

3.2.1. رموز العملية الأساسية

3.2.1.1. معالجة

يمثل الرمز وظيفة لمعالجة البيانات من أي نوع (إجراء عملية معينة أو مجموعة من العمليات تؤدي إلى تغيير في معنى أو شكل أو موضع المعلومات أو إلى تحديد يجب أن يتحرك المرء على طوله من عدة اتجاهات للتدفق).

3.2.2. معالجة رموز محددة

3.2.2.1. عملية محددة مسبقا

يمثل الرمز عملية محددة مسبقًا تتكون من عملية واحدة أو أكثر أو خطوات برنامج محددة في مكان آخر (في روتين فرعي ، وحدة نمطية).

3.2.2.2. التشغيل اليدوي

يمثل الرمز أي عملية يقوم بها شخص.

3.2.2.3. تحضير

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

3.2.2.4. حل

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

3.2.2.5. إجراءات موازية

يمثل الرمز تزامن عمليتين متوازيتين أو أكثر.

مثال

ملحوظة. لا يمكن بدء العمليات C و D و E حتى تكتمل العملية A ؛ وبالمثل ، يجب أن تنتظر العملية "و" حتى تنتهي العمليات "ب" و "ج" و "د" ، ولكن يمكن أن تبدأ العملية "ج" و / أو تنتهي قبل بدء و / أو انتهاء العملية "د" ، على التوالي.

3.2.2.6. حدود الدورة

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

مثالنبسب

3.3 رموز الخط

3.3.1. رمز الخط الأساسي

3.3.1.1. خط

يمثل الرمز تدفق البيانات أو التحكم.

يمكن إضافة أسهم الاتجاه حسب الحاجة أو لتحسين إمكانية القراءة.

3.3.2. رموز خط محددة

3.3.2.1. نقل السيطرة

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

3.3.2.2. وصلة

يعرض الرمز نقل البيانات عبر قناة الاتصال.

3.3.2.3. خط منقط

يمثل الرمز علاقة بديلة بين رمزين أو أكثر. بالإضافة إلى ذلك ، يتم استخدام الرمز لتتبع المنطقة المشروحة.


مثال 1

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

مثال 2

يمكن توصيل الإخراج المستخدم كمدخل للعملية التالية بهذا الإدخال باستخدام خط متقطع.

3.4. الرموز الخاصة

3.4.1. موصل

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

3.4.2. المنهي

يمثل الرمز الإخراج إلى البيئة الخارجية والمدخلات من البيئة الخارجية (بداية أو نهاية مخطط البرنامج ، والاستخدام الخارجي ومصدر أو وجهة البيانات).

3.4.3. تعليق

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


مثال

3.4.4. يتخطى

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

مثال

4. قواعد تطبيق الرموز وتنفيذ المخططات

4.1 قواعد الرموز

4.1.1. الغرض من الرمز هو تحديد الوظيفة التي يعرضها بيانياً ، بغض النظر عن النص الموجود داخل هذا الرمز.

4.1.2. يجب أن تكون المسافات بين الرموز في الرسم البياني متساوية. يجب الالتزام بطول اتصال معقول وأقل عدد من الخطوط الطويلة.

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

يمكن رسم الرموز في أي اتجاه ، ولكن يفضل الاتجاه الأفقي كلما أمكن ذلك. يشير انعكاس شكل الرمز إلى نفس الوظيفة ، لكنه غير مفضل.

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

مثال

إذا تجاوز حجم النص الذي يناسب الرمز حجمه ، فيجب عليك استخدام رمز التعليق.

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

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

مثال

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

مثال

4.1.7. في مخططات النظام ، تمثل الرموز التي تمثل وسائط التخزين في كثير من الحالات طرق الإدخال / الإخراج. لاستخدامها كمرجع للتوثيق ، يجب وضع نص الرسم التخطيطي للرموز التي تمثل طرق الإخراج على اليمين فوق الرمز ، ويجب وضع نص للرموز التي تمثل طرق الإدخال على اليمين أسفل الرمز.

مثال

4.1.8. يمكن أن تستخدم الرسوم التخطيطية طريقة عرض تفصيلية ، يشار إليها بعملية أو رمز شريط بيانات. يشير رمز الشريط إلى توفر عرض تقديمي أكثر تفصيلاً في مكان آخر في نفس مجموعة المستندات.

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

يجب استخدام حرف الفاصل كحرف أول وآخر حرف من الحرف المطول. يجب أن يحتوي الحرف الأول من حرف النهاية على مرجع موجود أيضًا في الحرف الشريطي.

رمز مع شريط

عرض تفصيلي

4.2 قواعد الاتصال

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

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

4.2.2. يجب تجنب خطوط العبور في الرسوم البيانية. لا يوجد اتصال منطقي للخطوط المتقاطعة مع بعضها البعض ، لذلك لا يُسمح بتغييرات الاتجاه عند نقاط التقاطع.

مثال

4.2.3. يمكن دمج سطرين واردين أو أكثر في سطر واحد صادر. إذا تم دمج سطرين أو أكثر في سطر واحد ، فيجب إزاحة نقطة الدمج.

مثال

4.2.4. يجب أن تقترب الخطوط في المخططات من الرمز إما من اليسار أو من أعلى ، وأن تأتي إما من اليمين أو من أسفل. يجب أن تشير الخطوط إلى مركز الرمز.

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

موصل خارجي

موصل داخلي

4.3 الاتفاقيات الخاصة

4.3.1. نواتج متعددة

4.3.1.1. يجب إظهار عدة مخارج من الرمز:

1) عدة أسطر من هذا الرمز إلى رموز أخرى ؛

2) سطر واحد من الرمز المحدد ، والذي يتفرع بعد ذلك إلى عدد الأسطر المقابل.

أمثلة على

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

أمثلة على

4.3.2. تكرار العرض

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

4.3.2.2. عندما تمثل الأحرف المتعددة مجموعة مرتبة ، يجب أن يكون هذا الترتيب من الأمام (الأول) إلى الخلف (الأخير).

4.3.2.3. يمكن أن تدخل الخطوط أو تنشأ من أي نقطة من الرموز المتداخلة ، ومع ذلك ، يجب مراعاة متطلبات 4.2.4. لا يتم تغيير الأولوية أو الترتيب التسلسلي للأحرف المتعددة بنقطة دخول السطر أو الخروج منه.

مثال

5. تطبيق الرموز

اسم الرمز

مخطط البيانات

مخطط البرنامج

مخطط تشغيل النظام

مخطط تفاعل البرامج

مخطط موارد النظام

رموز البيانات

الرئيسية

البيانات المحفوظة

محدد

ذاكرة الوصول العشوائية

جهاز الذاكرة المتسلسلة

جهاز تخزين الوصول المباشر

وثيقة

إدخال يدوي

شريط ورقي

رموز العملية

الرئيسية

محدد

عملية محددة مسبقا

التشغيل اليدوي

كيفية تعيين "رمز الضيف" لمستند

ميخائيل أوستروجورسكي, 2010

لماذا نحتاج إلى تعيينات المستندات

يُسألون أحيانًا عن كيفية تخصيص رمز أو تشفير أو رقم وما إلى ذلك بشكل صحيح للمستند ، دعنا نقول على الفور أن هذا ليس علمًا رائعًا. ولكن ، أولاً ، ليس رمزًا أو تشفيرًا ، ولكن تعيينًا ، على الأقل إذا كنا نعتزم الامتثال لـ ESPD (GOST 19) أو KSAS (GOST 34). ثانيًا ، دعنا أولاً نتعرف على معنى تعيينات المستندات.

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

لا يحتاج المدعي العام ، ولا Rostekhregulirovanie ، ولا مطور البرنامج أو النظام ، إلى تعيينات المستندات ، ولكن قبل كل شيء ، من قبل العميل. إذا طلب عميلك بأي ثمن تزويد المستندات التي تم إنشاؤها له "برمز gost" ، فيمكنك أن تسأل ردًا على ما إذا كان يحتفظ بأرشيف للوثائق الفنية. لسوء الحظ ، ستكون الإجابة في معظم الحالات بالنفي. إذا كان لدى العميل مثل هذا الأرشيف ، فمن المرجح أن يكون هذا الأرشيف إلكترونيًا وليس ورقيًا. في الأرشيفات الإلكترونية ، عادةً ما يتم تعيين معرفات فريدة للمستندات تلقائيًا.

وبالتالي ، فإن تخصيص تعيينات الضيف للوثائق اليوم لا معنى له إلى حد كبير وهو "طقس سحري". ماذا لو استمر العميل في الإصرار على تنفيذه؟ نفذ ، بالطبع.

تعيينات المستندات للأنظمة الآلية

يظهر أدناه هيكل التعيين لوثيقة النظام وفقًا لـ GOST 34.201-89. ويرد في الجدول فك رموز أجزاء التعيين.

A.B.CCC.DD.EE.F-G.M

جزء من التعيين المعنى
أ كود مطور النظام. يقول GOST 34.201-89: "يتم تعيين رمز المنظمة المطورة وفقًا لمصنف All-Union للمؤسسات والمؤسسات والمنظمات (OKPO) أو وفقًا للقواعد التي وضعتها التوثيق العلمي والتقني للصناعة."لأسباب معروفة ، لا يوجد لدينا اليوم مصنف لجميع الاتحادات ، ولكن يوجد مصنف لعموم روسيا للمؤسسات والمنظمات (OKPO). يتم تضمين كود OKPO في التفاصيل الرسمية للمنظمة ، ويجب أن يعرفه قسم المحاسبة الخاص بك. إذا كنت تكره الاتصال بقسم المحاسبة ، فحاول البحث عن شركتك في دليل عبر الإنترنت ، ولكن ضع في اعتبارك أن العلامة الموجودة على اللافتة عند باب المكتب لا تتطابق دائمًا مع اسم الكيان القانوني. بالإضافة إلى ذلك ، وفقًا لـ GOST 2.201-80 ، يجب تعيين رمز مكون من أربعة أحرف لمؤسسة التطوير لتكوين تسميات لوثائق التصميم. يتم تنفيذ التخصيص المركزي للرموز من قبل المنظمات المعتمدة ، على سبيل المثال ، المؤسسة الفيدرالية الموحدة للدولة "Standartinform" و JSC "StandartElectro". هذه ممارسة حقيقية ، حتى أن بعض الشركات تنشر شهادات على مواقعها الإلكترونية حول تخصيص رمز لها.
ب رمز صفة التصنيف المميزة لنوع النظام أو جزء منه. وفقًا لـ GOST 34.201-89 ، يجب تحديد هذا الرمز من مصنف All-Union Product ، والذي تم استبداله الآن بـ All-Russian Product Classifier (OKP). تم نشره عدة مرات على الإنترنت ، ويمكنك العثور عليه بسهولة باستخدام الرابط الوارد هنا أو باستخدام محرك بحث. يحتوي هذا المصنف على جميع المنتجات الممكنة من الحفارات المشاة إلى المسامير. يبدأ قسم المصنف المخصص للأنظمة الآلية بالخط 425000 مجمعات البرمجيات والأجهزة للأنظمة الآلية... ربما توجد سلاسل أخرى في المصنف أكثر ملاءمة لك وفقًا لخصائص النظام. حاول العثور عليها باستخدام وظيفة البحث المعتادة في نص الصفحة. كبديل لـ OKP ، يقترح المعيار استخدام مصنف All-Union للأنظمة الفرعية ومجمعات مهام ACS (OKPKZ). وبقدر ما نعلم ، فقد تم إلغاؤه ولكن لم يتم استبداله بأي شيء آخر ، لذا فإن هذا الرابط أصبح تاريخًا
CCC رقم تسجيل النظام الآلي أو جزء منه. من المفترض أن المطور قد نظم عملية محاسبة للأنظمة المؤتمتة المنتجة وقام بتعيين أرقام التسجيل لها. إذا لم يتم قبول هذا في شركتك ، فهذا يعني أنه لا يمكنك الامتثال الكامل لمتطلبات KCAS. ابدأ حياة جديدة ، واحتفظ بسجل للأنظمة التي تم إصدارها. يتم ترقيم الأنظمة لكل نوع (أي رمز خاصية التصنيف ، انظر أعلاه) للأنظمة بشكل منفصل. كيف تكون منظمة تمكنت من إصدار 1000 من نفس النوع من الأنظمة الآلية ، لا يقول المعيار
DD رمز المستند (بشكل أكثر دقة ، نوع المستند) وفقًا لـ GOST 34.201-89. على سبيل المثال ، رمز دليل المستخدم هو I3(وثلاثة) ، ورمز البرنامج ومنهجية الاختبار - مساء.
إي رقم الوثيقة لاسم واحد. لنفترض أن لديك ثلاثة إرشادات لسير العمل لثلاثة أدوار وظيفية مختلفة في مجموعة الوثائق الخاصة بك. في هذه الحالة ، سيكون لديهم أرقام 01, 02 و 03 ... لم يتم تحديد قواعد تعيين هذه الأرقام (حسب تاريخ إصدار المستند أو حسب الأسماء بالترتيب الأبجدي أو غير ذلك). الشيء الرئيسي هو أن الأرقام تذهب بالتتابع من واحد. إذا تضمنت المجموعة مستندًا واحدًا فقط من نوع معين ، على سبيل المثال ، ملاحظة تفسيرية واحدة لمشروع تقني ، لم يتم تعيين رقم ، ويتم تخطي الموضع المقابل في التعيين
F رقم مراجعة الوثيقة. نحن نتحدث عن تلك الإصدارات التي تنقلها رسميًا إلى العميل ، وهو يوافق عليها رسميًا ويوافق عليها. إذا قام العميل ، أثناء عملية مراجعة المستند والموافقة عليه ، بإرسال تعليقات لك مرارًا وتكرارًا ، وأجبته بملف مصحح ، فإننا لا نتحدث عن مراجعات جديدة للمستند ، فهذه مواد عمل وليس أكثر. ينشأ إصدار جديد إذا وافق العميل على إصدار جديد من المستند ، مع الاحتفاظ بالإصدار السابق ، ومن حيث المبدأ ، في بعض المواقف ، يمكن استخدام كلا الإصدارين. خلاف ذلك ، يمكن إلغاء النسخة القديمة ونسيانها إلى الأبد. يتم تخصيص الأرقام للطبعات ، بدءًا من الثانية. في الطبعة الأولى ، تم حذف الموضع المقابل في التعيين.
جي رقم الجزء من المستند. يمكن تقسيم المستند ماديًا إلى عدة أجزاء. يتم ذلك عادةً لتسهيل قراءة المستند أو ربطه. إذا لم يتم تقسيم المستند إلى أجزاء ، فلن يتم تعيين الرقم ، ويتم تخطي الموضع المقابل في التعيين
م في عام 1989 ، كانت الوثائق الإلكترونية لا تزال ظاهرة جديدة وغير عادية. كانت الوثيقة النموذجية عبارة عن ورقة أو كومة من الأوراق مع الموافقة والموافقة على التوقيعات. تتطلب حقيقة أن القرص المرن أو الشريط المغناطيسي الذي يحتوي على نص مكتوب عليه أن يكون مستندًا يتطلب فهمًا منفصلاً. لذلك ، تمت إضافة الرسالة إلى تسمية هذه المستندات م... ومن الغريب أن هذه الممارسة لا تخلو من الأسباب ، حيث إنها وثائق ورقية في بلدنا تحمل توقيعات أصلية لأشخاص مختصين وأختام "مبللة" للمنظمات تظهر في توزيع الوثائق الرسمية. لذلك ، على سبيل المثال ، يجب تنفيذ التعليمات التكنولوجية ، لعدم التقيد بها يمكن معاقبة الموظف رسميًا ، في هذا النموذج. ولكن إذا طلب العميل منا ، على سبيل المثال ، نص البرنامج (مستند مقدم من ESPD) ، فلا يزال بإمكاننا تزويده ليس بشاحنة قوائم ، بل قرص مضغوط. يجب أن ينتهي تعيين مثل هذا المستند بالحرف موالذي تم فصله عن الجزء السابق بنقطة (وليس واصلة!)

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

63755082.425750.001.I2.01 ،أين

63755082 - كود شركة Filosoft LLC حسب شركة OKPO.

425750 - مجمعات برمجيات وأجهزة برمجيات لأتمتة معالجة المعلومات في التجارة والدعم المادي والتقني وفقًا لـ OKP. قام مؤلف المقال بالتصفح في OKP ، ففكر وقرر أن هذه الخاصية تناسب موقعنا بشكل أفضل من كل الميزات الأخرى المعروضة هناك. ربما كان مخطئا.

001 هو رقم التسجيل لنظام آلي من هذا النوع في المحاسبة الداخلية لدينا (لنفترض أننا نحتفظ به).

I2 - كود التعليمات التكنولوجية وفقًا لـ GOST 34.201-89.

01 - عدد التعليمات التكنولوجية في مجموعة التوثيق الفني للموقع. تذكر أن هناك واحدًا آخر ، لمدير إعلانات البانر ، لديه رقم 02.

تحديد المواصفات الفنية لنظام آلي

في الفقرة 3.2 من GOST 34.602-89 ، توجد عبارة يذكر فيها رمز معين للمعارف التقليدية: "يتم وضع أرقام الأوراق (الصفحات) ، بدءًا من الورقة الأولى التي تلي صفحة العنوان ، في الجزء العلوي من الورقة (فوق النص ، في المنتصف) بعد تعيين رمز المعارف التقليدية على AC".في الوقت نفسه ، يحتوي GOST 34.201-89 على أكواد للمستندات تم تطويرها على مراحل ، بدءًا من مسودة التصميم ، ولكن لا يوجد رمز للمعارف التقليدية ، وهو أمر محير إلى حد ما.

عند تكوين رمز المعارف التقليدية في الاتحاد الأفريقي ، يمكنك مراعاة البند 3.5. GOST 34.602-89 والتي تقول: "إذا لزم الأمر ، يُسمح بوضع الرموز المنشأة في الصناعة على صفحة العنوان الخاصة بالمعارف التقليدية في الاتحاد الأفريقي ، على سبيل المثال: ختم السرية ، ورمز العمل ، ورقم تسجيل المعارف التقليدية ، وما إلى ذلك" ،وتعيين الكود بشكل تعسفي ، بالإشارة إلى حقيقة أنه مقبول على هذا النحو في الصناعة أو تحدده NTD لمؤسسة معينة. بالإضافة إلى ذلك ، يمكنك أن تتذكر أنه وفقًا لـ GOST 24.101-80 ، كان للمهمة الفنية رمز 2A ، وتعيين تسمية للمستند وفقًا للمخطط الموضح أعلاه. لكن بشكل عام ، كل هذا يشبه العد المدرسي لعدد الشياطين عند طرف إبرة.

رموز وثيقة البرنامج

يظهر أدناه هيكل التعيين لوثيقة البرنامج وفقًا لـ GOST 19.103-77. ويرد في الجدول فك رموز أجزاء التعيين. يتكون رقم المراجعة ورقم المستند ورقم جزء المستند بنفس طريقة تكوين مستندات النظام (من منظور تاريخي ، العكس ، لكننا نطلب من القارئ أن يغفر لنا هذه المفارقة التاريخية).

ABCCCCC-DD EE FF-G

جزء من التعيين المعنى
أ رمز الدولة. في الوقت الحاضر ، من المعقول تحديد الرمز المكون من حرفين وفقًا لمعيار ISO 3166-1: RUبالنسبة لروسيا، KZلكازاخستان ، إلخ.
ب كود منظمة المطور. قياسا على وثائق النظام ، يمكنك تحديد كود OKPO
CCCCC رقم التسجيل في البرنامج. وفقًا لـ GOST 19.103-77 ، يجب تعيينه "وفقًا لمصنف البرامج All-Union ، المعتمد من قِبل معيار الولاية وفقًا للإجراء المعمول به."نحن لا نعرف كيف نمتثل لهذا المطلب اليوم. انتبه إلى عام الموافقة على المعيار: 1977. لقد تغير الكثير منذ ذلك الحين في حياتنا
DD رقم مراجعة الوثيقة
إي رمز نوع المستند وفقًا لـ GOST 19.101-77
FF رقم الوثيقة من هذا النوع
جي رقم جزء المستند

الجزء الأول من التعيين ، ألف باء CCCCC-DD ،بمثابة تسمية للبرنامج نفسه وفي نفس الوقت المستند الرئيسي المرتبط به ، المواصفات.

تعيين وثائق التصميم

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

تعيينات ورقة الموافقة

إذا تم تزويد المستند بورقة اعتماد ، فيجب أن يكون لهذه الأخيرة التعيين الخاص بها. يتم تشكيلها وفقًا للقاعدة الأولية: يجب إضافة تشفير إلى تسمية المستند LU ،فصلها بشرطة ، على سبيل المثال: 63755082.425750.001.I2.01-LU.

فوائد التدوين بتفاؤل منضبط

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

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

G O S U D A R S T V E N N Y S T A N D A R T S O Y Z A S S R

نظام موحد لتوثيق البرنامج

GOST 19.003-80

بدلا من

GOST 19428-74

مخططات الخوارزميات وتصميم البرامج الرسوم البيانية الشرطية

النظام المتحد لتوثيق البرنامج.

رموز مخطط انسيابي رسومية.

بموجب مرسوم صادر عن لجنة الدولة لاتحاد الجمهوريات الاشتراكية السوفياتية للمعايير بتاريخ 24 أبريل 1980 1867 ، تم تحديد فترة التقديم

من 01.07 1981

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

لا ينطبق المعيار على السجلات والتعيينات الموضوعة داخل الرمز أو بالقرب منه ، والتي تعمل على توضيح الوظائف التي يؤديها.

يحدد المعيار القائمة والاسم والشكل وحجم الرموز والوظائف التي تعرضها الرموز.

يتوافق المعيار مع MS ISO 1028-73 من حيث تسميات الرموز

1. قائمة واسم وتسمية الرموز والوظائف المعروضة

1.1 يجب أن تتوافق قائمة الرموز المطلوبة واسمها وتسميتها وأحجامها والوظائف التي تعرضها في الخوارزمية وبرنامج معالجة البيانات مع تلك المشار إليها في الجدول. 1.

الجدول 1.

اسم

التعيين والأبعاد بالملم

وظيفة

1. العملية

إجراء عمليات أو مجموعة عمليات من شأنها تغيير قيمة البيانات أو عرضها أو موقعها
2. الحل

اختيار اتجاه تنفيذ خوارزمية أو برنامج حسب بعض الظروف المتغيرة
3. التعديل

القيام بعمليات تغير الأوامر أو مجموعة أوامر تغير البرنامج
4. عملية محددة مسبقا استخدام الخوارزميات أو البرامج التي تم إنشاؤها مسبقًا والموضحة بشكل منفصل
5. التشغيل اليدوي

عملية مستقلة تتم يدويًا أو بوسائل غير آلية
6. عملية مساعدة عملية مستقلة يتم تنفيذها بواسطة جهاز لا يتحكم فيه المعالج مباشرة
7. دمج الجمع بين مجموعتين أو أكثر في مجموعة واحدة
8. العزلة

إزالة مجموعة واحدة أو أكثر من مجموعة واحدة
9. التجميع

اتحاد مجموعتين أو أكثر مع اختيار عدة مجموعات أخرى
10. الفرز

فرز مجموعة وفقًا لمعايير معينة
11. الإدخال اليدوي

الإدخال اليدوي للبيانات باستخدام أجهزة غير مستقلة مع لوحة مفاتيح ومجموعة من المفاتيح والأزرار
12. المدخلات والمخرجات

تحويل البيانات إلى نموذج مناسب للمعالجة (الإدخال) أو عرض نتائج المعالجة (الإخراج)
13. ذاكرة غير مستقلة

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

بيانات الإدخال / الإخراج تستند إلى الورق
16. بطاقة لكمة

بيانات الإدخال / الإخراج محمولة بواسطة بطاقة مثقوبة
17. ظهر البطاقات المثقوبة

عرض مجموعة من البطاقات المثقوبة
18. ملف

عرض تقديمي للبيانات منظم على أساس السمات المشتركة ، التي تميز في المجموع بعض وجوه معالجة البيانات. يُستخدم الرمز مع رموز وسائط تخزين معينة تؤدي وظائف الإدخال / الإخراج
19. شريط مثقوب

يتم نقل بيانات الإدخال / الإخراج بواسطة شريط مثقوب
20. شريط مغناطيسي بيانات الإدخال / الإخراج محمولة بواسطة شريط مغناطيسي
21. اسطوانة مغناطيسية

بيانات الإدخال / الإخراج ، الناقل لها عبارة عن أسطوانة مغناطيسية
22. قرص مغناطيسي

إدخال / إخراج البيانات بواسطة قرص مغناطيسي
23. ذاكرة الوصول العشوائي

بيانات الإدخال / الإخراج محمولة بواسطة قلب مغناطيسي
24. العرض إدخال البيانات والمخرجات ، إذا كان الجهاز المتصل مباشرة بالعملية يعيد إنتاج البيانات ويسمح لمشغل الكمبيوتر بإجراء تغييرات أثناء معالجتها
25. قناة اتصال

نقل البيانات عبر قنوات الاتصال
26. تبسيط

تحديد تسلسل بين الأحرف
27. الإجراءات الموازية

بدء أو إنهاء عمليتين متزامنتين أو أكثر
28. موصل

بيان العلاقة بين خطوط التدفق المتقطع التي تربط الرموز
29. ابدأ - توقف

بدء أو إنهاء أو مقاطعة معالجة البيانات أو تنفيذ البرنامج
30. التعليق

العلاقة بين العنصر التخطيطي والتعليق التوضيحي

1.2 يجب أن تتوافق قائمة الرموز الموصى بها واسمها وتسميتها وأحجامها والوظائف التي تعرضها في الخوارزمية وبرنامج معالجة البيانات مع تلك المشار إليها في الجدول. 2.

الجدول 2

اسم

التعيين والأبعاد بالملم

وظيفة

1. موصل خارج الصفحة بيان العلاقة بين الأجزاء المنفصلة من مخططات الخوارزميات والبرامج الموجودة على أوراق مختلفة
2. البطاقة الممغنطة

بيانات الإدخال / الإخراج محمولة بواسطة بطاقة ممغنطة
3. وثيقة يدوية

تشكيل وثيقة كنتيجة للعمليات اليدوية
4. أرشفة

تخزين مجموعة من وسائط التخزين المنظمة لإعادة استخدامها
5. معالجة دون اتصال تحويل البيانات الأولية نتيجة لأداء عمليات غير متصلة بالإنترنت
6. فك

القراءة من وسيط تخزين ، وتحويل الشفرة والطباعة على نفس أو وسيط تخزين مختلف كنتيجة لعملية غير متصلة بالإنترنت
7. الترميز

تطبيق المعلومات المشفرة على وسيط نتيجة لعملية مستقلة
8. نسخ

في. كاربوف

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

TECHNICAL TASK (GOST 19.201-78)

1. أحكام عامة

مراحل التطور (GOST 19.102-77)

وصف البرنامج (GOST 19.402-78)

نص البرنامج (GOST 19.401-78)

البرنامج وإجراءات الاختبار (GOST 19.301-79)

متطلبات مستندات البرنامج التي تم إجراؤها بطريقة الطباعة (GOST 19.106-78)

التوحيد القياسي في مجال توثيق البرمجيات

كيف تمضي قدما

إعداد الوثائق الخاصة بأدوات البرمجيات (PS) وفقًا لـ GOSTs الحالية

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

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

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

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

أولاً ، تحدد القدرة على إنشاء وثائق البرامج المستوى المهني للمبرمج. لن يخوض العميل في التفاصيل الدقيقة والميزات حتى لأروع البرامج. سيقرأ العميل الوثائق أولاً. يلعب العامل النفسي أيضًا دورًا مهمًا في هذا. على وجه الخصوص ، كانت مدرسة البرمجة السوفيتية السابقة موضع تقدير في جميع أنحاء العالم (ولا تزال موضع تقدير حتى الآن). توقف عن اقتباس المبرمجين المحليين الحديثين. الصف ليس هو نفسه. في الوقت الحاضر ، لم تعد تُكتب البرامج ، بل يتم تجميعها (وهما "اختلافان كبيران"). لذلك ، فإن مجموعة وثائق البرنامج (المشار إليها فيما يلي باسم PD) التي تم إنشاؤها بالأسلوب "الكلاسيكي" ستخلق الانطباع الأكثر ملاءمة لعميلك أو صاحب العمل. علاوة على ذلك ، إذا كان مؤلف PD سيتجنب عبارات مثل "انقر فوق شريط التمرير ..." ، أو "برغي" ، وما إلى ذلك. لسوء الحظ ، عادةً ما تخفي هذه الثرثرة العامية إما ندرة الأفكار أو الفراغ التام (انطباع لا يمحى على المؤلف من قصة أحد معارفه عن "لاعب" معين إما "تحدث" مع شخص ما هناك ، أو كان منخرطًا في "الاعتدال" أو شيء من هذا القبيل). لغة PD هي نوع من اللغة البيروقراطية والمحافظة للغاية. لها سحرها الخاص. توافق على أن مصطلحات HDD و HDD والمعامل اليدوي مثل "mouse" (أو "kolobok" ، كما كانت في إحدى حزم PD القديمة) تبدو مختلفة تمامًا عن "المسمار" و "flop" و "الماوس" فقط. بالمناسبة ، لقد وصلت الأشياء بالفعل إلى النقطة التي يقولون ، حتى ظهر تخصص خاص - كاتب تقني ، أي شخص يعرف كيفية إنشاء وثائق البرامج.

ثانيًا ، ستوفر لك حزمة PD المكونة بكفاءة (بشكل أكثر دقة ، تم إنشاؤها) الكثير من المتاعب. على وجه الخصوص ، يمكنك التخلص من الأسئلة المزعجة والادعاءات التي لا أساس لها ببساطة عن طريق إحالة المستخدم إلى الوثائق. هذا ينطبق في المقام الأول على أهم وثيقة - الشروط المرجعية. سنتحدث عن هذا أدناه ، ولكن يمكننا الآن استدعاء دعوى قضائية بملايين الدولارات ضد شركة IBM. تم رفع هذه الدعوى من قبل ناشر كبير ، غير راضٍ عن جودة VT والبرامج. فازت IBM في المحاكمة. وفازت فقط لأنها قدمت الاختصاصات الموقعة من الطرفين. لقد مر وقت طويل ، في السبعينيات ، لكن هذا لا يغير جوهر الأمر.

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

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

  • IPK "دار نشر المعايير" ، الإدارة الإقليمية لتوزيع الوثائق العلمية والتقنية (مخزن "المعايير") ، 17961 ، موسكو ، شارع. دونسكايا ، 8 ، هاتف. 236-50-34 ، 237-00-02 ، فاكس / هاتف. 236-34-48 (من حيث GOST و GOST R).
  • VNIIKI Gosstandart of Russia (غرفة القراءة) ، 103001 ، موسكو ، Granatny per. 4 ، هاتف. 290-50-94 (من حيث المعايير الدولية والأجنبية وأمراض المناطق المدارية المهملة الأخرى).

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

لنبدأ بالأحكام العامة المتعلقة بالنظام الموحد لتوثيق البرنامج (والتي تم تحديدها أيضًا في المعيار المقابل GOST 19.001-77).

النظام الموحد لتوثيق البرنامج هو مجموعة من معايير الدولة التي تضع قواعد مترابطة لتطوير وتصميم وتعميم البرامج وتوثيق البرنامج.

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

  • المعايير الأساسية والتنظيمية والمنهجية ؛
  • المعايير التي تحدد شكل ومحتوى وثائق البرنامج المستخدمة في معالجة البيانات ؛
  • المعايير التي تضمن أتمتة تطوير وثائق البرنامج.

بشكل عام ، قائمة وثائق ESPD واسعة جدًا. وهي ، على وجه الخصوص ، تشمل GOSTs التالية:

  • GOST 19.001-77 ESPD. الأحكام العامة.
  • GOST 19.101-77 ESPD. أنواع البرامج ووثائق البرنامج (أعيد نشرها في نوفمبر 1987 بصيغته المعدلة).
  • 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.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.508-79 ESPD. كتيب الصيانة. متطلبات المحتوى والتصميم.
  • GOST 19.604-78 ESPD. قواعد إجراء تغييرات على وثائق البرنامج تتم بطريقة مطبوعة.
  • GOST 19.701-90 ESPD. مخططات الخوارزميات والبرامج والبيانات والأنظمة. رموز وقواعد التنفيذ.
  • GOST 19.781-90. برمجيات نظم معالجة المعلومات.

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

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

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

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

وفقًا لـ GOST ، يحدد هذا المعيار (الذي أعيد إصداره في نوفمبر 1987) الإجراء الخاص ببناء وتنفيذ المواصفات الفنية لتطوير برنامج أو منتج برمجي لأجهزة الكمبيوتر والمجمعات والأنظمة ، بغض النظر عن الغرض منها ونطاقها.

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

يتم وضع الشروط المرجعية على أوراق A4 و / أو A3 ، كقاعدة عامة ، دون ملء هوامش الورقة. يتم وضع أرقام الورقة (الصفحة) في أعلى الورقة أعلى النص.

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

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

  • الاسم والنطاق
  • أساس التنمية؛
  • غرض التنمية؛
  • المتطلبات الفنية لبرنامج أو منتج برنامج ؛
  • مراحل ومراحل التطوير ؛
  • إجراءات المراقبة والقبول ؛
  • التطبيقات.

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

في الفصل الاسم والنطاقأشر إلى الاسم ووصفًا موجزًا ​​لنطاق البرنامج أو منتج البرنامج والكائن الذي يُستخدم فيه البرنامج أو منتج البرنامج.

في الفصل أساس التنميةيجب الإشارة إلى:

  • الوثيقة (الوثائق) التي يتم على أساسها التطوير ؛
  • المنظمة التي وافقت على هذه الوثيقة وتاريخ الموافقة عليها ؛
  • اسم و (أو) تسمية موضوع التطوير.

فيما يتعلق بتفاصيل العملية التعليمية ، يمكن أن يكون الأساس عبارة عن مهمة لتصميم الدورة ، وهو أمر للمعهد من __.__. لـ N ___. ، العقد __.__. لـ N ___. ، إلخ.

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

على سبيل المثال: البرنامج هو جوهر محطة العمل الآلية (AWS) لمطور أنظمة التحكم الآلي الخطي المستمر (ACS) ، والذي يسمح للمستخدم بحل مشاكل تحليل النماذج البسيطة.

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

  • متطلبات الأداء؛
  • متطلبات الموثوقية
  • تعليمات الاستخدام؛
  • متطلبات تكوين ومعايير الوسائل التقنية ؛
  • متطلبات توافق المعلومات والبرمجيات ؛
  • متطلبات وضع العلامات والتعبئة والتغليف ؛
  • متطلبات النقل والتخزين ؛
  • متطلبات خاصة.

بمعنى آخر ، هذا هو المكان الذي تبدأ فيه التفاصيل. يصف ما يجب أن يفعله البرنامج وكيف يجب أن يبدو.

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

على سبيل المثال: يجب أن يسمح البرنامج ... بالحساب ... البناء ... الإنشاء ...

البيانات الأولية: ملف نصي به ...

بيانات الإخراج: المعلومات الرسومية والنصية - نتائج تحليل النظام ... ؛ ملفات نصية - تقارير حول ... تشخيصات حالة النظام ورسائل حول أي أخطاء حدثت.

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

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

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

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

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

متطلبات تكوين ومعلمات الوسائل التقنية. حدد التكوين المطلوب للوسائل التقنية مع الإشارة إلى خصائصها التقنية.

الشيء الرئيسي هنا هو عدم نسيان أي شيء والتنبؤ بكل شيء ، من ناحية (وإلا فسوف ينزلقون بعضًا من IBM PC / XT بشاشة أحادية اللون وبدون ماوس) ، ومن ناحية أخرى ، لا تفرط في ذلك مع المتطلبات المتزايدة ، وإلا سيجد العميل متعاقدًا أكثر امتثالًا.

على سبيل المثال: يتطلب جهاز كمبيوتر شخصي متوافق مع IBM مع محول رسومات EGA (VGA). مساحة القرص المطلوبة 600 كيلو بايت على الأقل ، ومقدار ذاكرة الوصول العشوائي المجانية 400 كيلو بايت على الأقل. من المستحسن أن يكون لديك برنامج تشغيل EMS ومناور من نوع الماوس.

متطلبات المعلومات وتوافق البرامج. الميزات هي نفسها كما في الفقرة السابقة. يجب الإشارة هنا إلى متطلبات هياكل المعلومات في المدخلات والمخرجات وطرق الحل ورموز المصدر ولغات البرمجة. ينبغي ضمان حماية المعلومات والبرامج عند الضرورة.

على سبيل المثال: يجب أن يعمل البرنامج بشكل مستقل ضمن الإصدار 3.3 من MS DOS OS أو أعلى. لغة البرمجة الأساسية هي Turbo Pascal 6.0.

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

المتطلبات الخاصة هي شيء صعب للغاية. من الأفضل تجنبها كلما أمكن ذلك. وأعلن ذلك على الفور.

على سبيل المثال: لا توجد متطلبات خاصة لتوقيت البرنامج. لا توجد متطلبات خاصة للسمات السعوية للبرنامج.

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

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

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

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

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

المراحل والمراحل الرئيسية التي لا غنى عنها هي المهمة الفنية نفسها ، ومسودة التصميم ، والمشاريع الفنية والتشغيلية.

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

هذه هي المتطلبات القياسية. إذا وافق العميل على أنه لا يمكن تقديم كل هذه القائمة ، فهذا يعني أن نواياه ليست جادة فيما يتعلق بك وبمنتجك.

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

على سبيل المثال: أثناء تطوير البرنامج ، يجب تحضير المواد الرسومية التالية:

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

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

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

الخامس المرفقاتإلى الاختصاصات ، إذا لزم الأمر ، تؤدي إلى:

  • قائمة بالبحوث والأعمال الأخرى التي تبرر التطوير ؛
  • مخططات الخوارزميات والجداول والأوصاف والمبررات والحسابات والوثائق الأخرى التي يمكن استخدامها في التطوير ؛
  • مصادر التنمية الأخرى.

يحدد هذا المعيار مراحل تطوير البرامج ، وتوثيق البرنامج ، وكذلك مراحل ومحتوى العمل:

مراحل التطور

مراحل العمل

مهمة فنية

تبرير الحاجة إلى تطوير البرنامج

صياغة المشكلة.
مجموعة من المواد المصدر.
اختيار وتبرير معايير فعالية وجودة البرنامج المطور.
تبرير الحاجة إلى العمل البحثي.

عمل بحثي

تحديد هيكل بيانات الإدخال والإخراج.
الاختيار الأولي لطرق حل المشكلات.
تبرير جدوى استخدام البرامج المطورة سابقاً.
تحديد متطلبات الوسائل التقنية.
إثبات الإمكانية الأساسية لحل المشكلة.

تطوير واعتماد المواصفات الفنية

تحديد متطلبات البرنامج.
تطوير دراسة جدوى لتطوير البرنامج.
تحديد مراحل ومراحل وشروط تطوير البرنامج وتوثيقه.
اختيار لغات البرمجة.
تحديد الحاجة إلى العمل البحثي في ​​المراحل اللاحقة.
تنسيق واعتماد المواصفات الفنية.

التصميم الأولي

تطوير مشروع التصميم

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

الموافقة على مشروع التصميم


تنسيق واعتماد مشروع التصميم

مشروع تقني

تطوير مشروع تقني

توضيح هيكل بيانات المدخلات والمخرجات.
تطوير خوارزمية لحل المشكلة.
تحديد شكل عرض بيانات المدخلات والمخرجات.
تحديد دلالات اللغة ونحوها.
تطوير هيكل البرنامج.
التحديد النهائي لتكوين الأجهزة.

الموافقة على التصميم الفني

وضع خطة عمل لتطوير وتنفيذ البرامج.
تطوير مذكرة توضيحية.
التنسيق والموافقة على المشروع الفني.

مشروع العمل

تطوير البرنامج

برمجة وتصحيح البرنامج

تطوير وثائق البرامج

تطوير وثائق البرنامج وفقًا لمتطلبات GOST 19.101-77.

اختبار البرنامج

تطوير وتنسيق واعتماد برنامج ومنهج الاختبار.
إجراء اختبارات الحالة الأولية والتقسيم بين الأقسام والقبول وأنواع أخرى من الاختبارات.
تصحيح وثائق البرنامج والبرنامج بناءً على نتائج الاختبار.

تطبيق

اعداد ونقل البرنامج

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

ملحوظات:

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

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

بالمعنى الدقيق للكلمة ، هناك وثيقتان مختلفتان ، ومع ذلك ، هناك الكثير من القواسم المشتركة. هذه هي الوصف العام (GOST 19.502-78) ووصف البرنامج (GOST 19.402-78). ومع ذلك ، نظرًا لحقيقة أنه من الصعب حقًا إنشاء أحدهما والآخر نوعيًا ، دون اللجوء إلى الازدواجية الكاملة تقريبًا ، وتمزيق القطع ، فمن الصعب جدًا ، فسيكون ذلك كافيًا لتنفيذ واحد ، أكثر عمومية ، "مختلط" وثيقة. دعنا نسميها "وصف البرنامج".

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

يجب أن يتضمن وصف البرنامج جزءًا إعلاميًا - التعليق التوضيحي والمحتوى.

يجب أن يتكون الجزء الرئيسي من المستند من جزء تمهيدي والأقسام التالية:

  • الغرض الوظيفي
  • وصف المنطق.
  • شروط الاستخدام؛
  • التكوين والوظائف.

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

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

على سبيل المثال: برنامج "Automated workplace of the ACS developer" مخصص لـ ... يتم تنفيذه على .... البرنامج يدعم ...

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

على سبيل المثال: البرنامج مصمم لحل المشاكل ... البرنامج هو جوهر محطة العمل الآلية ...

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

في الفصل " وصف المنطق"يشير:

  • وصف هيكل البرنامج وأجزائه الرئيسية

(على سبيل المثال: يشتمل البرنامج على ما يلي:

  • واجهة المستخدم،
  • وحدة لتحديد المسارات في الرسم البياني ،
  • وحدة حساب وظيفة النقل،
  • وحدة لبناء خصائص السعة وتردد الطور ،
  • وحدة لتكوين استجابة لإجراء متعدد الحدود ،
  • محرر النص) .
  • وصف وظائف المكونات والوصلات فيما بينها ؛

على سبيل المثال: يتكون البرنامج من ست وحدات: وحدة الواجهة ؛ وحدة تعريف ... ؛ وحدة حسابية ... ؛ وحدة ... إلخ ..

تم بناء وحدة الواجهة على نوعين من الحوارات: مربع حوار "سؤال - إجابة" ومربع حوار نوع "القائمة". تتحكم وحدة الواجهة ...

وحدة التعريف ... هي ...

وحدة الحساب ... إلخ.

  • معلومات حول لغة البرمجة ؛

على سبيل المثال: البرنامج مكتوب باللغة ... باستخدام المترجم ...

  • وصف بيانات المدخلات والمخرجات لكل جزء من الأجزاء المكونة ؛

على سبيل المثال: بيانات الإدخال. بيانات الإدخال للبرنامج عبارة عن ملف نصي يصف مصفوفة الوقوع الموسعة للرسم البياني للنظام قيد الدراسة.

انتاج. الخرج هو:

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

عند وصف منطق البرنامج ، من الضروري الارتباط بنص البرنامج.

في الفصل التكوين والوظائفالإشارة إلى وصف تكوين ووظيفة البرامج والطرق التطبيقية لحل المشكلات.

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

على سبيل المثال: يتم تشغيل البرنامج على جهاز كمبيوتر شخصي (PC) من نوع IBM PC / AT. للعمل في وضع الحوار ، يتم استخدام شاشة عرض ولوحة مفاتيح وماوس. مطلوب محول EGA (VGA) لدعم وضع الرسومات. يتم تخزين بيانات الإدخال على قرص مرن و / أو محركات أقراص ثابتة. يعمل البرنامج تحت نظام التشغيل ...

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

ولا تنس تضمين اسم وحدة التحميل بالإضافة إلى وصف للإجراء بأكمله.

استدعاء وتحميل النظام

تعتبر متطلبات تنسيق نص البرنامج بسيطة للغاية وطبيعية للمبرمج المختص. الشيء الرئيسي الذي يجب إرشادك عند إنشاء هذا المستند هو أن نص البرنامج يجب أن يكون قابلاً للقراءة.

لا يزال من الضروري إعداد الجزء الإعلامي - التعليق التوضيحي والمحتوى.

يجب أن يتكون الجزء الرئيسي من المستند من نصوص قسم واحد أو أكثر ، والتي يتم منحها عناوين.

يبدأ نص كل ملف برنامج بـ "header" ، والذي يشير إلى:

    • اسم البرنامج
    • مؤلف،
    • تاريخ إنشاء البرنامج ،
    • رقم الإصدار،
    • تاريخ آخر تعديل.

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

يوجد أدناه مثال على نص برنامج مقروء جيدًا (مأخوذ من موقع Nikolai Gekht ، البريد الإلكتروني: [بريد إلكتروني محمي]، http://users.omskreg.ru/~geht)

/ * كود مصدر Windows "98

رمز المصدر إلى Windows 98 * / #include "win31.h" #include "win95.h" #include "evenmore.h" #include "oldstuff.h" # include "billrulz.h" #include "monopoly.h" # حدد INSTALL = HARD char make_prog_look_big ؛ void main () (while (! CRASHED) (display_copyright_message ()؛ display_bill_rules_message ()؛ do_nothing_loop ()؛ if (first_time_installation) (make_50_megabyte_swapfile ()؛ do_nothing_loop ()؛ ) write_something (أي شيء) ؛ display_copyright_message () ؛ do_nothing_loop () ؛ do_some_stuff () ؛ إذا (still_not_crashed) (display_copyright_message_loop ؛ do_nothing_nothing) () ؛ do_nothing_loop () ؛)) إذا (اكتشف_ ذاكرة التخزين المؤقت ()) (if_cache ()) ؛ )) (set_wait_states (لوتات) ؛ set_mouse (سرعة ، بطيئة جدًا) ؛ set_mouse (عمل ، سريع) ؛ set_mouse (رد فعل ، أحيانًا) ؛) / * printf ("مرحبًا بك في Windows 3.11") ؛ * / / * printf ("مرحبًا" إلى Windows 95 ") ؛ * / printf (" مرحبًا بك في Windows 98 ") ؛ إذا تعطل (system_ok ()) (to_dos_prompt) وإلا system_memory = open (" a: \ swp0001.swp "، O_CREATE) ؛ while (something) ( النوم (5) ؛ get_user_input () ؛ ينام (5) ؛ act_on_user_input () ، ينام (5) ؛ ) create_general_protection_fault () ،

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

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

الأجزاء المكونة لهذا المستند أسهل وأكثر وضوحًا لوصفها على الفور في شكل أمثلة.

كائن الاختبار

مثال: كائن الاختبار هو برنامج ... مخصص لـ ...

الغرض من الاختبارات

مثال: التحقق من موثوقية البرنامج.

متطلبات البرنامج

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

متطلبات توثيق البرامج

مثال: تكوين وثائق البرنامج المقدمة أثناء الاختبار:

  • وصف البرنامج (GOST 19.402-78) ؛
  • برنامج الاختبار ومنهجيته (GOST 19.301-79) ؛
  • نص البرنامج (GOST 19.401-78).

الوسائل وإجراءات الاختبار

مثال: يعمل البرنامج وفقًا لشروط تشغيل MS DOS (إصدار لا يقل عن 3.0) على كمبيوتر شخصي مثل IBM PC / AT ، وكذلك على الأجهزة المتوافقة. محول EGA (VGA) مطلوب أيضًا للتشغيل.

إجراء الاختبار:

    1. تم إطلاق البرنامج من قبل….
    2. المحدد ...
    3. ضغط ...
    4. تم التحديد بالتتابع ...

حالات تجريبية

مثال: للاختبار ، يتم تقديم ... ، ووصف الذي يرد في الملفات ... محتويات ملفات الاختبار ونتائج البرنامج موجودة في الملحق 1.

وأخيرًا ، ضع في اعتبارك آخر معيار ESPD ، والذي يسمى

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

المتطلبات العامة.من الضروري الدخول في مستندات البرنامج المنفذة بالطرق الكتابية والآلية والكتابة بخط اليد والكلمات الفردية والصيغ والعلامات التقليدية (يدويًا بخط الرسم) وحروف الأبجدية اللاتينية واليونانية ، وكذلك لتنفيذ المخططات والرسومات بالحبر الأسود أو الحبر.

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

لا يُسمح بإتلاف أوراق المستندات والبقع وآثار النص المحذوف غير الكامل (الرسومات).

يتم وضع وثائق البرنامج على أوراق A4. بجانب:

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

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

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

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

يُسمح بتضمين أجزاء الوثيقة من نص البرنامج ، الذي تم وضعه وفقًا لقواعد اللغة التي يُكتب بها نص البرنامج.

يتم وضع التعليق التوضيحي في صفحة (صفحات) منفصلة ، مزودة بالعنوان "ANNOTATION" ، مرقمة ومضمنة في محتوى المستند.

يتم تقسيم نص كل وثيقة ، إذا لزم الأمر ، إلى فقرات وفقرات - إلى فقرات فرعية ، بغض النظر عما إذا كان المستند مقسمًا إلى أجزاء وأقسام وأقسام فرعية أم لا.

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

يجب ترقيم الأقسام والأقسام الفرعية والبنود والفقرات بالأرقام العربية مع نقطة. يجب أن تحتوي الأقسام على رقم تسلسلي (1 ، 2 ، إلخ.)

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

يمكن صياغة التفسيرات اللازمة لنص الوثيقة مع الحواشي السفلية. تتم الإشارة إلى الحاشية السفلية برقم يحتوي على أقواس موضوعة على مستوى خط الاقتصاص العلوي للخط.

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

الرسوم التوضيحية.يمكن وضع الرسوم التوضيحية في نص المستند و / أو في الملاحق. الرسوم التوضيحية ، إذا كان هناك أكثر من واحدة في هذا المستند ، يتم ترقيمها بالأرقام العربية في جميع أنحاء المستند.

في الملاحق ، يتم ترقيم الرسوم التوضيحية داخل كل ملحق بالترتيب المحدد للنص الرئيسي للوثيقة. ترد الإشارات إلى الرسوم التوضيحية حسب النوع: "الشكل 12" أو "(الشكل 12)". يمكن أن تحتوي الرسوم التوضيحية على عنوان موضوعي ونص صورة يشرح محتوى الرسم التوضيحي.

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

ترد الإشارات في النص إلى الرقم الترتيبي للصيغة بين قوسين ، على سبيل المثال: "في الصيغة (3)". عند تقسيم مستند إلى أجزاء ، يتم وضع رقم الجزء قبل الرقم التسلسلي للصيغة ويفصل عن آخر نقطة ، على سبيل المثال: "في الصيغة (1.4)".

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

الروابط.يُسمح بالإشارات إلى المعايير والمستندات الأخرى في وثائق السياسة. يجب الإشارة إلى الوثيقة ككل أو إلى أقسامها (مع الإشارة إلى تسمية وعنوان الوثيقة ورقم وعنوان القسم أو التطبيق).

يُسمح بالإشارة فقط إلى تسمية المستند و (أو) الأقسام دون الإشارة إلى أسمائهم. لا يُسمح بالإشارة إلى الأقسام الفرعية والفقرات والرسوم التوضيحية الفردية لوثيقة أخرى. يُسمح بالإشارة إلى الفقرات والتوضيحات والأقسام الفرعية الفردية داخل المستند.

ملحوظات.في الملاحظات على النص والجداول ، يشار فقط إلى البيانات المرجعية والتفسيرية. ملاحظة واحدة غير مرقمة. بعد كلمة "ملاحظة" ضع نقطة. يجب ترقيم العديد من الملاحظات بأرقام عربية متسلسلة مع نقطة. كلمة "ملاحظة" متبوعة بنقطتين. يمكن طباعة نص الملاحظة بمسافة واحدة فقط.

الاختصارات.لا يُسمح باختصارات الكلمات في النص والتعليقات التوضيحية تحت الرسوم التوضيحية ، باستثناء:

  • تم إنشاء الاختصارات في GOST 2.316-68 والمقبولة عمومًا باللغة الروسية ؛
  • تستخدم الاختصارات لتعيين البرامج وأجزائها وطرق عملها ، ولغات التحكم في الوظائف ، وإعدادات البرامج ، وما إلى ذلك ، ويُشار إليها بأحرف الأبجدية اللاتينية.

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

يجب أن يبدأ كل تطبيق في صفحة جديدة بها كلمة "Application" في الزاوية اليمنى العليا وأن يكون لها عنوان موضوعي. في حالة وجود أكثر من مرفق واحد في المستند ، يتم ترقيم جميع المرفقات بالأرقام العربية (بدون علامة الرقم) ، على سبيل المثال:

الملحق 1 ، الملحق 2 ، إلخ.

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

G O S U D A R S T V E N N Y S T A N D A R T S O Y Z A S S R

نظام موحد لتوثيق البرنامج

GOST 19.103-77

تحديد البرامج ووثائق البرامج

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

تاريخ التقديم من 01.01.80

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

2. يجب أن يتكون تعيين البرامج والوثائق من مجموعات من الأحرف ، مفصولة بنقاط (بعد رمز البلد ورمز المنظمة المطورة) ، ومسافات (بعد رقم مراجعة المستند وكود نوع المستند) ، وواصلات (بعد التسجيل رقم ورقم وثيقة من هذا النوع).

3. يجري العمل على إنشاء نظام تسجيل لتحديد البرامج ووثائق البرنامج.

هيكل تسمية البرامج ووثيقة برنامجها - المواصفات:

أ.ب.XXXXX-XX
الجزء العام من التعيين / كود الدولة | | | |
برامج وبرامج | كود منظمة المطور | | |
وثائق لها \ رقم التسجيل | |
رقم الإصدار (للبرنامج) |
رقم المراجعة (للمستند) |

4 - هيكل تسمية وثائق البرنامج الأخرى:

أ. ب. XXXXX-XX XX XX-X
الجزء العام من تسمية البرنامج | | | | |
ووثائق البرنامج الموجودة عليه | | | | |
رقم مراجعة المستند | | | |
كود نوع الوثيقة | | |
رقم المستند من هذا النوع | |
رقم الجزء من المستند |

5. يتم تعيين رمز بلد المطور ورمز المنظمة (المؤسسة) للمطور وفقًا للإجراء المتبع.

يتم تعيين رقم التسجيل وفقًا لمصنف البرامج All-Union ، المعتمد من قبل معيار الولاية وفقًا للإجراء المعمول به.

قبل الموافقة على مصنف All-Union للبرامج ، يُسمح بتعيين رقم تسجيل بترتيب تصاعدي ، بدءًا من 00001 إلى 99999 ، لكل مؤسسة (مؤسسة) - مطور.

يتم تعيين رقم إصدار البرنامج أو رقم مراجعة المستند بترتيب تصاعدي من 01 إلى 99.

6. يتم تعيين رمز نوع المستند وفقًا لمتطلبات GOST 19.101-77.

7. يتم تعيين رقم المستند من هذا النوع بترتيب تصاعدي من 01 إلى 99.

8. يتم تعيين رقم الجزء لنفس المستند بترتيب تصاعدي من 1 إلى 9.

ملحوظة.إذا كان المستند يتكون من جزء واحد ، فلن تتم الإشارة إلى الواصلة والرقم التسلسلي للجزء.

9. يجب أن يتطابق رقم مراجعة المواصفات وبيان الوثائق التشغيلية للبرنامج مع رقم إصدار نفس البرنامج.

اعادة اصدار. نوفمبر 1987