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>

lib/xpress/utils/device.dart

@@ -0,0 +1,65 @@
+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';
+
+class DeviceUtils {
+  static const String _deviceIdKey = 'deviceId';
+  static const String _fcmTokenKey = 'fcmToken';
+
+  static Future<String> ensureDeviceId(SharedPreferences prefs) async {
+    final String? existing = prefs.getString(_deviceIdKey);
+    if (existing != null && existing.isNotEmpty) {
+      if (kDebugMode) print('[DEVICE] Using cached device ID: $existing');
+      return existing;
+    }
+    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');
+      }
+    } on PlatformException catch (e) {
+      throw Exception('Failed to get device ID: ${e.message}');
+    } catch (e) {
+      throw Exception('Failed to get device ID: $e');
+    }
+  }
+
+  static Future<String> ensureFcmToken(SharedPreferences prefs) async {
+    try {
+      final String? existing = prefs.getString(_fcmTokenKey);
+      if (existing != null && existing.isNotEmpty) {
+        return existing;
+      }
+      if (Firebase.apps.isEmpty) {
+        try {
+          await Firebase.initializeApp();
+        } catch (_) {
+          return '';
+        }
+      }
+      final FirebaseMessaging messaging = FirebaseMessaging.instance;
+      final NotificationSettings settings = await messaging.requestPermission(
+        alert: true,
+        badge: true,
+        sound: true,
+      );
+      if (settings.authorizationStatus == AuthorizationStatus.authorized ||
+          settings.authorizationStatus == AuthorizationStatus.provisional) {
+        final String? token = await messaging.getToken();
+        if (token != null && token.isNotEmpty) {
+          await prefs.setString(_fcmTokenKey, token);
+          return token;
+        }
+      }
+    } catch (_) {}
+    return '';
+  }
+}