Wave 40 reports/export readiness

جاهزية التقارير والتصدير

Wave: 40/40

نطاق V1

الهدف:Make current report and export foundations understandable from the UI
النمط:Readiness-only status surface linked to existing foundations
الحقيقة:Reports stay anchored to journal truth, not draft documents
الحد:No report renderer, no PDF/XLSX/CSV generation, no download streaming, and no accounting behavior change

ملخص جاهزية التقارير والتصدير

المجالالحالةالإشارة الحاليةالخطوة الآمنة التالية
اليومية والأستاذready foundationJournal entries and account ledger read posted/reversed journal truth with source document traceabilityKeep filters and calculations narrow when report meaning changes
ميزان المراجعةready foundationTrial-balance direction starts from journal lines and avoids draft document truthDo not add report parity claims before legacy report evidence is mapped
الفلاتر والتشغيلreadiness-onlySavedReportFilter and ReportRun preserve request, status, timestamps, summary, and pagination directionConnect richer runtime UX later without changing accounting calculations in this wave
دورة التصديرreadiness-onlyReportExport tracks requested, generating, ready, failed, and expired metadata onlyKeep file generation, storage providers, signed URLs, and streams out of V1 readiness pages
الوصول والتنزيلreadiness-onlyAccess-check and download-info expose owner/support-grant decisions and readiness reasonsShow authorization status only; do not add download streaming or signed URL behavior
التدقيق والاحتفاظreadiness-onlyAudit/event traces, retention preview, review queue, and bulk review metadata are modeledKeep review operations metadata-only until worker/storage execution is explicitly approved

الأساسات الحالية

تقارير اليومية والأستاذ وميزان المراجعة

ready foundation
العقود:/accounting/reports/journal-entries, /accounts/:accountId/ledger, /trial-balance
الحقيقة:Reads POSTED and REVERSED journal truth; DRAFT journal entries stay excluded
الأثر:Source document id, number, reference, type, and reversal links remain visible
الحد:No renderer, print clone, VAT recalculation, stock movement, posting, or journal behavior change

الفلاتر المحفوظة وتشغيل التقارير

readiness-only
العقود:/reporting/saved-filters, /reporting/report-runs, /reporting/runs
التخزين:Saved filters and runs are tenant/company/user scoped
الحالة:Request status, timestamps, result summary, row count, and errors are tracked
الحد:No calculation engine expansion, exact legacy report clone, or export renderer

دورة بيانات التصدير

readiness-only
العقود:/reporting/exports, /mark-processing, /mark-completed, /mark-failed
الربط:Exports can link to report runs and report definitions
الأثر:Format, type, file name, mime type, storage key, byte size, and status stay metadata
الحد:No PDF/XLSX/CSV generation, no storage-provider calls, and no real file streaming

الوصول ومعلومات التنزيل

readiness-only
العقود:/reporting/exports/:id/access-check, /download-info
القرار:Owner and support-grant outcomes stay explicit with reason codes
الجاهزية:Download-info describes readiness and artifact metadata without serving a file
الحد:No signed URL, no stream, no support impersonation shortcut, and no tenant-boundary bypass

التدقيق والأحداث

readiness-only
الأثر:Access checks, reads, and download-info checks write audit/domain-event traces
الدعم:Support-grant involvement remains explicit
النطاق:Tenant, company, requester, and export ids remain visible in the trace
الحد:No worker execution, notification dispatch, or provider integration

الاحتفاظ والمراجعة

readiness-only
العقود:/retention/cleanup-preview, /review-queue, /bulk-mark-*
العمليات:Retention, cleanup, review-needed, retry-ready, rejected, and cleared states stay metadata-only
الملخص:Queue summaries expose ready, reviewed, cleanup, and status counts
الحد:No storage deletion, no download changes, no background worker, and no notifications

نواقص V1 المحجوبة

قوالب التقارير:Exact legacy report and print template parity still needs report evidence
التوليد:Blocked until evidence/integration; PDF, XLSX, CSV, and print generation remain outside this readiness wave
التنزيل:Blocked until evidence/integration; streaming, signed URLs, and provider-backed delivery are not implemented here
الحسابات:Any financial calculation or filter changing accounting meaning must be a narrow future wave
المشغل:Workers, retries, notifications, and storage deletion stay outside Wave 40
الشاشات:This page is a readiness/status surface, not a full report renderer or operator console