التقارير المحاسبية

تتيح صفحة التقارير المحاسبية عرض وتصدير البيانات المالية التنظيمية المغربية: الميزانية العمومية، حساب النتائج (CPC)، جدول تكوين النتائج (ESG)، وجدول التمويل. تعتمد على نموذج التقرير المحدد وبيانات السنة المالية الحالية.

نظرة عامة

شاهد الدرس خطوة بخطوة

افتح هذه الصفحة في التطبيق

تنقسم الصفحة إلى تبويبين:

• عرض التقرير — يعرض التقرير المُنشأ (جدول حسب الأقسام والسطور) مع إمكانية التصدير إلى Excel أو PDF
• الإعداد — يعرض هيكل النموذج (الأقسام، السطور، المناطق، مصادر الحساب)

يتم إنشاء التقرير تلقائيًا عند تحديد سنة مالية.

الوظائف الرئيسية

اختيار نموذج التقرير

يتم تحميل النموذج النشط (مثال BILAN_MA، CPC_MA، ESG_MA، TF_MA) عبر معلمة slug في عنوان URL (/accounting/reports/<code>). يعرّف كل نموذج:

• الأقسام (كتل التقرير: الأصول، الخصوم، الإيرادات، الأعباء، إلخ)
• السطور المرقمة ضمن كل قسم
• المناطق (الأعمدة: N، N-1، إجمالي، استهلاك، صافي، إلخ)
• مصادر الحساب (balance، balance_debit، balance_credit، debit_moves، credit_moves، formula)

عرض التقرير

يعرض تبويب عرض التقرير ($t('accounting.report_view')):

• جدول منظم حسب الأقسام والسطور
• الخلايا المحسوبة لكل منطقة (قيم رقمية)
• أزرار تصدير Excel و PDF في أعلى الجدول

انقر على سطر لفتح اللوحة الجانبية التي تحتوي على:

• تفاصيل خلايا السطر (التسمية، القيمة، المصادر، الصيغة)
• خيار توسيع الحساب (handleExpandAccount) لعرض القيود المرتبطة من دفتر الأستاذ
• زر المسرد (GlossaryDialog)

الإعداد

يعرض تبويب الإعداد ($t('accounting.report_config')) شجرة النموذج:

• الأقسام مع سطورها ومناطقها
• لكل منطقة: الرمز، التسمية، الرمز الرسمي، العمود، المصادر
• تحدد المصادر طريقة الحساب ونمط الحساب أو الصيغة

التصدير

تؤدي أزرار تصدير Excel ($t('accounting.export_excel')) و تصدير PDF ($t('accounting.export_pdf')) إلى تشغيل exportReport() باستخدام النموذج والسنة المالية المحددة والتنسيق. تشير مؤشرات التحميل (exportingXlsx، exportingPdf) إلى أن التصدير قيد التنفيذ.

لوحة تفاصيل السطر

عند النقر على سطر في الجدول، تفتح لوحة جانبية (Dialog من الجانب الأيمن) تعرض:

• تسمية السطر
• الخلايا مع قيمها المحسوبة
• تسمية السنة المالية (selectedFY?.label)
• حالة توسيع الحساب (expandedAccno) وقيود دفتر الأستاذ (ledgerEntries)
• زر المسرد (GlossaryDialog) الذي يشرح الطرق والأنماط والصيغ

المهام خطوة بخطوة

عرض تقرير

1. افتح /accounting/reports/<CODE> (مثال BILAN_MA، CPC_MA)
2. تأكد من أن تبويب عرض التقرير نشط
3. تصفح الجدول حسب الأقسام والسطور
4. انقر على سطر لعرض التفاصيل والمصادر

تصدير تقرير

1. في تبويب عرض التقرير، انقر على تصدير Excel أو تصدير PDF
2. انتظر انتهاء التنزيل (يعرض الزر مؤشر تحميل)
3. يتم تنزيل الملف بالاسم المُنشأ (filename) أو افتراضيًا report.xlsx / report.pdf

عرض قيود دفتر الأستاذ لحساب

1. انقر على سطر في التقرير لفتح لوحة التفاصيل
2. في اللوحة، انقر على زر توسيع الحساب (onExpandAccount)
3. تظهر قيود دفتر الأستاذ (ledgerEntries)، مرتبة حسب accno، entry_date، entry_number
4. انقر مرة أخرى للطي

عرض إعداد النموذج

1. انتقل إلى تبويب الإعداد
2. تصفح الأقسام والسطور
3. اطلع على المناطق ومصادرها (الطريقة، النمط، الصيغة)

نصائح

• تُعيد الصفحة التوجيه من /accounting/reports/ إلى /accounting/reports/bilan_ma عبر +layout.svelte و+page.svelte
• يتم تحميل السنة المالية (selectedFY) والفترة (period.fiscalYearId) من الأصل (await parent())
• إذا لم تُكوّن أي فترة (period.fiscalYearId فارغ)، تُرجع generateReport() قيمة null ويظل التقرير فارغًا
• تحتفظ اللوحة الجانبية بـ selectedLine وexpandedAccno وledgerEntries في حالة محلية ($state)

استكشاف الأخطاء

• لا يُعرض أي تقرير: تأكد من تحديد سنة مالية (selectedFiscalYearId) وأن النموذج (template) موجود. إذا لم يتطابق slug مع أي نموذج، تُرجع خطأ 404 (if (!template) error(404, 'Report not found')).
• فشل التصدير: تظهر رسالة خطأ (addLocalError) ويتم إعادة تعيين مؤشرات التحميل (finally)
• لوحة فارغة بعد النقر على سطر: يتم اشتقاق reportSections من data.lines. إذا لم تُعرّف أي سطور في النموذج، يظل الجدول فارغًا
• قيود دفتر الأستاذ فارغة: يستعلم طلب accounting_ledger حسب company_id وaccno (باستخدام like) وfiscal_year_id ويُرتب حسب التاريخ ورقم القيد

---

صفحات ذات صلة: محرر التقارير، السنوات المالية، مخطط الحسابات