साझा खर्च बिल विभाजक और सेटल-अप योजनाकार

--- name: shared-expense-bill-splitter-and-settle-up-planner description: एक CSV लेजर को विभाजित करता है जिसमें एक यात्रा, फ्लैट या इवेंट के साझा खर्च होते हैं - बराबर, शेयर, सटीक, प्रतिशत और आइटमीकृत बिल टैक्स और टिप के साथ, 'सभी को छोड़कर' बहिष्करण, कई भुगतानकर्ता, रिफंड, पुनर्भुगतान और सहमत दरों पर कई मुद्राएं - सेंट में, फिर सबसे कम से कम सेटल-अप ट्रांसफर खोजता है (सटीक जीरो-सम सबग्रुप खोज)। बैलेंस, प्रति व्यक्ति ऑडिट और चैट संदेश लौटाता है। इसमें एक stdlib Python प्लानर शामिल है जिसमें --self-test है। --- # साझा खर्च बिल विभाजक और सेटल-अप प्लानर आप साझा खर्चों की एक अव्यवस्थित सूची को एक उचित, जांचने योग्य विभाजन और भुगतान की सबसे छोटी संभव सूची में बदल देते हैं। आप लेजर को एक CSV के रूप में रखते हैं जिसे समूह किसी भी स्प्रेडशीट में संपादित कर सकता है, प्रत्येक पंक्ति के लिए वास्तव में आवश्यक विभाजन नियम लागू करते हैं (वहां कौन था, किसने क्या ऑर्डर किया, किसने कम रातें बिताईं), समूह द्वारा सहमत दरों पर मुद्राओं को परिवर्तित करते हैं, और सबसे कम ट्रांसफर के साथ सभी को सेटल करते हैं। हर सेंट का हिसाब है, और कोई भी अपनी संख्या को पंक्ति दर पंक्ति ट्रेस कर सकता है। ## इस स्किल में फाइलें - `scripts/settle_up.py` - CSV लेजर पढ़ता है, प्रत्येक पंक्ति को पूर्णांक सेंट में विभाजित करता है (सबसे बड़ा शेष पूर्णांकन), प्रति व्यक्ति भुगतान/शेयर/नेट की गणना करता है, और न्यूनतम संख्या में ट्रांसफर खोजने के लिए सभी जीरो-सम सबग्रुप खोजता है (18 लोगों तक सटीक, उससे अधिक के लिए ग्रीडी) (केवल Python 3.8+ मानक पुस्तकालय) - `references/split-methods.md` - CSV प्रारूप, किस लागत के लिए कौन सा विभाजन, टैक्स और टिप के साथ आइटमीकृत बिल, बहिष्करण, भुगतानकर्ता, रिफंड और पुनर्भुगतान - `references/settle-up-and-currency.md` - न्यूनतम "लोग - 1" से कम क्यों हो सकता है, खोज कैसे काम करती है, पूर्णांकन, विनिमय दरें और कार्ड शुल्क, भुगतान शिष्टाचार - `templates/settle-up-summary.md` - सारांश जो वापस सौंपना है और ग्रुप चैट में पेस्ट करना है - `examples/lisbon-trip.csv` - 5 दोस्त, 11 पंक्तियाँ: रातों के हिसाब से शेयर, एक बहिष्कृत व्यक्ति, एक आइटमीकृत रात्रिभोज, एक USD बुकिंग, प्रीमियम सीटें, दो भुगतानकर्ता, एक रिफंड, GBP स्नैक्स और एक पहले से किया गया पुनर्भुगतान - `examples/lisbon-settle-output.md` - उस लेजर पर प्लानर का वास्तविक आउटपुट - `examples/flat-october.csv` - 6 फ्लैटमेट जहां न्यूनतम (4 ट्रांसफर) सबसे बड़े कर्ज को सबसे बड़े क्रेडिट को चुकाने से बेहतर है (5) ## कार्यप्रवाह ### 1. लेजर इकट्ठा करें हर साझा लागत के लिए पूछें: क्या, किसने भुगतान किया (और कितना, अगर कई लोगों ने भुगतान किया), राशि और मुद्रा, और यह किसके लिए था। ऐसे प्रश्न पूछें जो विभाजन बदलते हैं: क्या कोई देर से आया या जल्दी चला गया? क्या किसी ने भोजन या गतिविधि छोड़ दी? क्या रात्रिभोज साझा था या व्यक्तिगत रूप से ऑर्डर किया गया था? क्या किसी ने पहले ही किसी को वापस भुगतान कर दिया है? आधार मुद्रा और दरों पर सहमत हों (पूरी यात्रा के लिए प्रति मुद्रा एक दर जब तक कि समूह कार्ड स्टेटमेंट दरें नहीं चाहता)। इसे `references/split-methods.md` में CSV के रूप में लिखें, `# people:` के साथ ताकि नामों में टाइपो पकड़े जाएं। ### 2. प्लानर चलाएं ``` python3 scripts/settle_up.py examples/lisbon-trip.csv python3 scripts/settle_up.py flat.csv --base GBP --rates EUR=0.86 --detail Ben python3 scripts/settle_up.py ledger.csv --json python3 scripts/settle_up.py --self-test ``` एग्जिट 0 = योजना मुद्रित (चेतावनी अनुभाग पढ़ें), 2 = लेजर में त्रुटि है (योग मेल नहीं खाते, लापता दर, अज्ञात विभाजन या नाम) - उस पंक्ति को ठीक करें जिसका नाम है। यदि आप कोड नहीं चला सकते हैं, तो उन्हीं चरणों का पालन करें: प्रत्येक पंक्ति को आधार सेंट में बदलें, विभाजित करें, प्रति व्यक्ति भुगतान घटाकर शेयर करें, फिर देनदारों को लेनदारों से मिलाएं, पहले उन लोगों या छोटे समूहों की तलाश करें जिनके बैलेंस बिल्कुल रद्द हो जाते हैं। ### 3. समूह के साथ परिणाम जांचें - चेक लाइन `nets add up to 0.00` पढ़नी चाहिए; भुगतान और शेयर बराबर होने चाहिए। - बैलेंस को सरल शब्दों में पढ़ें ("एना ने 990.00 का भुगतान किया, उसका शेयर 377.31 है और एली ने उसे पहले ही 100.00 दे दिया है, इसलिए उसे 512.69 वापस मिलते हैं")। - उन पंक्तियों को इंगित करें जो परिणाम चलाती हैं और विवाद करना आसान है (रातों के हिसाब से शेयर, आइटमीकृत भोजन, एक रिफंड, एक पुनर्भुगतान), और किसी को भी अपना ब्रेकडाउन चाहिए तो `--detail <name>` प्रदान करें। - यदि कोई किसी और को भुगतान करना पसंद करता है (या किसी व्यक्ति को सीधे भुगतान नहीं कर सकता), तो सहमत ट्रांसफर को `payment` पंक्ति के रूप में जोड़ने के बाद फिर से चलाएं; योजना बाकी की पुनर्गणना करती है। ### 4. डिलीवर करें `templates/settle-up-summary.md` भरें: कुल, बैलेंस तालिका, क्रमांकित ट्रांसफर, धारणाएं (दरें, किसे कहां बाहर रखा गया था, टैक्स/टिप कैसे फैलाया गया था), और छोटा ग्रुप-चैट संदेश। प्रत्येक ट्रांसफर को लेजर में `payment` पंक्ति के रूप में जोड़कर पूर्ण के रूप में चिह्नित करने का सुझाव दें, ताकि दूसरी बार चलाने पर सभी 0.00 दिखें। ## उदाहरण परिणाम `examples/lisbon-trip.csv` पर (5 लोग, 1,583.07 EUR खर्च) एना ने अपार्टमेंट और फाडो टिकट का भुगतान किया और 512.69 EUR वापस मिलते हैं; योजना 4 ट्रांसफर है: बेन एना को 243.17 देता है, डारा एना को 140.94 देती है, एली एना को 128.58 देता है और एली सेम को 0.85 देता है (एली का पहले का 100.00 पुनर्भुगतान पहले से गिना जा चुका है)। `examples/flat-october.csv` पर बो और फिन एक दूसरे को रद्द कर देते हैं, इसलिए 6 फ्लैटमेट 4 ट्रांसफर में सेटल होते हैं जबकि सबसे बड़े कर्ज को सबसे बड़े क्रेडिट को चुकाने में 5 लगते। ## नियम - राशियों, दरों या किसने भाग लिया, कभी आविष्कार न करें; पूछें, या पंक्ति को सारांश में एक धारणा के रूप में चिह्नित करें। - प्रति मुद्रा एक सहमत दर का उपयोग करें और इसे दिखाएं; तैयार विभाजन में लाइव दरों को न मिलाएं। - सभी अंकगणित सेंट में रखें और दिखाएं कि पूर्णांकन सेंट कहां गए (सबसे बड़ा शेष, टाई पहले सूचीबद्ध व्यक्ति को)। - खर्च का न्याय न करें; केवल उन पंक्तियों को चिह्नित करें जो डुप्लिकेट, टाइपो या लापता प्रतिभागियों की तरह दिखती हैं। - एक पुनर्भुगतान एक `payment` पंक्ति है, कभी नकारात्मक खर्च नहीं; एक रिफंड एक नकारात्मक खर्च है जो मूल लागत के समान लोगों द्वारा साझा किया जाता है। - योजना को एक प्रस्ताव के रूप में प्रस्तुत करें; समूह कौन किसे भुगतान करता है बदल सकता है जब तक प्रत्येक व्यक्ति का नेट अपरिवर्तित रहता है।