Files
tripz-llc/apps/rider_new/lib/features/auth/cubit/login_cubit.dart
T
Hamza-AyedandClaude Opus 5 c52338f3bb feat(apps): نظام التصميم والمصادقة الكاملة — المرحلتان 2 و3
## تصحيح بنيوي أولاً
بنية المرحلة 1 كانت تخالف docs/23 §1 المُلزِم. أُعيدت للشجرة المفروضة
حرفياً: app.dart في الجذر · core/{config,build_config,di,router}.dart ·
core/{design,ui,l10n,api,storage,session}/ · features/<f>/{cubit,data,view}/

## المرحلة 2 — نظام التصميم (docs/26)
- core/design: tokens (مسافات/زوايا/حركة/أحجام — الشاشة لا تخترع رقماً) ·
  typography (IBM Plex Sans Arabic + Inter محليّان، بأرقام tabular للأسعار
  والعدّادات) · TripzColors كـThemeExtension للأدوار الدلالية ·
  buildTheme(brightness, locale) بمدخلين لا ثالث لهما
- core/ui: 11 مكوّناً. TripzScaffold يحوّل status الـCubit وحده إلى
  skeleton/خطأ/فراغ/محتوى — فلا تكتب أي شاشة if (loading)
- core/l10n: ARB عربي/إنجليزي + gen_l10n. لا نص مرئي داخل widget
- SettingsCubit: المظهر واللغة. الاتجاه يتبع اللغة آلياً بلا Directionality
  مفروضة، وسقف تكبير النص 1.3

## المرحلة 3 — المصادقة
- طبقة الشبكة: تجديد استباقي بطلقة واحدة (عمر التوكن 15 دقيقة) ·
  x-app-role · x-device-id من device_info_plus — يُرسَل الآن كي يُفعَّل علم
  الخادم لاحقاً بلا تعديل التطبيق
- SessionCubit في core/session خلف واجهة SessionSource: الجلسة حالة على
  مستوى التطبيق لا ميزة، و core لا يستورد من features
- LoginCubit بخطواته الخمس، ProfileCubit، وست شاشات:
  الشروط ← إذن الموقع ← الهاتف ← الرمز ← إكمال الملف ← هيكل الرئيسية

من سيرو نُقل السلوك لا الكود: بوابتان قبل أي حقل إدخال · إعادة فحص الإذن عند
العودة من إعدادات النظام · تحقّق الهاتف الثلاثي. وأُضيف ما ينقصه: عدّاد إعادة
إرسال الرمز — بدونه تُحظر ثلاث ضغطات المستخدمَ خمس دقائق (docs/38 §2).

قراران موثّقان في docs/37: لا packages/tripz_ui (الوثيقتان المُلزِمتان تفرضان
core/design و core/ui داخل التطبيق)، والـCubit يُصدر رمز فشل لا نصّاً
(يجمع بين docs/23 §3 و docs/26 §4).

flutter analyze نظيف في التطبيقين · 48 ملف و3,140 سطر لكل تطبيق · الفرق
بينهما أربعة ملفات فقط: build_config · config · ملفّا ARB.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-04 21:42:19 +03:00

170 lines
5.6 KiB
Dart

import 'dart:async';
import 'package:flutter_bloc/flutter_bloc.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:shared_preferences/shared_preferences.dart';
import '../../../core/api/api_exception.dart';
import '../../../core/config.dart';
import '../data/auth_repository.dart';
import 'auth_failure.dart';
import 'login_state.dart';
import 'phone_error.dart';
/// تدفّق الدخول كاملاً: الشروط ← إذن الموقع ← الهاتف ← الرمز.
///
/// الـCubit لا يعرف Flutter: لا `BuildContext` ولا تنقّل ولا `SnackBar`
/// (docs/23 §3). يُصدر حالة، والواجهة تتصرّف.
class LoginCubit extends Cubit<LoginState> {
LoginCubit(this._repo, this._prefs) : super(const LoginState()) {
_resolveInitialStep();
}
final AuthRepository _repo;
final SharedPreferences _prefs;
static const _kAgreed = 'auth.agreed_terms';
Timer? _resendTimer;
@override
Future<void> close() {
_resendTimer?.cancel();
return super.close();
}
// ── البوابتان ──────────────────────────────────────────────────────────
void _resolveInitialStep() {
if (_prefs.getBool(_kAgreed) != true) {
emit(state.copyWith(step: LoginStep.agreement));
return;
}
emit(state.copyWith(step: LoginStep.permission, agreed: true));
unawaited(checkLocationPermission());
}
void toggleAgreement(bool value) => emit(state.copyWith(agreed: value));
Future<void> acceptAgreement() async {
if (!state.agreed) return;
await _prefs.setBool(_kAgreed, true);
emit(state.copyWith(step: LoginStep.permission));
await checkLocationPermission();
}
/// تُستدعى أيضاً عند **العودة من إعدادات النظام**: بلا إعادة الفحص تبقى
/// الشاشة عالقة بعد أن يمنح المستخدم الإذن يدوياً (حالة حافة من docs/39 §2).
Future<void> checkLocationPermission() async {
final status = await Permission.locationWhenInUse.status;
if (status.isGranted || status.isLimited) {
emit(state.copyWith(step: LoginStep.phone));
return;
}
emit(state.copyWith(
permissionPermanentlyDenied: status.isPermanentlyDenied,
));
}
Future<void> requestLocationPermission() async {
final status = await Permission.locationWhenInUse.request();
if (status.isGranted || status.isLimited) {
emit(state.copyWith(step: LoginStep.phone));
return;
}
emit(state.copyWith(
permissionPermanentlyDenied: status.isPermanentlyDenied,
));
}
Future<void> openSystemSettings() => openAppSettings();
// ── الهاتف ─────────────────────────────────────────────────────────────
void phoneChanged(String value) {
emit(state.copyWith(
phone: value,
clearPhoneError: true,
clearFailure: true,
));
}
Future<void> submitPhone() async {
final error = validatePhone(state.phone);
if (error != null) {
emit(state.copyWith(phoneError: error));
return;
}
emit(state.copyWith(status: LoginStatus.submitting, clearFailure: true));
try {
await _repo.sendOtp(state.phone.trim());
emit(state.copyWith(status: LoginStatus.idle, step: LoginStep.otp));
_startResendCountdown();
} on ApiException catch (e) {
emit(state.copyWith(
status: LoginStatus.failure,
failure: e.toAuthFailure(),
));
}
}
void editPhone() {
_resendTimer?.cancel();
emit(state.copyWith(
step: LoginStep.phone,
status: LoginStatus.idle,
resendIn: 0,
clearFailure: true,
));
}
// ── الرمز ──────────────────────────────────────────────────────────────
Future<void> resendOtp() async {
if (!state.canResend) return;
emit(state.copyWith(status: LoginStatus.submitting, clearFailure: true));
try {
await _repo.sendOtp(state.phone.trim());
emit(state.copyWith(status: LoginStatus.idle));
_startResendCountdown();
} on ApiException catch (e) {
emit(state.copyWith(
status: LoginStatus.failure,
failure: e.toAuthFailure(),
));
// حتى عند الرفض بحدّ المعدّل نبدأ العدّاد — وإلا ضغط المستخدم مجدداً
// فوراً وعمّق الحظر.
_startResendCountdown();
}
}
Future<void> submitOtp(String code) async {
if (code.length != AppConfig.otpLength) return;
emit(state.copyWith(status: LoginStatus.submitting, clearFailure: true));
try {
final user = await _repo.verifyOtp(phone: state.phone.trim(), code: code);
_resendTimer?.cancel();
emit(state.copyWith(
status: LoginStatus.success,
step: LoginStep.done,
user: user,
));
} on ApiException catch (e) {
emit(state.copyWith(
status: LoginStatus.failure,
failure: e.toAuthFailure(),
));
}
}
void _startResendCountdown() {
_resendTimer?.cancel();
emit(state.copyWith(resendIn: AppConfig.otpResendCooldown.inSeconds));
_resendTimer = Timer.periodic(const Duration(seconds: 1), (timer) {
final next = state.resendIn - 1;
if (next <= 0) timer.cancel();
emit(state.copyWith(resendIn: next < 0 ? 0 : next));
});
}
}