Student-AutoAlarm: Android-приложение (Kotlin, Jetpack Compose), которое по расписанию
КГЭУ автоматически ставит будильник перед первой парой — в стоковое приложение часов
или, по выбору, собственным будильником приложения (полноэкранный звонок с кнопкой
«Отключить»). Сейчас расписание берётся из официального публичного API личного кабинета
kabinet.kgeu.ru
(архитектура допускает добавление других вузов — слой провайдера расписания изолирован).
Приложение работает по единой логике «одна ночь вперёд» (0.8.0): включение тумблера проверяет сегодня/завтра и сразу ставит будильник на ближайшее пробуждение (со свежим расписанием — замены!), а каждую ночь в 00:05 (и страховками в 01:00, 02:00 и 03:00) проверщик смотрит, есть ли пары в наступивший день, и ставит будильник на ближайшее время — или не ставит, если пар нет. Никаких будильников «на день недели», которые потом приходится выключать руками; замены и отмены пар переставляют/снимают будильник сами. Вычитание выбранного вами времени на подъём и сборы, «под каждую пару» — у каждой пары может быть своё время подъёма. Числитель/знаменатель разворачивает в конкретные даты сам сервер КГЭУ, приложение работает только с фактическими датами.
Интерфейс переведён на 19 языков: русский, татарский, английский, арабский (с RTL), узбекский, казахский, кыргызский, таджикский, туркменский, чувашский, французский, испанский, турецкий, китайский, башкирский. Язык выбирается на первом шаге мастера настройки и меняется в «Настройки → Оформление → Язык».
| Этап | Что происходит |
|---|---|
| Первая настройка | Язык интерфейса (19 языков, включая «язык системы») → вуз → роль (студент/преподаватель) → поиск группы или ФИО по API → «за сколько обычно встаёшь до первой пары» |
| Включение тумблера / мастер настройки / смена цели будильника | Будильник ставится сразу на ближайшее предстоящее пробуждение в пределах сегодня и завтра (логика 0.8.0): сначала тихо подтягивается свежее расписание (неделя сейчас + через 7 дней — замены нередко публикуют ПОСЛЕ последней синхронизации), затем — сегодня, если время подъёма ещё не прошло, иначе завтра. Дальше завтра не ставится ничего — за следующие дни отвечает ночная сверка. Выключение тумблера снимает будильники приложения (гарантированно отменяет собственный будильник движка «В приложении»; в часах снимает последний разовый и, для очистки наследия старых версий, «Авто: Пн…Вс» по точным меткам) и сбрасывает внутренние маркеры — включённый заново тумблер ставит будильник заново, даже если старый вы уже удалили в часах вручную |
| Ночь (00:05, 01:00, 02:00, 03:00) | Точная сверка приложения: запрос свежего расписания (сегодня + следующая неделя, ~15 КБ), затем ночная сверка с ближайшим ПРЕДСТОЯЩИМ пробуждением в пределах сегодня+завтра: есть пара сегодня — будильник ставится на ближайшее время; пар нет — фантомный снимается; замена сдвинула время — старый снимается, ставится новый; совпал — не дублируется. Тики 01:00–03:00 — страховки (0.12.0, раньше один тик в 06:00): если 00:05 пропущено (телефон был выключен, оболочка придавила точный будильник), ночные страховки ставят будильник на первую пару дня ещё ДО пробуждения — в том числе при ранних подъёмах 05:00–06:00. В движке «В приложении» слот перезаписывается свежим планом — самолечение по построению; в движке «в часах» ставятся только РАЗОВЫЕ будильники — повторов «на день недели» больше нет |
| После перезагрузки | BootReceiver восстанавливает все ночные сверки (00:05 + 01:00/02:00/03:00) и немедленно восстанавливает ближайший будильник: в движке «В приложении» — перепоставляет безусловно (системный AlarmManager перезагрузку не переживает, а старый маркер дедупликации больше не «подтверждает» мёртвый слот — фикс 0.9.0); в движке «в часах» — сверка ставит разовый будильник на сегодняшнюю первую пару, если телефон был выключен всю ночь и все тики пропущены (фикс 0.9.0). Резервный WorkManager синкает расписание каждые 12 часов и тоже сверяет будильник |
| В течение дня | Расписание можно перепроверить в любой момент (кнопка обновления); карточка «Мои будильники» (0.10.0) показывает то, что уже стоит: время, дату, метку, движок и живой ли слот, а с 0.13.0 — и тестовый будильник (в движке «В приложении» — с кнопкой снятия до звона); кнопки «Снять будильники» и — в движке «В часах» — явная «Список будильников» (приложение само часы не открывает никогда) |
Важно: с 0.7.1 будильник по умолчанию звонит в приложении (полный контроль тумблера,
точная дата, гарантированное снятие) — SET_ALARM стоковых часов не умеет «на дату»,
а DISMISS_ALARM на части оболочек (ColorOS/Realme UI) молча игнорируется. Если хотите
сигнал в привычных часах — переключите «Где звонит будильник → В часах»: с 0.8.0 там
ставятся только разовые будильники в пределах сегодня/завтра (дата соблюдается по
построению: ночной тик 00:05 ставит будильник в сам день пары), но снятие по-прежнему
зависит от оболочки.
- Единая логика «одна ночь вперёд» (0.8.0) — будильник ставится максимум на завтра: включение тумблера проверяет сегодня/завтра, ночная сверка 00:05 (+страховки 01:00–03:00 ночи) каждый день ставит будильник на ближайшую пару наступившего дня или снимает фантом, если пар нет. Режим «на несколько дней вперёд» (партия недельных будильников «Авто: Пн…Вс») удалён — при смене расписания такие будильники приходилось выключать руками; наследие старых установок снимается одноразовой миграцией при первом запуске 0.8.0. Под каждую пару — своё время подъёма (настраивается отдельно в диалоге с пресетами), у пар без своего значения — общий подъём.
- Будильник в приложении (0.7.0; с 0.7.1 — по умолчанию) — настройка «Где звонит будильник»: «В приложении» — собственный точный будильник (
AlarmManager.setAlarmClock): полноэкранный звонок поверх экрана блокировки с кнопками «Отключить» и «Отложить» (0.22.0: тишина на 5 минут, потом полный звонок), системный значок будильника, автоглушение через 10 минут с пометкой «пропущен» — либо «В часах» (черезACTION_SET_ALARM, только разовые будильники сегодня/завтра). Тумблер, исключения и снятие работают гарантированно в движке приложения — оболочка не может молча блокировать собственный будильник приложения. - Занятия-исключения (0.7.0: точные) — перед парами, чьё полное название совпало точно, будильник не ставится: тип уже написан в названии пары приставкой, и правило учитывает его: «л. материаловедение» гасит только лекцию, «пр. материаловедение» — только практику, «лаб. …» — только лабораторную. Никаких отдельных «тумблеров типов» — они не нужны. Переключаются прямо из расписания иконкой (иконка больше не «красит» все типы дисциплины разом); при добавлении — автодополнение по полным названиям из вашего реального расписания («мате» → «л. материаловедение», «пр. материаловедение»…).
- Свои занятия — например, физкультура или секция, которых нет в расписании: свой день недели (или дата), время и отдельное смещение будильника.
- Большой тумблер авто-будильника на главном экране — отключение в одно касание. Выключение снимает будильники приложения (гарантированно — в движке «В приложении»; по меткам с честным фолбэком — в часах) и отчитывается снекбаром. Включение подтягивает свежее расписание и ставит будильник заново: «удалил будильник в часах → включил-выключил тумблер → будильник вернулся», ждать полуночи не нужно.
- Карточка «Мои будильники» (0.10.0) на главном экране: крупное время звонка, локализованная дата, метка, движок и честный статус слота («стоит» / «не найден — перепоставится автоматически» после перезагрузки); кнопка «Снять будильники» гасит оба движка. Управление будильниками в часах — явная кнопка «Список будильников» (движок «В часах») открывает будильники телефона; «Отключить будильники приложения» через официальный канал
DISMISS_ALARMотключает и партию «Авто: Пн…Вс», и последний разовый будильник (по точным меткам «Авто: …»); если оболочка команду не принимает (часть Realme UI/ColorOS) — приложение сообщает об ограничении снекбаром, а список часов открывается только явной кнопкой «Список будильников» (0.10.0: авто-переходы в чужое приложение удалены). - Уведомления «Будильник поставлен на 07:00 (пр Атомные электрические станции, ауд. А413)».
- Кастомизация: тема (системная/светлая/тёмная), Material You (динамический цвет Android 12+), 6 палитр акцента + палитра «своего цвета» (квадрат насыщенность/яркость + ползунок тона) — кружки выбора показывают реальный цвет темы; стиль расписания на выбор: Стандарт, Бумажный календарь, Мел и доска, Неон, Терминал, Акварель, Ретро-печать; своя картинка на фон с регулировкой прозрачности; светлая и тёмная темы всегда следуют теме приложения — окно и поверхности окрашиваются согласованно, без «серой каши» при тёмной системе.
- 19 языков интерфейса (ru, tt, en, ar, uz, kk, ky, tg, tk, cv, fr, es, tr, zh, ba, az, hy, ka, mn): переводятся все экраны, уведомления, дни недели и даты; названия языков в списке — родным именем и на текущем языке («English / Английский»); сверху — русский, татарский и английский.
- Перепроверка расписания: данные не считаются «вечными» — кэш старше трёх суток помечается предупреждением, замены пар помечаются бейджем «замена», а каждое обновление подтверждается снекбаром: успех с числом пар или причина ошибки (нет связи / сеть недоступна / сбой сервера).
- Напоминание о будильнике — фолбэк для оболочек, блокирующих установку будильников (Realme UI китайского рынка, Huawei и др.): каждый день в выбранное время приходит своё уведомление «завтра пара во столько — не забудьте поставить будильник».
- Совместимость с ColorOS/Realme UI — приложение само находит установленный пакет часов (Oppo/OnePlus/Realme, Samsung, Xiaomi/Huawei, Pixel, Tecno/Infinix) и адресует команду напрямую; для самых агрессивных оболочек есть тумблер «Показывать часы при постановке» — часы открываются с готовым будильником, подтверждение одним тапом.
- Ориентация в календаре: текущая неделя выделена цветом акцента с бейджем «эта неделя», сегодняшний день — жирным со скруглённой полоской НАД названием дня (у выбранного — цвета «на акцента»), в шапке кнопка возврата к сегодняшней неделе (подсвечена, пока вы «уехали»). Расписание перелистывается свайпом — влево день вперёд, вправо назад, с плавным перетеканием выделения между чипами дней; шапка с неделей и месяцем стоит на месте и плавно сменяется при переходе через границу недели (0.25.0, статичная с 0.25.3 — без разрывов при свайпе), а сама неделя тихо подтягивается из сети; навигация никогда не ждёт сеть — неделя меняется мгновенно даже на медленном интернете (0.25.3).
- Своя фоновая картинка — своё изображение под интерфейсом с настраиваемой прозрачностью (нижний порог гарантирует читаемость текста); удалённый вручную файл не оставляет «прозрачного» экрана — нет файла, работает плотный фон. Карточки на всех экранах — плотные и контрастные.
- Маркеры дней в расписании — под числом дня: серая точка «есть пары», цветная точка с числом «столько обозначенных (исключённых) секций»; «сегодня» отмечается полоской над названием дня — путаться не с чем.
- Отключение будильника с заблокированного экрана — при звонке экран сам загорается (страховочный wake-lock даже при капризах оболочки), уведомление полностью видно на локскрине с кнопками «Отключить» и «Отложить» (0.22.0), полноэкранный звонок — с большой кнопкой; если Android 14+ не выдал full-screen intent — в настройках появится подсказка с переходом к разрешению. Если оболочка не поднимает звонок над локскрином (MIUI/HyperOS, ColorOS/Realme UI) — в инструкциях по автозапуску есть блок «Звонок поверх экрана блокировки» с путём включения «показа на экране блокировки»/«всплывающих окон» (0.22.0) и разрешением «Поверх других окон» (0.23.0: системное исключение, позволяющее звонку подняться из фона даже при закрытом приложении; на главной — карточка-подсказка с переходом в настройки разрешения).
- Настенный календарь — стиль «Бумажный календарь»: нарисованный лист с кольцами и шапкой месяца, расписание внутри, ваш фон вокруг; рядом — 5 ещё более смелых тем, у каждой своё оформление листа (0.15.0): Мел и доска — деревянная рама и рукописный шрифт, Неон — светящаяся кайма, Терминал — корпус лампового монитора, Акварель — пастельная рамка, Ретро-печать — газетные линейки.
- Скачайте APK из раздела Releases.
- Откройте файл и разрешите установку из неизвестных источников для вашего проводника/браузера.
- Запустите «Автобудильник КГЭУ» и пройдите мастер настройки (5 шагов, ~1 минута: язык → роль → группа → подъём → финиш).
Требования: Android 8.0+ (API 26); интернет для загрузки расписания. Стоковые часы нужны ТОЛЬКО для движка «В часах» (опционально: по умолчанию будильник звонит в приложении — часы не требуются).
- Установите новый APK поверх старого — настройки, исключения и кэш расписания сохраняются (DataStore/Room).
- Обновления поверх работают потому, что все релизы подписываются одним и тем же стабильным ключом (хранится в Secrets CI, в git не попадает; SHA-256 ключа зафиксирован пином в workflow — подмена секрета ломает сборку, а не молча подписывает APK чужим ключом).
- SHA-256 сертификата подписи (сверяйте после обновлений):
FD:29:47:48:43:08:64:89:7F:87:30:57:A7:2F:19:C1:E7:B2:D3:CB:B7:F4:CB:CF:2D:D4:95:F5:C5:95:F5:A0 - С 0.11.0 отпечаток сверяется автоматически на каждом релизе в CI (SEC-10): несовпадение ломает сборку, а не подписывает APK чужим ключом.
- Релизы публикуются как prerelease; после проверок на устройствах тег можно
дожать до стабильного: Actions → release → Run workflow → тег +
promote = true(ставит галку latest и снимает признак prerelease). - После обновления в 00:05 приложение само продолжит работу; перенастройка не требуется.
- Мастер настройки: язык интерфейса → группа/преподаватель → время на подъём → «Готово».
- Разрешите уведомления (Android 13+ запросит сам).
- Настройки → «Система»: отключите оптимизацию батареи и добавьте приложение в автозапуск (инструкция под вашего производителя — Xiaomi/Huawei/Oppo/Samsung и т. д.).
- Нажмите «Проверить будильник» — в часах появится тестовый будильник через 2 минуты.
- Будильники не ставятся вообще (бывает на Realme/Huawei/Xiaomi, особенно китайских прошивках)? Включите Настройки → «Напоминание о будильнике» и выберите время — приложение будет присылать своё уведомление с первой парой на завтра.
- Сам удалил будильник в часах / выключил тумблер — как вернуть будильник? Просто включите тумблер авто-будильника заново — будильник встанет на ближайшее пробуждение (сегодня/завтра) немедленно.
- Часы игнорируют команды приложения (постановка только вручную, снятие не работает — часть Realme UI/ColorOS/MIUI)? С 0.7.1 движок «В приложении» включён по умолчанию — приложение звонит само, полный контроль тумблера без ограничений оболочки (вернуть часы можно в Настройки → «Где звонит будильник» → «В часах»).
Приложение не имеет аналитики, рекламы и серверов: всё хранится только в приватной папке приложения. Минимум разрешений:
| Разрешение | Зачем |
|---|---|
INTERNET |
Загрузка расписания с kabinet.kgeu.ru |
SET_ALARM |
Постановка разового будильника в стоковые часы (движок «В часах»): ACTION_SET_ALARM/DISMISS_ALARM/SHOW_ALARMS |
RECEIVE_BOOT_COMPLETED |
Восстановить ночной планировщик и ближайший будильник после перезагрузки |
POST_NOTIFICATIONS |
Уведомления «будильник поставлен» (Android 13+) |
SCHEDULE_EXACT_ALARM (Android 12–12L) + USE_EXACT_ALARM (Android 13+) |
Ночная сверка срабатывает в 00:05, 01:00, 02:00 и 03:00, а не «примерно»; собственному звонку (setAlarmClock) разрешение не требуется |
REQUEST_IGNORE_BATTERY_OPTIMIZATIONS |
Кнопка «Исправить» в настройках (не отправляет ничего) |
FOREGROUND_SERVICE + FOREGROUND_SERVICE_DATA_SYNC |
Фоновая синхронизация расписания (WorkManager, expedited-fallback на Android < 12) |
VIBRATE + USE_FULL_SCREEN_INTENT + FOREGROUND_SERVICE_MEDIA_PLAYBACK |
Звонок движка «В приложении»: вибрация, полноэкранное уведомление поверх экрана блокировки, фоновый сервис звонка |
Резервные копии Google отключены (allowBackup=false, правила dataExtractionRules):
данные расписания, исключений и своих занятий не покидают устройство — включая
облачные бэкапы и перенос через Google. Релизный APK собран с R8 + shrinkResources
(с 0.10.0): ~2,6 МБ вместо 13 МБ.
| Путь | Назначение |
|---|---|
app/src/main/java/ru/uniautoalarm/kgeu/data/model/ |
Доменные модели (Lesson, Settings, AlarmPlan…) |
…/data/remote/ |
API КГЭУ: OkHttp + kotlinx.serialization (DTO с русскими полями сервера) |
…/data/db/ |
Room: кэш расписания, исключения, свои занятия |
…/data/repository/ |
SettingsRepository (DataStore), ScheduleRepository (сеть+кэш) |
…/domain/ |
AlarmPlanner — расчёт времени пробуждения |
…/alarm/ |
Движки будильника: StockAlarmSetter (ACTION_SET_ALARM в часы), InAppAlarmScheduler + AlarmFireReceiver + AlarmRingingService + SnoozePolicy (собственный звонок и «Отложить»), AlarmGateway (маршрутизация по цели), ночная сверка, BootReceiver, уведомления |
…/work/ |
WorkManager: периодический синк расписания |
…/ui/ |
Compose: мастер настройки, главный экран, расписание, настройки, темы |
gradle/libs.versions.toml |
Version catalog (AGP 9.4.1, Kotlin 2.3.21, Compose BOM 2026.09.00) |
# 1. JDK 17+, Android SDK (platform 37, build-tools 36.0.0)
git clone https://github.com/rvmxl/Student-AutoAlarm.git
cd Student-AutoAlarm
# 2. local.properties с путём к SDK (или переменная ANDROID_HOME)
echo "sdk.dir=/path/to/Android/Sdk" > local.properties
# 2b. Лицензии SDK (один раз на машину; без них сборка падает на проверке лицензий)
yes | "$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager" --licenses > /dev/null
# 3. Отладочная сборка APK
./gradlew :app:assembleDebug
# результат: app/build/outputs/apk/debug/app-debug.apk
# 4. Юнит-тесты (78: AlarmPlanner, правила доставки, парсер API, паритет 19 локалей, порядок языков, ночные тики, DISMISS-канал, маркеры дней/слоты пар, скины/«свой цвет», отложенный звонок, видимость строки будильника)
./gradlew :app:testDebugUnitTest
# 5. Релизная сборка — ТОЛЬКО со стабильным ключом подписи (обновления поверх):
# env-переменные KEYSTORE_FILE, KEYSTORE_PASSWORD, KEY_ALIAS, KEY_PASSWORD.
# Ключа нет → сборка упадёт ЯВНО (автогенерация нового ключа запрещена:
# чужой/новый ключ ломает установку обновлений поверх старых версий).
# В CI ключ берётся из Secrets (см. .github/workflows/release.yml).
./gradlew :app:assembleRelease© 2026 RVMXL, лицензия Apache License 2.0 (текст — LICENSE, атрибуция — NOTICE).
- Данные расписания принадлежат КГЭУ и получаются из официального публичного API личного кабинета университета; это приложение не аффилировано с КГЭУ.
- Kotlin/AndroidX/Compose/OkHttp/Coil — Apache License 2.0 их правообладателей (список — NOTICE).
- Товарные знаки Android и Google принадлежат Google LLC.
Этот репозиторий — не форк; исходный код написан с нуля для авто-будильника по расписанию.
