feat(reconciliation): build subscription payment reconciliation automation

docs/API.md

@@ -379,6 +379,29 @@ Returns all subscription IDs for a given subscriber.
 | ------------ | --------- | ---------- |
 | `subscriber` | `Address` | `Vec<u64>` |
 
+#### `generateComplianceReport(format)`
+Exports full compliance status and audit logs in `json` or `csv`.
+
+---
+
+## Payment Reconciliation API
+
+The `ReconciliationService` automates payment matching against bank and chain statements, manages exception resolution workflows, handles automated scheduling, and exports financial reconciliation reports.
+
+### Methods
+
+#### `runAutomatedReconciliation(subscriptions, bankStatements)`
+Executes automated payment matching against statement records and categorizes items into matched, fee variance, or exceptions.
+
+#### `resolveException(matchId, reason, notes)`
+Manually resolves payment variance or exception entries with resolution notes.
+
+#### `updateSchedule(config)` & `getSchedule()`
+Manages automated reconciliation frequency (realtime, hourly, daily, weekly) and auto-resolution thresholds.
+
+#### `generateReport(format)`
+Generates downloadable financial reconciliation reports in `json` or `csv` format.
+
 #### `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: Automated Compliance
+    description: Automated compliance checks, alerts, regulatory monitoring, and audit trail
+  - name: Payment Reconciliation
+    description: Automated payment matching, exception resolution, scheduling, and reporting
   - name: Plan Management
     description: Create and manage subscription plans
   - name: Subscription Management

src/navigation/AppNavigator.tsx

@@ -96,6 +96,7 @@
   }))
 );
 const AnalyticsDashboard = lazyScreen(() => import('../../app/screens/AnalyticsDashboard'));
+const PaymentReconciliationDashboard = lazyScreen(() => import('../screens/PaymentReconciliationDashboard'));
 const TrialDetailsScreen = lazyScreen(() => import('../screens/TrialDetailsScreen'));
 
 // Issue #547: GDPR
@@ -535,9 +536,14 @@
       options={{ title: 'Credits & Prepayments', headerShown: true }}
     />
     <Stack.Screen
-      name="TaxCompliance"
-      component={TaxComplianceScreen}
-      options={{ title: 'Tax Compliance', headerShown: true }}
+      name="AutomatedCompliance"
+      component={AutomatedComplianceDashboard}
+      options={{ title: 'Automated Compliance', headerShown: true }}
+    />
+    <Stack.Screen
+      name="PaymentReconciliation"
+      component={PaymentReconciliationDashboard}
+      options={{ title: 'Payment Reconciliation', headerShown: true }}
     />
     <Stack.Screen
       name="SupportDashboard"

src/navigation/types.ts

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