gfw

ما هي الساعة العالمية فورست ووتش؟

Global Forest Watch (GFW) عبارة عن نظام ديناميكي لمراقبة الغابات عبر الإنترنت وتمكينه يمكّن الناس في كل مكان من إدارة الغابات بشكل أفضل. يحتوي هذا المستودع على تطبيق الويب GFW.

ابدء

تم تصميم تطبيق الويب GFW باستخدام NextJs و React و Redux.

تثبيت التطبيق

استنساخ الريبو:

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

تثبيت التبعيات:

$ yarn

.env.sample .env.local

$ yarn dev

يجب الآن الوصول إلى التطبيق على http://0.0.0.0:3000.

النمو

نحن نتبع Gitflow Worklow للتنمية والنشر.
نقوم بدمج طلبات السحب في develop ، والتي يتم نشرها تلقائيًا على كل من خوادم التدريج وما قبل الإنتاج. من أجل إطلاق الميزات في الإنتاج ، ندمج develop إلى master ، مما يؤدي إلى نشر تلقائي للإنتاج.

تطبيقات التدريج ، ما قبل الإنتاج والمراجعة

نستخدم Heroku لنشر تطبيقاتنا. يتم نشر الإنتاج تلقائيًا من master إلى GlobalForeStwatch.org.

لدينا بيئتان انطلاق: التدريج ومسبق الإنتاج. يتم نشر كلاهما تلقائيًا من develop .
الفرق الرئيسي هو أن التدريج يشير إلى بيئات التدريج في واجهات برمجة التطبيقات التي نصل إليها ، ويشير ما قبل الإنتاج إلى الإنتاج. يتم تعيين هذا بواسطة متغير env NEXT_PUBLIC_FEATURE_ENV .

نستفيد أيضًا من ميزة تطبيقات مراجعة Heroku.
عند إنشاء طلب سحب ، يتم نشر تطبيق مراجعة تلقائيًا بواسطة Heroku باستخدام NEXT_PUBLIC_FEATURE_ENV من preproduction ، ويتم إضافة رابط للبيئة تلقائيًا إلى طلب السحب المعني.

الإصدارات

نحن نستخدم إصدارات GitHub لتسجيل التغييرات في التطبيق. لمساعدتنا في إدارة هذا ، نحن نستخدم إصدارات Zeit ، حزمة NPM للتعامل مع إصدارات GitHub ، وترتيب العلامات (التخصص ، القاصر ، التصحيح) ، وأتمتة سجلات الإصدار الدلالي. للاطلاع على شرح أكثر تفصيلاً للمحلل الدلالي ، انظر هذا المنشور.

إدارة الالتزامات لإصدار

عند التطوير ، يمكنك وضع علامة على الالتزامات الخاصة بك على النحو التالي: fix some excellent bug (patch) حيث يمكن أن يكون patch (major/minor/patch/ignore) . سيتم تجميع عنوان الالتزام هذا تلقائيًا في القسم الصحيح للإصدار. وإلا فإنك ستتم مطالبتك أثناء الإصدار لتعيين (أو تجاهل) كل من الاهتمامات. سيتعين عليك القيام بذلك مقابل كل التزام ، لذا لا تنسى أن تسحق!

فكيف تصدر على GFW؟

1. ماجستير الخروج ودمج في التطوير (ليس إلزاميًا ولكنه نصح بالاتساق).
2. قم بتشغيل npx release [type] حيث يمكن أن يكون النوع major أو minor أو patch أو pre (انظر مستندات Zeit لمزيد من التفاصيل).
3. اتبع المطالبات لإدارة الالتزامات.
4. سيتم نقلك إلى محرر إصدار GitHub مسودة مع جميع ارتباطاتك المجمعة وجاهزة للذهاب.
5. أدخل عنوانك وقم بتضمين أي معلومات إضافية تريدها.
6. نشر!

وثائق API RW لـ GFW

يتم تخزين طبقات MAP ومجموعات البيانات ذات الصلة في RW-API ويستخدم globalforestwatch.org/map ماناجير الطبقة لتقديمها.

المخطط المستخدم في تصميم هذه الطبقات ، وأساطيرهم ، وتحديد تفاعلاتها خاصة بمنصة مراقبة الغابات العالمية .

عند إنشاء أو تعديل طبقات/مجموعات بيانات لـ GFW ، اتبع المخطط وبناء الجملة الموضحة في ملف تخفيض وثائق API.

لعرض الطبقات ومجموعات البيانات الخاصة بـ GFW ، استخدم نقطة النهاية التالية:

https://api.resourcewatch.org/v1/dataset؟app=gfw&includes=layer،vocabulary،metadata&pagesize justel=200

التصفح

نحن نستخدم BrowserStack للعثور على مشكلات المتصفح المتقاطعة وإصلاحها.