DarkRoute

वे देख रहे हैं। हम वापस देख रहे हैं।

विषय-सूची

• यह क्या है
• रिपॉज़िटरी लेआउट
• आर्किटेक्चर
• सार्वजनिक API
• रनटाइम वर्कफ़्लो
• पूर्वापेक्षाएँ
• इंस्टॉलेशन
• एनवायरनमेंट वेरिएबल्स
• डेवलपमेंट कमांड्स
• टेस्ट कमांड्स
• सुरक्षा और गोपनीयता मॉडल
• डिज़ाइन स्रोत और टोकन नियम
• प्लेटफ़ॉर्म सीमाएँ
• योगदान
• सुरक्षा नीति
• लाइसेंस

यह क्या है

एक Android-प्रथम काउंटर-निगरानी PWA जो ड्राइवर को बताती है कि स्वचालित लाइसेंस प्लेट रीडर कहाँ हैं, इससे पहले कि वे उनके पास से गुज़रें।

यह ऑफ़लाइन-सक्षम कैमरा आर्काइव के विरुद्ध रीयल-टाइम निकटता अलर्ट, स्थानीय एक्सपोज़र इतिहास, हस्ताक्षरित और हैश-चेन्ड कैमरा रिपोर्ट्स की ऑन-डिवाइस कतार, और आपके आस-पास कैमरे संचालित करने वाली एजेंसियों के बारे में स्रोत-समर्थित सार्वजनिक-रिकॉर्ड संदर्भ प्रदान करती है।

तैनात ऐप में कोई रिपोर्ट-अपलोड एंडपॉइंट नहीं है। रिपोर्ट्स आज IndexedDB में रहती हैं। एक सबमिशन गेटवे ऑपरेटर कोड के रूप में मौजूद है और यह तैनात रूट नहीं है; यह अंतर इस पूरे README में जानबूझकर बनाए रखा गया है।

यह जानबूझकर छठी चीज़ नहीं करता: यह किसी विक्रेता के सिस्टम को क्वेरी नहीं करता, और लाइसेंस प्लेट मान कभी डिवाइस नहीं छोड़ते।

रिपॉज़िटरी लेआउट

darkroute/
├── apps/
│   ├── pwa/                    React 19 + TypeScript + Vite PWA
│   ├── desktop/                developer console at api.darkroute.ai; its functions/ proxy /v1 and /api/v1 to the apex
│   └── android/                buildable Android Trusted Web Activity shell
├── packages/
│   ├── core/                   pure geometry and alert engine; no DOM or I/O
│   └── api-client/             empty placeholder; the live contract is GET /api/v1/openapi.json
├── functions/
│   ├── cameras/                same-origin camera tiles from the CAMERA_TILES R2 binding
│   └── api/
│       ├── v1/                 the public API: reads, /submit (opens a PR), /photo, openapi.json, _middleware
│       └── admin/              Cloudflare Access tester allowlist (private dev host only)
├── scripts/                    camera pipeline, deploy, asset and policy checks
├── docs/                       implementation, operations and public documentation
├── the design-gap ledger              unresolved design decisions and stand-ins
└── installer.sh

LoRa स्टैक Meshtastic का ही है, अपरिवर्तित: यह प्रोजेक्ट कोई फ़र्मवेयर बनाता नहीं है और एक स्टॉक नोड के साथ पेयर होता है। packages/api-client एक प्लेसहोल्डर बना हुआ है; प्रोडक्शन PWA इसका उपयोग नहीं करता।

आर्किटेक्चर

तैनात उत्पाद एक स्टैटिक PWA और Cloudflare Pages Functions है: कैमरा टाइल रूट, /api/v1/ के अंतर्गत पब्लिक API (देखें Public API), और प्राइवेट dev होस्ट पर दो Access-गेटेड प्रशासनिक रूट। इसमें कोई FastAPI प्रोसेस, Postgres डेटाबेस, presence API या तैनात रिपोर्ट एंडपॉइंट नहीं है; एकमात्र राइट पाथ, POST /api/v1/submit, किसी चीज़ में लिखने के बजाय एक पब्लिक पुल रिक्वेस्ट खोलता है।

flowchart LR
    OSM["OpenStreetMap"] --> PIPE["scheduled Node camera pipeline"]
    PIPE --> R2[("R2 camera archive")]
    R2 --> CAM["/cameras/* Pages Function"]

    subgraph device["Browser or Android TWA"]
        GPS["geolocation + other adapters"] --> CORE["packages/core alert engine"]
        CORE --> UI["DRIVE / map / reports"]
        UI <--> IDB[("IndexedDB + service-worker cache")]
    end

    CAM --> IDB
    MAP["project tile host (PMTiles)"] --> UI

कैमरा टाइल्स same-origin /cameras/* से अनुरोधित होते हैं, जो CAMERA_TILES R2 binding से सर्व किए जाते हैं, और ऑफ़लाइन उपयोग के लिए कैश किए जाते हैं। Basemap और speed archives प्रोजेक्ट-संचालित सार्वजनिक tile host के लिए cross-origin range requests हैं। darkroute.ai सार्वजनिक ऐप है। प्रशासनिक Functions इस वितरण के पूरी तरह बाहर रहते हैं।

क्यूरेशन टूलिंग और सबमिशन गेटवे ऑपरेटर कोड हैं, जिन्हें इस वितरण से बाहर रखा गया है। दोनों में से कोई भी तैनात रनटाइम सर्वर नहीं है, और इस रिपॉज़िटरी में कुछ भी किसी पर निर्भर नहीं करता: ऐप उनके बिना बिल्ड, रन, टेस्ट और ऑडिट होता है।

Geospatial गणना packages/core में रहती है; स्क्रीन stores और adapters का उपभोग करती हैं। Plate matching, trip history और report evidence chain डिवाइस पर ही रहते हैं।

सार्वजनिक API

संग्रह किसी के भी द्वारा, बिना कुंजी के, https://darkroute.ai/api/v1/ पर पढ़ा जा सकता है, जो https://api.darkroute.ai/v1/ और https://api.darkroute.ai/api/v1/ के रूप में भी डेवलपर कंसोल के प्रॉक्सी के माध्यम से सर्व किया जाता है। मशीन-पठनीय अनुबंध GET /api/v1/openapi.json है; गद्य docs/public/API.md §1.3 है; इसे आज़माने का कंसोल api.darkroute.ai है।

Route	यह क्या उत्तर देता है
GET /api/v1/cameras	एक bbox में कैमरे (प्रति भुजा ≤ 1.5°, ≤ 24 टाइल्स, ≤ 1000 पंक्तियाँ), वैकल्पिक owner फ़िल्टर
GET /api/v1/stats	संग्रह आकार, generation, build और upstream टाइमस्टैम्प
GET /api/v1/abuse	प्रलेखित मामले और generation तिथि; वैकल्पिक काउंटी fips
GET /api/v1/news	स्वचालित रूप से एकत्रित ALPR हेडलाइन्स, स्रोत लिंक और संग्रह स्थिति
GET /api/v1/atlas	काउंटी के अनुसार EFF Atlas एजेंसियाँ और विक्रेता, retrieval/check तिथियों के साथ; वैकल्पिक fips
GET /api/v1/monitoring	सड़क-निगरानी उपकरण सूचियाँ; वैकल्पिक kind और bbox
GET /api/v1/monitoring/image?id=...	चयनित ट्रैफ़िक कैमरे के लिए उपलब्ध प्रकाशक फ़ोटो
GET /api/v1/place	एक US/PR स्थान लुकअप, प्रॉक्सी किया गया ताकि geocoder कभी ड्राइवर का पता न देखे
GET /api/v1/route	एक ड्राइविंग मार्ग जो 60 बिंदुओं तक से बचता है; कभी कैश नहीं किया जाता
GET /api/v1/doc/{name}	सार्वजनिक मिरर से एक प्रकाशित दस्तावेज़, Markdown के रूप में
POST /api/v1/submit	एक सुधार, जिसे [unreviewed] pull request में बदला जाता है, संग्रह में कुछ भी नहीं लिखा जाता
PUT /api/v1/photo	एक फ़ोटोग्राफ़ जिसका संदर्भ कोई सबमिशन देता है, उसके bytes द्वारा keyed; GET /api/v1/photo/{key} इसे वापस सर्व करता है