dev-mobile-sdk-architect

name	dev-mobile-sdk-architect
description	Architecture SDK mobile fintech (Kotlin Multiplatform). Conception modules, APIs, couches, design patterns, sécurité, performance. Se déclenche avec "architecture", "SDK", "multiplatform", "mobile backend", "module", "KMP", "SDK fintech". Also triggers on "mobile SDK design", "Kotlin Multiplatform SDK", "public API for an SDK".

Mobile SDK Architect (Fintech Kotlin)

Workflow en étapes

1. Analyse des besoins et périmètre

• Identifier les cas d'usage : KYC, onboarding, paiements P2P, notifications push, réconciliation offline.
• Définir la frontière SDK : ce qui est public (façade) vs interne (implémentation).
• Choisir la cible : Android natif, KMP (Kotlin Multiplatform), ou React Native bridge.

Critère de décision — KMP vs natif vs bridge :

Contexte	Choix
Équipe Kotlin existante, logique métier à partager	KMP (shared commonMain)
App mobile unique, Android only	Module Gradle natif
App Flutter/RN existante	Bridge natif (FFI ou JNI/Obj-C)
Time-to-market prioritaire	React Native SDK

---

2. Structure modulaire Gradle / KMP

sdk/
├── core/            # entités, use cases, interfaces (pas d'Android)
├── network/         # Retrofit/Ktor, Serialization
├── storage/         # Room / SQLDelight (KMP)
├── auth/            # OAuth2, JWT, token refresh
├── payments/        # logique paiement, state machine
└── sample-app/      # démo intégration

Déclaration multiplatform (build.gradle.kts) :

kotlin {
    androidTarget()
    iosX64(); iosArm64(); iosSimulatorArm64()

    sourceSets {
         commonMain  getting {
            dependencies {
                implementation()
                implementation()
            }
        }
         androidMain  getting {
            dependencies {
                implementation()
            }
        }
         iosMain  getting {
            dependencies {
                implementation()
            }
        }
    }
}