Ինչպես ենք մենք գնահատել փաստաթղթերի որակը

Բարև, Հաբր: Ես Լեշան եմ, ես Alfa-Bank-ի արտադրանքի թիմերից մեկի համակարգերի վերլուծաբան եմ: Այժմ ես նոր առցանց բանկ եմ մշակում իրավաբանական անձանց և անհատ ձեռներեցների համար։

Իսկ երբ վերլուծաբան ես, հատկապես նման ալիքում, առանց փաստաթղթերի ու դրա հետ սերտ աշխատանքի չես կարող որևէ տեղ հասնել։ Իսկ փաստաթղթավորումը մի բան է, որը միշտ շատ հարցեր է առաջացնում: Ինչու՞ վեբ հավելվածը նկարագրված չէ: Ինչու՞ է ճշգրտումը ցույց տալիս, թե ինչպես պետք է աշխատի ծառայությունը, բայց այն ընդհանրապես այդպես չի աշխատում: Ինչո՞ւ է միայն երկու հոգի, որոնցից մեկն այն գրել է, կարող են հասկանալ հստակեցումը:

Այնուամենայնիվ, փաստաթղթերը չեն կարող անտեսվել ակնհայտ պատճառներով: Եվ մեր կյանքը հեշտացնելու համար մենք որոշեցինք գնահատել փաստաթղթերի որակը: Թե կոնկրետ ինչպես մենք դա արեցինք և ինչ եզրակացությունների եկանք, կտրվածքից ցածր է:

Փաստաթղթերի որակը

Որպեսզի տեքստում մի քանի տասնյակ անգամ չկրկնվի «Նոր ինտերնետ բանկ»-ը, ես կգրեմ NIB: Այժմ մենք ունենք մեկ տասնյակից ավելի թիմեր, որոնք աշխատում են ձեռնարկատերերի և իրավաբանական անձանց համար NIB-ի մշակման վրա: Ավելին, նրանցից յուրաքանչյուրը կա՛մ զրոյից ստեղծում է իր սեփական փաստաթղթերը նոր ծառայության կամ վեբ հավելվածի համար, կա՛մ փոփոխություններ է կատարում ընթացիկի մեջ։ Այս մոտեցմամբ սկզբունքորեն փաստաթղթավորումը կարո՞ղ է լինել բարձրորակ:

Եվ փաստաթղթերի որակը որոշելու համար մենք առանձնացրել ենք երեք հիմնական բնութագրիչ:

1. Այն պետք է լինի ամբողջական: Սա բավականին կապիտանային է թվում, բայց կարևոր է նշել: Այն պետք է մանրամասն նկարագրի իրականացված լուծման բոլոր տարրերը:
2. Այն պետք է համապատասխան լինի: Այսինքն՝ համապատասխանում է բուն լուծման ներկայիս իրականացմանը։
3. Դա պետք է հասկանալի լինի։ Որպեսզի այն օգտագործողը հասկանա, թե ինչպես է լուծումն իրականացվում։

Ամփոփելու համար՝ ամբողջական, արդի և հասկանալի փաստաթղթեր:

Опрос

Փաստաթղթերի որակը գնահատելու համար մենք որոշեցինք հարցազրույց վերցնել նրանց հետ, ովքեր անմիջականորեն աշխատում են դրա հետ՝ NIB-ի վերլուծաբաններից: Հարցվողներին առաջարկվել է գնահատել 10 պնդում՝ «1-ից 5 սանդղակով (լիովին համաձայն չեմ - լիովին համաձայն եմ)» սխեմայի համաձայն:

Հայտարարություններն արտացոլում էին որակական փաստաթղթերի բնութագրերը և հարցման կազմողների կարծիքը NIB փաստաթղթերի վերաբերյալ:

1. NIB հավելվածների փաստաթղթերը արդիական են և լիովին համապատասխանում են դրանց իրականացմանը:
2. NIB հավելվածների իրականացումն ամբողջությամբ փաստաթղթավորված է:
3. NIB հավելվածների համար փաստաթղթերն անհրաժեշտ են միայն ֆունկցիոնալ աջակցության համար:
4. NIB-ի հայտերի փաստաթղթերը առկա են գործառնական աջակցության համար դրանց ներկայացման պահին:
5. NIB հավելվածների մշակողները փաստաթղթավորում են օգտագործում՝ հասկանալու համար, թե ինչ պետք է իրականացնեն:
6. Բավականաչափ փաստաթղթեր կան, որպեսզի NIB հավելվածները հասկանան, թե ինչպես են դրանք իրականացվում:
7. Ես անհապաղ թարմացնում եմ NIB նախագծերի փաստաթղթերը, եթե դրանք ավարտվեն (իմ թիմի կողմից):
8. NIB հավելվածների մշակողները վերանայում են փաստաթղթերը:
9. Ես հստակ հասկանում եմ, թե ինչպես պետք է փաստաթղթեր պատրաստել NIB նախագծերի համար:
10. Ես հասկանում եմ, թե երբ պետք է գրել/թարմացնել փաստաթղթերը NIB նախագծերի համար:

Հասկանալի է, որ պարզապես «1-ից 5»-ը պատասխանելը կարող է չբացահայտել անհրաժեշտ մանրամասները, ուստի անձը կարող է մեկնաբանություն թողնել յուրաքանչյուր կետի վերաբերյալ:

Մենք այս ամենն արեցինք կորպորատիվ Slack-ի միջոցով. մենք պարզապես հրավեր ուղարկեցինք համակարգի վերլուծաբաններին՝ հարցում անցկացնելու համար: Վերլուծաբանները 15-ն էին (9-ը Մոսկվայից և 6-ը Սանկտ Պետերբուրգից): Հարցումն ավարտվելուց հետո մենք ստեղծեցինք միջին միավոր 10 հայտարարություններից յուրաքանչյուրի համար, որը մենք այնուհետև ստանդարտացրինք:

Ահա թե ինչ եղավ.

Հարցումը ցույց է տվել, որ թեև վերլուծաբանները հակված են կարծելու, որ NIB հավելվածների իրականացումը լիովին փաստաթղթավորված է, նրանք միանշանակ համաձայնություն չեն տալիս (0.2): Որպես կոնկրետ օրինակ՝ նրանք մատնանշեցին, որ մի շարք տվյալների բազաներ և առկա լուծումների հերթերը փաստաթղթային չեն: Մշակողը կարողանում է վերլուծաբանին ասել, որ ամեն ինչ չէ, որ փաստաթղթավորված է: Բայց այն թեզը, որ մշակողները վերանայում են փաստաթղթերը, նույնպես միանշանակ աջակցություն չստացավ (0.33): Այսինքն՝ պահպանվում է իրականացված լուծումների ոչ ամբողջական նկարագրության ռիսկը։

Համապատասխանությունն ավելի հեշտ է. չնայած կրկին չկա հստակ համաձայնություն (0,13), վերլուծաբանները դեռ հակված են համապատասխան համարել փաստաթղթերը: Մեկնաբանությունները մեզ թույլ տվեցին հասկանալ, որ արդիականության հետ կապված խնդիրներն ավելի հաճախ առաջանում են, քան մեջտեղում: Այնուամենայնիվ, նրանք մեզ ոչինչ չեն գրել աջակցելու մասին:

Ինչ վերաբերում է նրան, թե արդյոք վերլուծաբաններն իրենք են հասկանում, թե երբ է անհրաժեշտ փաստաթղթեր գրել և թարմացնել, համաձայնագիրը շատ ավելի միատեսակ էր (1,33), ներառյալ դրա դիզայնը (1.07): Այստեղ որպես անհարմարություն նշվել է փաստաթղթերի պահպանման միասնական կանոնների բացակայությունը։ Հետևաբար, որպեսզի չմիացնեն «Ով գնում է անտառ, ով է վառելափայտ» ռեժիմը, նրանք պետք է աշխատեն գոյություն ունեցող փաստաթղթերի օրինակներով։ Հետևաբար, օգտակար ցանկություն է ստեղծել փաստաթղթերի կառավարման ստանդարտ և մշակել դրանց մասերի ձևանմուշներ:

NIB-ի դիմումների փաստաթղթերը գործում են գործառութային աջակցության համար ներկայացնելու պահին (0.73): Սա հասկանալի է, քանի որ ֆունկցիոնալ աջակցության համար նախագիծ ներկայացնելու չափանիշներից մեկը արդի փաստաթղթերն են: Բավական է նաև հասկանալ իրագործումը (0.67), թեև երբեմն հարցեր են մնում։

Բայց այն, ինչի հետ հարցվողները համաձայն չէին (միանգամայն միաձայն) այն էր, որ NIB հավելվածների համար փաստաթղթերը, սկզբունքորեն, անհրաժեշտ են միայն ֆունկցիոնալ աջակցության համար (-1.53): Որպես փաստաթղթերի սպառողներ ամենից հաճախ նշվում էին վերլուծաբանները։ Թիմի մնացած մասը (մշակողները) - շատ ավելի քիչ հաճախ: Ավելին, վերլուծաբանները կարծում են, որ մշակողները չեն օգտագործում փաստաթղթեր՝ հասկանալու համար, թե ինչ պետք է իրականացնեն, թեև ոչ միաձայն (-0.06): Սա, ի դեպ, սպասվում է նաև այն պայմաններում, երբ կոդի մշակումն ու փաստաթղթաշրջանառությունը զուգահեռ են ընթանում։

Ո՞րն է հիմնականը և ինչու են մեզ անհրաժեշտ այս թվերը:

Փաստաթղթերի որակը բարելավելու համար մենք որոշեցինք անել հետևյալը.

1. Խնդրեք մշակողին վերանայել գրավոր փաստաթղթերը:
2. Հնարավորության դեպքում թարմացրեք փաստաթղթերը ժամանակին, առաջին հերթին:
3. Ստեղծեք և ընդունեք NIB նախագծերի փաստաթղթավորման ստանդարտ, որպեսզի բոլորը կարողանան արագ հասկանալ, թե համակարգի որ տարրերը և ինչպես պետք է ճշգրիտ նկարագրվեն: Դե, մշակե՛ք համապատասխան կաղապարներ։

Այս ամենը պետք է օգնի փաստաթղթերի որակը բարձրացնել նոր մակարդակի:

Համենայնդեպս ես այդպես հույս ունեմ։

Source: www.habr.com