03 - Project Tour

flutter_app/
├── android/                # Native Android wrapper (Gradle, AndroidManifest)
├── ios/                    # Native iOS wrapper (Xcode, Info.plist, Podfile)
├── web/                    # Web entry (index.html, manifest.json, favicon)
├── windows/                # Windows desktop (optional target)
├── linux/                  # Linux desktop (optional target)
├── macos/                  # macOS desktop (optional target)
├── assets/
│   └── images/             # 41 Lottie/SVG/PNG assets (RISE logo, illustrations, icons)
├── lib/                    # ★ All Dart source code lives here
│   ├── config/
│   ├── models/
│   ├── services/
│   ├── screens/
│   ├── widgets/
│   ├── app.dart
│   └── main.dart
├── test/                   # Unit/widget tests (mostly empty, TBD)
├── pubspec.yaml            # Dependencies and asset registration
└── pubspec.lock            # Locked dependency versions

lib/
├── config/                         # Compile-time constants and config
│   ├── api_config.dart             # Base URL, routes, env flag, timeouts
│   ├── routes.dart                 # Named routes for all 16 stages
│   ├── theme.dart                  # MaterialApp theme (RISE colors, Inter font)
│   └── assets.dart                 # Static paths to Lottie/SVG/PNG assets
│
├── models/                         # Plain Dart classes with fromJson factories
│   ├── lead.dart                   # Lead (leadId, mobile, state)
│   ├── pan_result.dart             # PAN verification response
│   ├── bank_result.dart            # Bank verification response + isPreVerified
│   ├── otp_result.dart             # OTP verify response
│   ├── journey_status.dart         # Journey stage + progress
│   ├── nominee.dart                # Nominee data
│   └── api_response.dart           # Generic ApiResponse<T> wrapper
│
├── services/                       # Business logic / external interfaces
│   ├── api_service.dart            # ★ 60+ API methods, single file
│   ├── storage_service.dart        # Singleton SharedPreferences wrapper
│   └── analytics_service.dart      # Event tracking stub (debugPrint)
│
├── screens/                        # One file per stage screen
│   ├── stage0_arrival.dart         # Splash + session init + resume detection
│   ├── stage1_registration.dart    # Mobile + name + T&C
│   ├── stage2_otp.dart             # Mobile OTP verification
│   ├── stage3_email.dart           # Email (Google / KRA / Manual OTP)
│   ├── stage4_pan.dart             # PAN entry + NSDL verify
│   ├── stage5_digilocker.dart      # DigiLocker WebView + mock bypass
│   ├── stage6_bank.dart            # UPI RPD or manual or Decentro pre-verified
│   ├── stage7_liveness.dart        # Camera selfie + HyperVerge
│   ├── stage8_signature.dart       # Draw signature on canvas
│   ├── stage9_personal.dart        # Personal details + income + F&O + nominees
│   ├── stage10_income.dart         # Deprecated (redirects to stage 9)
│   ├── stage11_validation.dart     # Backend compliance validation (animated)
│   ├── stage12_document.dart       # AOF PDF generation
│   ├── stage13_esign.dart          # eMudhra/HyperVerge eSign WebView
│   ├── stage14_account.dart        # CBOS account creation
│   └── stage15_congrats.dart       # Success screen + Razorpay fund transfer
│
├── widgets/                        # Reusable widgets
│   ├── loading_overlay.dart        # Full-screen Lottie loader
│   ├── session_timer.dart          # 15-min inactivity timeout + warning
│   ├── back_button_handler.dart    # Intercepts device back button
│   ├── progress_bar.dart           # JourneyProgressBar (16-stage striped)
│   ├── striped_progress_painter.dart # CustomPainter for striped fill
│   ├── error_dialog.dart           # Error dialog + snackbar helpers
│   ├── otp_input.dart              # 4-digit OTP box input
│   └── consent_checkbox.dart       # Consent checkbox with rich text
│
├── app.dart                        # MaterialApp root (theme, routes)
└── main.dart                       # Entry point, orientation lock, storage init

class ApiResponse<T> {
  final bool success;
  final String? message;
  final String? errorCode;
  final T? data;
  final String displayMessage;

  ApiResponse({
    required this.success,
    this.message,
    this.errorCode,
    this.data,
    required this.displayMessage,
  });

  static ApiResponse<T> ok<T>(T data, [String? msg]) => ...
  static ApiResponse<T> fail<T>(String msg, [String? code]) => ...
}

name: ekyc_app
description: MOSL EKYC 3.0 - Digital Account Opening Journey
version: 3.0.0+1

environment:
  sdk: '>=3.2.0 <4.0.0'

dependencies:
  flutter:
    sdk: flutter
  http: ^1.2.0                    # REST client used by ApiService
  shared_preferences: ^2.2.2      # Key-value storage (StorageService)
  path_provider: ^2.1.2           # File paths (for signature save)
  google_sign_in: ^6.1.6          # Stage 3 email Google OAuth
  file_picker: ^8.0.0             # Stage 9 income proof upload
  url_launcher: ^6.2.2            # Open external URLs (T&C, Razorpay redirect)
  webview_flutter: ^4.4.3         # Stage 5 DigiLocker, Stage 13 eSign
  permission_handler: ^11.1.0     # Camera/location permissions
  sms_autofill: ^2.3.0            # Stage 2 OTP auto-read
  signature: ^5.4.1               # Stage 8 signature canvas
  geolocator: ^11.0.0             # GPS for Stage 7 liveness
  razorpay_flutter: ^1.3.7        # Stage 15 mobile payment SDK
  image_picker: ^1.0.7            # Camera/gallery for selfie
  google_fonts: ^6.2.1            # Inter font from Google Fonts
  lottie: ^3.3.1                  # Lottie animations (loader, tick, congrats)
  flutter_svg: ^2.2.0             # SVG rendering (RISE logo, illustrations)

flutter:
  uses-material-design: true
  assets:
    - assets/images/              # Registers all 41 asset files

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'app.dart';
import 'services/storage_service.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // Lock to portrait mode
  await SystemChrome.setPreferredOrientations([
    DeviceOrientation.portraitUp,
    DeviceOrientation.portraitDown,
  ]);

  // Initialize singleton storage (async)
  await StorageService.getInstance();

  runApp(const EkycApp());
}