Футбольная школа "Арсенал"

Полнофункциональное мобильное приложение для управления футбольной школой "Арсенал" с поддержкой веб-платформы.

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

Запуск веб-версии:

npm run launch-web

Сборка APK для Android:

npm run build-apk

📱 Основные функции

Для всех пользователей:

• 📅 Просмотр расписания тренировок
• 📰 Просмотр новостей школы
• 🍎 Рекомендации по питанию
• 🏆 Просмотр достижений

Для учеников:

• 👤 Личный профиль
• 📈 Прогресс в тренировках
• 🎯 Результаты по дисциплинам

Для родителей:

• 👶 Прогресс ребенка
• 📅 Расписание занятий

Для тренеров:

• 📋 Управление посещаемостью
• 📊 Ведение прогресса учеников
• 🏃 Ввод результатов тренировок

Для управляющих:

• 🛠️ Админ-панель
• 📊 Аналитика посещаемости
• 👥 Управление пользователями
• 🎯 Управление навыками
• 🏢 Управление филиалами
• 👨‍🏫 Назначение тренеров
• ⚙️ Настройки базы данных

Для SMM-менеджеров:

• 📝 Управление новостями для социальных сетей

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

• React Native - кроссплатформенная разработка
• Expo - инструменты для разработки
• TypeScript - типизация
• React Navigation - навигация
• React Native Paper - UI компоненты
• AsyncStorage - локальное хранение данных

📁 Структура проекта

Goal-School/
├── src/
│   ├── components/        # Компоненты интерфейса
│   ├── context/           # Контексты React
│   ├── navigation/        # Навигация приложения
│   ├── screens/           # Экраны приложения
│   ├── services/          # Сервисы для работы с данными
│   ├── types/             # TypeScript типы
│   └── utils/             # Вспомогательные функции
├── web-export/            # Собранные файлы веб-версии
├── android/               # Файлы для Android платформы
└── assets/                # Ресурсы приложения

🎯 Основные команды

Разработка

npm start              # Запуск Expo DevTools
npm run web            # Запуск веб-версии в режиме разработки
npm run android        # Запуск на Android
npm run ios            # Запуск на iOS

Сборка и запуск

npm run launch-web     # Быстрый запуск веб-версии (рекомендуется)
npm run build-web-assets # Сборка веб-версии
npm run serve          # Запуск веб-сервера
npm run build-apk      # Создание APK для Android

Проверка

npm run check          # Проверка состояния проекта

👤 Тестовые учетные записи

Роль	Email	Пароль
Ребенок	admin1@gs.com	admin
Родитель	admin2@gs.com	admin
Управляющий	admin3@gs.com	admin
Тренер	admin4@gs.com	admin
SMM-менеджер	admin5@gs.com	admin

🌐 Веб-версия

Веб-версия приложения полностью функциональна и включает все возможности мобильной версии. Для запуска используйте команду npm run launch-web.

📱 Мобильная версия

Android (APK для Rustore)

npm run build-apk

После создания APK файл будет доступен для загрузки в RuStore. Текущая версия APK находится в стадии тестирования.

iOS

Для сборки iOS версии требуется macOS и Xcode.

🏢 Информация о филиалах

Приложение поддерживает работу с несколькими филиалами:

Филиал Жулебино

• Расписание: Вт/Чт/Сб с 18:00 до 19:00
• Тренер: Захар

Филиал Ул. Дмитриевского

• Расписание: Пн/Ср/Пт с 17:30 до 18:30
• Тренер: Захар

Подробная информация о филиалах доступна в файле BRANCHES_INFO.md

☁️ Развертывание

Веб-версия (Beget)

Следуйте инструкции в файле DEPLOY_WEB.md

Мобильная версия (Rustore)

Следуйте инструкции в файле DEPLOY_APK.md

📚 Документация

• Полная документация
• Инструкция по использованию
• Развертывание веб-версии
• Создание APK для Rustore

🆘 Поддержка

Если у вас возникли проблемы:

1. Проверьте логи консоли
2. Убедитесь, что все зависимости установлены
3. Попробуйте очистить кэш: npm start --reset-cache
4. Обратитесь к разработчику

Проект: Мобильное приложение футбольной школы "Арсенал"

🎯 Цель проекта

Разработка мобильного приложения для футбольной школы "Арсенал" с функционалом для учеников, родителей, тренеров и управляющих филиалами.

📋 Основные функции

🎓 Для учеников (детей)

• Просмотр расписания тренировок
• Просмотр новостей школы
• Просмотр рекомендаций по питанию
• Отслеживание личного прогресса
• Просмотр результатов по дисциплинам
• Получение достижений

👨‍👩‍👧‍👦 Для родителей

• ✅ Просмотр прогресса своих детей
• ✅ Просмотр расписания тренировок
• Получение уведомлений о посещаемости
• ✅ Просмотр рекомендаций по питанию

⚽ Для тренеров

• Управление посещаемостью
• Внесение результатов по дисциплинам
• Ввод результатов тренировок
• Просмотр прогресса учеников своего филиала
• Обратная связь ученикам

🏢 Для управляющих филиалами

• Аналитика посещаемости по филиалам
• Управление пользователями
• Просмотр общей статистики школы
• Управление филиалами
• Назначение тренеров филиалам

📱 Для SMM-менеджеров

• Создание и публикация новостей
• Создание рекомендаций по питанию
• Аналитика по просмотрам новостей

🏗️ Архитектура проекта

📁 Структура папок

src/
├── components/        # Переиспользуемые компоненты
├── context/           # Контексты React (аутентификация, база данных и т.д.)
├── hooks/             # Пользовательские хуки
├── navigation/        # Навигация приложения
├── screens/           # Экраны приложения
├── services/          # Сервисы для работы с данными
├── types/             # Типы TypeScript
├── utils/             # Вспомогательные функции
└── constants/         # Константы приложения

📚 Документация

📖 Общая документация

• Детальный план разработки - полный план разработки проекта
• Требования к приложению - детальные требования к функциональности
• Функциональность по ролям - описание функциональности для каждой роли пользователя
• Функциональность для родителей - описание функциональности для родителей
• Требования к регистрации по филиалам - требования к регистрации пользователей с привязкой к филиалам
• Требования к системе уведомлений - требования к системе уведомлений
• Требования к цветовой палитре - требования к цветовой схеме приложения
• План реализации регистрации по филиалам - технический план реализации функциональности филиалов
• Техническое задание по функциональности филиалов - техническое задание для реализации функциональности филиалов
• Функциональность филиалов - описание реализации функциональности филиалов
• Система ввода результатов тренировок - описание системы ввода результатов тренировок
• Система уведомлений для тренеров - описание системы уведомлений для тренеров
• Обзор экранов приложения - описание всех экранов приложения
• Структура навигации - описание структуры навигации в приложении
• Система уведомлений - описание системы уведомлений
• Система управления филиалами - описание системы управления филиалами
• Руководство СММ-менеджера - руководство по использованию функционала СММ-менеджера
• Система Push-уведомлений - описание системы push-уведомлений
• Система пользовательских уведомлений - описание системы пользовательских уведомлений через периодический опрос сервера
• Система локализации - описание системы мультиязычной поддержки

🛠️ Техническая документация

• Техническая спецификация - техническое описание архитектуры
• Схема базы данных - описание структуры базы данных
• API документация - документация по API
• Документация по компонентам - описание компонентов интерфейса

📊 Документация по тестированию

• План тестирования - план тестирования приложения
• Результаты тестирования - результаты тестирования
• Отчеты по багам - отчеты по найденным ошибкам

👥 Документация по ролям

• Руководство для учеников - инструкция для учеников
• Руководство для родителей - инструкция для родителей
• Руководство для тренеров - инструкция для тренеров
• Руководство для управляющих - инструкция для управляющих
• Руководство для SMM-менеджеров - инструкция для SMM-менеджеров
• Руководство СММ-менеджера - руководство по использованию функционала СММ-менеджера

📈 Документация по аналитике

• Аналитика использования - данные по использованию приложения
• Отчеты по производительности - отчеты по производительности

🚀 Запуск проекта

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

• Node.js (версия 16 или выше)
• npm или yarn
• Expo CLI

📥 Установка

# Клонирование репозитория
git clone <repository-url>
cd goal-school

# Установка зависимостей
npm install

▶️ Запуск приложения

# Запуск в режиме разработки
npm start

# Запуск для Android
npm run android

# Запуск для iOS
npm run ios

# Запуск для Web
npm run web

🧪 Тестирование

# Запуск unit-тестов
npm test

# Запуск тестов с покрытием
npm run test:coverage

📦 Сборка

# Создание веб-версии
npm run build-web

# Создание простой веб-версии (альтернативный способ)
npm run build-simple-web

# Файлы веб-версии находятся в папке web-export
# Готовый архив: web-export-final.zip

Мобильная версия (APK)

# Создание простого APK (демонстрационная версия)
node build-apk-simple.js

# Создание полноценного APK (требуется Android SDK)
.\build_apk.bat

# Файлы APK находятся в папке apk-build
# Готовый архив: apk-build.zip

🚀 Развертывание

Предварительный просмотр веб-версии

Для предварительного просмотра веб-версии приложения:

1. Запустите сервер предварительного просмотра:

   node preview_server.js
   

2. Откройте браузер и перейдите по адресу: http://localhost:3000

3. Для создания полноценной веб-версии остановите сервер (Ctrl+C) и выполните:

   npx expo export:web
   

4. После экспорта снова запустите сервер предварительного просмотра

Веб-развертывание на Beget

1. Все необходимые файлы для веб-развертывания находятся в папке web-export
2. Просто загрузите содержимое этой папки на ваш хостинг Beget
3. Основной файл - index.html

Локальная сборка APK для Rustore

Для сборки APK необходимы инструменты разработки Android. Мы подготовили подробное руководство по установке и сборке:

📖 Подробное руководство по установке и сборке APK

Быстрый старт (минимальная установка):

1. Минимальная установка: Запустите install_java_android_sdk.bat для установки только необходимых компонентов (JDK и Android SDK)
2. Полная установка: Запустите install_android_tools.bat для установки полного комплекта (JDK, Android Studio и Android SDK)
3. Сборка APK: После установки и перезагрузки командной строки запустите build_apk.bat для сборки APK

Ручная установка инструментов

Если вы предпочитаете установить инструменты вручную, следуйте инструкциям в подробном руководстве.

После установки инструментов:

1. Откройте терминал в корневой папке проекта
2. Перейдите в папку android: cd android
3. Запустите сборку: .\gradlew.bat assembleRelease
4. APK будет создан по адресу: android/app/build/outputs/apk/release/app-release.apk

🧰 Основные технологии

• React Native - кроссплатформенная разработка
• Expo - платформа для React Native
• TypeScript - типизация кода
• React Navigation - навигация в приложении
• React Native Paper - UI компоненты
• AsyncStorage - локальное хранилище
• Jest - тестирование
• React Hooks - управление состоянием

🎨 Дизайн

Приложение следует цветовой палитре футбольного клуба Arsenal:

• Красный: #EF0107
• Белый: #FFFFFF
• Черный: #000000

📱 Поддерживаемые платформы

• iOS
• Android
• Web

📊 Статус разработки

Подробный статус разработки и текущие задачи можно посмотреть в файле CURRENT_STATUS.md

📞 Контакты

Для вопросов и предложений по проекту обращайтесь к разработчику.

📄 Лицензия

Проект разработан специально для футбольной школы "Арсенал" и не подлежит распространению без разрешения правообладателя.