Placemark application का परिचय
- Placemark एक web application है जो geospatial data को import, create, export, visualize और publish कर सकती है.
- यह विभिन्न geospatial data formats, algorithm-आधारित editing tasks (उदाहरण: buffering) और drawing-आधारित tasks को support करती है.
- इस tool का उपयोग करने वाले कई YouTube वीडियो हैं, और archived website पर पहले की marketing materials उपलब्ध हैं.
शुरुआती open source release के लिए ध्यान देने योग्य बातें
- यह codebase का शुरुआती open source release है, इसलिए setup में मदद संभव है, लेकिन end-to-end integration support प्रदान नहीं किया जा सकता.
- यह एक complex web application है और जिस environment में इसे बनाया गया था उसमें काम करती है, लेकिन हर environment में काम करेगी यह जरूरी नहीं है (उदाहरण: Windows पर लगभग निश्चित रूप से काम नहीं करेगी).
- दूसरे environments में setup को आसान बनाने, features को optional बनाने, या अन्य improvements और fixes के लिए PR का स्वागत है.
तकनीकी स्टैक
- application के technical stack पर notes
docs/architecture.md में देखे जा सकते हैं.
Docker का उपयोग करके चलाना
- Docker file examples उपलब्ध हैं, और details
docs/docker में देखी जा सकती हैं.
Render पर चलाना
- यह
render.yaml file द्वारा configure किया जाता है, और Render पर host करना इसे चलाने का सबसे तेज़ तरीका हो सकता है.
- Railway, Heroku, Flightcontrol जैसी समान hosting setups पर भी यह काम कर सकता है.
इंस्टॉलेशन
- project को yarn का उपयोग करके बनाया गया है, और आखिरी बार test की गई yarn version
1.22.19 है.
- npm या किसी अन्य package manager से install करने पर अलग dependencies आ सकती हैं.
environment variables
- development के दौरान
.env file पढ़ी जाती है, और production environment में environment variables की आवश्यकता होती है.
- startup पर environment variables की जाँच की जाती है, इसलिए कोई variable missing होने पर application crash हो सकती है.
- आवश्यक environment variables की सूची
app/lib/env_server.ts और app/lib/env_client.ts में देखी जा सकती है.
आवश्यक और वैकल्पिक environment variables
- आवश्यक: GitHub, Replicache
- वैकल्पिक: Posthog, Cloudflare, Postmark, WorkOS, Stripe, CampaignMonitor, Logtail
- self-hosted installation में Stripe जैसी कुछ services की आवश्यकता नहीं हो सकती, और इन्हें optional बनाना संभव है.
infrastructure
- Placemark दो servers पर निर्भर करता है: application (यह repository) और Postgres 14 (या उससे ऊपर) database.
domain
- वेब पर Placemark तीन domains के अंतर्गत serve किया जाता है:
app.placemark.io, api.placemark.io, API
- API, app के समान web server पर serve की जाती है, और Cloudflare Worker का उपयोग करके
api.placemark.io से app.placemark.io तक requests को proxy किया जाता है.
local SSL testing
- यह उन features को test करने के लिए आवश्यक है जो केवल SSL के तहत काम करते हैं (उदाहरण: iPhone पर geolocation testing).
- Tailscale के
tailscale cert का उपयोग करें, certificate को इस directory में ले जाएँ, फिर caddy start चलाएँ.
Stripe का उपयोग
- Stripe इस project की एक optional dependency बन रही है.
- webhook proxy
./_scripts/webhook-proxy.js में है, और इसे वैकल्पिक रूप से चलाया जा सकता है.
GN⁺ की राय
- Placemark geospatial data को संभालने के लिए आवश्यक कई features देने वाली एक शक्तिशाली web application है, जो GIS professionals और developers के लिए उपयोगी है.
- open source के रूप में उपलब्ध होने से इसे community contributions मिल सकते हैं, और विभिन्न environments में उपयोग के लिए सुधार संभव हैं.
- Docker जैसे containerization tools का उपयोग करके इसे आसानी से deploy और run किया जा सकता है, और cloud hosting services के माध्यम से जल्दी deploy करने का लाभ भी है.
1 टिप्पणियां
Hacker News टिप्पणियाँ