Ezvento provides comprehensive reporting for every aspect of your business. From real-time dashboard widgets to detailed GST compliance reports, every report is role-scoped, exportable, and backed by immutable audit trails. All reports respect RBAC permissions and tenant isolation.
Reports Overview
The Ezvento reporting layer is built on top of Prisma-aggregated queries and Recharts visualizations. Reports are divided into five categories: Sales, Inventory, GST, Financial, and Audit. Each category has dedicated dashboard widgets and detailed report pages with date range filtering, grouping, and multi-format export. All report endpoints enforce REPORT_VIEW_* andREPORT_EXPORT_* permissions.
Sales Reports
Sales reports provide a complete view of revenue performance across stores, counters, and time periods. The dashboard features a SalesChart (AreaChart) showing daily revenue trends, while the dedicated reports page uses SalesBarChartfor comparative analysis by store, product, or payment method.
Sales Report Permissions
REPORT_VIEW_SALESREPORT_EXPORT_SALES
REPORT_VIEW_SALES grants access to all sales visualizations and tables.REPORT_EXPORT_SALESallows downloading reports in CSV, Excel, or PDF format. Store Managers see only their store's data. Regional Managers see all stores in their region. Owners see everything.
Inventory Reports
Inventory reports help businesses maintain optimal stock levels, track product movement, and identify slow-moving or dead stock. Reports are scoped to the user's accessible stores and locations, ensuring no cross-tenant or unauthorized store data leakage.
Inventory Report Permissions
REPORT_VIEW_INVENTORYREPORT_EXPORT_INVENTORY
GST Reports
GST reports are designed for Indian tax compliance. Ezvento generates GSTR-1 (Outward Supplies) and GSTR-3B ready reports from invoice data. The GstPieChart component visualizes GST breakdown by rate slab (0%, 5%, 12%, 18%, 28%) to help businesses understand their tax liability distribution.
GST Report Permissions
REPORT_EXPORT_GST
GST reports are typically restricted to the Accountant and Organization Ownerroles due to their tax compliance nature. The REPORT_EXPORT_GST permission is required to download GSTR-1 and GSTR-3B formatted files.
Financial Reports
Financial reports provide the business owner and accountant with a clear picture of revenue, profit margins, and cash flow. Reports aggregate data from sales invoices, purchase invoices, payments, and returns. All monetary values use the tenant's configured decimal places and currency.
Financial Report Permissions
REPORT_VIEW_FINANCIAL
Financial reports are typically accessed by the Accountant andOrganization Owner. Store Managers may see store-level revenue and profit if granted REPORT_VIEW_FINANCIAL with STORE scope.
Audit Reports
The ActivityLog model provides an immutable, append-only audit trail of every significant action in the system. Rows include structured old/new value snapshots, a SHA-256 hash chain linking each row to its predecessor, and severity classification. Audit reports are read-only and cannot be deleted or modified by any user.
LogSeverity Levels
Hash Chain Integrity
Each ActivityLog row computes its SHA-256 hash from all fields plus the previousHash of the preceding row (ordered by tenant + createdAt). This creates a cryptographically linked chain. Any tampering with historical rows would break the hash chain, making detection trivial. The hash chain is verified nightly by a background job and any anomalies are surfaced to the Organization Owner.
Audit Report Permissions
REPORT_VIEW_AUDITREPORT_EXPORT_AUDIT
Audit reports are read-only. The REPORT_VIEW_AUDIT permission is typically held by the Auditor and Organization Owner. The Auditor role has a read-only scope and cannot perform any mutations in the system.
Export Formats
All reports support export in three formats: CSV, Excel (XLSX), and PDF. Exports include the tenant's configured header/footer, logo, and GSTIN. Date ranges and filters applied in the UI are preserved in the exported file. Large exports (>10,000 rows) are processed asynchronously and delivered via email.
Dashboard Widgets
The main dashboard displays key business metrics as widgets. Each widget is a self-contained component that fetches its own data and respects the user's scope permissions. Widgets auto-refresh every 5 minutes when the dashboard is active.
Report Permissions
Report access is strictly role-based. The system enforces both permission checks and data scoping so that users see only the stores, regions, and warehouses they are authorized for. The Owner sees all data across the organization. Other roles see data scoped to their assigned scope types.
Scope Enforcement
Every report query includes WHERE tenantId = ?as the base filter. Additional filters are applied based on the user's role assignments: