แนะนำแอปพลิเคชัน Placemark
- Placemark เป็นเว็บแอปพลิเคชันที่สามารถนำเข้าข้อมูลภูมิสารสนเทศ สร้าง ส่งออก แสดงผล และเผยแพร่ข้อมูลได้
- รองรับทั้งรูปแบบข้อมูลภูมิสารสนเทศที่หลากหลาย งานแก้ไขที่อิงอัลกอริทึม (เช่น buffering) และงานแบบวาด
- มีวิดีโอ YouTube จำนวนมากที่สาธิตการใช้เครื่องมือนี้ และในเว็บไซต์ที่ถูกเก็บถาวรยังมีสื่อการตลาดก่อนหน้านี้อยู่
ข้อควรทราบสำหรับการเปิดซอร์สครั้งแรก
- นี่คือการปล่อยโค้ดเบสแบบโอเพนซอร์สครั้งแรก จึงพอช่วยเรื่องการตั้งค่าได้ แต่ไม่สามารถให้การสนับสนุนแบบบูรณาการครบวงจรตั้งแต่ต้นจนจบได้
- เป็นเว็บแอปพลิเคชันที่ซับซ้อน และแม้จะทำงานได้ในสภาพแวดล้อมที่ใช้พัฒนา แต่ไม่ได้หมายความว่าจะทำงานได้ในทุกสภาพแวดล้อม (เช่น บน Windows แทบจะแน่นอนว่าใช้งานไม่ได้)
- ยินดีรับ PR สำหรับการทำให้ตั้งค่าได้ง่ายขึ้นในสภาพแวดล้อมอื่น การทำให้บางฟีเจอร์เป็นตัวเลือกได้ ตลอดจนการปรับปรุงหรือแก้ไขอื่น ๆ
เทคโนโลยีสแตก
- หมายเหตุเกี่ยวกับเทคโนโลยีสแตกของแอปพลิเคชันดูได้ที่
docs/architecture.md
การรันด้วย Docker
- มีตัวอย่างไฟล์ Docker และสามารถดูรายละเอียดได้ที่
docs/docker
การรันบน Render
- กำหนดค่าผ่านไฟล์
render.yaml และการโฮสต์บน Render อาจเป็นวิธีที่รันได้เร็วที่สุด
- อาจทำงานได้บนการตั้งค่าโฮสต์ที่คล้ายกัน เช่น Railway, Heroku และ Flightcontrol
การติดตั้ง
- โปรเจ็กต์นี้สร้างด้วย yarn และเวอร์ชัน yarn ที่ทดสอบล่าสุดคือ
1.22.19
- หากติดตั้งด้วย npm หรือแพ็กเกจแมเนเจอร์อื่น อาจได้ชุด dependency ที่แตกต่างออกไป
ตัวแปรสภาพแวดล้อม
- ระหว่างพัฒนาจะอ่านไฟล์
.env และในสภาพแวดล้อม production จำเป็นต้องใช้ตัวแปรสภาพแวดล้อม
- ระบบจะตรวจสอบตัวแปรสภาพแวดล้อมตอนเริ่มต้น ดังนั้นหากมีตัวแปรที่ขาดหาย แอปพลิเคชันอาจล่มได้
- ดูรายการตัวแปรสภาพแวดล้อมที่จำเป็นได้ที่
app/lib/env_server.ts และ app/lib/env_client.ts
ตัวแปรสภาพแวดล้อมที่จำเป็นและแบบเลือกใช้
- จำเป็น: GitHub, Replicache
- เลือกใช้: Posthog, Cloudflare, Postmark, WorkOS, Stripe, CampaignMonitor, Logtail
- ในการติดตั้งแบบ self-hosted อาจไม่จำเป็นต้องใช้บางบริการ เช่น Stripe และสามารถทำให้เป็นตัวเลือกได้
โครงสร้างพื้นฐาน
- Placemark พึ่งพาเซิร์ฟเวอร์ 2 ส่วน ได้แก่ แอปพลิเคชัน (รีโพซิทอรีนี้) และฐานข้อมูล Postgres 14 (หรือสูงกว่า)
โดเมน
- บนเว็บ Placemark ให้บริการภายใต้ 3 โดเมน:
app.placemark.io, api.placemark.io, API
- API ให้บริการจากเว็บเซิร์ฟเวอร์เดียวกับแอป และใช้ Cloudflare Worker เพื่อพร็อกซีคำขอจาก
api.placemark.io ไปยัง app.placemark.io
การทดสอบ SSL บนเครื่องโลคัล
- จำเป็นเมื่อคุณต้องทดสอบฟีเจอร์ที่ทำงานได้เฉพาะภายใต้ SSL (เช่น การทดสอบตำแหน่งทางภูมิศาสตร์บน iPhone)
- ใช้
tailscale cert ของ Tailscale แล้วนำใบรับรองมาไว้ในไดเรกทอรีนี้ จากนั้นรัน caddy start
การใช้ Stripe
- Stripe กำลังกลายเป็น dependency แบบเลือกใช้ของโปรเจ็กต์นี้
- เว็บฮุคพร็อกซีอยู่ที่
./_scripts/webhook-proxy.js และสามารถรันแบบเลือกใช้ได้
ความเห็นของ GN⁺
- Placemark เป็นเว็บแอปพลิเคชันที่ทรงพลังซึ่งมีฟังก์ชันหลากหลายสำหรับการจัดการข้อมูลภูมิสารสนเทศ จึงมีประโยชน์ต่อผู้เชี่ยวชาญด้าน GIS และนักพัฒนา
- การเปิดเป็นโอเพนซอร์สทำให้ชุมชนสามารถมีส่วนร่วมได้ และยังเปิดทางให้มีการปรับปรุงเพื่อใช้งานในสภาพแวดล้อมที่หลากหลาย
- สามารถดีพลอยและรันได้ง่ายด้วยเครื่องมือคอนเทนเนอร์อย่าง Docker และมีข้อดีที่ดีพลอยได้รวดเร็วผ่านบริการคลาวด์โฮสติ้ง
1 ความคิดเห็น
ความคิดเห็นจาก Hacker News