Система технической документации на АСУ. Требования к содержанию документов по программному обеспечению

ÓÄÊ 65.011.56:681.3:002:006.354 Ãðóïïà Ò52

Ã Î Ñ Ó Ä À Ð Ñ Ò Â Å Í Í Û É   Ñ Ò À Í Ä À Ð Ò   Ñ Î Þ Ç À   Ñ Ñ Ð

Ñèñòåìà òåõíè÷åñêîé äîêóìåíòàöèè íà ÀÑÓ ÃÎÑÒ 24.207-80*
 
 
ÒÐÅÁÎÂÀÍÈß Ê ÑÎÄÅÐÆÀÍÈÞ ÄÎÊÓÌÅÍÒΠÏÎ ÏÐÎÃÐÀÌÌÍÎÌÓ ÎÁÅÑÏÅ×ÅÍÈÞ
 
 
 
System of technical documentation for computer control systems. Requirements for contents of documents on software
 

Ïîñòàíîâëåíèåì Ãîñóäàðñòâåííîãî êîìèòåòà ÑÑÑÐ ïî ñòàíäàðòàì îò 14 ìàÿ 1980 ã. ¹ 2101 ñðîê ââåäåíèÿ óñòàíîâëåí
ñ 01.01 1981 ã.
Íàñòîÿùèé ñòàíäàðò ðàñïðîñòðàíÿåòñÿ íà òåõíè÷åñêóþ äîêóìåíòàöèþ íà àâòîìàòèçèðîâàííûå ñèñòåìû óïðàâëåíèÿ (ÀÑÓ) âñåõ âèäîâ, ðàçðàáàòûâàåìûå äëÿ âñåõ óðîâíåé óïðàâëåíèÿ (êðîìå îáùåãîñóäàðñòâåííîãî), è óñòàíàâëèâàåò òðåáîâàíèÿ ê ñîäåðæàíèþ äîêóìåíòîâ, âõîäÿùèõ â ñîîòâåòñòâèè ñ ÃÎÑÒ 24.101-80 â ñîñòàâ äîêóìåíòàöèè ïðîãðàììíîãî îáåñïå÷åíèÿ â ïðîåêòàõ ÀÑÓ.
1. ÎÁÙÈÅ ÏÎËÎÆÅÍÈß
1.1. Äîêóìåíòàöèÿ ïðîãðàììíîãî îáåñïå÷åíèÿ ïðåäíàçíà÷åíà:
· äëÿ îïèñàíèÿ ïðîåêòíûõ ðåøåíèé ïî ïðîãðàììíîìó îáåñïå÷åíèþ â äîêóìåíòå “Îïèñàíèå ïðîãðàììíîãî îáåñïå÷åíèÿ ÀÑÓ”.
· äëÿ óñòàíîâëåíèÿ òðåáîâàíèé ê ïðîãðàììå (êîìïëåêñó ïðîãðàìì) â äîêóìåíòå “Òåõíè÷åñêîå çàäàíèå”;
· äëÿ îïèñàíèÿ ðåøåíèé, îáåñïå÷èâàþùèõ ñîïðîâîæäåíèå, èçãîòîâëåíèå è ýêñïëóàòàöèþ ïðîãðàììû (êîìïëåêñà ïðîãðàìì) â äîêóìåíòàõ “Ïîÿñíèòåëüíàÿ çàïèñêà”, “Îïèñàíèå ïðèìåíåíèÿ”, “Îïèñàíèå ïðîãðàììû”, “Ñïåöèôèêàöèÿ”, “Ðóêîâîäñòâî ïðîãðàììèñòà”, “Ðóêîâîäñòâî îïåðàòîðà”, “Òåêñò ïðîãðàììû”, “Ôîðìóëÿð”, “Ïîðÿäîê è ìåòîäèêà èñïûòàíèé”;
· äëÿ ïðîâåðêè ðàáîòîñïîñîáíîñòè ïðîãðàììû (êîìïëåêñà ïðîãðàìì) â äîêóìåíòå “Îïèñàíèå êîíòðîëüíîãî ïðèìåðà”.
(Èçìåíåííàÿ ðåäàêöèÿ, Èçì. ¹ 1).
1.2. Ïðè ðàçðàáîòêå äîêóìåíòîâ íà ÷àñòè ÀÑÓ ñîäåðæàíèå ðàçäåëîâ êàæäîãî äîêóìåíòà îãðàíè÷èâàþò ðàìêàìè ñîîòâåòñòâóþùåé ÷àñòè.
1.3.  çàâèñèìîñòè îò íàçíà÷åíèÿ è ñïåöèôè÷åñêèõ îñîáåííîñòåé ñîçäàâàåìûõ ÀÑÓ äîïóñêàåòñÿ âêëþ÷àòü â äîêóìåíòû äîïîëíèòåëüíûå ðàçäåëû, òðåáîâàíèÿ ê ñîäåðæàíèþ êîòîðûõ íå óñòàíîâëåíû íàñòîÿùèì ñòàíäàðòîì. Îòñóòñòâèå ïðîåêòíûõ ðåøåíèé ïî ðàçäåëó äîêóìåíòà ôèêñèðóþò â ñîîòâåòñòâóþùåì ðàçäåëå ñ íåîáõîäèìûìè ïîÿñíåíèÿìè.
1.4. Òðåáîâàíèÿ ê ñîäåðæàíèþ äîêóìåíòîâ “Òåõíè÷åñêîå çàäàíèå”, “Ïîÿñíèòåëüíàÿ çàïèñêà”, “Îïèñàíèå ïðèìåíåíèÿ”, “Ñïåöèôèêàöèÿ”, “Ðóêîâîäñòâî îïåðàòîðà”, “Òåêñò ïðîãðàììû”, “Ôîðìóëÿð”, “Ïîðÿäîê è ìåòîäèêà èñïûòàíèé” óñòàíîâëåíû ÃÎÑÒ 19.201-78, ÃÎÑÒ 19.404-79, ÃÎÑÒ 19.502-78, ÃÎÑÒ 19.202-78, ÃÎÑÒ 19.505-79, ÃÎÑÒ 19.401-78, ÃÎÑÒ 19.501-78 è ÃÎÑÒ 19.301-79.
(Èçìåíåííàÿ ðåäàêöèÿ, Èçì. ¹ 1).
2. ÒÐÅÁÎÂÀÍÈß Ê ÑÎÄÅÐÆÀÍÈÞ ÄÎÊÓÌÅÍÒÎÂ
2.1. Îïèñàíèå ïðîãðàììíîãî îáåñïå÷åíèÿ ÀÑÓ
2.1.1. Äîêóìåíò äîëæåí ñîäåðæàòü ââîäíóþ ÷àñòü è ðàçäåëû:
· ñòðóêòóðà ïðîãðàììíîãî îáåñïå÷åíèÿ;
· îñíîâíûå ôóíêöèè ÷àñòåé ïðîãðàììíîãî îáåñïå÷åíèÿ;
· ìåòîäû è ñðåäñòâà ðàçðàáîòêè ïðîãðàììíîãî îáåñïå÷åíèÿ;
· îïåðàöèîííàÿ ñèñòåìà;
· ñðåäñòâà, ðàñøèðÿþùèå âîçìîæíîñòè îïåðàöèîííîé ñèñòåìû.
2.1.2. Ââîäíàÿ ÷àñòü äîëæíà ñîäåðæàòü îñíîâíûå ñâåäåíèÿ î òåõíè÷åñêîì, èíôîðìàöèîííîì è äðóãèõ âèäàõ îáåñïå÷åíèÿ ÀÑÓ, íåîáõîäèìûå äëÿ ðàçðàáîòêè ïðîãðàììíîãî îáåñïå÷åíèÿ, èëè ññûëêó íà ñîîòâåòñòâóþùèå äîêóìåíòû ïðîåêòà ÀÑÓ.
2.1.3. Ðàçäåë “Ñòðóêòóðà ïðîãðàììíîãî îáåñïå÷åíèÿ” äîëæåí ñîäåðæàòü ïåðå÷åíü ÷àñòåé ïðîãðàììíîãî îáåñïå÷åíèÿ ñ óêàçàíèåì èõ âçàèìîñâÿçåé è îáîñíîâàíèåì âûäåëåíèÿ êàæäîé èç íèõ.
2.1.4. Ðàçäåë “Îñíîâíûå ôóíêöèè ÷àñòåé ïðîãðàììíîãî îáåñïå÷åíèÿ” äîëæåí ñîäåðæàòü ïîäðàçäåëû, â êîòîðûõ äëÿ êàæäîé ÷àñòè ïðîãðàììíîãî îáåñïå÷åíèÿ ïðèâîäÿò íàçíà÷åíèå è îïèñàíèå îñíîâíûõ ôóíêöèé
(Èçìåíåííàÿ ðåäàêöèÿ, Èçì. ¹ 1).
2.1.5. Ðàçäåë “Ìåòîäû è ñðåäñòâà ðàçðàáîòêè ïðîãðàììíîãî îáåñïå÷åíèÿ” äîëæåí ñîäåðæàòü ïåðå÷åíü ìåòîäîâ ïðîãðàììèðîâàíèÿ è ñðåäñòâ ðàçðàáîòêè ïðîãðàììíîãî îáåñïå÷åíèÿ ÀÑÓ ñ óêàçàíèåì ÷àñòåé ïðîãðàììíîãî îáåñïå÷åíèÿ, ïðè ðàçðàáîòêå êîòîðûõ ñëåäóåò èñïîëüçîâàòü ñîîòâåòñòâóþùèå ìåòîäû è ñðåäñòâà.
2.1.6. Ðàçäåë “Îïåðàöèîííàÿ ñèñòåìà” äîëæåí ñîäåðæàòü:
· íàèìåíîâàíèå, îáîçíà÷åíèå è êðàòêóþ õàðàêòåðèñòèêó âûáðàííîé îïåðàöèîííîé ñèñòåìû è åå âåðñèè, â ðàìêàõ êîòîðîé áóäóò âûïîëíÿòü ðàçðàáàòûâàåìûå ïðîãðàììû, ñ îáîñíîâàíèåì âûáîðà è óêàçàíèåì èñòî÷íèêîâ, ãäå äàíî ïîäðîáíîå îïèñàíèå âûáðàííîé âåðñèè;
· íàèìåíîâàíèå ðóêîâîäñòâà, â ñîîòâåòñòâèè ñ êîòîðûì äîëæíà îñóùåñòâëÿòüñÿ ãåíåðàöèÿ âûáðàííîãî âàðèàíòà îïåðàöèîííîé ñèñòåìû;
· òðåáîâàíèÿ ê âàðèàíòó ãåíåðàöèè âûáðàííîé âåðñèè îïåðàöèîííîé ñèñòåìû.
2.1.7. Ðàçäåë “Ñðåäñòâà, ðàñøèðÿþùèå âîçìîæíîñòè îïåðàöèîííîé ñèñòåìû” äîëæåí ñîäåðæàòü ïîäðàçäåëû, â êîòîðûõ äëÿ êàæäîãî èñïîëüçóåìîãî ñðåäñòâà, ðàñøèðÿþùåãî âîçìîæíîñòè îïåðàöèîííîé ñèñòåìû, ñëåäóåò óêàçàòü:
· íàèìåíîâàíèå, îáîçíà÷åíèå è êðàòêóþ õàðàêòåðèñòèêó ñðåäñòâà ñ îáîñíîâàíèåì íåîáõîäèìîñòè åãî ïðèìåíåíèÿ è óêàçàíèåì èñòî÷íèêà, ãäå äàíî ïîäðîáíîå îïèñàíèå âûáðàííîãî ñðåäñòâà;
· íàèìåíîâàíèå ðóêîâîäñòâà, â ñîîòâåòñòâèè ñ êîòîðûì ñëåäóåò íàñòðàèâàòü èñïîëüçóåìîå ñðåäñòâî íà êîíêðåòíîå ïðèìåíåíèå;
· òðåáîâàíèÿ ê íàñòðîéêå èñïîëüçóåìîãî ñðåäñòâà.
2.2. Îïèñàíèå ïðîãðàììû
2.2.1. Ñîäåðæàíèå äîêóìåíòà äîëæíî ñîîòâåòñòâîâàòü ÃÎÑÒ 19.402-78.
2.2.2. Äëÿ ïðîãðàììû (êîìïëåêñà ïðîãðàìì), ïîëó÷àåìîé çà ñ÷åò èñïîëüçîâàíèÿ ðàíåå ðàçðàáîòàííûõ ïðîãðàììíûõ ñðåäñòâ, äîêóìåíò “Îïèñàíèå ïðîãðàììû” ñëåäóåò äîïîëíÿòü ðàçäåëîì “Íàñòðîéêà ïðîãðàììíûõ ñðåäñòâ”.
2.2.3. Ðàçäåë “Íàñòðîéêà ïðîãðàììíûõ ñðåäñòâ” äîëæåí ñîäåðæàòü:
· íàèìåíîâàíèå, îáîçíà÷åíèå èñïîëüçîâàííûõ ïðîãðàììíûõ ñðåäñòâ, îïèñàíèå ïðîöåäóð, íåîáõîäèìûõ äëÿ èõ íàñòðîéêè, èëè ññûëêè íà ýêñïëóàòàöèîííóþ äîêóìåíòàöèþ ýòèõ ñðåäñòâ;
· ïåðå÷åíü ýëåìåíòîâ èñïîëüçîâàííûõ ïðîãðàììíûõ ñðåäñòâ, íåîáõîäèìûõ äëÿ ïîëó÷åíèÿ ïðîãðàììû (êîìïëåêñà ïðîãðàìì);
· îïèñàíèå íàñòðîéêè íà ÿçûêå, ïðåäóñìîòðåííîì â ýêñïëóàòàöèîííîé äîêóìåíòàöèè íà èñïîëüçóåìûå ïðîãðàììíûå ñðåäñòâà.
2.3. Ðóêîâîäñòâî ïðîãðàììèñòà
2.3.1. Äîêóìåíò ïî ñîñòàâó ðàçäåëîâ è èõ ñîäåðæàíèþ äîëæåí ñîîòâåòñòâîâàòü ÃÎÑÒ 19.504-79 è, êðîìå òîãî, âêëþ÷àòü ðàçäåë “Ñâåäåíèÿ î ôîðìå ïðåäñòàâëåíèÿ ïðîãðàììû (êîìïëåêñà ïðîãðàìì)”.
2.3.2. Ðàçäåë “Ñâåäåíèÿ î ôîðìå ïðåäñòàâëåíèÿ ïðîãðàììû (êîìïëåêñà ïðîãðàìì)” äîëæåí ñîäåðæàòü ñâåäåíèÿ î íîñèòåëå, íà êîòîðîì çàïèñàíà ïðîãðàììà, î ñîäåðæàíèè è ñèñòåìå êîäèðîâàíèÿ èíôîðìàöèè, çàïèñàííîé íà íîñèòåëå, à òàêæå ñâåäåíèÿ, íåîáõîäèìûå äëÿ ÷òåíèÿ èíôîðìàöèè ñ íîñèòåëÿ.
2.3.3. Äëÿ ïðîãðàììû (êîìïëåêñà ïðîãðàìì), äîïóñêàþùåé íàñòðîéêó íà óñëîâèÿ êîíêðåòíîãî ïðèìåíåíèÿ, â äîêóìåíò “Ðóêîâîäñòâî ïðîãðàììèñòà” âêëþ÷àþò ðàçäåëû:
· ñòðóêòóðà ïðîãðàììû;
· íàñòðîéêà ïðîãðàììû;
· äîïîëíèòåëüíûå âîçìîæíîñòè;
· ñîîáùåíèÿ ñèñòåìíîìó ïðîãðàììèñòó.
Ñîäåðæàíèå ýòèõ ðàçäåëîâ äîëæíî ñîîòâåòñòâîâàòü òðåáîâàíèÿì ÃÎÑÒ 19.503-79.
2.3.4. Ðàçðåøàåòñÿ äëÿ ïðîãðàììû (êîìïëåêñà ïðîãðàìì), äîïóñêàþùåé íàñòðîéêó íà óñëîâèÿ êîíêðåòíîãî ïðèìåíåíèÿ, âìåñòî ðàçäåëîâ, ïåðå÷èñëåííûõ â ï. 2.3.3, ðàçðàáàòûâàòü îòäåëüíûé äîêóìåíò “Ðóêîâîäñòâî ñèñòåìíîãî ïðîãðàììèñòà”, óäîâëåòâîðÿþùèé òðåáîâàíèÿì ÃÎÑÒ 19.503-79.
2.4. Îïèñàíèå êîíòðîëüíîãî ïðèìåðà
2.4.1. Äîêóìåíò äîëæåí ñîäåðæàòü ðàçäåëû:
· íàçíà÷åíèå;
· èñõîäíûå äàííûå;
· ðåçóëüòàòû ðàñ÷åòà;
· ïðîâåðêà ïðîãðàììû (êîìïëåêñà ïðîãðàìì).
2.4.2. Ðàçäåë “Íàçíà÷åíèå” äîëæåí ñîäåðæàòü ïåðå÷åíü ïàðàìåòðîâ è êðàòêóþ õàðàêòåðèñòèêó ôóíêöèè, èç ÷èñëà ðåàëèçóåìûõ ïðîãðàììîé (êîìïëåêñîì ïðîãðàìì), ïðîâåðÿåìûõ êîíòðîëüíûì ïðèìåðîì.
2.4.3. Ðàçäåë “Èñõîäíûå äàííûå” äîëæåí ñîäåðæàòü îïèñàíèå èñõîäíûõ äàííûõ äëÿ ïðîâåðêè ïðîãðàììû (êîìïëåêñà ïðîãðàìì) ñ ïðèâåäåíèåì èñõîäíûõ äàííûõ. Äîïóñêàåòñÿ èñõîäíûå äàííûå ïðåäñòàâëÿòü â âèäå ðàñïå÷àòêè ñ ÀÖÏÓ.
2.4.4. Ðàçäåë “Ðåçóëüòàòû ðàñ÷åòà” äîëæåí ñîäåðæàòü ðåçóëüòàòû îáðàáîòêè èñõîäíûõ äàííûõ ïðîãðàììîé (êîìïëåêñîì ïðîãðàìì), ïîçâîëÿþùèå îöåíèòü ïðàâèëüíîñòü âûïîëíåíèÿ ïðîâåðÿåìûõ ôóíêöèè è çíà÷åíèå ïðîâåðÿåìûõ ïàðàìåòðîâ. Äîïóñêàåòñÿ ðåçóëüòàòû ðàñ÷åòà ïðèâîäèòü â âèäå ðàñïå÷àòêè ñ ÀÖÏÓ.
2.4.5. Ðàçäåë “Ïðîâåðêà ïðîãðàììû (êîìïëåêñà ïðîãðàìì)” äîëæåí ñîäåðæàòü:
· îïèñàíèå ñîñòàâà òåõíè÷åñêèõ ñðåäñòâ, íåîáõîäèìûõ äëÿ ðàáîòû ïðîãðàììû (êîìïëåêñà ïðîãðàìì), èëè ññûëêó íà ñîîòâåòñòâóþùèå ïðîãðàììíûå äîêóìåíòû;
· îïèñàíèå ïðîöåäóð ôîðìèðîâàíèÿ èñõîäíûõ äàííûõ äëÿ ïðîâåðêè ïðîãðàììû (êîìïëåêñà ïðîãðàìì), âûçîâà ïðîâåðÿåìîé ïðîãðàììû (êîìïëåêñà ïðîãðàìì) è ïîëó÷åíèÿ ðåçóëüòàòîâ ðàñ÷åòà;
· îïèñàíèå äåéñòâèé îïåðàòîðà ïðè ïîäãîòîâêå èñõîäíûõ äàííûõ è ïðîâåðêå ïðîãðàììû (êîìïëåêñà ïðîãðàìì) íà êîíòðîëüíîì ïðèìåðå.
*Ïåðåèçäàíèå (ìàé 1986 ã.) ñ Èçìåíåíèåì ¹ 1, óòâåðæäåííûì â àâãóñòå 1985 ã. (ÈÓÑ 11-85).