Messenger/docs/android-roadmap.md

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.