## تصحيح بنيوي أولاً
بنية المرحلة 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>
88 lines
2.6 KiB
Dart
88 lines
2.6 KiB
Dart
import 'package:equatable/equatable.dart';
|
|
|
|
import '../../../core/session/app_user.dart';
|
|
import 'auth_failure.dart';
|
|
import 'phone_error.dart';
|
|
|
|
/// خطوات الدخول بالترتيب الميداني المثبت في سيرو (docs/39 §2): بوابتان
|
|
/// كاملتان **قبل** أي حقل إدخال، ثم الهاتف فالرمز.
|
|
enum LoginStep { agreement, permission, phone, otp, done }
|
|
|
|
enum LoginStatus { idle, submitting, failure, success }
|
|
|
|
class LoginState extends Equatable {
|
|
const LoginState({
|
|
this.step = LoginStep.agreement,
|
|
this.status = LoginStatus.idle,
|
|
this.phone = '',
|
|
this.agreed = false,
|
|
this.failure,
|
|
this.phoneError,
|
|
this.resendIn = 0,
|
|
this.permissionPermanentlyDenied = false,
|
|
this.user,
|
|
});
|
|
|
|
final LoginStep step;
|
|
final LoginStatus status;
|
|
|
|
/// الرقم كما أدخله المستخدم — الخادم يطبّعه، فلا نطبّعه نحن (docs/38 §2).
|
|
final String phone;
|
|
|
|
final bool agreed;
|
|
final AuthFailure? failure;
|
|
final PhoneError? phoneError;
|
|
|
|
/// ثوانٍ متبقّية قبل السماح بإعادة الإرسال. الخادم يحدّ بثلاثة طلبات كل
|
|
/// خمس دقائق، فالعدّاد ليس تجميلاً (docs/39 §2).
|
|
final int resendIn;
|
|
|
|
/// رُفض الإذن نهائياً — الحل الوحيد فتح إعدادات النظام.
|
|
final bool permissionPermanentlyDenied;
|
|
|
|
final AppUser? user;
|
|
|
|
bool get isSubmitting => status == LoginStatus.submitting;
|
|
bool get canResend => resendIn == 0 && !isSubmitting;
|
|
|
|
LoginState copyWith({
|
|
LoginStep? step,
|
|
LoginStatus? status,
|
|
String? phone,
|
|
bool? agreed,
|
|
AuthFailure? failure,
|
|
PhoneError? phoneError,
|
|
int? resendIn,
|
|
bool? permissionPermanentlyDenied,
|
|
AppUser? user,
|
|
bool clearFailure = false,
|
|
bool clearPhoneError = false,
|
|
}) {
|
|
return LoginState(
|
|
step: step ?? this.step,
|
|
status: status ?? this.status,
|
|
phone: phone ?? this.phone,
|
|
agreed: agreed ?? this.agreed,
|
|
failure: clearFailure ? null : (failure ?? this.failure),
|
|
phoneError: clearPhoneError ? null : (phoneError ?? this.phoneError),
|
|
resendIn: resendIn ?? this.resendIn,
|
|
permissionPermanentlyDenied:
|
|
permissionPermanentlyDenied ?? this.permissionPermanentlyDenied,
|
|
user: user ?? this.user,
|
|
);
|
|
}
|
|
|
|
@override
|
|
List<Object?> get props => [
|
|
step,
|
|
status,
|
|
phone,
|
|
agreed,
|
|
failure,
|
|
phoneError,
|
|
resendIn,
|
|
permissionPermanentlyDenied,
|
|
user,
|
|
];
|
|
}
|