docs: ten scenarios for connecting and splitting revenue, in click order

Written to be executed in the room. Each scenario is the sentence the accountant
will say, then the exact buttons in order, then the journal entry that appears.

Covers the one that prompted it — "the 150,000 splits 30% to this fund, 10% to
that one" — plus flat amounts, the percentage-base question, creating a missing
fund account mid-meeting, VAT inclusive vs exclusive, deferred subscription
revenue, connecting an unconnected path, breaking out an aggregate account,
undoing a change, and proving the numbers reconcile.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

docs/كيف-أوصّل-أي-إيراد.md

+# كيف أوصّل أي إيراد وأوزّعه — خطوة بخطوة
+
+> ملف تنفيذي. كل سيناريو هنا مكتوب بالترتيب اللي هتضغطه بالظبط، عشان تعمله
+> قدامهم وانت قاعد من غير ما تدوّر.
+
+**الشاشات الثلاثة اللي هتشتغل عليها:**
+
+| الشاشة | الرابط | بتعمل إيه |
+|---|---|---|
+| مركز التوصيل | `/accounting/revenue-mapping/connections` | كل المسارات وحالتها والمبلغ اللي برة الدفاتر |
+| محرك القيود | `/accounting/revenue-mapping` | القائمة الكاملة بالمراحل |
+| باني التوزيع | تفتح من أي مسار | تقسيم المبلغ + محاكاة لحظية |
+
+---
+
+## المفهوم في سطرين
+
+كل مبلغ بيتحصّل بيتقسم لـ**بنود**. كل بند: إما **نسبة %**، أو **مبلغ ثابت**،
+أو **«الباقي»**. لازم يكون فيه بند «باقي» واحد بالظبط، وهو اللي بياخد المتبقي
+وبيستوعب كسور القرش عشان القيد يفضل متوازن دايمًا.
+
+**ترتيب التطبيق ثابت ومكتوب على الشاشة:**
+> الضريبة تُفصل الأول ← المبالغ الثابتة ← النسب ← «الباقي»
+
+---
+
+## السيناريو ١ — «المية وخمسين ألف دي بتتقسم»
+
+**اللي هيقولوه:** «قيمة العضوية ١٥٠٬٠٠٠ — ٣٠٪ منها تروح صندوق دعم النشاط،
+و١٠٪ صندوق الرعاية الاجتماعية، والباقي إيراد عضويات.»
+
+**اللي هتعمله:**
+
+1. `المحاسبة ← توزيع الإيرادات`
+2. اكتب في البحث: **قيمة العضوية**
+3. اضغط زرار **تحصيل**
+4. في **بنود التوزيع** هتلاقي بند واحد طريقته «الباقي» رايح لـ `410101 عضويات جديدة`
+5. اضغط **+ إضافة بند** → غيّر طريقة التوزيع لـ **نسبة %** → اكتب `30`
+   → في خانة الحساب اكتب «دعم النشاط» واختر `23082101 صندوق دعم النشاط الرياضي`
+6. اضغط **+ إضافة بند** تاني → **نسبة %** → `10`
+   → اختر `23082102 صندوق الرعاية الاجتماعية للأعضاء`
+7. رتّب بالأسهم ▲▼ بحيث «الباقي» يبقى آخر بند
+8. في خانة **مبلغ تجريبي** على اليمين اكتب `150000`
+
+**اللي هيظهر قدامهم لحظيًا:**
+
+| الحساب | مدين | دائن |
+|---|---:|---:|
+| الصندوق بالجنيه المصري | ١٥٠٬٠٠٠٫٠٠ | |
+| صندوق دعم النشاط الرياضي — ٣٠٪ | | ٤٥٬٠٠٠٫٠٠ |
+| صندوق الرعاية الاجتماعية — ١٠٪ | | ١٥٬٠٠٠٫٠٠ |
+| عضويات جديدة — الباقي | | ٩٠٬٠٠٠٫٠٠ |
+| **الإجمالي** | **١٥٠٬٠٠٠٫٠٠** | **١٥٠٬٠٠٠٫٠٠** |
+
+✓ القيد متوازن
+
+9. اكتب سبب التغيير في **ملاحظة** (مثلاً: قرار مجلس الإدارة رقم كذا)
+10. **حفظ كإصدار جديد وتفعيله**
+
+> **الجملة اللي تقولها وانت بتحفظ:** «التاريخ ده معناه إن التوزيع الجديد بيشتغل من
+> النهارده ورايح. القيود المرحّلة قبل كده ما بتتغيرش، ومسجّل مين غيّر وإمتى وليه.»
+
+---
+
+## السيناريو ٢ — «فيه خمسة جنيه ثابتة مش نسبة»
+
+**اللي هيقولوه:** «طابع الشهداء ٥ جنيه ثابتة على كل استمارة، مش نسبة.»
+
+1. افتح المسار (مثلاً **رسوم استمارة عضوية**) ← مرحلة **تحصيل**
+2. **+ إضافة بند** → طريقة التوزيع **مبلغ ثابت** → القيمة `5`
+3. الحساب: `23082103 طابع الشهداء — محصّل لحساب الغير`
+4. **نوع البند**: اختار **تحصيل لحساب الغير (التزام)**
+5. رتّبه فوق بند «الباقي»
+
+على مبلغ ٥٠٥: الطابع ٥٫٠٠ والباقي ٥٠٠٫٠٠.
+
+> **ليه «تحصيل لحساب الغير» مش «إيراد»؟** لأن الخمسة جنيه دي مش فلوس النادي —
+> النادي بيحصّلها ويوردها. فهي التزام، ولو دخلت الإيراد يبقى الإيراد متضخّم
+> والالتزام مخفي. دي نقطة المحاسب هيحترمها.
+
+---
+
+## السيناريو ٣ — «الترتيب: النسبة قبل الخصم ولا بعده؟»
+
+سؤال شاطر وهيتسأل. الإجابة موجودة على الشاشة نفسها في خانة **«النسبة تُحسب على»**:
+
+| الاختيار | معناه |
+|---|---|
+| الصافي بعد خصم المبالغ الثابتة | النسبة بعد ما تشيل الثابت (الافتراضي) |
+| الصافي الكامل | النسبة على الصافي قبل الثابت |
+| الإجمالي المحصَّل | النسبة على المبلغ كله قبل الضريبة |
+
+**مثال:** ١٬٠٠٠ + طابع ٥ ثابتة + عمولة ١٠٪
+- على «الصافي بعد الثابت» → ١٠٪ من ٩٩٥ = **٩٩٫٥٠**
+- على «الصافي الكامل» → ١٠٪ من ١٬٠٠٠ = **١٠٠٫٠٠**
+
+غيّر الاختيار قدامهم وورّيهم الرقم بيتغير في المحاكاة.
+
+---
+
+## السيناريو ٤ — «الحساب اللي عايزينه مش موجود»
+
+**اللي هيقولوه:** «لازم يروح صندوق تطوير الملاعب» — وهو مش في دليل الحسابات.
+
+**متروحش لدليل الحسابات — اعمله من نفس الشاشة:**
+
+1. جنب خانة الحساب في البند، اضغط **+ حساب جديد**
+2. **تحت أي حساب رئيسي؟** → اختار `230821 صناديق النادي والأمانات المخصصة`
+   (أو `4105 إيرادات النادي` لو إيراد حقيقي)
+3. اكتب الاسم بالعربي
+4. **إنشاء وتحديد**
+
+الحساب بياخد الكود التالي المتاح تلقائيًا، وبيورث نوع وطبيعة الأب، وبيتحدد في
+البند على طول.
+
+> الشاشة بترفض إنك تحط حساب جديد تحت حساب فرعي عليه حركة — لأن ده بيحوّل الحساب
+> لرئيسي ويسيب رصيده معلّق. دي حماية مقصودة.
+
+---
+
+## السيناريو ٥ — «ضريبة ١٤٪ على الخدمة دي»
+
+1. في نفس شاشة المسار، خانة **المعالجة الضريبية**
+2. اختار:
+   - **ضريبة قيمة مضافة 14% (شاملة السعر)** — السعر المعلن شامل الضريبة
+   - **ضريبة قيمة مضافة 14% (تُضاف على السعر)** — الضريبة فوق السعر
+   - **معفاة** / **خارج نطاق الضريبة**
+3. المحاكاة هتفصل الضريبة فورًا
+
+**الفرق مهم — على ١٬١٤٠ شامل ١٤٪:**
+- الإيراد **١٬٠٠٠** والضريبة **١٤٠**
+- لو حسبتها ١٤٪ من ١٬١٤٠ غلط → **١٥٩٫٦٠** (فرق ١٩٫٦٠ في كل عملية)
+
+الضريبة بتروح `23080404 ضريبة القيمة المضافة` وهي **التزام** مش إيراد.
+
+---
+
+## السيناريو ٦ — «الاشتراك السنوي ده مش إيراد شهر واحد»
+
+**اللي هيقولوه:** «العضو دفع ١٢٬٠٠٠ عن سنة — مش كلهم إيراد يناير.»
+
+1. في البند، غيّر **نوع البند** لـ **إيراد مؤجل (يُستحق على فترة)**
+2. هيظهر صندوق بنفسجي:
+   - **عدد الشهور**: `12`
+   - **يتحقق في حساب الإيراد**: اختار حساب الإيراد النهائي
+3. حساب البند نفسه يبقى `230809 ايرادات مدفوعة مقدما`
+4. حفظ
+
+**النتيجة:**
+
+عند التحصيل: مدين النقدية ١٢٬٠٠٠ / دائن إيرادات مدفوعة مقدمًا ١٢٬٠٠٠
+كل شهر: مدين إيرادات مدفوعة مقدمًا ١٬٠٠٠ / دائن إيراد الاشتراكات ١٬٠٠٠
+
+**الترحيل الشهري:** `المحاسبة ← الإيراد المؤجل` ← اختار الفترة ← **معاينة** ←
+**ترحيل تحقق الإيراد**.
+
+> السند: معيار المحاسبة المصري رقم ٤٨ — الإيراد يتحقق مع أداء الخدمة.
+
+---
+
+## السيناريو ٧ — «الحاجة دي مش موصولة أصلًا»
+
+1. `المحاسبة ← مركز التوصيل`
+2. الشاشة مقسومة تلات أقسام:
+
+**«تُوصَّل الآن من الشاشة»** — الوحدة بتبعت الحدث ومعاه المبلغ.
+اضغط **اربط الحسابات** واعمل التوزيع زي السيناريو ١. بيشتغل فورًا على أي حركة جاية.
+
+**«تحتاج تعديل برمجي»** — الوحدة بتسجّل الفلوس في جدولها ومش بتبعت حدث.
+**مفيش زرار ربط هنا بقصد** — لأن الربط لوحده مش هيعمل حاجة. الصف بيقول بالظبط
+إيه الناقص.
+
+> **الجملة:** «الفرق بين القسمين مش شكلي. الأول أقدر أقفله دلوقتي قدامكم.
+> التاني محتاج الوحدة تبعت الحدث الأول — وده سطر كود، مش إعداد. الشاشة
+> بتفرّق بينهم عشان ما أدّيش وعد ما ينفعش أنفذه.»
+
+**«موصولة»** — التوزيع الحالي ظاهر قدام كل مسار، وزرار **عدّل التوزيع** أو
+**قسّم على حسابات** لو لسه رايح لحساب واحد.
+
+---
+
+## السيناريو ٨ — «الحساب المجمّع ده فيه إيه؟»
+
+**اللي هيقولوه:** «إيرادات متنوعه دي فيها ٤ مليون. إيه اللي جواها؟»
+
+1. `المحاسبة ← توزيع الإيرادات ← فحص الحالة`
+2. الجدول التالت: **«ما هو مُرحَّل إلى ٤١٠٥١٥ — إيرادات متنوعه»**
+   بيوريك كل نوع دفعة والمبلغ والنسبة
+
+**للتفصيل:**
+1. من نفس الجدول شوف أكبر بند (مثلاً رسوم التنازل)
+2. روح لمساره في محرك القيود
+3. اعمل حساب جديد مخصص (السيناريو ٤) أو اختار حساب موجود
+4. غيّر البند وفعّل
+
+> **مهم جدًا تقولها:** «التغيير ده بيأثر من تاريخ السريان ورايح بس. المبالغ
+> التاريخية اللي في الحساب المجمّع محتاجة **قيد تسوية** بعد ما تعتمدوا التوزيع
+> الصحيح — وده قراركم مش قراري.»
+
+---
+
+## السيناريو ٩ — «طيب لو غلطنا؟»
+
+- كل حفظ = **إصدار جديد** بتاريخ سريان. القديم بيتقفل يوم قبله ويفضل في السجل.
+- **سجل الإصدارات** ظاهر على يمين شاشة المسار: مين فعّل، إمتى، والملاحظة.
+- القيد المرحّل **ما بيتعدلش** — بيتعكس بقيد مضاد من `قيود اليومية ← عكس القيد`.
+- عايز ترجع لتوزيع قديم؟ اعمل إصدار جديد بنفس بنود القديم.
+
+---
+
+## السيناريو ١٠ — «ورّينا إن الأرقام سليمة»
+
+بالترتيب ده:
+
+1. `تقارير ← ميزان المراجعة` → المدين = الدائن
+2. `تقارير ← قائمة الدخل` → إجمالي الإيراد **مطابق** لميزان المراجعة
+3. `تقارير ← الميزانية العمومية` → أصول = التزامات + حقوق ملكية
+4. `دليل الحسابات` → الأرصدة مطابقة لميزان المراجعة
+
+> **الجملة:** «التطابق ده محسوب من الدفاتر نفسها مش من جدول مساعد — فلو فيه فرق
+> كان هيبان هنا.»
+
+---
+
+## ملخص الأزرار
+
+| عايز تعمل إيه | تروح فين |
+|---|---|
+| تقسّم مبلغ على حسابات | محرك القيود ← المسار ← + إضافة بند |
+| تعمل حساب جديد | باني التوزيع ← + حساب جديد |
+| تضيف ضريبة | باني التوزيع ← المعالجة الضريبية |
+| تخلّي إيراد مؤجل | باني التوزيع ← نوع البند ← إيراد مؤجل |
+| ترحّل الاستحقاق الشهري | المحاسبة ← الإيراد المؤجل |
+| تشوف اللي مش موصول | المحاسبة ← مركز التوصيل |
+| تشوف اللي مكسور | توزيع الإيرادات ← فحص الحالة |
+| تشوف تفصيل حساب مجمّع | فحص الحالة ← الجدول التالت |
+| ترجع في تغيير | المسار ← إصدار جديد بالبنود القديمة |
+
+---
+
+## آخر حاجة
+
+الحاجة الوحيدة اللي ممكن تبوّظ الاجتماع هي ادعاء يتكشف.
+الشاشة اتعملت مخصوص عشان تفرّق بين **«ده أقدر أقفله دلوقتي»** و**«ده محتاج كود»** —
+استخدم الفرق ده، هو أقوى حاجة معاك.