feat(apps): ثيم سيرو ومفتاح الدولة والعراق

## الثيم مقرَّب من سيرو (قرار المالك 2026-08-05)
- البذرة صارت كحليّ سيرو #1A2340 بدل الأزرق العام، والثانوي #8C9CF8
- fromSeed وحدها تنتج من بذرة داكنة أسطحاً باهتة، فثُبّت الأساسي والثانوي
  والأسطح صراحةً وتُرك الباقي للمشتقّ — شكل سيرو مع تباين M3
- الأدوار الدلالية بأرقام سيرو الميدانية: نجاح #22C55E · تحذير #F59E0B ·
  خطأ #EF4444، وبطاقة الليلي #2C2C2E

## مفتاح الدولة عاد
core/ui/phone_field.dart — النمط المجرَّب في سيرو، لكن بلا intl_phone_field:
تلك الحزمة تحمل 240 دولة ونحتاج أربعاً. CountryCode صريح ومقصور على أسواقنا.
- الاختيار من ورقة سفلية لا قائمة منسدلة: أهداف لمس أكبر وأربع دول لا مئتان
- الترتيب يبدأ بحزمة دولة المستأجر — الأردنيّ يرى الأردن أولاً بلا بحث
- الرقم يُرسل كاملاً بالمفتاح بلا + (962790000001) كما يقبله الخادم
- التحقّق صار بطول الدولة لا برقم ثابت: jo/sy تسع خانات، eg/iq عشر

## العراق
- CountryCode.iraq (+964) في قائمة الهاتف
- قنوات دفعه: زين كاش · كي كارد · نقد
⚠️ الباك إند لا يعرف حزمة `iq`: default-tariffs.ts فيه jo/sy/eg فقط، فمستأجر
عراقي يُزوَّد بلا أي تعرفة. موثَّق في الكود — وهو شغل خادم يسبق أي إطلاق عراقي.

flutter analyze نظيف في التطبيقين.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Hamza-Ayed
2026-08-05 01:08:18 +03:00
co-authored by Claude Opus 5
parent 3a8caf7b27
commit e22cc5c7e4
128 changed files with 684 additions and 666 deletions
@@ -1,22 +1,16 @@
import 'dart:async';
import 'package:flutter_bloc/flutter_bloc.dart';
import 'package:geolocator/geolocator.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:shared_preferences/shared_preferences.dart';
import '../../../core/api/api_exception.dart';
import '../../../core/api/api_failure.dart';
import '../../../core/config.dart';
import '../../../core/payments/country_codes.dart';
import '../data/auth_repository.dart';
import 'login_state.dart';
import 'phone_error.dart';
/// تدفّق الدخول كاملاً: الشروط ← إذن الموقع ← الهاتف ← الرمز.
@@ -121,6 +115,15 @@ class LoginCubit extends Cubit<LoginState> {
// ── الهاتف ─────────────────────────────────────────────────────────────
/// يُنادى عند الإقلاع بحزمة دولة المستأجر — فيرى الأردنيُّ الأردن أولاً.
void applyTenantCountry(String countryPack) {
if (state.phone.isNotEmpty) return; // لا نغيّر اختياراً واعياً للمستخدم
emit(state.copyWith(country: CountryCode.fromPack(countryPack)));
}
void countryChanged(CountryCode country) =>
emit(state.copyWith(country: country, clearPhoneError: true));
void phoneChanged(String value) {
emit(state.copyWith(
phone: value,
@@ -130,14 +133,14 @@ class LoginCubit extends Cubit<LoginState> {
}
Future<void> submitPhone() async {
final error = validatePhone(state.phone);
final error = validatePhone(state.phone, state.country);
if (error != null) {
emit(state.copyWith(phoneError: error));
return;
}
emit(state.copyWith(status: LoginStatus.submitting, clearFailure: true));
try {
await _repo.sendOtp(state.phone.trim());
await _repo.sendOtp(state.e164);
emit(state.copyWith(status: LoginStatus.idle, step: LoginStep.otp));
_startResendCountdown();
} on ApiException catch (e) {
@@ -164,7 +167,7 @@ class LoginCubit extends Cubit<LoginState> {
if (!state.canResend) return;
emit(state.copyWith(status: LoginStatus.submitting, clearFailure: true));
try {
await _repo.sendOtp(state.phone.trim());
await _repo.sendOtp(state.e164);
emit(state.copyWith(status: LoginStatus.idle));
_startResendCountdown();
} on ApiException catch (e) {
@@ -182,7 +185,7 @@ class LoginCubit extends Cubit<LoginState> {
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);
final user = await _repo.verifyOtp(phone: state.e164, code: code);
_resendTimer?.cancel();
emit(state.copyWith(
status: LoginStatus.success,
@@ -1,9 +1,8 @@
import 'package:equatable/equatable.dart';
import '../../../core/api/api_failure.dart';
import '../../../core/payments/country_codes.dart';
import '../../../core/session/app_user.dart';
import 'phone_error.dart';
/// خطوات الدخول بالترتيب الميداني المثبت في سيرو (docs/39 §2): بوابتان
@@ -17,6 +16,7 @@ class LoginState extends Equatable {
this.step = LoginStep.agreement,
this.status = LoginStatus.idle,
this.phone = '',
this.country = CountryCode.jordan,
this.agreed = false,
this.failure,
this.phoneError,
@@ -31,6 +31,13 @@ class LoginState extends Equatable {
/// الرقم كما أدخله المستخدم — الخادم يطبّعه، فلا نطبّعه نحن (docs/38 §2).
final String phone;
/// الدولة المختارة — تحدّد المفتاح الدولي وطول التحقّق. تُبدأ من
/// `countryPack` المستأجر لا من لغة الجهاز.
final CountryCode country;
/// ما يُرسل للخادم: المفتاح + الرقم بلا `+` (`962790000001`).
String get e164 => '${country.dial}${phone.trim()}';
final bool agreed;
final ApiFailure? failure;
final PhoneError? phoneError;
@@ -51,6 +58,7 @@ class LoginState extends Equatable {
LoginStep? step,
LoginStatus? status,
String? phone,
CountryCode? country,
bool? agreed,
ApiFailure? failure,
PhoneError? phoneError,
@@ -64,6 +72,7 @@ class LoginState extends Equatable {
step: step ?? this.step,
status: status ?? this.status,
phone: phone ?? this.phone,
country: country ?? this.country,
agreed: agreed ?? this.agreed,
failure: clearFailure ? null : (failure ?? this.failure),
phoneError: clearPhoneError ? null : (phoneError ?? this.phoneError),
@@ -79,6 +88,7 @@ class LoginState extends Equatable {
step,
status,
phone,
country,
agreed,
failure,
phoneError,
@@ -1,11 +1,15 @@
import '../../../core/payments/country_codes.dart';
/// أخطاء تحقّق **محليّة** لرقم الهاتف — تُكتشف قبل أي نداء شبكة.
/// الشروط الثلاثة منقولة من التحقّق المطبَّق ميدانياً في سيرو (docs/39 §2).
enum PhoneError { empty, leadingZero, tooShort }
PhoneError? validatePhone(String raw) {
/// الطول المتوقّع من **الدولة المختارة** لا رقماً ثابتاً: الأردن وسوريا 9
/// خانات، ومصر والعراق 10.
PhoneError? validatePhone(String raw, CountryCode country) {
final v = raw.trim();
if (v.isEmpty) return PhoneError.empty;
if (v.startsWith('0')) return PhoneError.leadingZero;
if (v.length < 9) return PhoneError.tooShort;
if (v.length < country.nationalLength) return PhoneError.tooShort;
return null;
}
@@ -1,9 +1,6 @@
import '../../../core/api/api_client.dart';
import '../../../core/session/app_user.dart';
import '../../../core/session/session_source.dart';
import '../../../core/storage/token_store.dart';
/// كل نداءات المصادقة (docs/38 §2). الـCubit لا ينادي Dio مباشرة أبداً
@@ -1,22 +1,14 @@
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import '../../../core/design/tokens.dart';
import '../../../core/design/tripz_colors.dart';
import '../../../core/l10n/l10n.dart';
import '../../../core/ui/tripz_button.dart';
import '../../../core/ui/tripz_scaffold.dart';
import '../cubit/login_cubit.dart';
import '../cubit/login_state.dart';
import '../../../core/ui/form_header.dart';
import '../../../core/ui/tripz_button.dart';
import '../../../core/ui/tripz_scaffold.dart';
import '../cubit/login_cubit.dart';
import '../cubit/login_state.dart';
/// البوابة الأولى: شاشة كاملة لا حوار، وزر متابعة **معطّل حتى يُؤشَّر**
/// (docs/39 §2). تُحفظ الموافقة فلا تتكرر.
@@ -1,21 +1,13 @@
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import '../../../core/di.dart';
import '../../../core/session/session_cubit.dart';
import '../cubit/login_cubit.dart';
import '../cubit/login_state.dart';
import 'agreement_view.dart';
import 'otp_view.dart';
import 'permission_view.dart';
import 'phone_view.dart';
/// مضيف تدفّق الدخول: خطوة واحدة معروضة في كل لحظة، والانتقال بينها من
@@ -1,26 +1,16 @@
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import '../../../core/design/tokens.dart';
import '../../../core/design/tripz_colors.dart';
import '../../../core/l10n/l10n.dart';
import '../../../core/ui/failure_text.dart';
import '../../../core/ui/tripz_button.dart';
import '../../../core/ui/tripz_otp_field.dart';
import '../../../core/ui/tripz_scaffold.dart';
import '../cubit/login_cubit.dart';
import '../cubit/login_state.dart';
import '../../../core/ui/form_header.dart';
import '../../../core/ui/tripz_button.dart';
import '../../../core/ui/tripz_otp_field.dart';
import '../../../core/ui/tripz_scaffold.dart';
import '../cubit/login_cubit.dart';
import '../cubit/login_state.dart';
class OtpView extends StatefulWidget {
const OtpView({super.key});
@@ -1,22 +1,14 @@
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import '../../../core/design/tokens.dart';
import '../../../core/l10n/l10n.dart';
import '../../../core/ui/status_banner.dart';
import '../../../core/ui/tripz_button.dart';
import '../../../core/ui/tripz_scaffold.dart';
import '../cubit/login_cubit.dart';
import '../cubit/login_state.dart';
import '../../../core/ui/form_header.dart';
import '../../../core/ui/status_banner.dart';
import '../../../core/ui/tripz_button.dart';
import '../../../core/ui/tripz_scaffold.dart';
import '../cubit/login_cubit.dart';
import '../cubit/login_state.dart';
/// البوابة الثانية: إذن الموقع. عند الرفض النهائي لا يبقى إلا فتح إعدادات
/// النظام — والعودة منها يلتقطها `LoginPage` بمراقبة دورة الحياة.
@@ -1,28 +1,48 @@
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
import '../../../core/design/tokens.dart';
import '../../../core/l10n/l10n.dart';
import '../../../core/tenant/tenant_cubit.dart';
import '../../../core/ui/failure_text.dart';
import '../../../core/ui/form_header.dart';
import '../../../core/ui/phone_field.dart';
import '../../../core/ui/tripz_button.dart';
import '../../../core/ui/tripz_scaffold.dart';
import '../../../core/ui/tripz_text_field.dart';
import '../cubit/login_cubit.dart';
import '../cubit/login_state.dart';
import '../../../core/ui/form_header.dart';
class PhoneView extends StatelessWidget {
class PhoneView extends StatefulWidget {
const PhoneView({super.key});
@override
State<PhoneView> createState() => _PhoneViewState();
}
class _PhoneViewState extends State<PhoneView> {
final _phone = TextEditingController();
@override
void initState() {
super.initState();
_phone.addListener(
() => context.read<LoginCubit>().phoneChanged(_phone.text),
);
// الدولة الافتراضية من المستأجر — يُطبَّق بعد أول إطار كي يتوفّر السياق.
WidgetsBinding.instance.addPostFrameCallback((_) {
if (!mounted) return;
context
.read<LoginCubit>()
.applyTenantCountry(context.read<TenantCubit>().state.countryPack);
});
}
@override
void dispose() {
_phone.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
final l10n = context.l10n;
@@ -30,6 +50,7 @@ class PhoneView extends StatelessWidget {
buildWhen: (p, n) =>
p.status != n.status ||
p.phoneError != n.phoneError ||
p.country != n.country ||
p.failure != n.failure,
builder: (context, state) {
final cubit = context.read<LoginCubit>();
@@ -49,11 +70,13 @@ class PhoneView extends StatelessWidget {
lead: l10n.phoneLead,
),
const SizedBox(height: Space.lg),
TripzTextField.phone(
PhoneField(
controller: _phone,
country: state.country,
onCountryChanged: cubit.countryChanged,
label: l10n.phoneLabel,
hint: l10n.phoneHint,
enabled: !state.isSubmitting,
onChanged: cubit.phoneChanged,
onSubmitted: (_) => cubit.submitPhone(),
errorText: state.phoneError == null
? null