Explore Moon

Осень 2021 — Лето 2022

Задача

Создать веб-приложение для отображения лунных данных.

Моя роль

Фронтенд разработка

Предыстория

После недавней дизайн-стажировки в Edenspiekermann я понял, что хочу развиваться как разработчик. Поскольку фронтенд был моим основным навыком, выбор был очевиден — фронтенд-разработка (при этом я всё равно хотел продолжать заниматься дизайном). Я присоединился к проекту как работающий студент. Команда состояла из четырёх человек: профессор, координатор (его ассистент) и два разработчика, один из которых — я.

Изначально задумка была такой: построить 3D-модель Луны, накладывать на неё релевантные данные и управлять ими через собственный интерфейс, поверх стандартного UI библиотек. Инструменты: CesiumJS — позволяет отобразить саму Луну и выводить данные поверх модели; React — для пользовательского интерфейса. Мы начали с проектирования первых UI-компонентов — им не обязательно было выглядеть идеально, главное, чтобы всё работало.

Упрощённая архитектура

Упрощённая архитектура приложения.

Возникающие проблемы

Поскольку мы хотели собирать всё с нуля, пришлось строго опираться на официальную документацию CesiumJS. На словах просто, но на практике документация довольно слабо структурирована, и человеку без опыта с Cesium сложно собрать всё воедино.

Хотя нам и удалось собрать 2D-слои на глобусе, внедрение 3D-рельефа (набора данных, задающего форме глобуса соответствие реальной модели) оказалось непростой задачей. По какой-то причине последняя версия генератора рельефа отказывалась принимать 3D-данные. После долгих недель проб и ошибок координатор всё же решил проблему — дело было в версии: переход на более старую версию инструмента всё исправил.

Функциональных планов было много, и если прогресс будет блокироваться такими «мелочами», как внедрение рельефа, проект займёт слишком много времени. Мы решили поискать решение, которое уже предлагает базовый набор функций, — и удачно нашли TerriaMap. TerriaMap — это инструмент, предоставляющий поверх CesiumJS готовые возможности.

Первый дизайн интерфейса

Первая итерация приложения.

Вторая итерация

Кастомизация проекта

Хотя TerriaMap и позволяет добавлять новые кастомные компоненты, не трогая ядро, такой подход довольно ограничен — он не гарантирует детальный доступ к стандартным компонентам. Поэтому, чтобы реализовать функциональность, взаимодействующую с предустановленным поведением, изменения приходилось вносить прямо в библиотеку.

Основной вид Увеличенный вид Затенённый вид

Вторая итерация проекта

Спектральный анализ (пример)

Допустим, мы уже выводим слои и конкретные данные на глобус. Необходимо уметь выполнять над данными специальные операции — стандартных функций становится недостаточно.

Задача: реализовать инструмент спектрального анализа. То есть у нас есть определённая область на карте (прямоугольник), и при клике по ней мы отправляем запрос к API с ID прямоугольника (imageID) и координатами (долгота и широта). Сервер рассчитывает ответ и возвращает обработанные данные в формате JSON. Эти данные затем отправляются на график. Кроме того, каждый следующий клик по той же области должен добавлять новую запись на графике, а при клике по другому прямоугольнику график должен сбрасываться.

До этого проекта у меня не было большого опыта с React — только небольшие проекты вроде to-do или календаря. Погружение в «нутро» библиотеки (node_modules) — процесс не самый красивый, местами перегружающий, но очень познавательный. Я разбил задачу на шаги, чтобы по ним реализовать код.

Упрощённая схема задачи

Задача, разбитая на шаги.

Управление состоянием

На тот момент, когда нужно было обновлять координаты, я использовал глобальные переменные и обращался к ним по мере необходимости. У такого подхода был серьёзный недостаток: при обновлении переменной компонент об этом «не узнавал», из-за чего нельзя было обновить один компонент из другого. Это базовое ограничение React, решаемое библиотеками управления состоянием — MobX или Redux.

После череды проб и ошибок я понял, что проще всего обновлять состояние приложения, а не вызывать методы из разных компонентов. В TerriaMap для управления состоянием используется MobX.

Однако возникла другая проблема: бесконечные обновления из-за глобального состояния. При изменении глобального состояния всё, что его наблюдает, тоже обновляется. Мой компонент обновлял состояние в момент вызова — в итоге получался «бесконечный цикл». Я добавил атомарные булевы флаги, чтобы вручную блокировать участок кода, обновляющий глобальное состояние тогда, когда это не нужно.

Последняя версия инструмента

Инструмент спектрального анализа

В итоге

За это время я хорошо прокачал React и намерен дальше расти как фронтенд-разработчик.

Давайте работать вместе
или просто передайте привет :)

hello@khurshidernazarov.uz

Смотреть кейс