गूगल एप्स स्क्रिप्ट (Google Apps Script) आधारित V20 ऑटोमेशन सिस्टम के निर्माण के लिए नया प्रोडक्शन-ग्रेड आर्किटेक्चर गाइड जारी किया गया है। यह दिशानिर्देश Google Drive से Gemini AI, डुप्लिकेट डिटेक्शन, Google Slides थंबनेल, ब्लॉगर ड्राफ्ट पब्लिशिंग और फ़ाइल आर्काइविंग की पूरी स्वचालित प्रक्रिया को बिना FIFO निर्भरता के निष्पादित करने का निर्देश प्रदान करता है।
मुख्य आर्किटेक्चर नियम
- नो FIFO मॉडल: फ़ाइलों को किसी भी तिथि या नाम के आधार पर सॉर्ट किए बिना 01_INBOX से सीधे चुना जाएगा।
- एक फ़ाइल प्रति रन: प्रति वर्कर निष्पादन MAX_FILES_PER_RUN = 1 की सीमा तय की गई है।
- स्क्रिप्ट लॉकिंग: रेस कंडीशन रोकने के लिए LockService.getScriptLock() का प्रयोग अनिवार्य है।
- स्थायी AI चेकपॉइंट: एक बार AI परिणाम सहेजने के बाद जेमिनी एपीआई को दोबारा कॉल नहीं किया जाएगा।
- स्वतंत्र रिट्री प्रणाली: थंबनेल या ब्लॉगर में एरर आने पर केवल विफल चरण का रिट्री होगा, AI प्रोसेसिंग का नहीं।
नो FIFO और सुरक्षित फ़ाइल चयन (No FIFO Policy)
सिस्टम में पूर्व वर्शन की तरह FIFO (First-In, First-Out) कतार व्यवस्था को पूरी तरह समाप्त कर दिया गया है। नई प्रणाली में 01_INBOX फोल्डर से किसी भी योग्य फ़ाइल को तुरंत चुनकर प्रोसेस किया जाता है। यदि कोई फ़ाइल 429 रेट लिमिट या त्रुटि के कारण RETRY_WAIT स्थिति में जाती है, तो वह अन्य फ़ाइलों की प्रोसेसिंग को ब्लॉक नहीं करेगी।
फ़ाइल स्टेट्स एवं वर्कफ़्लो चक्र (State Machine & Workflow)
V20 सिस्टम में फ़ाइल की स्थिति की निगरानी के लिए स्पष्ट स्टेट मशीन परिभाषित की गई है। मुख्य स्टेट निम्नलिखित हैं:
- प्रारंभिक स्थितियां: NEW, CLAIMED, HASHED, AI_PROCESSING, AI_CHECKPOINT
- प्रोसेसिंग स्थितियां: DUPLICATE_CHECK, UNIQUE, THUMBNAIL_PENDING, THUMBNAIL_DONE, BLOGGER_PENDING, BLOGGER_DRAFT, ARCHIVE_PENDING
- टर्मिनल स्थितियां: DUPLICATE, DONE, FAILED
फ़ोल्डर संरचना और सिस्टम कॉन्फ़िगरेशन (Drive & Configuration)
ऑटोमेशन के सुचारू संचालन के लिए रूट फ़ोल्डर में निम्नलिखित 6 सब-फ़ोल्डर होने अनिवार्य हैं:
| फ़ोल्डर का नाम | विवरण / उद्देश्य |
|---|---|
| 01_INBOX | नया अपलोड किया गया दस्तावेज़ |
| 02_UNIQUE | सफलतापूर्वक सत्यापित अद्वितीय दस्तावेज़ |
| 03_DUPLICATE | पहचाने गए डुप्लिकेट दस्तावेज़ |
| 04_FAILED | स्थायी रूप से विफ़ल दस्तावेज़ |
| 05_THUMBNAILS | जनरेट किए गए थंबनेल इमेज फ़ाइलें |
| 06_ARCHIVE_FILES | प्रोसेस्ड फ़ाइलों का अंतिम आर्काइव |
स्लाइड्स थंबनेल और हार्ड इनवेरिएंट्स (Slides Contract & Hard Invariants)
Google Slides टेम्पलेट के लिए {{MAIN_TITLE}}, {{SUBTITLE}}, {{CATEGORY}}, {{DATE}}, और {{AUTHORITY}} जैसे मार्केटर्स निर्धारित हैं। V20 आर्किटेक्चर के कड़े नियमों (Hard Invariants) के तहत डुप्लिकेट फ़ाइलों पर जेमिनी एपीआई कॉल शून्य (0) रहेगी, और एक बार AI Checkpoint दर्ज होने के बाद संबंधित फ़ाइल के लिए पुनः कोई जेमिनी एपीआई कॉल नहीं की जाएगी।