mirror of
https://github.com/stan-smith/FossFLOW.git
synced 2026-04-23 08:31:16 -04:00
204 lines
18 KiB
Markdown
204 lines
18 KiB
Markdown
# FossFLOW - आइसोमेट्रिक आरेख उपकरण <img width="30" height="30" alt="fossflow" src="https://github.com/user-attachments/assets/56d78887-601c-4336-ab87-76f8ee4cde96" />
|
|
|
|
<p align="center">
|
|
<a href="../README.md">English</a> | <a href="README.cn.md">简体中文</a> | <a href="README.es.md">Español</a> | <a href="README.pt.md">Português</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.bn.md">বাংলা</a> | <a href="README.ru.md">Русский</a> | <a href="README.id.md">Bahasa Indonesia</a> | <a href="README.de.md">Deutsch</a>
|
|
</p>
|
|
|
|
<b>नमस्ते!</b> मैं Stan हूं, यदि आपने FossFLOW का उपयोग किया है और इसने आपकी मदद की है, <b>तो मैं वास्तव में सराहना करूंगा यदि आप कुछ छोटा दान कर सकें :)</b> मैं पूर्णकालिक काम करता हूं, और इस परियोजना पर काम करने के लिए समय निकालना पर्याप्त चुनौतीपूर्ण है।
|
|
यदि मैंने आपके लिए कोई सुविधा लागू की है या कोई बग ठीक किया है, तो यह बहुत अच्छा होगा यदि आप कर सकें :) यदि नहीं, तो कोई समस्या नहीं है, यह सॉफ्टवेयर हमेशा मुफ्त रहेगा!
|
|
|
|
|
|
<b>साथ ही!</b> यदि आपने अभी तक नहीं किया है, तो कृपया <a href="https://github.com/markmanx/isoflow">@markmanx</a> द्वारा बनाई गई अंतर्निहित लाइब्रेरी देखें, जिस पर यह बना है। मैं वास्तव में यहां एक दिग्गज के कंधों पर खड़ा हूं 🫡
|
|
|
|
[](https://ko-fi.com/P5P61KBXA3)
|
|
|
|
<img width="30" height="30" alt="image" src="https://github.com/user-attachments/assets/dc6ec9ca-48d7-4047-94cf-5c4f7ed63b84" /> <b> https://buymeacoffee.com/stan.smith </b>
|
|
|
|
|
|
धन्यवाद,
|
|
|
|
-Stan
|
|
|
|
## इसे ऑनलाइन आज़माएं
|
|
|
|
यहां जाएं <b> --> https://stan-smith.github.io/FossFLOW/ <-- </b>
|
|
|
|
|
|
------------------------------------------------------------------------------------------------------------------------------
|
|
FossFLOW सुंदर आइसोमेट्रिक आरेख बनाने के लिए एक शक्तिशाली, ओपन-सोर्स प्रोग्रेसिव वेब ऐप (PWA) है। React और <a href="https://github.com/markmanx/isoflow">Isoflow</a> लाइब्रेरी (अब फोर्क किया गया और NPM पर fossflow के रूप में प्रकाशित) के साथ बनाया गया, यह ऑफ़लाइन समर्थन के साथ पूरी तरह से आपके ब्राउज़र में चलता है।
|
|
|
|
|
|
|
|
- **🤝 [CONTRIBUTORS.md](https://github.com/stan-smith/FossFLOW/blob/master/CONTRIBUTORS.md)** - परियोजना में योगदान कैसे करें।
|
|
|
|
## हाल के अपडेट (अक्टूबर 2025)
|
|
|
|
### बहुभाषी समर्थन
|
|
- **8 भाषाएं समर्थित** - अंग्रेजी, चीनी (सरलीकृत), स्पेनिश, पुर्तगाली (ब्राज़ीलियाई), फ्रेंच, हिंदी, बंगाली और रूसी में पूर्ण इंटरफ़ेस अनुवाद
|
|
- **भाषा चयनकर्ता** - ऐप हेडर में उपयोग में आसान भाषा स्विचर
|
|
- **पूर्ण अनुवाद** - सभी मेनू, संवाद, सेटिंग्स, टूलटिप्स और सहायता सामग्री अनुवादित
|
|
- **लोकेल-जागरूक** - स्वचालित रूप से आपकी भाषा प्राथमिकता का पता लगाता है और याद रखता है
|
|
|
|
### बेहतर कनेक्टर उपकरण
|
|
- **क्लिक-आधारित निर्माण** - नया डिफ़ॉल्ट मोड: पहले नोड पर क्लिक करें, फिर कनेक्ट करने के लिए दूसरे नोड पर क्लिक करें
|
|
- **ड्रैग मोड विकल्प** - मूल ड्रैग-एंड-ड्रॉप अभी भी सेटिंग्स के माध्यम से उपलब्ध है
|
|
- **मोड चयन** - सेटिंग्स → कनेक्टर टैब में क्लिक और ड्रैग मोड के बीच स्विच करें
|
|
- **बेहतर विश्वसनीयता** - क्लिक मोड अधिक अनुमानित कनेक्शन निर्माण प्रदान करता है
|
|
|
|
### कस्टम आइकन आयात
|
|
- **अपने स्वयं के आइकन आयात करें** - अपने आरेखों में उपयोग करने के लिए कस्टम आइकन (PNG, JPG, SVG) अपलोड करें
|
|
- **स्वचालित स्केलिंग** - पेशेवर उपस्थिति के लिए आइकन स्वचालित रूप से सुसंगत आकारों में स्केल किए जाते हैं
|
|
- **आइसोमेट्रिक/फ्लैट टॉगल** - चुनें कि आयातित आइकन 3D आइसोमेट्रिक या फ्लैट 2D के रूप में दिखाई दें
|
|
- **स्मार्ट दृढ़ता** - कस्टम आइकन आरेखों के साथ सहेजे जाते हैं और सभी भंडारण विधियों में काम करते हैं
|
|
- **आइकन संसाधन** - मुफ्त आइकन यहां खोजें:
|
|
- [Iconify Icon Sets](https://icon-sets.iconify.design/) - हजारों मुफ्त SVG आइकन
|
|
- [Flaticon Isometric Icons](https://www.flaticon.com/free-icons/isometric) - उच्च गुणवत्ता वाले आइसोमेट्रिक आइकन पैक
|
|
|
|
### सर्वर स्टोरेज समर्थन
|
|
- **स्थायी भंडारण** - सर्वर फ़ाइल सिस्टम में सहेजे गए आरेख, ब्राउज़र सत्रों में बने रहते हैं
|
|
- **बहु-डिवाइस पहुंच** - Docker डिप्लॉयमेंट का उपयोग करते समय किसी भी डिवाइस से अपने आरेखों तक पहुंचें
|
|
- **स्वचालित पहचान** - उपलब्ध होने पर UI स्वचालित रूप से सर्वर स्टोरेज दिखाता है
|
|
- **अधिलेखन सुरक्षा** - डुप्लिकेट नामों से सहेजते समय पुष्टिकरण संवाद
|
|
- **Docker एकीकरण** - Docker डिप्लॉयमेंट में डिफ़ॉल्ट रूप से सर्वर स्टोरेज सक्षम
|
|
|
|
### बेहतर इंटरैक्शन सुविधाएं
|
|
- **कॉन्फ़िगर करने योग्य हॉटकी** - विजुअल संकेतकों के साथ उपकरण चयन के लिए तीन प्रोफाइल (QWERTY, SMNRCT, कोई नहीं)
|
|
- **उन्नत पैन नियंत्रण** - रिक्त क्षेत्र ड्रैग, मध्य/दाएं क्लिक, संशोधक कुंजी (Ctrl/Alt) और कीबोर्ड नेविगेशन (Arrow/WASD/IJKL) सहित कई पैन विधियां
|
|
- **कनेक्टर तीर टॉगल करें** - व्यक्तिगत कनेक्टरों पर तीर दिखाने/छिपाने का विकल्प
|
|
- **स्थायी उपकरण चयन** - कनेक्शन बनाने के बाद कनेक्टर उपकरण सक्रिय रहता है
|
|
- **सेटिंग्स संवाद** - हॉटकी और पैन नियंत्रण के लिए केंद्रीकृत कॉन्फ़िगरेशन
|
|
|
|
### Docker और CI/CD सुधार
|
|
- **स्वचालित Docker बिल्ड** - कमिट्स पर स्वचालित Docker Hub डिप्लॉयमेंट के लिए GitHub Actions वर्कफ़्लो
|
|
- **बहु-आर्किटेक्चर समर्थन** - `linux/amd64` और `linux/arm64` दोनों के लिए Docker छवियां
|
|
- **पूर्व-निर्मित छवियां** - `stnsmith/fossflow:latest` पर उपलब्ध
|
|
|
|
### Monorepo आर्किटेक्चर
|
|
- लाइब्रेरी और एप्लिकेशन दोनों के लिए **एकल रिपॉजिटरी**
|
|
- सुव्यवस्थित निर्भरता प्रबंधन के लिए **NPM Workspaces**
|
|
- रूट पर `npm run build` के साथ **एकीकृत बिल्ड प्रक्रिया**
|
|
|
|
### UI सुधार
|
|
- Quill संपादक टूलबार आइकन प्रदर्शन समस्या ठीक की गई
|
|
- संदर्भ मेनू में React कुंजी चेतावनियां हल की गईं
|
|
- markdown संपादक स्टाइलिंग में सुधार किया गया
|
|
|
|
## विशेषताएं
|
|
|
|
- 🎨 **आइसोमेट्रिक आरेख** - आश्चर्यजनक 3D-शैली तकनीकी आरेख बनाएं
|
|
- 💾 **ऑटो-सेव** - आपका काम हर 5 सेकंड में स्वचालित रूप से सहेजा जाता है
|
|
- 📱 **PWA समर्थन** - Mac और Linux पर मूल ऐप के रूप में इंस्टॉल करें
|
|
- 🔒 **गोपनीयता-प्रथम** - सभी डेटा आपके ब्राउज़र में स्थानीय रूप से संग्रहीत
|
|
- 📤 **आयात/निर्यात** - JSON फ़ाइलों के रूप में आरेख साझा करें
|
|
- 🎯 **सत्र भंडारण** - संवाद के बिना त्वरित सहेजें
|
|
- 🌐 **ऑफ़लाइन समर्थन** - इंटरनेट कनेक्शन के बिना काम करें
|
|
- 🗄️ **सर्वर स्टोरेज** - Docker उपयोग करते समय वैकल्पिक स्थायी भंडारण (डिफ़ॉल्ट रूप से सक्षम)
|
|
- 🌍 **बहुभाषी** - 8 भाषाओं के लिए पूर्ण समर्थन: English, 简体中文, Español, Português, Français, हिन्दी, বাংলা, Русский
|
|
|
|
|
|
## 🐳 Docker के साथ त्वरित डिप्लॉय
|
|
|
|
```bash
|
|
# Docker Compose का उपयोग करना (अनुशंसित - स्थायी भंडारण शामिल)
|
|
docker compose up
|
|
|
|
# या स्थायी भंडारण के साथ Docker Hub से सीधे चलाएं
|
|
docker run -p 80:80 -v $(pwd)/diagrams:/data/diagrams stnsmith/fossflow:latest
|
|
```
|
|
|
|
Docker में सर्वर स्टोरेज डिफ़ॉल्ट रूप से सक्षम है। आपके आरेख होस्ट पर `./diagrams` में सहेजे जाएंगे।
|
|
|
|
सर्वर स्टोरेज अक्षम करने के लिए, `ENABLE_SERVER_STORAGE=false` सेट करें:
|
|
```bash
|
|
docker run -p 80:80 -e ENABLE_SERVER_STORAGE=false stnsmith/fossflow:latest
|
|
```
|
|
|
|
## त्वरित प्रारंभ (स्थानीय विकास)
|
|
|
|
```bash
|
|
# रिपॉजिटरी क्लोन करें
|
|
git clone https://github.com/stan-smith/FossFLOW
|
|
cd FossFLOW
|
|
|
|
# निर्भरताएं इंस्टॉल करें
|
|
npm install
|
|
|
|
# लाइब्रेरी बनाएं (पहली बार आवश्यक)
|
|
npm run build:lib
|
|
|
|
# विकास सर्वर प्रारंभ करें
|
|
npm run dev
|
|
```
|
|
|
|
अपने ब्राउज़र में [http://localhost:3000](http://localhost:3000) खोलें।
|
|
|
|
## Monorepo संरचना
|
|
|
|
यह दो पैकेज वाला एक monorepo है:
|
|
|
|
- `packages/fossflow-lib` - नेटवर्क आरेख बनाने के लिए React घटक लाइब्रेरी (Webpack के साथ निर्मित)
|
|
- `packages/fossflow-app` - आइसोमेट्रिक आरेख बनाने के लिए Progressive Web App (RSBuild के साथ निर्मित)
|
|
|
|
### विकास आदेश
|
|
|
|
```bash
|
|
# विकास
|
|
npm run dev # ऐप विकास सर्वर शुरू करें
|
|
npm run dev:lib # लाइब्रेरी विकास के लिए वॉच मोड
|
|
|
|
# बिल्डिंग
|
|
npm run build # लाइब्रेरी और ऐप दोनों बनाएं
|
|
npm run build:lib # केवल लाइब्रेरी बनाएं
|
|
npm run build:app # केवल ऐप बनाएं
|
|
|
|
# परीक्षण और लिंटिंग
|
|
npm test # यूनिट टेस्ट चलाएं
|
|
npm run lint # लिंटिंग त्रुटियों की जांच करें
|
|
|
|
# E2E टेस्ट (Selenium)
|
|
cd e2e-tests
|
|
./run-tests.sh # एंड-टू-एंड टेस्ट चलाएं (Docker और Python आवश्यक)
|
|
|
|
# प्रकाशन
|
|
npm run publish:lib # npm पर लाइब्रेरी प्रकाशित करें
|
|
```
|
|
|
|
## उपयोग कैसे करें
|
|
|
|
### आरेख बनाना
|
|
|
|
1. **आइटम जोड़ें**:
|
|
- शीर्ष दाईं ओर मेनू पर "+" बटन दबाएं, घटक लाइब्रेरी बाईं ओर दिखाई देगी
|
|
- लाइब्रेरी से घटकों को कैनवास पर ड्रैग और ड्रॉप करें
|
|
- या ग्रिड पर राइट-क्लिक करें और "नोड जोड़ें" चुनें
|
|
|
|
2. **आइटम कनेक्ट करें**:
|
|
- कनेक्टर उपकरण चुनें ('C' दबाएं या कनेक्टर आइकन पर क्लिक करें)
|
|
- **क्लिक मोड** (डिफ़ॉल्ट): पहले नोड पर क्लिक करें, फिर दूसरे नोड पर क्लिक करें
|
|
- **ड्रैग मोड** (वैकल्पिक): पहले से दूसरे नोड तक क्लिक करें और ड्रैग करें
|
|
- सेटिंग्स → कनेक्टर टैब में मोड स्विच करें
|
|
|
|
3. **अपना काम सहेजें**:
|
|
- **त्वरित सहेजें** - ब्राउज़र सत्र में सहेजता है
|
|
- **निर्यात** - JSON फ़ाइल के रूप में डाउनलोड करें
|
|
- **आयात** - JSON फ़ाइल से लोड करें
|
|
|
|
### भंडारण विकल्प
|
|
|
|
- **सत्र भंडारण**: ब्राउज़र बंद होने पर अस्थायी सहेजें साफ़ हो जाते हैं
|
|
- **निर्यात/आयात**: JSON फ़ाइलों के रूप में स्थायी भंडारण
|
|
- **ऑटो-सेव**: सत्र में हर 5 सेकंड में परिवर्तन स्वचालित रूप से सहेजता है
|
|
|
|
## योगदान देना
|
|
|
|
हम योगदान का स्वागत करते हैं! कृपया दिशानिर्देशों के लिए [CONTRIBUTORS.md](../CONTRIBUTORS.md) देखें।
|
|
|
|
## प्रलेखन
|
|
|
|
- [FOSSFLOW_ENCYCLOPEDIA.md](../FOSSFLOW_ENCYCLOPEDIA.md) - कोडबेस के लिए व्यापक गाइड
|
|
- [CONTRIBUTORS.md](../CONTRIBUTORS.md) - योगदान दिशानिर्देश
|
|
|
|
## लाइसेंस
|
|
|
|
MIT
|