chat/docs/MOBILE_QUICK_START.md

# 🚀 БЫСТРЫЙ СТАРТ: Интеграция Emergency Service в мобильное приложение

## 📋 КРАТКИЙ ЧЕКЛИСТ (30 минут)

### 1️⃣ УДАЛИТЕ ВРЕМЕННЫЕ ТОКЕНЫ (5 мин)
```kotlin
// ❌ УДАЛИТЬ:
val tempToken = "temp_token_for_${email}"

// ✅ ЗАМЕНИТЬ:
val jwtToken = authManager.getValidJwtToken()
```

### 2️⃣ ДОБАВЬТЕ JWT АУТЕНТИФИКАЦИЮ (10 мин)
```kotlin
// Добавить в build.gradle
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.okhttp3:okhttp:4.11.0'
implementation 'org.jetbrains.kotlinx:kotlinx-serialization-json:1.5.1'

// Простая авторизация
suspend fun login(email: String, password: String): String? {
    val response = apiService.login(LoginRequest(email, password))
    return if (response.isSuccessful) {
        response.body()?.access_token
    } else null
}
```

### 3️⃣ НАСТРОЙТЕ WEBSOCKET (10 мин)
```kotlin
val token = getJwtToken()
val wsUrl = "ws://YOUR_SERVER:8002/api/v1/emergency/ws/current_user_id?token=$token"

val client = OkHttpClient()
val request = Request.Builder().url(wsUrl).build()
val webSocket = client.newWebSocket(request, object : WebSocketListener() {
    override fun onMessage(webSocket: WebSocket, text: String) {
        // Обработка сообщений от сервера
        handleEmergencyMessage(text)
    }
})
```

### 4️⃣ ДОБАВЬТЕ API CALLS (5 мин)
```kotlin
// Создание экстренного вызова
suspend fun createAlert(latitude: Double, longitude: Double, description: String) {
    val alert = CreateAlertRequest("medical", latitude, longitude, null, description)
    val response = emergencyApi.createAlert(alert, "Bearer $jwtToken")
    // Обработка ответа
}

// Получение списка вызовов
suspend fun getMyAlerts() {
    val response = emergencyApi.getMyAlerts("Bearer $jwtToken")
    // Обработка списка
}
```

---

## 🛠️ ОСНОВНЫЕ ENDPOINTS

### Аутентификация:
```
POST http://YOUR_SERVER:8000/api/v1/auth/login
Body: {"email": "user@example.com", "password": "password"}
Response: {"access_token": "JWT_TOKEN", "user": {...}}
```

### Emergency API (все с Bearer JWT токеном):
```
POST http://YOUR_SERVER:8002/api/v1/alert - Создать вызов
GET  http://YOUR_SERVER:8002/api/v1/alerts/my - Мои вызовы
GET  http://YOUR_SERVER:8002/api/v1/alerts/active - Активные вызовы
GET  http://YOUR_SERVER:8002/api/v1/alerts/nearby?lat=55.7&lon=37.6&radius=5 - Ближайшие
POST http://YOUR_SERVER:8002/api/v1/alert/{id}/respond - Ответить на вызов
POST http://YOUR_SERVER:8002/api/v1/safety-check - Проверка безопасности
```

### WebSocket:
```
ws://YOUR_SERVER:8002/api/v1/emergency/ws/current_user_id?token=JWT_TOKEN
```

---

## 📱 МИНИМАЛЬНЫЙ КОД

### AuthManager.kt
```kotlin
class AuthManager {
    private var jwtToken: String? = null
    
    suspend fun login(email: String, password: String): Boolean {
        val response = retrofit.create(AuthApi::class.java)
            .login(LoginRequest(email, password))
            
        return if (response.isSuccessful) {
            jwtToken = response.body()?.access_token
            true
        } else false
    }
    
    fun getJwtToken(): String? = jwtToken
}
```

### EmergencyManager.kt
```kotlin
class EmergencyManager(private val authManager: AuthManager) {
    private var webSocket: WebSocket? = null
    
    fun connectWebSocket() {
        val token = authManager.getJwtToken() ?: return
        val wsUrl = "ws://YOUR_SERVER:8002/api/v1/emergency/ws/current_user_id?token=$token"
        
        val request = Request.Builder().url(wsUrl).build()
        webSocket = OkHttpClient().newWebSocket(request, object : WebSocketListener() {
            override fun onMessage(webSocket: WebSocket, text: String) {
                handleMessage(text)
            }
        })
    }
    
    suspend fun createAlert(lat: Double, lon: Double, description: String) {
        val token = authManager.getJwtToken() ?: return
        val alert = CreateAlertRequest("medical", lat, lon, null, description)
        
        val response = emergencyApi.createAlert(alert, "Bearer $token")
        // Handle response
    }
    
    private fun handleMessage(message: String) {
        val data = Json.decodeFromString<WebSocketMessage>(message)
        when (data.type) {
            "emergency_alert" -> showEmergencyNotification(data)
            "connection_established" -> onConnected()
        }
    }
}
```

---

## 🧪 ТЕСТИРОВАНИЕ

### Проверьте подключение:
```bash
# На сервере запустите тесты
./venv/bin/python test_final_security.py
```

### Тестовые данные:
- **Server**: `http://192.168.219.108:8000` (замените на ваш IP)
- **Email**: `shadow85@list.ru`
- **Password**: `R0sebud1985`

### Быстрый тест в коде:
```kotlin
// В onCreate или init
lifecycleScope.launch {
    val success = authManager.login("shadow85@list.ru", "R0sebud1985")
    if (success) {
        emergencyManager.connectWebSocket()
        Toast.makeText(this@MainActivity, "Connected!", Toast.LENGTH_SHORT).show()
    }
}
```

---

## ⚠️ ВАЖНЫЕ МОМЕНТЫ

1. **Замените IP адрес** `YOUR_SERVER` на реальный IP сервера
2. **Удалите ВСЕ** `temp_token_` из кода
3. **Добавьте разрешения** в AndroidManifest.xml:
```xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
```

4. **Обработайте ошибки** сети и токенов
5. **Сохраняйте токен** в зашифрованном виде

---

## 📞 ПРОБЛЕМЫ?

1. **WebSocket не подключается** → Проверьте JWT токен и URL
2. **API возвращает 403** → Проверьте заголовок Authorization
3. **API возвращает 500** → Проверьте формат данных в запросе
4. **Нет уведомлений** → Проверьте WebSocket подключение

**Полная документация:** `MOBILE_APP_INTEGRATION_GUIDE.md`

**Готовые тесты сервера:** `test_final_security.py` - показывает, что все работает! ✅