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/controllers/riderkm.dart

@@ -0,0 +1,31 @@
+import 'dart:convert';
+import 'package:http/http.dart' as http;
+import 'package:miler/xpress/Models/summary/riderweeklykms.dart';
+import 'package:miler/xpress/views/helpers/constants/apiconstants.dart';
+
+class RiderWeeklyKmController {
+  final String baseUrl = ApiConstants.summaryriderkmLive;
+
+  Future<Map<String, dynamic>> getRiderWeeklyKms(int userId) async {
+    final url = Uri.parse("$baseUrl/getriderweeklykms?userid=$userId");
+    final response = await http.get(url);
+
+    if (response.statusCode == 200) {
+      final body = json.decode(response.body);
+      if (body['status'] == true) {
+        final details = (body['details'] as List)
+            .map((e) => RiderWeeklyKms.fromJson(e))
+            .toList();
+
+        return {
+          'details': details,
+          'total_kms': double.tryParse('${body['total_kms'] ?? 0}') ?? 0.0,
+        };
+      } else {
+        throw Exception(body['message'] ?? "API returned false status");
+      }
+    } else {
+      throw Exception("Failed to fetch (code: ${response.statusCode})");
+    }
+  }
+}