# H11.0-P10.5 — Professional Daily Revenue Excel Export & Audit Workbook

## الهدف
تحويل تصدير الإيراد اليومي للمرضى المنومين من ملف تقني بسيط إلى ملف مالي احترافي قريب من الملف اليدوي المستخدم فعليًا، مع إضافة طبقة تدقيق ومراجعة وملخص تنفيذي.

## خط الأساس
- Baseline Release: `11.0.10.4.3`
- Baseline Phase: `H11.0-P10.4-R3`

## الإصدار المستهدف
- Target Release: `11.0.10.5`
- Target Phase: `H11.0-P10.5`

## نطاق التغيير
التغيير خاص بالتصدير إلى Excel وعرض بطاقة التصدير في صفحة Daily Inpatient Revenue فقط.

لا توجد تغييرات على:
- قواعد الشركة 365.
- قواعد TCS 170.
- Cash = Patient Share Total / LOS.
- Insurance = Company Share Total / LOS.
- منطق Total LOS.
- SQL الخاص بمحرك الإيراد.
- مصادر الإيراد العشرة.
- Oracle schema.
- Oracle writes.

## اسم الملف الجديد
يتم إنشاء الملف تلقائيًا بهذا النمط:

`{HOSPITAL}_Daily_Revenue_{YYYY-MM-DD}.xlsx`

مثال:

`NJCH_Daily_Revenue_2026-07-12.xlsx`

## الأوراق الأربع داخل الملف

### 1) Summary
ملخص تنفيذي يشمل:
- Patients in Rooms.
- Total Daily Revenue.
- Average per Patient.
- Automatic Coverage.
- Needs Review.
- Revenue by Care Area.
- Revenue by Financial Class.
- Native Excel chart لأهم جهات الدفع حسب الإيراد اليومي.
- قواعد الحساب المعتمدة.

### 2) Daily Revenue
هذه هي الورقة الموجهة للاستخدام اليومي للموظف، وتم تصميمها لتكون قريبة من الملف اليدوي المألوف.

الأعمدة الأساسية وعددها 13:
1. Attending Doctor
2. Financial Class
3. LOS
4. Nationality
5. Patient Name
6. Patient ID
7. Time
8. Date
9. Daily Revenue
10. Bed
11. Room
12. Initial Admission
13. Total LOS

التحسينات الإضافية:
- تقسيم المرضى حسب الوحدة.
- عنوان واضح لكل وحدة.
- No Of Patients لكل وحدة.
- No Of Beds لكل وحدة.
- Occupancy لكل وحدة.
- Unit Daily Revenue subtotal.
- Grand Total Daily Revenue.
- تنسيق مالي وتواريخ وأوقات حقيقية داخل Excel.

### 3) Detailed Audit
ورقة تدقيق تفصيلية على مستوى المريض وتشمل:
- Patient Share Total.
- Company Share Total.
- Daily Revenue.
- Calculation Source.
- Status.
- Review Reason.
- معلومات المريض والزيارة والمكان.

هذه الورقة مصممة لتفسير سبب كل قيمة وإثبات طريقة الحساب بدل الاكتفاء بالرقم النهائي.

### 4) Needs Review
تحتوي فقط على الحالات التي تحتاج مراجعة بسبب:
- عدم وجود accumulated share.
- قيمة سالبة أو غير صالحة.
- أي حالة يحددها محرك الحساب كـ Needs Review.

إذا لم توجد حالات، تعرض الورقة رسالة واضحة بذلك.

## التحقق على بيانات 12/07/2026
تم استخدام ملف الموقع الحقيقي `final.xlsx` ليوم 12/07/2026 كعينة تحقق، وتم إنشاء Workbook احترافي على نفس بيانات المرضى:
- Patients: 81
- Total Daily Revenue: 227,188.93 SR
- Workbook sheets: 4
- XLSX ZIP integrity: PASS
- Spreadsheet parser import: PASS
- Formula/error scan: 0 errors

## نتائج الاختبارات المحلية
- CLI / Calculation / Architecture / XLSX: `35/35 PASS`
- Protected QA Contract: `42/42 PASS`
- PHP Syntax: PASS
- XLSX ZIP Integrity: PASS
- Artifact spreadsheet import: PASS
- Native payer chart package: PASS

## التوافق
- PHP 7.4+ compatible.
- لا يستخدم `match` أو PHP 8-only syntax في ملفات التشغيل الجديدة.
- لا يعتمد على مكتبات خارجية مثل PhpSpreadsheet.
- يعتمد على ZIP-capable PHP archive engine المتوفر في البيئة كما في المرحلة السابقة.

## الأمان وقاعدة البيانات
- Oracle Writes: `NONE`
- Database Schema Changes: `NONE`
- Direct `SP_IPD_OPD_VAT_REVENUE` call: `NONE`
- Direct `SP_INPATIENT_REVENUE_DATA` call: `NONE`

## ملاحظة مهمة
تستمر قاعدة الشركة 365 بعد أكثر من 30 يومًا على القيمة المطلوبة من المستخدم:

`2373.00 SR`

مع بقاء الفرق التاريخي مع بعض الملفات اليدوية القديمة التي كانت تستخدم `2373.44 SR` مسجلًا للمراجعة المالية.
