feat(trial): implement subscription trial optimization with conversion tracking

docs/API.md

@@ -1012,3 +1012,24 @@ soroban contract deploy \
 ## Versioning
 
 This API documentation corresponds to the current `main` branch. The Soroban contract does not use semantic versioning on-chain; breaking changes require redeployment to a new contract ID. Client-side services follow the app version in `package.json`.
+
+---
+
+## Trial Optimization & Conversion Tracking API
+
+The `TrialOptimizationService` provides conversion tracking, trial-to-paid automated triggers, trial extension rules, notification templates, and analytics.
+
+### Methods
+
+#### `processTrials(subscriptions)` & `getAnalyticsSummary(subscriptions)`
+Calculates trial conversion rate, active/converted/extended trial counts, and generated conversion revenue.
+
+#### `applyExtension(trialId, ruleId)`
+Applies trial extension rules (e.g. high engagement bonus days).
+
+#### `convertTrialToPaid(trialId, trigger)`
+Triggers automated or manual trial-to-paid conversion with designated trigger type.
+
+#### `generateReport(format)`
+Exports full trial conversion logs and analytics in `json` or `csv`.
+

docs/openapi.yaml

@@ -499,6 +499,9 @@ components:
 tags:
   - name: Initialization
     description: One-time contract setup
+  - name: Trial Optimization
+    description: Trial conversion tracking, trial-to-paid automation, extension rules, and notifications
+
   - name: Plan Management
     description: Create and manage subscription plans
   - name: Subscription Management

src/navigation/AppNavigator.tsx

@@ -96,6 +96,8 @@
   }))
 );
 const AnalyticsDashboard = lazyScreen(() => import('../../app/screens/AnalyticsDashboard'));
+const PaymentReconciliationDashboard = lazyScreen(() => import('../screens/PaymentReconciliationDashboard'));
+const TrialOptimizationDashboard = lazyScreen(() => import('../screens/TrialOptimizationDashboard'));
 const TrialDetailsScreen = lazyScreen(() => import('../screens/TrialDetailsScreen'));
 
 // Issue #547: GDPR
@@ -609,6 +611,16 @@
       component={BillingAlignmentScreen}
       options={{ headerShown: false }}
     />
+    <Stack.Screen
+      name="PaymentReconciliation"
+      component={PaymentReconciliationDashboard}
+      options={{ title: 'Payment Reconciliation', headerShown: true }}
+    />
+    <Stack.Screen
+      name="TrialOptimization"
+      component={TrialOptimizationDashboard}
+      options={{ title: 'Trial Optimization', headerShown: true }}
+    />
     <Stack.Screen
       name="PaymentMethods"
       component={PaymentMethodsScreen}

src/navigation/types.ts

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