FLUTTER ECOSYSTEM

0niel/university-app

適用於莫斯科國立資訊技術、無線電技術與電子大學的行動應用程式，包含課程表、新聞及其他多項功能

在 GitHub 查看 ↗

Stars: 259
Forks: 37
最近推送（UTC）: 2026年9月17日
專案狀態: 未封存

GITHUB User

Sergei Dmitriev ↗

YandexSerbia

語言DartPLpgSQLPythonTypeScriptJavaScriptC++CMakeSwiftKotlinHTMLPowerShellRubyShellCDockerfileObjective-C

技術主題

# flutter # dart # android # ios # bloc # clean-architecture

使用的依賴

依賴清單 170 項

academic_calendar{"path":"packages/academic_calendar"}
activity_calendar^1.0.1
adaptive_theme^3.5.0
ads_ui{"path":"packages/ads_ui"}
after_layout^1.1.0
analytics_repository{"path":"packages/analytics_repository"}
app_settings^7.0.0
app_ui{"path":"packages/app_ui"}
article_repository{"path":"packages/article_repository"}
bloc^9.2.0
bloc_concurrency^0.3.0
bot_toast^4.1.3
built_collection^5.1.1
cached_network_image^3.2.0
calendar_date_picker2^3.0.0
campus_repository{"path":"packages/campus_repository"}
carousel_slider^5.0.0
chewie^1.16.2
clock^1.1.2
collection^1.18.0
community_catalog_repository{"path":"packages/community_catalog_repository"}
community_repository{"path":"packages/community_repository"}
connectivity_client{"path":"packages/connectivity_client"}
cupertino_icons^1.0.2
deep_link_client{"path":"packages/deep_link_client"}
device_calendar{"git":{"url":"https://github.com/0niel/device_calendar.git","ref":"develop"}}
dio^5.1.2
dismissible_page^1.0.2
dot_navigation_bar{"git":{"url":"https://github.com/0niel/dot_navigation_bar.git","ref":"master"}}
dynamite_runtime^0.6.0
enough_platform_widgets^1.1.1
equatable^2.0.5
extended_image^10.0.1
file_picker^12.0.0-beta.4
filesize^2.0.0
firebase_analytics^12.1.2
firebase_core^4.4.0
firebase_messaging^16.1.1
fl_chart^1.1.1
flutter{"sdk":"flutter"}
flutter_animate^4.5.0
flutter_bloc^9.1.1
flutter_cache_manager^3.3.1
flutter_html^3.0.0-beta.2
flutter_html_iframe^3.0.0-beta.2
flutter_html_svg^3.0.0-beta.2
flutter_html_table^3.0.0-beta.2
flutter_html_video^3.0.0-beta.2
flutter_layout_grid^2.0.8
flutter_localizations{"sdk":"flutter"}
flutter_map^8.2.2
flutter_material_design_icons^3.1.0+7447
flutter_native_splash^2.4.3
flutter_nfc_kit^3.3.1
flutter_quill^11.5.1
flutter_quill_extensions^11.0.0
flutter_screenutil^5.9.3
flutter_secure_storage^10.0.0
flutter_staggered_animations^1.1.0
flutter_staggered_grid_view^0.7.0
flutter_sticky_header^0.8.0
flutter_svg^2.0.5
flutter_typeahead^6.0.0
flutter_web_plugins{"sdk":"flutter"}
formz^0.8.0
freezed_annotation3.1.0
friends_repository{"path":"packages/friends_repository"}
gamification_repository{"path":"packages/gamification_repository"}
geolocator^14.0.2
go_router^17.1.0
home_widget0.9.1
http^1.2.2
hugeicons^1.1.5
hydrated_bloc^11.0.0
image_picker^1.1.2
intl^0.20.2
json_annotation4.12.0
latlong2^0.9.1
local_auth_client{"path":"packages/local_auth_client"}
local_notifications_client{"path":"packages/local_notifications_client"}
local_notifications_repository{"path":"packages/local_notifications_repository"}
logger^2.0.2+1
logging^1.1.1
lost_and_found_repository{"path":"packages/lost_and_found_repository"}
material_floating_search_bar_2^0.5.0
meta^1.15.0
mime^2.0.0
mini_apps_repository{"path":"packages/mini_apps_repository"}
mobile_scanner^7.2.0
network_location_client{"path":"packages/network_location_client"}
news_blocks{"path":"packages/news_blocks"}
news_blocks_ui{"path":"packages/news_blocks_ui"}
news_repository{"path":"packages/news_repository"}
nfc_pass_client{"path":"packages/nfc_pass_client"}
nfc_pass_repository{"path":"packages/nfc_pass_repository"}
open_filex^4.4.0
package_info_client{"path":"packages/package_info_client"}
package_info_plus^10.1.0
path^1.0.0
path_drawing^1.0.1
path_provider^2.1.1
pdf3.12.0
pdfx^2.11.0
perfect_freehand^2.5.2+1
permission_client{"path":"packages/permission_client"}
persistent_storage{"path":"packages/storage/persistent_storage"}
photo_view^0.15.0
platform^3.0.2
preferences_repository{"path":"packages/preferences_repository"}
promo_repository{"path":"packages/promo_repository"}
qr_flutter^4.1.0
queue^3.0.0
responsive_framework^1.5.1
rxdart^0.28.0
salomon_bottom_bar^3.3.2
schedule{"path":"packages/schedule"}
schedule_exporter_repository{"path":"packages/schedule_exporter_repository"}
schedule_repository{"path":"packages/schedule_repository"}
secure_storage{"path":"packages/storage/secure_storage"}
sentry_dio9.20.0
sentry_flutter9.20.0
sentry_logging9.20.0
service_catalog_repository{"path":"packages/service_catalog_repository"}
share_launcher{"path":"packages/share_launcher"}
share_plus^13.1.0
shared_preferences^2.0.11
sliver_tools^0.2.12
smooth_sheets^1.0.2
speech_to_text^7.4.0
stac_bridge{"path":"packages/stac_bridge"}
storage{"path":"packages/storage/storage"}
story^1.1.0
stream_transform^2.1.1
study_groups_repository{"path":"packages/study_groups_repository"}
supabase_authentication_client{"path":"packages/auth_client/supabase_authentication_client"}
supabase_flutter^2.8.3
syncfusion_flutter_calendar^32.1.23
syncfusion_localizations^32.2.3
table_calendar^3.0.3
timezone^0.10.0
token_storage{"path":"packages/auth_client/token_storage"}
tutorial_coach_mark^1.3.3
uniconsany
universal_io^2.0.0
university_modules^0.1.0
university_provider{"path":"packages/university_provider"}
url_launcher^6.1.12
user_repository{"path":"packages/user_repository"}
uuid^4.5.3
very_good_infinite_list^0.9.0
video_player^2.9.2
visibility_detector^0.4.0+2
watch_connectivity0.2.9
xml^6.6.1
yandex_mobileads^8.0.0
yx_scope^1.1.2
yx_scope_flutter^1.1.2
bloc_test開發依賴^10.0.0
build_runner開發依賴2.15.1
build_verify開發依賴any
flutter_gen_runner開發依賴^5.3.2
flutter_launcher_icons開發依賴^0.14.1
flutter_test開發依賴{"sdk":"flutter"}
freezed開發依賴3.2.5
go_router_builder開發依賴^4.1.1
json_serializable開發依賴6.14.0
mocktail開發依賴^1.0.5
shared_preferences_platform_interface開發依賴^2.4.2
very_good_analysis開發依賴10.3.0
yaml開發依賴3.1.3

App 分類

教育

所在榜單

Architecture#67 Production#375

原始 README

以下為英文專案原文快照，最新內容請造訪 GitHub。

展開 / 收合專案 README

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 ↗

技術主題

相關套件與範例

bloc_concurrency

hydrated_bloc

get

firebase_analytics

firebase_messaging

go_router_builder

flutter_screenutil

flutter_map

extended_image

table_calendar

flutter_html

flutter_html_table