docs: add android checklist and prioritized roadmap

docs/android-roadmap.md

@@ -0,0 +1,110 @@
+# Android Roadmap (до production)
+
+## Принципы
+- Backend/API уже есть: Android строим поверх текущего контракта (`/auth`, `/chats`, `/messages`, `/realtime`, `/media`).
+- Сначала закрываем core-мессенджер, потом polish.
+- Каждая фаза завершается demo + regression check.
+
+## Phase 0: Foundation (1-2 недели)
+**Цель:** запустить каркас приложения и базовую сетевую инфраструктуру.
+
+### Scope
+- Проектная архитектура, DI, навигация.
+- Retrofit/OkHttp + auth/refresh.
+- Room + DataStore заготовки.
+- Базовый theme system и design tokens.
+- Экран логина (email-first).
+
+### DoD
+- Можно авторизоваться и получить `me`.
+- Сборка/линт/тесты в CI зеленые.
+
+## Phase 1: Web-Core parity MVP (3-5 недель)
+**Цель:** довести Android до текущего рабочего web-core.
+
+### Scope
+- Chat list: unread/mentions/pin/archive/mute badges.
+- Chat screen: send/read/reply/edit/delete/forward/reactions.
+- Realtime: receive/update/delete/typing/read/delivered/presence.
+- Media: image/video/file/audio upload + viewer.
+- Voice: record (hold/lock/cancel) + playback + waveform.
+- Groups/channels roles/permissions, invite links.
+
+### DoD
+- Основные пользовательские сценарии проходят без перезапуска.
+- Нет blocker-багов по auth/chat/realtime/media.
+
+## Phase 2: Stability & Security (2-3 недели)
+**Цель:** сделать релизно-устойчивую версию.
+
+### Scope
+- Offline queue + reconcile после reconnect.
+- Session management + 2FA + recovery codes UX.
+- Crash reporting + performance baseline.
+- Deep link handling (`verify-email`, `join`, `open chat/message`).
+- Расширенное тестирование (unit/integration/ui).
+
+### DoD
+- Crash-free rate целевой для internal beta.
+- Критичные сценарии покрыты автотестами.
+
+## Phase 3: Product polish (2-4 недели)
+**Цель:** UX-качество уровня “приятно ежедневно использовать”.
+
+### Scope
+- Chat info polish (media tabs, links, jump to message).
+- Контекстные меню и жесты без конфликтов.
+- Тонкая настройка тем (light/dark readability).
+- Улучшение поиска и навигации по результатам.
+- Accessibility pass.
+
+### DoD
+- UX-bug backlog снижен до low/medium.
+- Продуктовая приемка по ключевым flows.
+
+## Phase 4: Release (1-2 недели)
+**Цель:** выкладка в production.
+
+### Scope
+- FCM push production config.
+- Подготовка Play Console, privacy, release notes.
+- Staged rollout (5% -> 25% -> 100%).
+- Monitoring и incident runbook.
+
+### DoD
+- Успешный staged rollout без критических откатов.
+
+## Приоритеты (P0/P1/P2)
+### P0 (обязательно до релиза)
+- Auth + refresh + logout cleanup
+- Chat list + chat screen core actions
+- Realtime стабильность
+- Media upload/view + voice record/playback
+- Roles/permissions для group/channel
+- Crash reporting + минимальные тесты
+
+### P1 (сразу после P0)
+- Search UX
+- Chat info/media tabs
+- Advanced formatting/threads polish
+- Better offline UX
+
+### P2 (после релиза)
+- Дополнительные эффекты/анимации
+- Расширенная аналитика
+- Экспериментальные UX-фичи
+
+## Оценка сроков
+- Реалистично до strong beta: **8-12 недель**.
+- До стабильного production с полировкой: **10-16 недель**.
+
+## Риски
+- Drift между web и android поведением.
+- Realtime race conditions при нестабильной сети.
+- Media edge-cases (mime/duration/seek).
+- Permission UX (микрофон/уведомления) на разных Android версиях.
+
+## Следующий практический шаг
+1. Заморозить API-контракт (OpenAPI snapshot).
+2. Поднять Android skeleton (Phase 0).
+3. Зафиксировать Definition of Done для Phase 1 demo.