gfw

Global Forest Watch คืออะไร?

Global Forest Watch (GFW) เป็นระบบตรวจสอบและแจ้งเตือนป่าออนไลน์แบบไดนามิกที่ให้อำนาจผู้คนทุกที่ในการจัดการป่าที่ดีขึ้น พื้นที่เก็บข้อมูลนี้มีแอป GFW Web

เริ่มต้น

แอปพลิเคชันเว็บ GFW สร้างขึ้นด้วย NextJs, React และ Redux

การติดตั้งแอพ

โคลน repo:

$ 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
ความแตกต่างที่สำคัญคือการจัดเตรียมจุดไปยังสภาพแวดล้อมการจัดเตรียมของ API ที่เราเข้าถึงซึ่งเป็นจุดผลิตก่อนการผลิต สิ่งนี้ถูกตั้งค่าโดยตัวแปร NEXT_PUBLIC_FEATURE_ENV env

นอกจากนี้เรายังใช้ประโยชน์จากคุณสมบัติแอพตรวจสอบของ Heroku
เมื่อมีการสร้างคำขอดึงแอพตรวจสอบจะถูกปรับใช้โดยอัตโนมัติโดย Heroku ด้วย NEXT_PUBLIC_FEATURE_ENV ของ preproduction และลิงก์ไปยังสภาพแวดล้อมจะถูกเพิ่มโดยอัตโนมัติไปยังคำขอดึงที่เกี่ยวข้อง

ปล่อย

เรากำลังใช้ GitHub เผยแพร่เพื่อบันทึกการเปลี่ยนแปลงในแอพ เพื่อช่วยให้เราจัดการสิ่งนี้เรากำลังใช้ Zeit Releases แพ็คเกจ NPM สำหรับการจัดการ GitHub รุ่นการติดแท็ก (Major, Minor, Patch) และบันทึกการปล่อยความหมายอัตโนมัติ สำหรับคำอธิบายโดยละเอียดเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงทางความหมายดูโพสต์นี้

การจัดการความมุ่งมั่นสำหรับการเปิดตัว

เมื่อพัฒนาคุณสามารถติดแท็กการกระทำของคุณได้ดังนี้: fix some excellent bug (patch) ที่สามารถ patch ได้ (major/minor/patch/ignore) ชื่อเรื่องนี้จะถูกจัดกลุ่มโดยอัตโนมัติในส่วนที่ถูกต้องสำหรับการเปิดตัว มิฉะนั้นคุณจะได้รับแจ้งในระหว่างการปล่อยเพื่อกำหนด (หรือละเว้น) แต่ละการกระทำของคุณ คุณจะต้องทำสิ่งนี้สำหรับทุกที่กระทำดังนั้นอย่าลืมสควอช!

แล้วคุณจะเปิดตัว GFW ได้อย่างไร?

1. Checkout Master และ Merge ในการพัฒนา (ไม่ใช่ภาคบังคับ แต่แนะนำเพื่อความสอดคล้อง)
2. เรียกใช้ npx release [type] โดยที่ประเภทสามารถเป็น major , minor , patch หรือ pre (ดูเอกสาร Zeit สำหรับรายละเอียดเพิ่มเติม)
3. ทำตามพรอมต์เพื่อจัดการการกระทำ
4. คุณจะถูกนำไปที่ GitHub Draft Release Editor โดยมีการจัดกลุ่มทั้งหมดและพร้อมที่จะไป
5. ป้อนชื่อของคุณและรวมข้อมูลเพิ่มเติมใด ๆ ที่คุณต้องการ
6. เผยแพร่!

เอกสาร RW API สำหรับ GFW

เลเยอร์แผนที่และชุดข้อมูลที่เกี่ยวข้องจะถูกเก็บไว้ใน RW-API และ globalforestwatch.org/map ใช้เครื่องมือจัดการเลเยอร์เพื่อแสดงผล

สคีมาที่ใช้ในการจัดสไตล์เลเยอร์เหล่านี้ตำนานของพวกเขาและกำหนดการโต้ตอบของพวกเขานั้นมีความเฉพาะเจาะจงกับแพลตฟอร์ม Watch Watch ทั่วโลก

เมื่อสร้างหรือแก้ไขเลเยอร์/ชุดข้อมูลสำหรับ GFW ให้ทำตามสคีมาและไวยากรณ์ที่ระบุไว้ในไฟล์ markdown เอกสาร API

ในการดูเลเยอร์และชุดข้อมูลเฉพาะ GFW ให้ใช้จุดสิ้นสุดต่อไปนี้:

https://api.resourcewatch.org/v1/dataset?app=gfw&includes=layer,vocabulary,metadata&page

อ่านหนังสือ

เราใช้ BrowserStack เพื่อค้นหาและแก้ไขปัญหาข้ามเบราว์เซอร์