---

Мой ИТИ ХГУ - Твой университет в кармане

📖 О проекте

Мой ИТИ ХГУ — это официальное мобильное приложение для студентов и преподавателей Инженерно-технологического института Хакасского государственного университета им. Н. Ф. Катанова. Приложение создано для того, чтобы сделать доступ к расписанию, новостям и навигации по университету максимально удобным и быстрым.

✨ Основные возможности

🎓 Для студентов

• Расписание: Просмотр расписания занятий по группам.
• Режимы: Дневной и недельный просмотр.
• Первокурснику: Специальный раздел с полезной информацией, ссылками и гайдами.

👨‍🏫 Для преподавателей

• Персональное расписание: Поиск по ФИО.
• Детализация: Отображение групп для каждой пары.
• Навигация: Удобный просмотр расписания на неделю.

🚀 Общие функции

• Офлайн-доступ: Кэширование расписания и новостей.
• Новости: Актуальные события университета.
• Карта: Интерактивная схема корпусов.
• Персонализация: Темы (светлая/тёмная) и цветовые акценты.
• Уведомления: Оповещения об изменениях и важных новостях.

🛠 Технический стек

Проект построен с использованием современных технологий:

• Framework: React Native
• Platform: Expo
• Language: JavaScript (ES6+)
• Navigation: Expo Router (File-based routing)

🚀 Запуск и разработка

Предварительные требования

• Node.js
• npm
• Git

Установка и запуск

1. Склонируйте репозиторий

   git clone https://github.com/PRO100BYTE/MyKHSU.git
   cd MyKHSU

2. Установите зависимости

   npm install

3. Запустите сервер разработки

   npx expo start

В результате, вы получите варианты запуска приложения в:

• тестовой сборке
• Android эмуляторе
• iOS симуляторе
• Expo Go

📦 Сборка приложения

Android

Для начала нужно создать prebuild:

npx expo prebuild

Затем выполните одну из команд:

# APK (Release)
npx eas build --platform android --profile release-apk --local

# AAB (Google Play)
npx eas build --platform android --profile release --local

# Development APK
npx eas build --platform android --profile development --local

Warning

Для локальной сборки под Android требуется Linux или macOS.

Note

Комментарий TheDayG0ne: Лично я для сборки приложения использую виртуальную машину с ОС Ubuntu Server 24.04. В качестве окружения устанавливал git, nodejs, jdk, а также android-sdk.

iOS

Для начала нужно создать prebuild:

npx expo prebuild

Затем выполните одну из команд:

# Release (IPA)
npx eas build --platform ios --profile release --local

# Development (Device)
npx eas build --platform ios --profile development --local

Warning

Для локальной сборки под iOS требуется macOS с установленным Xcode.

📚 Полезные ресурсы

• Документация Expo
• Учебное пособие Expo

🤝 Вклад в развитие

Мы приветствуем вклад сообщества! Пожалуйста, ознакомьтесь с CONTRIBUTING.md и CODE_OF_CONDUCT.md перед началом работы.

📄 Лицензия

Этот проект распространяется под лицензией LGPL v3. Подробнее см. в файле LICENSE.md.

---

_{Разработано с ❤️ командой PRO100BYTE}