Miler rider app: surface system, visible design language, backend lifecycle

Design system
- MilerSurface ladder (canvas → working → raised → floating) with MilerPanel
  as layer 1; canvas moved to #DEE3EA so white separates at 1.290:1.
- Visible vocabulary applied across Home, Deliveries, Activity, Account and
  the sheets: hero heads (tabular numeral + small caption, clamped at 1.3x),
  canvas wells for anything that opens, small filled tags for shelf labels,
  demoted placeholders. Recorded in DESIGN_SYSTEM.md §6.
- One icon family: 222 Material glyphs migrated to Lucide; none left outside
  lib/xpress.
- Colour semantics corrected: amber only for what is genuinely owed, brand red
  reserved for the live stop, disabled primaries go neutral rather than pale.

Data and lifecycle
- lib/data/lifecycle.dart reads mutations for what they prove; route_order.dart
  makes admin sequence the single ordering authority; service_day.dart, and
  stop_area.dart rewritten against live Coimbatore addresses (digit-token
  stripping, city stoplist, street suffixes, stammer collapse).
- countLabel states the load once, in bags.

Testing
- 1440 tests passing; golden shot harnesses for Home, Deliveries, Activity,
  sheets and verify, with test/failures/ now gitignored (diff debris).
- New pins: home_gutter_test, stop_area_test, plus updated structural bounds.

Note: this commit also carries pre-existing working-tree deletions that were
present before this work (API_SPEC.md, README.md, demo test fixtures).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-22 05:40:35 +05:30
parent c8350563d9
commit d7348e253f
387 changed files with 80693 additions and 12272 deletions

View File

@@ -1,37 +1,92 @@
import 'dart:math';
import 'package:device_info_plus/device_info_plus.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_messaging/firebase_messaging.dart';
import 'package:device_info_plus/device_info_plus.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/services.dart';
import 'package:shared_preferences/shared_preferences.dart';
/// Identifiers for this handset: one stable device id, one push token.
///
/// ── Neither of these may ever fail a sign-in ──
///
/// [ensureDeviceId] used to `throw` on every unhappy path — on an empty
/// hardware id, on a `PlatformException`, and on anything else it caught. It is
/// awaited on the line *before* the PIN check posts, inside the sign-in's outer
/// `try`, so a throw here never reached the network at all: the rider got
/// "Could not reach the server", pressed Retry, and the MPIN screen painted
/// **"Incorrect MPIN"** at him. For every phone number, on every attempt.
///
/// Two things made that certain rather than unlucky:
///
/// • It asked for `androidInfo` **unconditionally**. On iOS that call throws,
/// so no iPhone could ever complete a PIN login.
/// • The value is not even sent. `POST /miler/verify-pin` takes `phone`,
/// `pin`, `configid` and `device_token` — `deviceId` is dropped on the floor
/// inside `AuthProvider.login`. The sign-in was being aborted by a field the
/// sign-in does not use.
///
/// So: this file hands back a best-effort answer and **never throws**. A caller
/// that wants to know whether the answer is real can compare against
/// [unknownDeviceId]; nothing currently needs to.
class DeviceUtils {
static const String _deviceIdKey = 'deviceId';
static const String _fcmTokenKey = 'fcmToken';
/// Prefix on ids this class generated rather than read off the hardware.
static const String unknownDeviceId = 'generated-';
/// A stable id for this install, persisted on first use.
///
/// Hardware id where the platform has one — Android's `id`, iOS's
/// `identifierForVendor` — and a persisted random id everywhere else, which
/// is what the backend actually needs: something that does not change
/// between launches. Never throws.
static Future<String> ensureDeviceId(SharedPreferences prefs) async {
final String? existing = prefs.getString(_deviceIdKey);
if (existing != null && existing.isNotEmpty) {
if (kDebugMode) debugPrint('[DEVICE] Using cached device ID: $existing');
return existing;
}
if (existing != null && existing.isNotEmpty) return existing;
String resolved = '';
try {
final deviceInfo = DeviceInfoPlugin();
final android = await deviceInfo.androidInfo;
final String androidId = android.id;
if (androidId.isNotEmpty) {
await prefs.setString(_deviceIdKey, androidId);
return androidId;
} else {
throw Exception('Android ID is empty');
final info = DeviceInfoPlugin();
switch (defaultTargetPlatform) {
case TargetPlatform.android:
resolved = (await info.androidInfo).id;
case TargetPlatform.iOS:
resolved = (await info.iosInfo).identifierForVendor ?? '';
case TargetPlatform.macOS:
resolved = (await info.macOsInfo).systemGUID ?? '';
case TargetPlatform.windows:
resolved = (await info.windowsInfo).deviceId;
case TargetPlatform.linux:
resolved = (await info.linuxInfo).machineId ?? '';
case TargetPlatform.fuchsia:
resolved = '';
}
} on PlatformException catch (e) {
throw Exception('Failed to get device ID: ${e.message}');
} catch (e) {
throw Exception('Failed to get device ID: $e');
// A missing plugin, a denied permission, a simulator with no vendor id.
// None of these are reasons to stop a rider signing in.
debugPrint('[DEVICE] hardware id unavailable, generating one: $e');
}
if (resolved.trim().isEmpty) resolved = _generateId();
await prefs.setString(_deviceIdKey, resolved);
return resolved;
}
/// 128 bits of hex behind [unknownDeviceId], so a generated id is
/// self-identifying in a log and cannot collide with a hardware one.
static String _generateId() {
final rand = Random.secure();
final bytes = List<int>.generate(16, (_) => rand.nextInt(256));
final hex = bytes.map((b) => b.toRadixString(16).padLeft(2, '0')).join();
return '$unknownDeviceId$hex';
}
/// The FCM registration token, or `''` when push is unavailable.
///
/// Already total, and stays that way: a rider who declined notifications
/// still has a day's work to do.
static Future<String> ensureFcmToken(SharedPreferences prefs) async {
try {
final String? existing = prefs.getString(_fcmTokenKey);

View File

@@ -0,0 +1,34 @@
import 'package:flutter/foundation.dart';
import 'package:url_launcher/url_launcher.dart';
/// Hands a destination to the phone's own maps app.
///
/// Native intent first, web as the fallback, so a rider gets the same app
/// whichever control in Miler he presses. Three screens had their own copy of
/// these two URLs — a route row, a map screen and a confirmation sheet — which
/// is three chances for one of them to open a different app, or the wrong
/// scheme, on the one action a rider takes at every single stop.
///
/// Silent on failure by design: there is nothing useful to say to a rider whose
/// phone has no maps application, and the screen he pressed from still has the
/// address on it.
Future<void> openExternalNavigation(double lat, double lng) async {
try {
final native = Uri.parse('google.navigation:q=$lat,$lng&mode=d');
if (await launchUrl(native, mode: LaunchMode.externalApplication)) return;
} catch (_) {
// Falls through to the web URL below — a device with no navigation intent
// handler is the normal case on iOS, not an error.
}
try {
await launchUrl(
Uri.parse(
'https://www.google.com/maps/dir/?api=1'
'&destination=$lat,$lng&travelmode=driving',
),
mode: LaunchMode.externalApplication,
);
} catch (e) {
debugPrint('[NAV] could not open maps: $e');
}
}