Fix: Onboarding UX & KYC Authentication Flow #200

Closed
opened 2026-06-04 17:08:13 +02:00 by kincses · 2 comments
Owner

Mérföldkő: Authentication & User Management
Cél: Javítani a regisztrációs és KYC folyamat UX problémáit, különösen a 'Not authenticated' hibát

🔗 Függőségek (Dependencies)

  • Bemenet: Frontend Auth Store, Backend Auth Service, VerifyEmailView, CompleteKycView
  • Kimenet: Javított user onboarding experience, Soft KYC support

📝 Implementált Javítások

1. Not authenticated hiba javítása

  • A verify success után már nem irányít egyból KYC-re
  • Sikeres aktiválás után 'Tovább a Belépéshez' gomb jelenik meg
  • A rendszer belépés után ellenőrzi a KYC státuszt és akkor irányít a /complete-kyc-re

2. E-mail automatikus kitöltés

  • Regisztrációkor az email mentésre kerül localStorage-ba (pending_verification_email)
  • A VerifyEmailView automatikusan betölti ezt az emailt
  • Sikeres belépés után törlődik a localStorage értéke

3. Tab order javítás

  • A Házszám mező kitöltése után Tab billentyű a Tovább gombra ugrik
  • Használt megoldás: @keydown.tab.exact event handler + nextTick + ref

4. Opcionális Okmányok (Soft KYC)

  • Backend: identity_docs most Optional a UserKYCComplete sémában
  • Backend: DocumentDetail mezői (number, expiry_date) szintén Optional
  • Frontend: ID_CARD validáció eltávolítva, minden okmány opcionális
  • Frontend: Vizuális jelzés: '(opcionális)' címke az okmányoknál
  • Frontend payload: Csak akkor küldi az identity_docs-ot, ha legalább egy mező ki van töltve

5. Auth Store KYC redirect logika

  • Login után automatikusan ellenőrzi a isKycComplete értékét
  • Ha KYC nem teljes, átirányít a /complete-kyc oldalra
  • Ha teljes, normál működés (dashboard vagy amit a LoginModal diktál)

🧪 Tesztelési lépések

  1. Új user regisztráció
  2. Email verify link kattintás
  3. 'Tovább a belépéshez' gomb megjelenése ellenőrzés
  4. Belépés után automatikus KYC átirányítás
  5. KYC kitöltés okmányok nélkül (csak név + cím)
  6. Sikeres mentés ellenőrzése
**Mérföldkő:** Authentication & User Management **Cél:** Javítani a regisztrációs és KYC folyamat UX problémáit, különösen a 'Not authenticated' hibát ### 🔗 Függőségek (Dependencies) - **Bemenet:** Frontend Auth Store, Backend Auth Service, VerifyEmailView, CompleteKycView - **Kimenet:** Javított user onboarding experience, Soft KYC support ### 📝 Implementált Javítások #### 1. **Not authenticated hiba javítása** ✅ - A verify success után már nem irányít egyból KYC-re - Sikeres aktiválás után 'Tovább a Belépéshez' gomb jelenik meg - A rendszer belépés után ellenőrzi a KYC státuszt és akkor irányít a /complete-kyc-re #### 2. **E-mail automatikus kitöltés** ✅ - Regisztrációkor az email mentésre kerül localStorage-ba (`pending_verification_email`) - A VerifyEmailView automatikusan betölti ezt az emailt - Sikeres belépés után törlődik a localStorage értéke #### 3. **Tab order javítás** ✅ - A Házszám mező kitöltése után Tab billentyű a Tovább gombra ugrik - Használt megoldás: `@keydown.tab.exact` event handler + `nextTick` + `ref` #### 4. **Opcionális Okmányok (Soft KYC)** ✅ - Backend: `identity_docs` most Optional a UserKYCComplete sémában - Backend: DocumentDetail mezői (number, expiry_date) szintén Optional - Frontend: ID_CARD validáció eltávolítva, minden okmány opcionális - Frontend: Vizuális jelzés: '(opcionális)' címke az okmányoknál - Frontend payload: Csak akkor küldi az identity_docs-ot, ha legalább egy mező ki van töltve #### 5. **Auth Store KYC redirect logika** ✅ - Login után automatikusan ellenőrzi a `isKycComplete` értékét - Ha KYC nem teljes, átirányít a /complete-kyc oldalra - Ha teljes, normál működés (dashboard vagy amit a LoginModal diktál) ### 🧪 Tesztelési lépések 1. Új user regisztráció 2. Email verify link kattintás 3. 'Tovább a belépéshez' gomb megjelenése ellenőrzés 4. Belépés után automatikus KYC átirányítás 5. KYC kitöltés okmányok nélkül (csak név + cím) 6. Sikeres mentés ellenőrzése
kincses added the Scope: BackendType: BugType: FeatureStatus: In Progress labels 2026-06-04 17:08:48 +02:00
kincses started working 2026-06-04 17:08:48 +02:00
Author
Owner

▶️ Munka megkezdve: 2026-06-04 17:08:48

▶️ **Munka megkezdve:** 2026-06-04 17:08:48
kincses added Status: Done and removed Status: In Progress labels 2026-06-04 17:09:18 +02:00
kincses worked for 30 seconds 2026-06-04 17:09:18 +02:00
Author
Owner

Munka befejezve: 2026-06-04 17:09:18

Technikai Összefoglaló:
Sikeres implementáció: Az összes UX javítás elkészült és dokumentálva van.

Elvégzett backend módosítások:

  • backend/app/schemas/auth.py: identity_docs és DocumentDetail mezők opcionálissá tétele (Soft KYC)

Elvégzett frontend módosítások:

  • frontend/src/views/VerifyEmailView.vue: Sikeres aktiválás után beléptetési flow (nem közvetlen KYC)
  • frontend/src/stores/auth.ts: Email mentés regisztrációkor, KYC redirect belépés után, localStorage cleanup
  • frontend/src/views/CompleteKycView.vue: Tab order javítás (Házszám→Tovább gomb), opcionális okmányok, validáció eltávolítása

Teljes folyamat javítva:
Regisztráció → Email confirm → Belépés → Automatikus KYC redirect (ha hiányzik) → Opcionális okmányok → Sikeres mentés

Tesztelhető funkciók:

  1. Email auto-fill a verify oldalon
  2. Aktiválás után beléptetési gomb
  3. Tab navigáció a KYC 2. lépésében
  4. KYC kitöltés okmányok nélkül
  5. Backend fogadja az üres identity_docs-ot

⏱️ Az idő rögzítve.

✅ **Munka befejezve:** 2026-06-04 17:09:18 **Technikai Összefoglaló:** ✅ Sikeres implementáció: Az összes UX javítás elkészült és dokumentálva van. **Elvégzett backend módosítások:** - backend/app/schemas/auth.py: identity_docs és DocumentDetail mezők opcionálissá tétele (Soft KYC) **Elvégzett frontend módosítások:** - frontend/src/views/VerifyEmailView.vue: Sikeres aktiválás után beléptetési flow (nem közvetlen KYC) - frontend/src/stores/auth.ts: Email mentés regisztrációkor, KYC redirect belépés után, localStorage cleanup - frontend/src/views/CompleteKycView.vue: Tab order javítás (Házszám→Tovább gomb), opcionális okmányok, validáció eltávolítása **Teljes folyamat javítva:** Regisztráció → Email confirm → Belépés → Automatikus KYC redirect (ha hiányzik) → Opcionális okmányok → Sikeres mentés **Tesztelhető funkciók:** 1. Email auto-fill a verify oldalon 2. Aktiválás után beléptetési gomb 3. Tab navigáció a KYC 2. lépésében 4. KYC kitöltés okmányok nélkül 5. Backend fogadja az üres identity_docs-ot ⏱️ *Az idő rögzítve.*
Sign in to join this conversation.