Библиотека 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.

Архитектура и структура репозитория

Проект разделен на два клиентских модуля, работающих по единому контракту данных (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)

  1. Склонируйте репозиторий:
    git clone https://hub.mos.ru/zayavlin.artem/media-tsentr
  2. Откройте папку android/ в Android Studio (версия Hedgehog / Iguana или новее).
  3. Дождитесь завершения синхронизации Gradle.
  4. Выберите эмулятор (рекомендуется Pixel 6 / API 33+) или подключите Android-устройство по USB (с включенной отладкой по USB).
  5. Нажмите Run (Shift + F10).

2. Запуск Web-версии

  1. Перейдите в папку web/.
  2. Из папки проекта выполните 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):

  1. Проверка корректного запуска приложения на эмуляторе Android без падений (Crash-free).
  2. Проверка переключения между экранами навигации (Главная, Услуги, Мои заказы, Чат).
  3. Проверка валидации полей ввода на экранах «Бронь ПК» и «Печать документов».