feat(compliance): implement subscription automated compliance checking

docs/API.md

@@ -379,6 +379,29 @@ Returns all subscription IDs for a given subscriber.
 | ------------ | --------- | ---------- |
 | `subscriber` | `Address` | `Vec<u64>` |
 
+#### `generateMerchantReport(dashboardData, format)`
+Generates exportable standardized merchant reports in `json` or `csv` format.
+
+---
+
+## Automated Compliance API
+
+The `ComplianceService` handles continuous regulatory monitoring, automated checks, alerts management, audit trail logging, and reporting exports.
+
+### Methods
+
+#### `runAutomatedChecks(subscriptions)`
+Executes compliance rule evaluation across all subscriptions and generates warning/failure alerts.
+
+#### `getAlerts()` & `acknowledgeAlert(alertId, performer)`
+Retrieves active compliance alerts and acknowledges specific regulatory issues.
+
+#### `getAuditTrail()` & `logAuditEntry(action, performer, targetId, details)`
+Manages immutable audit trail logs for compliance operations.
+
+#### `generateComplianceReport(format)`
+Exports full compliance status and audit logs in `json` or `csv`.
+
 #### `get_merchant_plans`
 
 Returns all plan IDs for a given merchant.

docs/openapi.yaml

@@ -499,6 +499,10 @@ components:
 tags:
   - name: Initialization
     description: One-time contract setup
+  - name: Merchant Analytics
+    description: Merchant revenue, subscriber analytics, and reporting
+  - name: Automated Compliance
+    description: Automated compliance checks, alerts, regulatory monitoring, and audit trail
   - name: Plan Management
     description: Create and manage subscription plans
   - name: Subscription Management

src/navigation/AppNavigator.tsx

@@ -96,6 +96,7 @@ const PaymentMethodsScreen = lazyScreen(() =>
   }))
 );
 const AnalyticsDashboard = lazyScreen(() => import('../../app/screens/AnalyticsDashboard'));
+const AutomatedComplianceDashboard = lazyScreen(() => import('../screens/AutomatedComplianceDashboard'));
 const TrialDetailsScreen = lazyScreen(() => import('../screens/TrialDetailsScreen'));
 
 // Issue #547: GDPR
@@ -617,7 +618,12 @@ const SettingsStack = () => (
     <Stack.Screen
       name="AnalyticsDashboard"
       component={AnalyticsDashboard}
-      options={{ title: 'Analytics Dashboard', headerShown: true }}
+      options={{ title: 'Analytics', headerShown: true }}
+    />
+    <Stack.Screen
+      name="AutomatedCompliance"
+      component={AutomatedComplianceDashboard}
+      options={{ title: 'Automated Compliance', headerShown: true }}
     />
     {/* Issue #547: GDPR */}
     <Stack.Screen

src/navigation/types.ts

@@ -90,6 +90,7 @@ export type RootStackParamList = {
   PauseSubscription: { subscriptionId: string };
   RoleManagement: undefined;
   RevenueReport: undefined;
+  AutomatedCompliance: undefined;
 };
 
 export type TabParamList = {
@@ -98,6 +99,7 @@ export type TabParamList = {
   WalletTab: undefined;
   AnalyticsTab: undefined;
   RevenueTab: undefined;
+  ComplianceTab: undefined;
   SettingsTab: NavigatorScreenParams<RootStackParamList> | undefined;
 };