Placemark uygulamasına giriş
- Placemark, coğrafi mekânsal verileri içe aktarma, oluşturma, dışa aktarma, görselleştirme ve yayımlama yapabilen bir web uygulamasıdır.
- Çeşitli coğrafi mekânsal veri biçimlerini, algoritma tabanlı düzenleme işlemlerini (ör. buffering) ve çizim tabanlı işlemleri destekler.
- Bu aracı kullanan çok sayıda YouTube videosu vardır ve arşivlenmiş web sitesinde önceki pazarlama materyalleri bulunur.
İlk açık kaynak sürümü için notlar
- Bu, bu kod tabanının ilk açık kaynak sürümüdür; kurulum konusunda yardımcı olunabilir ancak uçtan uca entegrasyon desteği sağlanamaz.
- Karmaşık bir web uygulamasıdır ve geliştirildiği ortamda çalışır, ancak her ortamda çalışması garanti değildir (ör. Windows'ta neredeyse kesin olarak çalışmaz).
- Diğer ortamlarda kurulumu kolaylaştıran, özellikleri isteğe bağlı hale getiren ya da başka iyileştirme ve düzeltmeler içeren PR'ler memnuniyetle karşılanır.
Teknoloji yığını
- Uygulamanın teknoloji yığınına dair notlar
docs/architecture.md içinde bulunabilir.
Docker ile çalıştırma
- Örnek Docker dosyaları vardır; ayrıntılar
docs/docker içinde görülebilir.
Render üzerinde çalıştırma
render.yaml dosyasıyla yapılandırılır ve Render üzerinde barındırmak en hızlı çalıştırma yöntemi olabilir.
- Railway, Heroku ve Flightcontrol gibi benzer barındırma kurulumlarında da çalışabilir.
Kurulum
- Proje yarn kullanılarak inşa edilmiştir ve en son test edilen yarn sürümü
1.22.19'dur.
- npm veya başka bir paket yöneticisiyle kurulum yapıldığında farklı bağımlılıklar ortaya çıkabilir.
Ortam değişkenleri
- Geliştirme sırasında
.env dosyası okunur, üretim ortamında ise ortam değişkenleri gerekir.
- Başlatma sırasında ortam değişkenleri kontrol edildiğinden, eksik değişkenler varsa uygulama çökebilir.
- Gerekli ortam değişkenlerinin listesi
app/lib/env_server.ts ve app/lib/env_client.ts içinde bulunabilir.
Zorunlu ve isteğe bağlı ortam değişkenleri
- Zorunlu: GitHub, Replicache
- İsteğe bağlı: Posthog, Cloudflare, Postmark, WorkOS, Stripe, CampaignMonitor, Logtail
- Kendi kendine barındırılan kurulumlarda Stripe gibi bazı hizmetler gerekmeyebilir ve bunları isteğe bağlı hale getirmek mümkündür.
Altyapı
- Placemark, uygulama (bu depo) ve Postgres 14 (veya üstü) veritabanı olmak üzere iki sunucuya bağımlıdır.
Alan adları
- Web üzerinde Placemark üç alan adı altında sunulur:
app.placemark.io, api.placemark.io, API
- API, uygulamayla aynı web sunucusunda sunulur ve Cloudflare Worker kullanılarak
api.placemark.io üzerindeki istekler app.placemark.io'ya proxy'lenir.
Yerel SSL testi
- Yalnızca SSL altında çalışan özellikleri test etmeniz gerektiğinde gereklidir (ör. iPhone'da coğrafi konum testi).
- Tailscale'in
tailscale cert komutunu kullanın, sertifikayı bu dizine taşıyın ve ardından caddy start çalıştırın.
Stripe kullanımı
- Stripe bu projenin isteğe bağlı bir bağımlılığı hâline gelmektedir.
- Webhook proxy'si
./_scripts/webhook-proxy.js içindedir ve isteğe bağlı olarak çalıştırılabilir.
GN⁺ görüşü
- Placemark, coğrafi mekânsal verilerle çalışmak için gereken çeşitli işlevleri sunan güçlü bir web uygulamasıdır; GIS uzmanları veya geliştiriciler için faydalıdır.
- Açık kaynak olarak sunulduğu için topluluk katkıları alabilir ve farklı ortamlarda kullanım için iyileştirilebilir.
- Docker gibi konteyner araçlarıyla kolayca dağıtılıp çalıştırılabilir; ayrıca bulut barındırma hizmetleri üzerinden hızlıca dağıtılabilmesi önemli bir avantajdır.
1 yorum
Hacker News görüşleri