შეცდომების იერარქია და პრიორიტეტების განათება

1) რატომ არის საჭირო შეცდომების იერარქია?

• აუხსნას რა მოხდა
• აჩვენეთ, რატომ არის ეს მნიშვნელოვანი
• მიუთითეთ რა უნდა გავაკეთოთ შემდეგ
• დაადგინეთ პრიორიტეტები, თუ რამდენიმე შეცდომაა.
• შეცდომების იერარქია ამცირებს კოგნიტურ დატვირთვას, აჩქარებს კორექტირებას და ზრდის ნაბიჯების კონვერსიას (რეგისტრაცია, გადახდა, KYC).

2) კრიტიკული დონის მოდელი

1. ინფო (ინფორმირება) - „პროფილი არასრულია, მოგვიანებით შეგიძლიათ შეავსოთ“. არ ბლოკავს.

2. Notice (ყურადღება) - „ლიმიტი თითქმის ამოწურულია“. გირჩევთ იმოქმედოთ.

3. Warning (გაფრთხილება) - „ფორმატის შეუსაბამობა, მონაცემები ნაწილობრივ არის დაცული“. შეიძლება ხელი შეუშალოს.

4. ერორი (შეცდომა) - „არასწორი ფორმატი/სავალდებულო ველი ცარიელია“. ბლოკავს კონკრეტულ ეფექტს.

5. კრიტიკული (კრიტიკული) - „გადახდა უარყოფილია/უსაფრთხოების რისკი“. ბლოკავს სცენარს, მოითხოვს დაუყოვნებლივ ნაბიჯს.

• ერთი ეკრანი არის ერთი მთავარი სტატუსი.
• მრავალჯერადი შეცდომით: ჩვენ ვაჩვენებთ ზემოდან კრიტიკას და სტაბილურად გადავუხვევთ პირველ შეცდომას.

3) პრიორიტეტების განსაზღვრის პრინციპები

1. ვიზუალური იერარქია: ფერი/იკონი/სისქე/კონტრასტი იზრდება კრიტიკულობით.
2. კოსმოსური სიახლოვე: შეცდომა ველის/ზონის მახლობლად, რომელსაც მიეკუთვნება.
3. ფოკუსი და გადახრა: პირველი შეცდომის მანქანა + ფოკუსი პრობლემურ სფეროში.
4. ერთი მთავარი callout: ზოგადი ბანერი/ალერტი კრიტიკულ საკითხზე + ადგილობრივი რჩევები.
5. ტოქსინების თანმიმდევრობა: ფერები/ხატები/შრიფტები ინფო/Warning/Error უცვლელია მთელ პროდუქტში.
6. ცხოვრების დრო: ადგილობრივი შეცდომები - ჯერ არ არის გამოსწორებული; ბანერები - დახურვამდე/შესწორებამდე.
7. ჩვენ არ ვაბნევთ მდგომარეობას: „ცარიელი“ - „შეცდომა“, „მოლოდინში“ - „შეცდომა“.

4) ვიზუალური ენა (UI ნიშნები)

• ინფო - ნეიტრალური ლურჯი/ნაცრისფერი,
• Notice - ქარვა/ყვითელი,
• Warning - ნარინჯისფერი
• ერორი - წითელი
• კრიტიკული - გაჯერებული წითელი + კონტრასტული ფონი.
• ხატები: info, notice, error/, success.

• ინლაინ შეტყობინება მინდვრის ქვეშ (მინიმალური ჩარჩო).
• Row-callout ხაზზე/ბარათზე.
• Page-alert (ბანერი) - ზოგადი/კრიტიკულისთვის.
• მიკროანიმაცია: რბილი გარეგნობა, განლაგების „ნაგვის“ გარეშე.

5) შეცდომების ტექსტები: ფორმულა და მაგალითები

ფორმულა: რა არ არის ისეთი + როგორ გამოსწორდეს + (რატომ/შეზღუდვა).

"არასწორი თარიღის ფორმატი. შეიყვანეთ DD ფორმატით. მმ. GGG"

"ფაილი ძალიან დიდია (მაქს. 10 MB). ჩამოტვირთეთ უფრო მცირე ფაილი"

"გადამოწმების არასაკმარისი დონე. გაიარეთ KYC - ამას დასჭირდება 2 წუთი"

"გადახდა უარყო ბანკმა. შეეცადეთ სხვა მეთოდი ან დაუკავშირდეთ ბანკს"

ანტი-ნიმუშები: „შეცდომა 400“, „რაღაც არასწორედ წარიმართა“, იუმორი სტრესულ ნაბიჯებში.

6) იერარქია რთული ფორმით (რეგისტრაცია/KUS/გადახდები)

1. ინტეგრაცია ბლურზე: ჩვენ დაუყოვნებლივ ვიღებთ ადგილობრივ შეცდომებს.
2. წყალმომარაგების გლობალური შემოწმება: ჩვენ ვაჩვენებთ ბანერს „გამოსწორებული მინდვრები“ და სია/წამყვანები.
3. შეცდომების ნავიგაცია: კლავიატურა/ტაბლეტი, „გადავიდეთ შეცდომაზე # 1/# N“.
4. კორექტირების პროცედურა: ჯერ ბლოკირება (Error/Critical), შემდეგ Warning/Notice.
5. კონტექსტის შენარჩუნება: შემოღებული მონაცემები შეცდომით არ იკარგება.

7) სკრიპტის სპეციფიკა

7. 1 გადახდა/დასკვნები

კრიტიკული: პროვაიდერის/ბანკის მიერ გადახრა, საეჭვო აქტივობა.
ერორი: ბარათის ველი/IBAN, ლიმიტები ოდენობით/სიხშირით.
Warning: ნელი ქსელი/ლოდინის დრო ჭარბი.

ტექსტი: "გადახდა უარყო ბანკმა. შეეცადეთ სხვა მეთოდი ან დაუკავშირდეთ ბანკს. კომისია არ არის გაუქმებული"

7. 2 KUS/უსაფრთხოება

კრიტიკული: დოკუმენტი გაყალბებულია/დაბლოკილი ქვეყანა/მულტფილმის ანგარიში.
ერორი: ამოუცნობი დოკუმენტი/თარიღის შეუსაბამობა.

ტექსტი: "დოკუმენტის ფოტო ბუნდოვანია. ატვირთეთ უფრო მკაფიო სურათი კარგი განათებით"

7. 3 ძებნა/ფილტრები

ეს არ არის შეცდომა, მაგრამ ნულოვანი შედეგი.

ტექსტი: „შედეგი არ არის {query}“. ამოიღეთ Provider: X ფილტრი ან შეეცადეთ „{alt}“. [ფილტრების ამოღება]"

8) წვდომა (A11y) და ტექნიკური მოთხოვნები

შეცდომები გამოცხადებულია ეკრანის ეკრანზე: aria-live = კრიტიკოსებისთვის „assertive“, სხვებისთვის „polite“.
შეცდომით ველები: aria-invalid =“ ნამდვილი“, aria-describedby შეტყობინებისთვის.
ფოკუსი გადადის პირველ შეცდომაზე; ტაბულაციის რიგი ინარჩუნებს ლოგიკას.
WCAG AA- ს კონტრასტი; ხატი არ ცვლის ტექსტს.
ტექსტი ხმამაღლა უნდა წაიკითხოს მნიშვნელობის დაკარგვის გარეშე.

9) ლოკალიზაცია და იურიდიული სიზუსტე

თავიდან აიცილოთ ჟარგონი და კულტურული მეტაფორები.
შეთანხმდით ტერმინებზე (გლოსარიუმი): „გადახდა უარყოფილია“, „ლიმიტი აღემატება“, „გადამოწმება“.
მიუთითეთ ადგილობრივი ფორმატის ვადები და შეზღუდვები: „15 წუთამდე“, ვალუტა/თარიღი.

10) ხარისხის მეტრიკა

Error rate მოედანზე/ნაბიჯზე (მომხმარებელთა წილი შეცდომის წინაშე აღმოჩნდა).
Time-to-Fix (საშუალო დრო პირველი შეცდომის გამოსწორებამდე).
შეცდომის შემდეგ დროპოფი (რამდენს ტოვებს გამოსწორების გარეშე).
შეცდომების განმეორება (ჩანაწერების) მომხმარებელთა/სესიების მიხედვით.
მიმართვები შეცდომის ტიპის მხარდასაჭერად.
ნაბიჯის გადაქცევა იერარქიაში ცვლილებების შემდეგ.

• Auto-croll და focus vs მხოლოდ ფერი/ტექსტი.
• მიზეზის ზუსტი ფორმულირება არის საერთო.
• განათების შეკვეთა (პირველი ბანერი - inline) vs (მხოლოდ inline).
• ბმულის დამატება „მოთხოვნების ჩვენება“ შეცდომის გვერდით.

11) ჩეკის სია გამოქვეყნებამდე

• თითოეულ შეცდომას აქვს დონე (Info/Notice/Warning/Error/Critical).
• ფერი/იკონკა/კონტეინერი შეესაბამება დონეს.
• არის პირველი შეცდომის გადახრა და ფოკუსის გადაცემა.
• მესიჯი განმარტავს, თუ როგორ/რატომ.
• ტერმინები ემთხვევა ტერმინს; შემოწმებულია ლოკალიზაცია.
• ხელმისაწვდომობა: aria ატრიბუტები, კონტრასტი, ხმამაღლა კითხვა.
• მონაცემები შეცდომით არ იკარგება.
• სტატუსები „ნულოვანი შედეგი“ და „მოლოდინი“ შეცდომად არ არის მიღებული.

12) მაგალითები „დაწყებამდე“

თარიღის ფორმა

ადრე: „შეცდომა 400“

შემდეგ: "თარიღის არასწორი ფორმატი. გამოიყენეთ DD. მმ. GGG"

გადახდა

ადრე: „გადახდა არ დასრულებულა“

შემდეგ: "გადახდა უარყო ბანკმა. შეეცადეთ სხვა მეთოდი ან დაუკავშირდეთ ბანკს. კომისია არ არის გაუქმებული"

KYC

ადრე: „დოკუმენტი არ იქნა მიღებული“

შემდეგ: "დოკუმენტის ამოცნობა ვერ მოხერხდა. ატვირთეთ ფოტოები ბლიკების გარეშე, კუთხეები და ტექსტი ჩანს"

ნულოვანი ძებნა (შეცდომა არ არის!)

ადრე: „შეცდომა: ვერაფერი იპოვნეს“

შემდეგ: „Live Roulette“ - ის შედეგები არ არის. ამოიღეთ High-limit ფილტრი ან შეეცადეთ roulette. [ფილტრების ამოღება]"

13) დიზაინის სისტემის კომპონენტები

``

Пропсы: `message`, `severity`, `ariaDescribedBy`, `compact`.
Render: ტექსტი + ხატი, ფერი 'severity'.

``

Пропсы: `title`, `description`, `severity`, `actions[]`.
პარამეტრები: 'info | notice | warning | error | critical'.

``

შეცდომების ჩამონათვალი მინდვრებში, კლავიატურის ნავიგაცია, „გადასვლა # 1“.

'' (ლოგიკა)

წესები სფეროში/ფორმა/ნაბიჯი, პრიორიტეტები, სქემები (მაგალითად, JSON-Schema), შეტყობინებების ლოკალიზაცია.

14) სწრაფი ფრაზების შაბლონები

15) პროცესი

დაპროგრამეთ ტექსტები რეალობის ლოგიკასთან ერთად.
შეინახეთ ხაზები i18n- ში კომპონენტების გვერდით, ვერსია.
PR ჩეკის ფურცელში: დონის შესაბამისობა, ატრიბუტების არსებობა, სწორი ლოკალიზაცია.
რეგულარულად გადახედეთ შეცდომებს მეტრიკებში და მხარდაჭერის უკუკავშირს.

საბოლოო ყალბი ფურცელი

Ocifrute დონე: Info Critical.
აჩვენეთ პრიორიტეტი ვიზუალურად და ყურადღებით.
ახსენით მოკლე და კონკრეტულად დარიგება.
ნუ უწოდებთ სიცარიელეს შეცდომას.
გაზომეთ და გააუმჯობესეთ: error rate, Time-to-Fix, drop-off.