feat: add activity log screen and API integration

- Introduced a new Activity Log screen in the settings for users to review their audit trail.
- Updated the router to include the activity log path, enhancing navigation within the app.
- Implemented the AuditLogEntry and AuditLogPage classes to handle audit log data from the API.
- Added a method in SettingsApi to fetch audit logs, improving the application's logging capabilities.

Author: CephasTechOrg

mobile/lib/app/router.dart

@@ -16,6 +16,7 @@ import '../features/customers/presentation/customers_screen.dart';
 import '../features/debts/presentation/debt_detail_screen.dart';
 import '../features/debts/presentation/debts_screen.dart';
 import '../features/notifications/presentation/notifications_inbox_screen.dart';
+import '../features/settings/presentation/activity_log_screen.dart';
 import '../features/settings/presentation/connect_paystack_screen.dart';
 import '../features/settings/presentation/business_profile_screen.dart';
 import '../features/settings/presentation/settings_screen.dart';
@@ -36,6 +37,7 @@ enum AppRoute {
   businessProfile('/settings/business-profile'),
   staff('/settings/staff'),
   paystack('/settings/payments/paystack'),
+  activity('/settings/activity'),
   customers('/customers'),
   customerDetail('/customers/:id'),
   debtDetail('/debts/:id'),
@@ -84,7 +86,8 @@ bool _isProtectedPath(String path) {
 bool _isOwnerOnlySettingsPath(String path) {
   return path == AppRoute.businessProfile.path ||
       path == AppRoute.staff.path ||
-      path == AppRoute.paystack.path;
+      path == AppRoute.paystack.path ||
+      path == AppRoute.activity.path;
 }
 
 Future<String?> _redirectGuard(Ref ref, GoRouterState state) async {
@@ -190,6 +193,10 @@ GoRouter createAppRouter(Ref ref) {
         path: AppRoute.paystack.path,
         builder: (context, state) => const ConnectPaystackScreen(),
       ),
+      GoRoute(
+        path: AppRoute.activity.path,
+        builder: (context, state) => const ActivityLogScreen(),
+      ),
       GoRoute(
         path: AppRoute.customers.path,
         builder: (context, state) => const CustomersScreen(),

mobile/lib/features/settings/data/settings_api.dart

@@ -117,6 +117,62 @@ class PaystackModeState {
   }
 }
 
+class AuditLogEntry {
+  const AuditLogEntry({
+    required this.auditLogId,
+    required this.action,
+    required this.createdAt,
+    this.actorUserId,
+    this.actorLabel,
+    this.entityType,
+    this.entityId,
+    this.meta,
+  });
+
+  final String auditLogId;
+  final String? actorUserId;
+  final String? actorLabel;
+  final String action;
+  final String? entityType;
+  final String? entityId;
+  final Map<String, dynamic>? meta;
+  final DateTime createdAt;
+
+  factory AuditLogEntry.fromJson(Map<String, dynamic> json) => AuditLogEntry(
+        auditLogId: json['audit_log_id'] as String,
+        actorUserId: json['actor_user_id'] as String?,
+        actorLabel: json['actor_label'] as String?,
+        action: json['action'] as String,
+        entityType: json['entity_type'] as String?,
+        entityId: json['entity_id'] as String?,
+        meta: json['meta'] is Map<String, dynamic>
+            ? json['meta'] as Map<String, dynamic>
+            : null,
+        createdAt: DateTime.parse(json['created_at'] as String),
+      );
+}
+
+class AuditLogPage {
+  const AuditLogPage({required this.items, this.nextCursor});
+
+  final List<AuditLogEntry> items;
+  final String? nextCursor;
+
+  factory AuditLogPage.fromJson(Map<String, dynamic> json) {
+    final items = json['items'];
+    if (items is! List) {
+      throw const FormatException('Unexpected activity payload.');
+    }
+    return AuditLogPage(
+      items: items
+          .cast<Map<String, dynamic>>()
+          .map(AuditLogEntry.fromJson)
+          .toList(growable: false),
+      nextCursor: json['next_cursor'] as String?,
+    );
+  }
+}
+
 class SettingsApi {
   SettingsApi(this._apiClient, {KvCacheRepository? cache}) : _cache = cache;
 
@@ -302,6 +358,26 @@ class SettingsApi {
     return PaystackConnectionSettings.fromJson(body);
   }
 
+  Future<AuditLogPage> fetchAuditLogs({
+    int limit = 50,
+    String? cursor,
+    String? action,
+  }) async {
+    final response = await _apiClient.dio.get<dynamic>(
+      '/audit-logs',
+      queryParameters: {
+        'limit': limit,
+        if (cursor != null) 'cursor': cursor,
+        if (action != null && action.trim().isNotEmpty) 'action': action.trim(),
+      },
+    );
+    final body = response.data;
+    if (body is! Map<String, dynamic>) {
+      throw const FormatException('Unexpected activity payload.');
+    }
+    return AuditLogPage.fromJson(body);
+  }
+
   bool _isOfflineish(DioException e) {
     if (e.type == DioExceptionType.connectionError) return true;
     if (e.type == DioExceptionType.connectionTimeout) return true;