इस प्रोजेक्ट के बारे में

Open Civic Signal OS एक नागरिक-तकनीकी प्लेटफॉर्म है जिसे monorepo के रूप में प्रदान किया गया है। इसका घोषित उद्देश्य सामुदायिक संकेतों — निवासियों द्वारा रिपोर्ट की गई बार-बार होने वाली स्थानीय समस्याओं — को एक सार्वजनिक बैकलॉग में बदलना है जिसे लोग समझ सकें, भरोसा कर सकें और जिस पर कार्रवाई कर सकें। उत्पाद के वादे को दो दृष्टिकोणों से वर्णित किया गया है। एक नागरिक के लिए, मार्ग यह है: सरल भाषा में एक वास्तविक स्थानीय समस्या की रिपोर्ट करें, देखें कि इसे प्राथमिकता क्यों दी गई, और ट्रैक करें कि क्या बदला, किसने प्रतिक्रिया दी और क्या अभी भी लंबित है। लोक सेवकों और सामुदायिक नेताओं के लिए, घोषित लक्ष्य शोर को कम करना, सबसे महत्वपूर्ण चीजों को सामने लाना और प्राथमिकता निर्धारण के पीछे के सबूतों को दृश्यमान रखना है। दस्तावेजीकृत उपयोगकर्ता यात्राएं तीन भूमिकाओं को कवर करती हैं: - सामुदायिक सदस्य: समस्या की रिपोर्ट करना, डुप्लिकेट करने के बजाय मौजूदा मुद्दे का समर्थन करना, यह समझना कि कोई मुद्दा उच्च प्राथमिकता वाला क्यों है, और समुदाय या किसी संस्थान से अपडेट ट्रैक करना। - सामुदायिक मॉडरेटर या समन्वयक: सामुदायिक बातचीत की समीक्षा करना, स्पष्ट भूमिका सीमाओं के साथ प्रगति अपडेट प्रकाशित करना, और चर्चा चैनलों को उपयोग योग्य और ऑडिट योग्य रखना। - लोक सेवक: उच्चतम प्राथमिकता वाली समस्याओं की जल्दी पहचान करना, प्रगति अपडेट प्रकाशित करना, और कार्यों के क्रम को उचित ठहराने के लिए पारदर्शी सबूतों का उपयोग करना। README वर्तमान UX अंतराल के बारे में स्पष्ट है: रिपॉजिटरी और एप्लिकेशन तकनीकी प्लेटफॉर्म को अच्छी तरह से समझाते हैं, लेकिन पहली बार उपयोग करने वाले उपयोगकर्ताओं के लिए बहुत जल्दी बहुत सारे नेविगेशन और वर्कफ़्लो विकल्प पेश करते हैं। इसलिए, चल रहा फ्रंटएंड कार्य प्रथम-रन अनुभव को सरल बनाने, प्राथमिक कार्यों को स्पष्ट करने और संज्ञानात्मक भार को कम करने पर केंद्रित है। घोषित उत्पाद दिशा में एक सरल प्रथम-स्क्रीन पदानुक्रम, स्पष्ट प्राथमिक कॉल टू एक्शन, कम-घर्षण ऑनबोर्डिंग और सत्यापन, सुलभ कीबोर्ड और मोबाइल नेविगेशन, और विश्वास सतहें शामिल हैं जो बिना किसी तकनीकी शब्दावली के रैंकिंग और प्रगति को समझाती हैं। दस्तावेजीकृत तकनीकी स्टैक: - बैकएंड: Java 21 Spring Boot के साथ, apps/api-java में, जो API और प्राथमिकता सेवाओं की मेजबानी करता है। - फ्रंटएंड: React, TypeScript और Vite, apps/web-react में, जो सार्वजनिक डैशबोर्ड और एक ऑपरेटर कंसोल प्रदान करता है। - डेटा: वर्तमान MVP के लिए JSON-first, जिसमें PostgreSQL को नियोजित के रूप में सूचीबद्ध किया गया है। - कॉन्ट्रैक्ट्स: packages/contracts के तहत OpenAPI परिभाषाएं और साझा स्कीमा। - अन्य निर्देशिकाएं: स्थानीय वातावरण और परिनियोजन संपत्तियों के लिए infra, और रणनीति, विचारों, आर्किटेक्चर और निष्पादन योजनाओं के लिए docs। प्रोजेक्ट चलाना: मानक एकीकृत विकास रनटाइम Docker है, जिसे npm run docker:dev:up के साथ शुरू किया जाता है, जिसे README फ्रंटएंड और बैकएंड दोनों के लिए आवश्यक हॉट-रीलोड पथ के रूप में वर्णित करता है। सहायक कमांड में docker:dev:doctor, docker:dev:ps, docker:dev:logs और docker:dev:down शामिल हैं, साथ ही एक प्रोडक्शन-जैसा मोड (docker:prod:up) और प्रीबिल्ट GHCR इमेज (docker:ghcr:up / docker:ghcr:down) हैं, जिसमें .github/workflows/docker-images.yml में एक CI इमेज वर्कफ़्लो है। README स्पष्ट रूप से अनुरोध करता है कि एकीकृत व्यवहार को मान्य करते समय Docker की अनुपलब्धता को स्थानीय वातावरण अवरोधक के रूप में माना जाए। वर्तमान MVP के लिए npm install और npm run prioritize जैसे स्क्रिप्ट भी हैं। अलग-थलग काम के लिए घटक-मात्र फॉलबैक पथ मौजूद हैं: apps/web-react के अंदर npm run dev के साथ React ऐप चलाना, और apps/api-java के अंदर ./mvnw spring-boot:run के साथ Java API चलाना। अतिरिक्त रिपॉजिटरी सामग्री में लॉन्च संसाधन (डेमो और आर्किटेक्चर GIFs, एक आर्किटेक्चर SVG, docs के तहत एक लैंडिंग पेज, एक विचार दस्तावेज़ और एक एजेंट प्लेबुक), एक ब्रांड और विजुअल एसेट किट (लोगो मार्क, वर्डमार्क, बैनर, सोशल कार्ड और PNG लोगो), और प्रोजेक्ट के GitHub issues के माध्यम से रोडमैप ट्रैकिंग शामिल है। कुल मिलाकर, रिपॉजिटरी एक शुरुआती चरण का, खुले तौर पर प्रलेखित नागरिक जुड़ाव और प्राथमिकता प्लेटफॉर्म है: यह इच्छित नागरिक और प्रशासक यात्राओं को परिभाषित करता है, Spring Boot और React घटकों के साथ Docker-आधारित monorepo विकास प्रवाह प्रदान करता है, API कॉन्ट्रैक्ट्स को रिपो में रखता है, और अपने शेष UX सरलीकरण कार्य को खुले तौर पर सूचीबद्ध करता है।