‹ Все проекты

TravelAssistant

★ 0 звёзд↓ 0 загрузок

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 нет 🎉

EN