Библиотека 24 — Мобильный и веб-помощник медиацентра
Команда №8 | Учебная практика УП.12
Статус проекта: Спринт 1 (В разработке — День 2)
О проекте
«Библиотека 24» — это цифровой сервис для взаимодействия студентов колледжа с медиацентром, который избавляет от живых очередей и бумажной волокиты. Приложение входит в единую цифровую экосистему колледжа.
Основные возможности:
- Мониторинг загрузки: отображение текущего статуса медиацентра в реальном времени («Свободно», «Есть очередь», «Закрыто на перерыв»).
- Бронирование ПК: выбор даты, свободного временного слота и номера компьютера для работы.
- Онлайн-печать документов: загрузка файлов (PDF/DOCX), выбор формата (А4, А3), количества копий и цветности (ч/б или цветная).
- Фото на документы: съемка через камеру смартфона или загрузка селфи из галереи с выбором формата (3x4, 4x6) и отправкой на ретушь.
- Ксерокопия: быстрое оформление заявки с указанием количества страниц.
- Встроенный чат и уведомления: связь с сотрудником медиацентра для уточнения деталей и получение Push-уведомлений о готовности заказа.
Команда и распределение ролей
| Участник | Роль в проекте | Зона ответственности |
|---|---|---|
| Заявлин Артём Романович | Team Lead / Аналитик / QA | Управление задачами в Мос.Треке, архитектура данных (JSON), проектирование User Flow, написание тест-кейсов, тестирование сборок и ведение документации. |
| Деменков Лев Алексеевич | Frontend / Web-разработчик | Разработка веб-версии для студентов и административной панели сотрудника медиацентра (смена статусов, прием файлов, управление очередью). |
| Каргин Кирилл Андреевич | Mobile-разработчик (Kotlin) | Разработка нативного Android-приложения на Kotlin, настройка локальной БД (Room/SQLite), работа с камерой/файлами и сборка APK. |
- **Доска задач (Мос.Трек):https://track-hub.mos.ru/project/mediacentr/tasks?page=1&pageSize=10
Архитектура и структура репозитория
Проект разделен на два клиентских модуля, работающих по единому контракту данных (JSON), что обеспечивает совместимость при интеграции с другими сервисами колледжа.
library-24/
├── android/ # Мобильное приложение на Kotlin (Android Studio)
├── web/ # Веб-приложение (Клиент студента + Панель сотрудника)
├── docs/ # Схема User Flow (draw.io), JSON-модели, тест-кейсы
└── README.md # Документация проекта
Стек технологий:
- Mobile: Kotlin, Android SDK, Jetpack Compose / XML, Room (SQLite), Coroutines.
- Web: HTML5, CSS3, JavaScript (React / Vue / Vanilla JS), LocalStorage.
- Проектирование и трекинг: Мос.Трек (track-hub.mos.ru), Git, Draw.io (Mermaid).
Инструкция по запуску
1. Запуск Android-приложения (Kotlin)
- Склонируйте репозиторий:
git clone https://hub.mos.ru/zayavlin.artem/media-tsentr - Откройте папку
android/в Android Studio (версия Hedgehog / Iguana или новее). - Дождитесь завершения синхронизации Gradle.
- Выберите эмулятор (рекомендуется Pixel 6 / API 33+) или подключите Android-устройство по USB (с включенной отладкой по USB).
- Нажмите Run (
Shift + F10).
2. Запуск Web-версии
- Перейдите в папку
web/. - Из папки проекта выполните node scripts/serve.mjs и откройте http://localhost:4173. Нужен Node.js 18+. Устанавливать пакеты не требуется. Проверки: node --test. Сборка: node scripts/build.mjs.
Прогресс по спринтам
Спринт 1 (Дни 1–5): Базовый MVP
-
День 1: Распределение ролей, настройка доски в Мос.Треке, инициализация Git, проектирование User Flow и единой JSON-схемы данных. -
День 2: Создание базовых экранов интерфейса (главный экран со статусом центра, экраны ввода для брони ПК и заказа печати, списки заказов), запуск на эмуляторе, оформление README.mdи первых тест-кейсов. -
День 3: Подключение локальной базы данных (SQLite/Room для Android, LocalStorage/JSON для Web) для сохранения заявок после перезапуска. -
День 4: Тестирование верстки, исправление багов, подготовка к демо. -
День 5: Демонстрация Спринта 1 заказчику и фиксация Change Request (CR).
Спринт 2 (Дни 6–10): Расширенный функционал и финал
-
Дни 6–7: Реализация вкладки «Фото на документы» (камера + форматы 3x4/4x6), ксерокопии, встроенного чата с сотрудником и Push-уведомлений. Внедрение правок по CR. -
Дни 8–9: Полное сквозное тестирование, написание unit-тестов, сборка финального .apkи подготовка презентации. -
День 10: Финальная защита проекта.
Тестирование (День 2)
На текущем этапе подготовлены базовые сценарии проверки (чек-лист в docs/test_cases.md):
- Проверка корректного запуска приложения на эмуляторе Android без падений (Crash-free).
- Проверка переключения между экранами навигации (Главная, Услуги, Мои заказы, Чат).
- Проверка валидации полей ввода на экранах «Бронь ПК» и «Печать документов».