TravelAssistant
README.md
Travel Assistant
Приложение для путешествий: план поездки, который работает офлайн, и языковая модель, которая помогает этот план собрать и переделать на ходу.
Наследник BeijingTrip — приложения, написанного под одну поездку вчетвером в Пекин. Там всё было зашито в APK: один город, один язык, один часовой пояс, одна бронь. Здесь то же самое, но для любой поездки, любого языка и любого количества участников.
Статус: скелет. Сборка, навигация, база, тема и каркас модулей работают; разделы наполняются по docs/ROADMAP.md.
Собрать и запустить
./gradlew :app:assembleDebug
android run --apks app/build/outputs/apk/debug/app-debug.apk
Эмулятор, если его ещё нет:
android emulator list
android emulator start <avd>
Тесты:
./gradlew test testDebugUnitTest
Что уже есть
| Сборка | AGP 9.4, Gradle 9.8, Kotlin 2.4, 17 модулей, конвенции в build-logic |
| Тема | Material 3 Expressive, цвета по обоям пользователя, пружинная анимация |
| Навигация | Navigation 3, плавающая панель вместо прибитой к низу |
| Данные | Room со схемой, готовой к синхронизации; DataStore для настроек |
| Модели | LlmProvider + Gemini Nano на устройстве; формат обмена планом в Markdown |
| Маршруты | Каталог готовых маршрутов; демонстрационный «Пекин за шесть дней» — 54 этапа |
| Камера | Экран на CameraX Compose; пакеты распознавания качаются по регионам |
| Подсказки | Свой компонент поверх M3: затемнение с вырезом, тур на экран |
| Тесты | 30 проверок, включая защиту демонстрационного маршрута от утечки личных данных |
Документы
- docs/STACK.md — библиотеки, версии и почему выбраны именно они
- docs/ARCHITECTURE.md — модули, потоки данных, схема синхронизации
- docs/DESIGN.md — правила интерфейса: Expressive, плавающие элементы, чипы
- docs/AI.md — модели, обмен планом, AppFunctions, A2UI, ADK
- docs/SHARING.md — готовые маршруты и почему личное не может в них попасть
- docs/VISION.md — фотоотчёт, распознавание и пакеты регионов
- docs/ROADMAP.md — фазы разработки и задачи для агентов
- docs/TOOLING.md — инструменты, CLI, скиллы и MCP
- CLAUDE.md — как работать в этом репозитории агентом
Устройство в двух словах
Локальная база — источник правды. Сеть опциональна и всегда пишет в базу, а не в
обход: приложение обязано работать в самолёте и в стране, где половина сервисов
недоступна. У каждой записи с первого дня есть updatedAt, deletedAt и
remoteRevision — синхронизации ещё нет, но добавить её потом, не переписав всё,
можно только так.
Модель никогда не пишет в план напрямую. Она возвращает текст, из которого собирается список изменений, и пользователь нажимает «Применить» сам. То же правило у распознавания достопримечательностей: подпись к снимку — предложение, пока человек её не подтвердил.
Личное и публичное разделены типами, а не аккуратностью: в TripTemplate,
который уезжает наружу, просто нет полей для броней, рейсов и участников.
Подробности — docs/SHARING.md.
Релизы
Релизов пока нет.
Открытые issues
Открытых issues нет 🎉