gfw

Что такое глобальные лесные часы?

Global Forest Watch (GFW) - это динамичная система онлайн -мониторинга леса и предупреждения, которая дает людям возможность повсюду лучше управлять лесами. Этот репозиторий содержит веб -приложение GFW.

Начиная

Веб -приложение GFW построено с NextJS, React и Redux.

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

Клонировать репо:

$ git clone https://github.com/wri/gfw.git

Установка зависимостей:

$ yarn

Скопируйте .env.sample to .env.local и запустите сервер:

$ yarn dev

Приложение теперь должно быть доступно на http://0.0.0.0:3000.

Развитие

Мы следуем рабочему делу Gitflow для разработки и развертывания.
Мы объединяем запросы на develop , которые автоматически развертываются как на серверах для постановки, так и на предварительном производстве. Чтобы выпустить функции в производство, мы develop в master , вызывая автоматическое развертывание производства.

Постановка, предварительные и просмотр приложений

Мы используем Heroku для развертывания наших приложений. Производство развертывается автоматически от master в GlobalForestWatch.org.

У нас есть две промежуточные среды: постановка и предварительная продукция. Оба развернуты автоматически из develop .
Основное отличие состоит в том, что постановка указывает на постановку среды API, к которым мы получаем доступ, предварительно продюнируйте производственные. Это установлено с помощью переменной env NEXT_PUBLIC_FEATURE_ENV .

Мы также используем функцию Heroku's Review Apps.
При создании запроса на вытягивание, приложение для просмотра автоматически развертывается Heroku автоматически с помощью preproduction NEXT_PUBLIC_FEATURE_ENV , а ссылка на среду добавляется автоматически к соответствующему запросу на привлечение.

Выпуски

Мы используем релизы GitHub для записи изменений в приложении. Чтобы помочь нам управлять этим, мы используем ZEIT Relases, пакет NPM для обработки выпусков GitHub, тегинга (Major, Minor, Patch) и автоматизации журналов семантического выпуска. Более подробное объяснение семантических изменений, см. Этот пост.

Управление коммитами для выпуска

При разработке вы можете пометить свои коммиты следующим образом: fix some excellent bug (patch) где может быть patch (major/minor/patch/ignore) . Это название коммита будет автоматически сгруппировано в правильный раздел для выпуска. В противном случае вам будет предложено во время выпуска, чтобы назначить (или игнорировать) каждый из ваших коммитов. Вам придется сделать это для каждого коммита, так что не забудьте раздавить!

Так как же выпустить релиз на GFW?

1. Посмотреть магистр и слияние в разработке (не обязательно, но рекомендуется для последовательности).
2. Запустите npx release [type] , где тип может быть major , minor , patch или pre (см. Документы ZEIT для получения более подробной информации).
3. Следуйте побуждениям к управлению коммитами.
4. Вы будете доставлены в редактор Draft Release Github со всеми вашими коммитами, сгруппированными и готовыми к работе.
5. Введите свой заголовок и включите любую дополнительную информацию, которую вы хотите.
6. Публиковать!

RW API документация для GFW

Слои карт и соответствующие наборы данных хранятся в RW-API, а globalforestwatch.org/map использует Manager Layer-Manager для их визуализации.

Схема, используемая для создания этих слоев, их легенд и определения их взаимодействия, специфична для глобальной платформы лесных часов .

При создании или изменении слоев/наборов данных для GFW следуйте схеме и синтаксису, изложенным в файле отметки документации API.

Для просмотра GFW-специфичных слоев и наборов данных используйте следующую конечную точку:

https://api.resourcewatch.org/v1/dataset?app=gfw&includes=layer, Vocabulary, MetaData&page=200

Браузрстук

Мы используем Browesstack, чтобы найти и исправить проблемы кросс-браузера.