Pengenalan aplikasi Placemark
- Placemark adalah aplikasi web untuk mengimpor, membuat, mengekspor, memvisualisasikan, dan memublikasikan data geospasial.
- Mendukung berbagai format data geospasial, pekerjaan pengeditan berbasis algoritme (misalnya buffering), serta pekerjaan berbasis gambar.
- Ada banyak video YouTube yang menggunakan alat ini, dan situs web arsip berisi materi pemasaran sebelumnya.
Catatan untuk rilis open source awal
- Ini adalah rilis open source awal dari codebase ini; bantuan untuk penyiapan mungkin bisa diberikan, tetapi dukungan integrasi end-to-end tidak dapat disediakan.
- Ini adalah aplikasi web yang kompleks dan berfungsi di lingkungan tempatnya dibuat, tetapi tidak selalu berfungsi di semua lingkungan (misalnya, hampir pasti tidak berjalan di Windows).
- PR untuk mempermudah penyiapan di lingkungan lain, membuat fitur menjadi opsional, atau perbaikan dan pembaruan lainnya sangat disambut.
Tech stack
- Catatan tentang tech stack aplikasi dapat dilihat di
docs/architecture.md.
Menjalankan dengan Docker
- Ada contoh file Docker, dan detailnya dapat dilihat di
docs/docker.
Menjalankan di Render
- Dikontrol oleh file
render.yaml, dan hosting di Render mungkin menjadi cara tercepat untuk menjalankannya.
- Mungkin juga dapat berjalan di pengaturan hosting serupa seperti Railway, Heroku, dan Flightcontrol.
Instalasi
- Proyek ini dibangun menggunakan yarn, dan versi yarn terakhir yang diuji adalah
1.22.19.
- Jika diinstal dengan npm atau package manager lain, dependensi yang berbeda bisa muncul.
Variabel lingkungan
- Saat pengembangan, file
.env dibaca, dan di lingkungan produksi diperlukan variabel lingkungan.
- Variabel lingkungan diperiksa saat startup, sehingga jika ada yang hilang aplikasi dapat crash.
- Daftar variabel lingkungan yang diperlukan dapat dilihat di
app/lib/env_server.ts dan app/lib/env_client.ts.
Variabel lingkungan wajib dan opsional
- Wajib: GitHub, Replicache
- Opsional: Posthog, Cloudflare, Postmark, WorkOS, Stripe, CampaignMonitor, Logtail
- Pada instalasi self-hosted, beberapa layanan seperti Stripe mungkin tidak diperlukan, dan hal itu bisa dijadikan opsional.
Infrastruktur
- Placemark bergantung pada dua server: aplikasi (repositori ini) dan database Postgres 14 (atau lebih tinggi).
Domain
- Di web, Placemark disajikan di bawah tiga domain:
app.placemark.io, api.placemark.io, API
- API disajikan dari web server yang sama dengan aplikasi, dan menggunakan Cloudflare Worker untuk mem-proxy permintaan dari
api.placemark.io ke app.placemark.io.
Pengujian SSL lokal
- Diperlukan saat perlu menguji fitur yang hanya berfungsi di bawah SSL (misalnya pengujian geolokasi di iPhone).
- Gunakan
tailscale cert dari Tailscale, pindahkan sertifikat ke direktori ini, lalu jalankan caddy start.
Penggunaan Stripe
- Stripe sedang menjadi dependensi opsional untuk proyek ini.
- Proxy webhook berada di
./_scripts/webhook-proxy.js dan dapat dijalankan secara opsional.
Pendapat GN⁺
- Placemark adalah aplikasi web yang kuat dan menyediakan berbagai fitur yang diperlukan untuk menangani data geospasial, sehingga berguna bagi profesional GIS maupun developer.
- Karena tersedia sebagai open source, proyek ini dapat menerima kontribusi komunitas dan ditingkatkan agar dapat digunakan di berbagai lingkungan.
- Dengan alat kontainerisasi seperti Docker, aplikasi ini dapat dengan mudah dideploy dan dijalankan, serta memiliki keunggulan dapat dideploy dengan cepat melalui layanan cloud hosting.
1 komentar
Komentar Hacker News