अवधारणाएं

यह वैचारिक मानचित्र है। API संदर्भ से पहले इसे एक बार पढ़ लें — बाकी दस्तावेज़ जल्दी समझ में आ जाएगा।

​

मेश

ResQ एक विकेंद्रीकृत मेश के रूप में चलता है, हब-एंड-स्पोक क्लाउड के रूप में नहीं। ड्रोन, ज़मीनी इकाइयाँ और ऑपरेटर स्टेशन एक पीयर नेटवर्क बनाते हैं जो तब भी काम करता रहता है जब अपस्ट्रीम बुनियादी ढांचा डाउन या अनुपलब्ध हो।

• नोड्स लोकल-फर्स्ट ट्रांसपोर्ट (मेश रेडियो, LTE, Wi-Fi) के माध्यम से संवाद करते हैं और अवसर मिलने पर क्लाउड के साथ मिलाते हैं।
• Coordination API इस तरह डिज़ाइन किया गया है कि अपस्ट्रीम निर्भरताएँ डिग्रेड होने पर भी टेलीमेट्री स्वीकारता रहे और लाइव स्टेट परोसता रहे।
• कोई एकल विफलता बिंदु नहीं है। यदि कोई कोऑर्डिनेटर गिरता है, पीयर नोड्स टेलीमेट्री साझा और काम क्यू करते रहते हैं।

API में, आंशिक आउटेज के दौरान कुछ रूट 503 Service Unavailable के रूप में दिखेंगे — रिट्राई गाइडेंस के लिए त्रुटियाँ देखें।

​

साक्ष्य और श्रृंखला

मिशन में हर परिणामी क्रिया साक्ष्य उत्पन्न करती है:

1. ड्रोन सेंसर फ्रेम, वीडियो और संरचित टेलीमेट्री कैप्चर करते हैं।
2. साक्ष्य फ़ाइलें IPFS पर पिन की जाती हैं और उनके CID (कंटेंट-एड्रेस्ड पहचानकर्ता) से संदर्भित होती हैं।
3. CIDs Solana पर एंकर किए जाते हैं, जो छेड़छाड़-प्रूफ श्रृंखला बनाते हैं।
4. Infrastructure API दोनों आधे उजागर करता है: /evidence IPFS पेलोड के लिए, /blockchain/* ऑन-चेन एंकर के लिए।

इससे एक्शन के बाद की समीक्षा और चेन-ऑफ़-कस्टडी समीक्षा बिना किसी एकल पक्ष पर भरोसा किए संभव होती है — CID और चेन संदर्भ रखने वाला कोई भी बाइट्स सत्यापित कर सकता है।

​

मानव-इन-द-लूप मिशन

ResQ के स्वायत्त प्रवाह HITL-गेटेड हैं। प्लेटफ़ॉर्म यूरोपीय संघ AI अधिनियम की धारा 14 मानव निरीक्षण लागू करता है: सिस्टम के क्रियान्वयन से पहले एक अधिकृत ऑपरेटर को उच्च-जोखिम क्रिया अनुमोदित करनी होगी। मिशन अनुमोदन Coordination API के माध्यम से उजागर है:

• GET /admin/missions/pending — अनुमोदन की प्रतीक्षा में क्रियाएँ
• POST /admin/missions/approve — एक लंबित मिशन को हरी झंडी
• POST /admin/missions/reject — ब्लॉक करें और कारण रिकॉर्ड करें

अनुमोदन के लिए missions.approve ऑपरेटर स्कोप चाहिए। इसके बिना कॉल 403 लौटाते हैं — त्रुटियाँ देखें।

​

एयरस्पेस और परमिट

डिलीवरी और स्वायत्त उड़ान के लिए, ResQ Solana पर ऑन-चेन एयरस्पेस रजिस्ट्री उपयोग करता है। Infrastructure API के /solana एंडपॉइंट परमिट, डिलीवरी इवेंट और रजिस्ट्री क्वेरी रिकॉर्ड करते हैं। डिस्पैचर अनुमत एयरस्पेस से बाहर की उड़ान योजनाओं को अस्वीकार करता है; यह गेट मिशन अनुमोदन से पहले है, बाद में नहीं।

​

टेलीमेट्री और लाइव इवेंट

दो प्रवाह वास्तविक-समय डेटा ले जाते हैं:

• इंजेशन: ड्रोन फ़्लीट Coordination API के POST /fleet/telemetry पर टेलीमेट्री बैच भेजते हैं। बैच एज पर बफ़र होते हैं और रिट्राई किए जाते हैं — टेलीमेट्री कभी चुपचाप नहीं गिरती।
• सब्सक्रिप्शन: क्लाइंट /events पर Server-Sent Events और /metrics पर Prometheus स्क्रेप के माध्यम से लाइव स्टेट उपभोग करते हैं (Coordination API)।

​

ऑपरेटर पहचान और स्कोप

ऑपरेटर POST /login पर उपयोगकर्ता नाम और पासवर्ड के साथ प्रमाणित होते हैं और एक अल्पकालिक JWT प्राप्त करते हैं (प्रमाणीकरण देखें)। टोकन ऑपरेटर के स्कोप ले जाता है — सूक्ष्म अनुमतियाँ जैसे missions.approve, evidence.write, या airspace.admin। प्रमाणीकरण में सफल लेकिन आवश्यक स्कोप के बिना अनुरोध 403 लौटाता है। इसे ऑपरेटर को दिखाएँ और रिट्राई न करें; इसके लिए प्रशासक कार्रवाई चाहिए।

​

फ़ॉल्ट इंजेक्शन और सिमुलेशन

Coordination API फ़ॉल्ट इंजेक्शन के लिए Simulation एंडपॉइंट उजागर करता है, और SDK सिमुलेशन हार्नेस के साथ आते हैं। उद्देश्य प्रोडक्शन में उस पर निर्भर होने से पहले मेश के डिग्रेडेड-मोड व्यवहार का परीक्षण करना है। इसका उपयोग एकीकरण परीक्षण में करें, लाइव संचालन में नहीं।

​

क्या कहाँ है

​

अगला