Обновить README.md

.gitea/workflows/workflow.yml

@@ -0,0 +1,82 @@
+name: Android Test
+
+on:
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  validate-and-test:
+    runs-on: android
+    steps:
+      - name: Check ANDROID_SERIAL is set
+        run: |
+          if [ -z "$ANDROID_SERIAL" ]; then
+            echo "❌ Ошибка: Переменная окружения ANDROID_SERIAL не установлена."
+            exit 1
+          fi
+          echo "✅ Переменная ANDROID_SERIAL установлена: $ANDROID_SERIAL"
+
+      - name: Check ADB device is connected
+        run: |
+          command -v adb >/dev/null 2>&1 || { echo "❌ Ошибка: adb не найден в PATH." >&2; exit 1; }
+
+          connected_devices=$(adb devices | grep -c "$ANDROID_SERIAL.*device$")
+
+          if [ "$connected_devices" -ne 1 ]; then
+            echo "❌ Ошибка: Устройство с серийным номером $ANDROID_SERIAL не подключено или не доступно."
+            echo "Доступные устройства:"
+            adb devices
+            exit 1
+          fi
+          echo "✅ Устройство с серийным номером $ANDROID_SERIAL подключено и готово к использованию."
+
+      - name: Checkout PR code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - name: Validate allowed changes
+        run: |
+          python3 /opt/scripts/validate-changes.py
+        env:
+          GITEA_REPOSITORY: ${{ gitea.repository }}
+          GITEA_BASE_REF: ${{ gitea.event.pull_request.base.ref }}
+          GITEA_HEAD_REF: ${{ gitea.event.pull_request.head.ref }}
+
+      - name: Checkout tests
+        run: python3 /opt/scripts/copy-tests.py --repo-url "Olympic/NTO-2025-Client-Android-tests" --branch "main"
+
+      - name: Uninstall APK before tests (Gradle)
+        run: |
+          chmod +x ./gradlew
+          ./gradlew uninstallAll
+
+      - name: Run tests
+        run: |
+          chmod +x ./gradlew
+          ./gradlew connectedDebugAndroidTest
+
+      - name: Uninstall APK after tests (Gradle)
+        run: |
+          chmod +x ./gradlew
+          ./gradlew uninstallAll
+        if: always()
+
+      - name: Upload test results
+        uses: christopherHX/gitea-upload-artifact@v4
+        with:
+          name: test-results
+          path: app/build/outputs/androidTest-results/connected
+          if-no-files-found: ignore
+          retention-days: 30
+        if: always()
+
+      - name: Upload test reports
+        uses: christopherHX/gitea-upload-artifact@v4
+        with:
+          name: test-reports
+          path: app/build/reports/androidTests/connected
+          if-no-files-found: ignore
+          retention-days: 30
+        if: always()

README.md

@@ -0,0 +1,66 @@
+# НТО 2025. II отборочный этап. Индивидуальные задания — Android
+
+## 📖 Предыстория
+В компании S есть возможность бронирования мест в пространствах, предназначенных под общее использование (open-space). На данный момент для бронирования места используются различные способы бронирования, разработанные в каждом офисе индивидуально.
+Администрации компании S требуется мобильное приложение, как для рядовых сотрудников, так и для администрации с возможностью просмотра забронированных мест.
+
+
+
+## 📋 Системные требования
+
+| **Параметр**                | **Требование**                        |
+|-----------------------------|---------------------------------------|
+| **Минимальная версия Android** | 9.0 (API 28)                         |
+| **Целевая версия Android**    | 16 (API 36)                          |
+| **Поддерживаемые устройства** | смартфоны, планшеты                  |
+| **Ориентация экранов**         | портретная                           |
+| **Языки**                    | русский                  |
+
+
+
+## 📱 Техническое задание
+Тебе предстоит доработать существующий проект, в котором уже реализован UI слой. Над этим проектом уже работал твой коллега, однако он ушел в отпуск. Твоя цель — описать бизнес-логику приложения, реализовав `domain` и `data` слой. Взаимодействие с сервером необходимо осуществить с помощью REST API.
+
+Поскольку проект только на начальной стадии развития и сервер ещё не был опубликован на внешнем ресурсе, тебе предстоит развернуть его локально. Ссылка на репозиторий с [бэкендом](https://git.sicampus.ru/Olympic/NTO-2025-Client-Android-backend). Рекомендуется открывать в IntelijIDEA.
+
+Отметим, что при доработке проекта ui слой и доменные сущности изменять не нужно. При решении заданий настоятельно рекомендуем соблюдать [Clean Architecture](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html).
+
+### 1. Реализация основного запроса
+
+Первая задача - реализовать сетевое взаимодействие для получения информации о пользователе и его существующих бронированиях. Для этого используется `GET /user`. Формат данных, возвращаемых сервером, можно посмотреть, запустив сервер и выполнив запрос к эндпоинту `/user`. Текущий проект уже содержит необходимую вёрстку и доменные модели, поля которых необходимо заполнить данными из ответа сервера в полном соответствии со структурой API.
+
+### 2. Заполнение формы ввода
+
+Далее тебе необходимо доработать форму отправки данных и реализовать обработку ответов от сервера. Для этого требуется добавить сетевой запрос `POST /book`, который отправляет данные в формате `multipart/form-data`. В теле запроса передаются поля `room` и `time`, содержащие информацию о бронировании. В рамках данного MVP реализация валидации или фильтрации вводимых данных на стороне клиента не требуется.
+
+### 3. Обработка ошибок
+
+Заключительным этапом разработки приложения является анализ и обработка ответов сервера. Необходимо доработать существующие сетевые запросы следующим образом:
+
+- если код статуса ответа равен 2xx, то необходимо считать тело ответа и вернуть полученные данные;
+- если код статуса ответа не равен 2xx, то необходимо считать тело ответа, содержащее информацию об ошибке, извлечь из него сообщение и на уровне доменной модели вернуть `Result.Failure` (как выполнить мапинг - решаешь ты, в т.ч. можно использовать конструкцию `runCatching { … }`), у которого это сообщение передаётся в свойство message для дальнейшего отображения в интерфейсе.
+
+Для тестирования можете модифицировать тестовый сервер, все необходимые сущности для этого уже созданы.
+
+
+## ✅ Особенности оценивания
+
+Оценивание происходит с помощью автоматической системы тестирования, которая самостоятельно находит элементы и взаимодействует с ними (именно для этого у каждого элемента указан уникальный идентификатор, по которому будет производится поиск). Каждый тест происходит с чистой установки приложения.
+
+
+**Неизменяемые файлы**
+
+Классы, отмеченные строкой:
+```kotlin
+// ДАННЫЙ КЛАСС ЗАПРЕЩЕНО МОДИЦИФИРОВАТЬ! ПРИ ТЕСТИРОВАНИИ ОН БУДЕТ ВОЗВРАЩЁН В ОРИГИНАЛЬНОЕ СОСТОЯНИЕ
+```
+Во время тестирования они будут возвращены в состояние, которое указано в шаблоне. Поэтому их редактирование запрещено.
+
+**Зависимости**
+
+Все необходимые зависимости проекта уже подключены. Тебе запрещено добавлять/изменять/удалять зависимости. Они будут возвращены в исходное состояние.
+
+**Указание адреса сервера**
+
+При подключении библиотеки для сетевых запросов обязательно host сервера используйте из файла `Constants.kt`. При тестировании данный файл будет изменён таким образом, чтобы у приложения была возможность подключиться и работать корректно с тестирующим сервером.
+

allowed_changes.yml

@@ -0,0 +1,14 @@
+version: 1
+allowed_files:
+  - "app/src/main/java/ru/myitschool/work/*"
+  - "app/src/main/res/*"
+forbidden_files:
+  - "app/src/main/java/ru/myitschool/work/domain/entities/BookingEntity.kt"
+  - "app/src/main/java/ru/myitschool/work/domain/entities/UserEntity.kt"
+  - "app/src/main/java/ru/myitschool/work/ui/theme/Color.kt"
+  - "app/src/main/java/ru/myitschool/work/ui/theme/Theme.kt"
+  - "app/src/main/java/ru/myitschool/work/ui/theme/Type.kt"
+  - "app/src/main/java/ru/myitschool/work/ui/root/RootActivity.kt"
+  - "app/src/main/java/ru/myitschool/work/ui/root/RootIntent.kt"
+  - "app/src/main/java/ru/myitschool/work/ui/root/RootState.kt"
+  - "app/src/main/java/ru/myitschool/work/ui/root/RootViewModel.kt"