Listo para abrir Android Studio

• Android Studio con AGP y Kotlin recientes; JDK 17; minSdk 26 y targetSdk al último nivel estable.
• Kotlin, Jetpack Compose, corrutinas y Flow; Hilt para inyección; WorkManager para la cola.
• Dos teléfonos físicos de fabricantes distintos desde el día uno: la radio no se prueba en emulador.
• Ninguna capa de negocio importa una API del sistema: solo las interfaces del módulo domain.

conecta-android/
├── settings.gradle.kts
├── build-logic/                  convenciones de compilación compartidas
├── app/                          ensamblado, navegación e inyección
├── core/
│   ├── model/                    modelos puros, sin Android
│   ├── common/                   Result, corrutinas, tiempo, logging
│   └── designsystem/             tema, tipografía, componentes Compose
├── feature/
│   ├── needhelp/                 MODO 1 — necesito Internet
│   ├── offerhelp/                MODO 2 — quiero ayudar
│   ├── session/                  sesión activa y finalización
│   └── history/                  historial, seguridad y uso justo
├── domain/                       casos de uso + interfaces de las capas
└── data/
    ├── discovery-ble/            BLE advertising y scanning
    ├── transport-p2p/            GATT y sockets Wi-Fi Direct
    ├── security-crypto/          X25519, HKDF, AES-GCM, Keystore
    ├── network-config/           panel de Ajustes y WifiNetworkSpecifier
    ├── local-store/              SQLite cifrada y outbox
    └── sync/                     WorkManager, envío idempotente

Cada módulo de data implementa exactamente una interfaz de domain. Así el mismo diseño se traslada a iOS y una capa puede sustituirse sin tocar la lógica.

// domain/src/main/kotlin/.../ports

interface PeerDiscovery {
    fun advertise(profile: EphemeralProfile): Flow<AdvertiseState>
    fun scan(): Flow<List<DiscoveredPeer>>   // alias efímero + rango de distancia
    suspend fun stop()
}

interface PeerTransport {
    suspend fun connect(peer: DiscoveredPeer): TransportChannel
    fun incoming(): Flow<TransportChannel>
}

interface SecurityManager {
    fun newEphemeralIdentity(): EphemeralIdentity
    suspend fun handshake(channel: TransportChannel, id: EphemeralIdentity): SecureChannel
    fun wipe(sessionId: SessionId)
}

interface NetworkConfigurator {
    suspend fun openTetheringPanel(): PanelResult        // confirmación del sistema
    suspend fun joinNetwork(cred: OneTimeCredential): JoinResult  // WifiNetworkSpecifier
    fun hasRealInternet(): Flow<Boolean>                 // NetworkCapabilities + tráfico
}

interface SessionManager {
    val state: StateFlow<SessionState>   // IDLE, NEGOCIANDO, ACTIVA, TERMINADA
    suspend fun start(agreement: Agreement)
    suspend fun endNow(reason: EndReason)
}

interface FairUseManager { fun evaluate(history: List<SessionRecord>): FairUseVerdict }

interface LocalEventStore {
    suspend fun append(event: SessionEvent)   // nunca guarda secretos
    fun outbox(): Flow<List<SessionEvent>>
}

interface SyncManager { fun scheduleUpload() }

Ningún paso se marca como hecho sin registro de prueba física con dispositivo, versión, hora, resultado y evidencia.