Hatalaryň iýerarhiýasy we ileri tutulýan ugurlar
1) Näme üçin ýalňyşlyklaryň iýerarhiýasy gerek?
Hata diňe "gyzyl tekst" däl. Bu dolandyrylýan signal:- nämäniň nädogrydygyny düşündirmek,
- Munuň näme üçin möhümdigini görkezmek,
- indiki näme etmelidigini aýtmak,
- birnäçe ýalňyşlyk bar bolsa ileri tutmaly.
- Ýalňyşlyklaryň iýerarhiýasy aň-düşünjäni peseldýär, düzedişi çaltlaşdyrýar we ädimleriň öwrümini ýokarlandyrýar (hasaba alyş, tölegler, KYC).
2) Kritikligiň derejesi (Severity)
Biz 5 derejäni maslahat berýäris - habardan blokirlemäge çenli:1. Info (habar bermek) - "Profil doly däl, soňrak dolduryp bolýar". Bloklamaýar.
2. Notice (üns) - "Çäk gutardy diýen ýaly". Hereket etmegi maslahat berýäris.
3. Warning (duýduryş) - "Formatyň deňsizligi, maglumatlar bölekleýin saklandy". Päsgel berip biler.
4. Error (ýalňyşlyk) - "Nädogry format/hökmany meýdan boş". Belli bir hereketi bloklaýar.
5. Critical (möhüm) - "Töleg ret edildi/howpsuzlyk töwekgelçiligi". Ssenariýany bloklaýar, derrew ädim ätmegi talap edýär.
Düzgünler:- Bir ekran - bir esasy status.
- Köp ýalňyşlyklarda: ýokardan kritiki görkezýäris we birinji ýalňyşlyga yzygiderli aýlanýarys.
3) Ileri tutulýan ugurlary beýan etmegiň ýörelgeleri
1. Wizual iýerarhiýa: reňk/nyşan/galyňlyk/kontrast kritiklik bilen ýokarlanýar.
2. Giňişlik ýakynlygy: degişli meýdanyň/zonanyň gapdalyndaky ýalňyşlyk.
3. Fokus we aýlamak: Ilkinji ýalňyşlyga awto-skroll + problema meýdanyna fokus.
4. Bir esasy jaň: möhüm mesele barada umumy banner/alert + ýerli maslahatlar.
5. Bellikleriň yzygiderliligi: Info/Warning/Error üçin reňkler/nyşanlar/şriftler önümde üýtgemez.
6. Durmuş wagty: ýerli ýalňyşlyklar - entek düzedilmedi; bannerler - ýapylýança/düzedilýänçä.
7. "Boş" ≠ "ýalňyşlyk", "garaşmak" ≠ "ýalňyşlyk" ýagdaýlaryny bulaşdyrmaýarys.
4) Wizual dil (UI-bellikler)
Reňkler:- Info - bitarap gök/çal,
- Notice - amber/sary,
- Warning - mämişi,
- Error - gyzyl,
- Critical - baý gyzyl + kontrast fon.
- Nyşanlar: info ⓘ, notice, error/, success.
- Meýdanyň aşagyndaky inline-habar (iň kiçi çarçuwa).
- Row-callout setirine/kartoçkasyna.
- Page-alert (banner) - umumy/kritiki üçin.
- Mikro animasiýalar: ýumşak görnüş, maket "çekilmezden".
5) Ýalňyşlyklaryň tekstleri: formula we mysallar
Formula: Näme nädogry + Nädip düzedmeli + (Näme üçin/çäklendirme).
"Senäniň formaty nädogry. DD görnüşinde giriziň. MM. GGGG"
"Faýl gaty uly (iň ýokary 10 MB). Has kiçi faýly göçürip alyň"
"Barlagyň ýeterlik derejesi. KYC geçiň - bu ~ 2 minut gerek bolar"
"Töleg bank tarapyndan ret edildi. Başga usuly synap görüň ýa-da bank bilen habarlaşyň"
Anti-nagyşlar: "Ýalňyşlyk 400", "Bir zat nädogry boldy", stresli ädimlerde gülkünç.
6) Çylşyrymly görnüşdäki iýerarhiýa (hasaba alyş/KUS/tölegler)
1. Blur-da inline-validasiýa: lokal ýalňyşlyklary derrew tutýarys.
2. Submit global barlagy: "Bellenen ýerleri düzet" bannerini we sanawyny/labyrlaryny görkezýäris.
3. Ýalňyşlyklar boýunça nawigasiýa: klawiatura/tabýa, "Ýalňyşlyga git # 1/ #N".
4. Düzediş tertibi: ilki bloklaýjy (Error/Critical), soň Warning/Notice.
5. Kontekstiň saklanmagy: girizilen maglumatlar ýalňyşlyk ýüze çykan halatynda ýitmez.
7) Ssenarileriň aýratynlyklary
7. 1 Tölegler/netijeler
Critical: üpjün ediji/bank tarapyndan ret edilmegi, şübheli işjeňlik.
Error: kartyň/IBAN meýdany, jemi/ýygylygy boýunça çäkler.
Warning: haýal tor/garaşmak wagtyndan artyk.
Teksti: "Töleg bank tarapyndan ret edildi. Başga usuly synap görüň ýa-da bank bilen habarlaşyň. Komissiýa ýazylmady"
7. 2 KUS/howpsuzlyk
Critical: Resminama galplaşdyryldy/petiklenen ýurt/köp hasap.
Error: okalmaýan resminama/senäniň gabat gelmezligi.
Teksti: "Resminamanyň suraty bulaşyk. Gowy yşyklandyryşda has aýdyň suraty ýükläň"
7. 3 Gözleg/süzgüçler
Bu ýalňyşlyk däl, nol netije.
"{query}" üçin hiç hili netije ýok. "Üpjün ediji: X" süzgüçini aýyryň ýa-da "{alt}" synagyny geçiriň. [Süzgüçleri taşla]"
8) Elýeterlilik (A11y) we tehniki talaplar
Kemçilikler skrinridere yglan edilýär: aria-live = "assertive" kritikler üçin, "polite" beýlekiler üçin.
Hataly meýdanlar: aria-invalid =" true", habara aria-describedby.
Fokus birinji ýalňyşlyga geçirilýär; tabulýasiýa tertibi logikany saklaýar.
WCAG AA boýunça kontrast; nyşan tekstiň ornuny tutmaýar.
Teksti manysyny ýitirmän sesli okamaly.
9) Lokalizasiýa we kanuny takyklyk
Jargondan we medeni metaforalardan gaça duruň.
"Töleg ret edildi", "çäk geçdi", "tassyklama" adalgalaryny (sözbaşysyny) ylalaşmak.
Möhletleri we çäklendirmeleri ýerli formatda görkezmek: "15 minuda çenli", walýuta/seneler.
10) Hil ölçegleri
Meýdan/ädim boýunça error rate (ýalňyşlyk bilen ýüzbe-ýüz bolan ulanyjylaryň paýy).
Wagt-to-Fix (ilkinji ýalňyşlygyň düzedilmegine çenli ortaça wagt).
Hatadan soň drop-off (düzedilmän näçe gidýär).
Ulanyjylar/sessiýalar boýunça ýalňyşlyklaryň gaýtalanmagy (recurrence).
Hatanyň görnüşi boýunça goldaw üçin ýüz tutmalar.
Iýerarhiýadaky üýtgeşmelerden öň/soň ädimiň öwrülişigi.
- Awto-skroll we fokus vs diňe reňk/tekst.
- Sebäbiniň takyk formulasy vs umumy.
- Yşyklandyryş tertibi (ilki banner → inline) vs (diňe inline).
- Hatanyň gapdalynda "Talaplary göster" baglanyşygyny goşmak.
11) Goýberilmezden öň çek-sanawy
- Her bir ýalňyşlygyň derejesi bar (Info/Notice/Warning/Error/Critical).
- Reňk/nyşan/konteýner derejä laýyk gelýär.
- Ilkinji ýalňyşlyk we fokus göçürmesi bar.
- Habar näme/nädip/näme üçin düşündirýär.
- Adalgalar sözbaşy bilen gabat gelýär; lokalizasiýa barlandy.
- Elýeterlilik: aria atributlary, kontrast, sesli okamak.
- Maglumatlar ýalňyşlyk ýüze çyksa ýitmez.
- "Nol netije" we "garaşmak" statuslary ýalňyşlyk hökmünde resmileşdirilmeýär.
12) "Öň/soň" mysallary
Senäniň görnüşi
Ondan öň: "Hata 400"
Ondan soň: "Senäniň formaty nädogry. DD ulanyň. MM. GGGG"
Töleg
Öň: "Töleg geçmedi"
Soň: "Töleg bank tarapyndan ret edildi. Başga usuly synap görüň ýa-da bank bilen habarlaşyň. Komissiýa ýazylmady"
KYC
Öň: "Resminama kabul edilmedi"
Soň: "Resminama tanalmady. Suraty şöhlesiz ýükläň, burçlar we tekst görünýär"
Nol gözleg (hata däl!)
Öň: "Hata: hiç zat tapylmady"
Ondan soň: "Live roulette" boýunça netije ýok. "High-limit" süzgüçini aýyryň ýa-da "roulette" synagyny görüň. [Süzgüçleri taşla]"
13) Dizaýn ulgamynyň komponentleri
`
Пропсы: `message`, `severity`, `ariaDescribedBy`, `compact`.
Render: tekst + nyşan, reňk 'severity'.
`
Пропсы: `title`, `description`, `severity`, `actions[]`.
Saýlawlar: 'info | notice | warning | error | critical'.
`
Meýdanlara labyrlar bilen ýalňyşlyklaryň sanawy, klawiatura nawigasiýasy, "Git # 1".
' ' (logika)
Meýdan/forma/ädim, ileri tutulýan ugurlar, shemalar (mysal üçin JSON-Shema), habarlaryň lokalizasiýasy boýunça düzgünler.
14) Çalt sözlem şablonlary
15) Işe goşulmak
Tekstleri tassyklamagyň logikasy bilen bir wagtda dizaýn ediň.
Komponentleriň gapdalynda i18n setirlerini saklaň, wersiýa ediň.
PR çek sanawynda: derejä laýyklyk, aria atributlarynyň barlygy, dogry lokalizasiýa.
Metrikler we goldaw sesleri boýunça ýalňyşlyklary yzygiderli gygyrmak.
Jemleýji şpargalka
Derejeleri sanlaşdyryň: Info → Critical.
Ileri tutulýan ugurlary wizual we fokusda görkeziň.
Düzedişi gysgaça we anyk düşündiriň.
Boşlugy ýalňyşlyk diýip atlandyrmaň.
Ölçäň we kämilleşdiriň: error rate, Time-to-Fix, drop-off.