搜索插件、代码仓与 APP 分类

GitHub 代码仓0niel/university-app

大学应用

一款适用于莫斯科国立信息技术、无线电技术与电子大学的移动应用程序,包含课表、新闻及其他多种功能

大学应用 项目封面
星标
268
复刻
38
最近推送(UTC)
2026年11月9日
项目状态
未归档

原始 README

以下为英文项目原文快照,最新内容请访问 GitHub。

University App

Открытая платформа студенческого приложения на Flutter. Репозиторий можно адаптировать под другой университет без форка бизнес-логики: tenant, публичный брендинг и deep links задаются конфигурацией, а университетские источники данных подключаются через нормализованный ingest-контракт Supabase.

Конфигурация по умолчанию сохраняет совместимость с РТУ МИРЭА. Встроенный MIREA-фетчер выключен по умолчанию и не должен использоваться для другого tenant.

Технологии и архитектура

  • Flutter 3.44.2 и Dart 3.12 с null safety.
  • Feature-first BLoC-архитектура: UI и BLoC находятся в lib/<feature>, а переиспользуемые клиенты, модели и репозитории — в Dart workspace packages/.
  • bloc/hydrated_bloc для состояния, yx_scope для dependency injection и go_router для навигации.
  • Freezed и json_serializable для генерируемых immutable-моделей и JSON DTO.
  • Supabase Auth, Storage, миграции, RPC и Edge Functions как серверный контракт.
  • Отдельный Python 3.12 worker для официальных новостей, Telegram-публикаций и Telegram Stories.

Основной поток данных:

внешний источник -> Python worker -> Edge Function /ingest
                 -> Supabase RPC/таблицы -> repository -> BLoC -> Flutter UI

Flutter не должен обращаться к внутренним таблицам или использовать service_role. Привилегированная запись контента проходит через защищённую функцию supabase/functions/ingest, а схема БД изменяется только миграциями из supabase/migrations.

Быстрый старт

Нужны Flutter, FVM и Java 17 для Android. Версия Flutter закреплена в .fvmrc.

dart pub global activate fvm
fvm install
fvm flutter pub get

Создайте две локальные compile-time конфигурации:

cp .env.example .env
cp config/university.example.json config/university.local.json

В PowerShell используйте Copy-Item вместо cp. В .env укажите публичные SUPABASE_URL и SUPABASE_PUBLISHABLE_KEY. В config/university.local.json задайте tenant и брендинг. Затем проверьте конфигурацию и сгенерируйте код:

fvm dart run tool/configure_university.dart
fvm dart run build_runner build

Запуск development flavor на Android/iOS/macOS:

fvm flutter run \
  --flavor development \
  --target lib/main/main_development.dart \
  --dart-define-from-file=.env \
  --dart-define-from-file=config/university.local.json \
  --dart-define-from-file=config/firebase.local.json

Firebase-файл опционален: без него Analytics и FCM корректно отключаются. Нативные google-services.json, GoogleService-Info.plist и сгенерированный firebase_options.dart не являются частью открытого исходного кода.

Для Windows уберите --flavor development. Подробности о схеме конфигурации и режиме --check описаны в docs/university-configuration.md.

Локальные .env, tenant-файлы, Firebase-конфигурация, ключи подписи и Telegram session-файлы нельзя коммитить. Пример university config содержит только публичные значения и не заменяет настройку собственных Firebase/Supabase проектов.

Supabase

Локальная конфигурация находится в supabase/config.toml. Для работы с миграциями нужен Supabase CLI и Docker:

supabase start
supabase db reset

Не изменяйте уже применённые миграции: создавайте новую через supabase migration new <name>. Секрет ingest-функции хранится только на сервере и в локальном окружении worker.

Для одного tenant задайте Edge secrets INGEST_API_KEY и INGEST_ORGANIZATION_ID. Общий backend нескольких университетов должен использовать INGEST_TENANT_KEYS — JSON-карту organization_id к отдельному ключу каждого worker. Не используйте один неприкреплённый ключ для всех tenant.

Фетчер контента

Worker находится в tools/social_media_fetcher и использует uv. Он нормализует контент и отправляет его в Edge ingest; напрямую в БД не пишет.

Для RSS/Atom и официальных API предпочтителен no-code путь через self-hosted n8n: импортируйте готовый rss-to-ingest.json и используйте HTTP Request node для Facebook Graph API, YouTube, Mastodon или иного документированного API. Python-коннектор оставлен для источников, которым нужна пользовательская сессия или особая обработка, например Telegram Stories. Полный контракт и правила расширения — в tools/social_media_fetcher/docs/architecture.md.

cd tools/social_media_fetcher
cp .env.example .env
uv sync --locked
uv run python worker.py

MIREA_ENABLED=true допустим только при APP_ORGANIZATION_ID=mirea. Telegram подключается явно через TELEGRAM_CHANNELS и TELEGRAM_STORY_CHANNELS. Для пользовательской Telegram-сессии используйте отдельный согласованный аккаунт и setup_telegram_session.py; полученный session string считается секретом и не должен попадать в логи, issues или Git.

Stories-медиа загружается только через подписанные Storage URL. Workflow cleanup-story-media.yml независимо от Telegram-сессии удаляет истёкшие и осиротевшие объекты; для него задаются SUPABASE_URL, INGEST_ORGANIZATION_ID и tenant-bound INGEST_API_KEY.

Проверки

fvm dart analyze --fatal-warnings
fvm flutter test

cd tools/social_media_fetcher
uv run ruff format --check .
uv run ruff check .
uv run pytest

CI повторяет анализ и тесты Flutter и ключевых workspace-пакетов, проверки Python worker, format/lint/type-check Edge ingest и fresh replay Supabase миграций. CI имеет только read-доступ к репозиторию. Релиз Shorebird запускается только вручную отдельным workflow.

Участие

Перед pull request прочитайте CONTRIBUTING.md и CODE_OF_CONDUCT.md. Уязвимости нельзя публиковать в обычных issues — используйте SECURITY.md.

Проект распространяется по лицензии MIT.

Sergei Dmitriev GitHub avatar
GitHub 作者

Sergei Dmitriev ↗

YandexSerbia
语言DartPLpgSQLPythonTypeScriptJavaScriptC++CMakeSwiftKotlinHTMLPowerShellRubyShellCDockerfileObjective-C

分类

依赖Flutter组件

使用的依赖

依赖清单 170 项

App 分类

所在榜单

如何选择适合项目的代码仓?

先按使用场景筛选,再比较项目活跃情况,最后到原始仓库核对使用要求。

  1. 通过仓库名、作者或描述搜索,再按技术分类缩小范围。
  2. 结合星标、复刻与最近推送比较项目;星标反映社区关注,不代表质量保证。
  3. 使用前在 GitHub 核对 README、许可证与 Issues。

来源与维护

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗