@managesome/eposmatic-toolkit 0.4.9 → 0.4.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/esm/constants/MATERIALIZED_REPORTS.js +455 -0
- package/esm/constants/enums/delivery.js +8 -0
- package/esm/helpers/index.js +3 -0
- package/esm/helpers/materialized-reports/index.js +32 -0
- package/esm/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +114 -0
- package/esm/helpers/materialized-reports/materialized-cash-classification-helpers.js +248 -0
- package/esm/helpers/materialized-reports/materialized-cash-close-day-helpers.js +396 -0
- package/esm/helpers/materialized-reports/materialized-cash-compile-helpers.js +245 -0
- package/esm/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +170 -0
- package/esm/helpers/materialized-reports/materialized-delivery-classification-helpers.js +430 -0
- package/esm/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +373 -0
- package/esm/helpers/materialized-reports/materialized-delivery-compile-helpers.js +216 -0
- package/esm/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +319 -0
- package/esm/helpers/materialized-reports/materialized-discount-classification-helpers.js +213 -0
- package/esm/helpers/materialized-reports/materialized-discount-close-day-helpers.js +604 -0
- package/esm/helpers/materialized-reports/materialized-discount-compile-helpers.js +186 -0
- package/esm/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +155 -0
- package/esm/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +199 -0
- package/esm/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +115 -0
- package/esm/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +89 -0
- package/esm/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +394 -0
- package/esm/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +167 -0
- package/esm/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +215 -0
- package/esm/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +477 -0
- package/esm/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +201 -0
- package/esm/helpers/materialized-reports/materialized-reports-scope-group-helpers.js +9 -6
- package/esm/helpers/materialized-reports/materialized-reports-selection-helpers.js +11 -4
- package/esm/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +189 -0
- package/esm/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +156 -0
- package/esm/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +588 -0
- package/esm/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +175 -0
- package/esm/helpers/materialized-reports/tenant-cash-in-out-formatter.js +157 -0
- package/esm/helpers/materialized-reports/tenant-delivery-formatter.js +230 -0
- package/esm/helpers/materialized-reports/tenant-discount-formatter.js +427 -0
- package/esm/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +238 -0
- package/esm/helpers/materialized-reports/tenant-payments-comparison-formatter.js +282 -0
- package/esm/helpers/materialized-reports/tenant-prep-time-formatter.js +228 -0
- package/esm/helpers/materialized-reports/tenant-sales-comparison-formatter.js +346 -0
- package/esm/helpers/reporting-contract/index.js +2 -0
- package/esm/helpers/reporting-contract/overview-contract.js +123 -0
- package/esm/helpers/reporting-contract/report-contract.js +228 -0
- package/esm/helpers/rider-earnings/index.js +1 -0
- package/esm/helpers/rider-earnings/rider-earnings.js +53 -0
- package/esm/helpers/rider-reports/index.js +2 -0
- package/esm/helpers/rider-reports/rider-daily-report.js +90 -0
- package/esm/helpers/rider-reports/rider-report.js +67 -0
- package/esm/helpers/store/common-order-actions.js +3 -2
- package/esm/schemas/models/deliveries.js +82 -1
- package/esm/schemas/models/index.js +15 -0
- package/esm/schemas/models/materialized_credit_bills.js +1 -1
- package/esm/schemas/models/materialized_rider_daily_reports.js +39 -0
- package/esm/schemas/models/materialized_tenant_cash_entries.js +95 -0
- package/esm/schemas/models/materialized_tenant_cash_reports.js +77 -0
- package/esm/schemas/models/materialized_tenant_delivery_entries.js +63 -0
- package/esm/schemas/models/materialized_tenant_delivery_reports.js +63 -0
- package/esm/schemas/models/materialized_tenant_discount_entries.js +156 -0
- package/esm/schemas/models/materialized_tenant_discount_reports.js +333 -0
- package/esm/schemas/models/materialized_tenant_hourly_comparison_entries.js +87 -0
- package/esm/schemas/models/materialized_tenant_hourly_comparison_reports.js +99 -0
- package/esm/schemas/models/materialized_tenant_payments_comparison_entries.js +71 -0
- package/esm/schemas/models/materialized_tenant_payments_comparison_reports.js +76 -0
- package/esm/schemas/models/materialized_tenant_prep_time_entries.js +130 -0
- package/esm/schemas/models/materialized_tenant_prep_time_reports.js +109 -0
- package/esm/schemas/models/materialized_tenant_sales_comparison_entries.js +130 -0
- package/esm/schemas/models/materialized_tenant_sales_comparison_reports.js +154 -0
- package/esm/schemas/models/materialized_tenant_sales_overview_reports.js +1 -1
- package/esm/schemas/types/index.js +15 -0
- package/esm/schemas/types/materialized_rider_daily_reports.js +1 -0
- package/esm/schemas/types/materialized_tenant_cash_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_cash_reports.js +1 -0
- package/esm/schemas/types/materialized_tenant_delivery_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_delivery_reports.js +1 -0
- package/esm/schemas/types/materialized_tenant_discount_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_discount_reports.js +2 -0
- package/esm/schemas/types/materialized_tenant_hourly_comparison_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_hourly_comparison_reports.js +1 -0
- package/esm/schemas/types/materialized_tenant_payments_comparison_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_payments_comparison_reports.js +11 -0
- package/esm/schemas/types/materialized_tenant_prep_time_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_prep_time_reports.js +1 -0
- package/esm/schemas/types/materialized_tenant_sales_comparison_entries.js +1 -0
- package/esm/schemas/types/materialized_tenant_sales_comparison_reports.js +14 -0
- package/lib/constants/MATERIALIZED_REPORTS.d.ts +345 -2
- package/lib/constants/MATERIALIZED_REPORTS.js +457 -1
- package/lib/constants/enums/delivery.d.ts +7 -0
- package/lib/constants/enums/delivery.js +9 -1
- package/lib/helpers/index.d.ts +3 -0
- package/lib/helpers/index.js +3 -0
- package/lib/helpers/materialized-reports/index.d.ts +32 -0
- package/lib/helpers/materialized-reports/index.js +32 -0
- package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.d.ts +18 -0
- package/lib/helpers/materialized-reports/materialized-cash-accumulator-helpers.js +118 -0
- package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.d.ts +142 -0
- package/lib/helpers/materialized-reports/materialized-cash-classification-helpers.js +257 -0
- package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.d.ts +103 -0
- package/lib/helpers/materialized-reports/materialized-cash-close-day-helpers.js +409 -0
- package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.d.ts +73 -0
- package/lib/helpers/materialized-reports/materialized-cash-compile-helpers.js +252 -0
- package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.d.ts +7 -0
- package/lib/helpers/materialized-reports/materialized-delivery-accumulator-helpers.js +173 -0
- package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.d.ts +113 -0
- package/lib/helpers/materialized-reports/materialized-delivery-classification-helpers.js +442 -0
- package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.d.ts +98 -0
- package/lib/helpers/materialized-reports/materialized-delivery-close-day-helpers.js +386 -0
- package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.d.ts +41 -0
- package/lib/helpers/materialized-reports/materialized-delivery-compile-helpers.js +220 -0
- package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.d.ts +52 -0
- package/lib/helpers/materialized-reports/materialized-discount-accumulator-helpers.js +325 -0
- package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.d.ts +50 -0
- package/lib/helpers/materialized-reports/materialized-discount-classification-helpers.js +222 -0
- package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.d.ts +182 -0
- package/lib/helpers/materialized-reports/materialized-discount-close-day-helpers.js +615 -0
- package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.d.ts +47 -0
- package/lib/helpers/materialized-reports/materialized-discount-compile-helpers.js +193 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.d.ts +64 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-close-day-helpers.js +163 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.d.ts +61 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-compile-helpers.js +207 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.d.ts +23 -0
- package/lib/helpers/materialized-reports/materialized-hourly-comparison-selection-helpers.js +120 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.d.ts +25 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-accumulator-helpers.js +99 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.d.ts +79 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-close-day-helpers.js +407 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.d.ts +35 -0
- package/lib/helpers/materialized-reports/materialized-payments-comparison-compile-helpers.js +173 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.d.ts +98 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-classification-helpers.js +224 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.d.ts +130 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-close-day-helpers.js +491 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.d.ts +47 -0
- package/lib/helpers/materialized-reports/materialized-prep-time-compile-helpers.js +208 -0
- package/lib/helpers/materialized-reports/materialized-reports-scope-group-helpers.d.ts +6 -3
- package/lib/helpers/materialized-reports/materialized-reports-scope-group-helpers.js +8 -5
- package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.d.ts +8 -0
- package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.js +10 -3
- package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.d.ts +48 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-accumulator-helpers.js +204 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.d.ts +22 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-baseline-helpers.js +160 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.d.ts +163 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-close-day-helpers.js +603 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.d.ts +68 -0
- package/lib/helpers/materialized-reports/materialized-sales-comparison-compile-helpers.js +182 -0
- package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.d.ts +98 -0
- package/lib/helpers/materialized-reports/tenant-cash-in-out-formatter.js +160 -0
- package/lib/helpers/materialized-reports/tenant-delivery-formatter.d.ts +133 -0
- package/lib/helpers/materialized-reports/tenant-delivery-formatter.js +233 -0
- package/lib/helpers/materialized-reports/tenant-discount-formatter.d.ts +114 -0
- package/lib/helpers/materialized-reports/tenant-discount-formatter.js +431 -0
- package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.d.ts +60 -0
- package/lib/helpers/materialized-reports/tenant-hourly-comparison-formatter.js +244 -0
- package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.d.ts +75 -0
- package/lib/helpers/materialized-reports/tenant-payments-comparison-formatter.js +289 -0
- package/lib/helpers/materialized-reports/tenant-prep-time-formatter.d.ts +98 -0
- package/lib/helpers/materialized-reports/tenant-prep-time-formatter.js +232 -0
- package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.d.ts +105 -0
- package/lib/helpers/materialized-reports/tenant-sales-comparison-formatter.js +352 -0
- package/lib/helpers/reporting-contract/index.d.ts +2 -0
- package/lib/helpers/reporting-contract/index.js +18 -0
- package/lib/helpers/reporting-contract/overview-contract.d.ts +55 -0
- package/lib/helpers/reporting-contract/overview-contract.js +127 -0
- package/lib/helpers/reporting-contract/report-contract.d.ts +159 -0
- package/lib/helpers/reporting-contract/report-contract.js +239 -0
- package/lib/helpers/rider-earnings/index.d.ts +1 -0
- package/lib/helpers/rider-earnings/index.js +17 -0
- package/lib/helpers/rider-earnings/rider-earnings.d.ts +51 -0
- package/lib/helpers/rider-earnings/rider-earnings.js +57 -0
- package/lib/helpers/rider-reports/index.d.ts +2 -0
- package/lib/helpers/rider-reports/index.js +18 -0
- package/lib/helpers/rider-reports/rider-daily-report.d.ts +28 -0
- package/lib/helpers/rider-reports/rider-daily-report.js +93 -0
- package/lib/helpers/rider-reports/rider-report.d.ts +49 -0
- package/lib/helpers/rider-reports/rider-report.js +70 -0
- package/lib/helpers/store/common-order-actions.js +3 -2
- package/lib/helpers/types/materialized-reports-apis.d.ts +300 -1
- package/lib/schemas/models/deliveries.d.ts +58 -1
- package/lib/schemas/models/deliveries.js +81 -0
- package/lib/schemas/models/expense_details.d.ts +3 -3
- package/lib/schemas/models/index.d.ts +15 -0
- package/lib/schemas/models/index.js +15 -0
- package/lib/schemas/models/materialized_credit_bills.d.ts +3 -3
- package/lib/schemas/models/materialized_credit_bills.js +1 -1
- package/lib/schemas/models/materialized_rider_daily_reports.d.ts +27 -0
- package/lib/schemas/models/materialized_rider_daily_reports.js +42 -0
- package/lib/schemas/models/materialized_tenant_cash_entries.d.ts +181 -0
- package/lib/schemas/models/materialized_tenant_cash_entries.js +98 -0
- package/lib/schemas/models/materialized_tenant_cash_reports.d.ts +111 -0
- package/lib/schemas/models/materialized_tenant_cash_reports.js +80 -0
- package/lib/schemas/models/materialized_tenant_delivery_entries.d.ts +98 -0
- package/lib/schemas/models/materialized_tenant_delivery_entries.js +66 -0
- package/lib/schemas/models/materialized_tenant_delivery_reports.d.ts +98 -0
- package/lib/schemas/models/materialized_tenant_delivery_reports.js +66 -0
- package/lib/schemas/models/materialized_tenant_discount_entries.d.ts +199 -0
- package/lib/schemas/models/materialized_tenant_discount_entries.js +159 -0
- package/lib/schemas/models/materialized_tenant_discount_reports.d.ts +216 -0
- package/lib/schemas/models/materialized_tenant_discount_reports.js +336 -0
- package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.d.ts +95 -0
- package/lib/schemas/models/materialized_tenant_hourly_comparison_entries.js +82 -0
- package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.d.ts +105 -0
- package/lib/schemas/models/materialized_tenant_hourly_comparison_reports.js +91 -0
- package/lib/schemas/models/materialized_tenant_payments_comparison_entries.d.ts +91 -0
- package/lib/schemas/models/materialized_tenant_payments_comparison_entries.js +70 -0
- package/lib/schemas/models/materialized_tenant_payments_comparison_reports.d.ts +98 -0
- package/lib/schemas/models/materialized_tenant_payments_comparison_reports.js +71 -0
- package/lib/schemas/models/materialized_tenant_prep_time_entries.d.ts +181 -0
- package/lib/schemas/models/materialized_tenant_prep_time_entries.js +133 -0
- package/lib/schemas/models/materialized_tenant_prep_time_reports.d.ts +118 -0
- package/lib/schemas/models/materialized_tenant_prep_time_reports.js +112 -0
- package/lib/schemas/models/materialized_tenant_sales_comparison_entries.d.ts +139 -0
- package/lib/schemas/models/materialized_tenant_sales_comparison_entries.js +120 -0
- package/lib/schemas/models/materialized_tenant_sales_comparison_reports.d.ts +167 -0
- package/lib/schemas/models/materialized_tenant_sales_comparison_reports.js +137 -0
- package/lib/schemas/models/materialized_tenant_sales_overview_reports.d.ts +3 -3
- package/lib/schemas/models/materialized_tenant_sales_overview_reports.js +1 -1
- package/lib/schemas/models/tenant_purchase_order_vendor_returns.d.ts +3 -3
- package/lib/schemas/models/warehouse_internal_movements.d.ts +6 -6
- package/lib/schemas/models/warehouse_purchase_order_receipts.d.ts +3 -3
- package/lib/schemas/models/warehouse_purchase_order_vendor_returns.d.ts +3 -3
- package/lib/schemas/models/warehouse_sale_deliveries.d.ts +6 -6
- package/lib/schemas/models/warehouse_sale_invoices.d.ts +3 -3
- package/lib/schemas/types/deliveries.d.ts +40 -1
- package/lib/schemas/types/index.d.ts +15 -0
- package/lib/schemas/types/index.js +15 -0
- package/lib/schemas/types/materialized_rider_daily_reports.d.ts +37 -0
- package/lib/schemas/types/materialized_rider_daily_reports.js +2 -0
- package/lib/schemas/types/materialized_tenant_cash_entries.d.ts +87 -0
- package/lib/schemas/types/materialized_tenant_cash_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_cash_reports.d.ts +144 -0
- package/lib/schemas/types/materialized_tenant_cash_reports.js +2 -0
- package/lib/schemas/types/materialized_tenant_delivery_entries.d.ts +98 -0
- package/lib/schemas/types/materialized_tenant_delivery_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_delivery_reports.d.ts +179 -0
- package/lib/schemas/types/materialized_tenant_delivery_reports.js +2 -0
- package/lib/schemas/types/materialized_tenant_discount_entries.d.ts +81 -0
- package/lib/schemas/types/materialized_tenant_discount_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_discount_reports.d.ts +209 -0
- package/lib/schemas/types/materialized_tenant_discount_reports.js +3 -0
- package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.d.ts +33 -0
- package/lib/schemas/types/materialized_tenant_hourly_comparison_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.d.ts +40 -0
- package/lib/schemas/types/materialized_tenant_hourly_comparison_reports.js +2 -0
- package/lib/schemas/types/materialized_tenant_payments_comparison_entries.d.ts +48 -0
- package/lib/schemas/types/materialized_tenant_payments_comparison_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_payments_comparison_reports.d.ts +51 -0
- package/lib/schemas/types/materialized_tenant_payments_comparison_reports.js +14 -0
- package/lib/schemas/types/materialized_tenant_prep_time_entries.d.ts +88 -0
- package/lib/schemas/types/materialized_tenant_prep_time_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_prep_time_reports.d.ts +132 -0
- package/lib/schemas/types/materialized_tenant_prep_time_reports.js +2 -0
- package/lib/schemas/types/materialized_tenant_sales_comparison_entries.d.ts +43 -0
- package/lib/schemas/types/materialized_tenant_sales_comparison_entries.js +2 -0
- package/lib/schemas/types/materialized_tenant_sales_comparison_reports.d.ts +74 -0
- package/lib/schemas/types/materialized_tenant_sales_comparison_reports.js +17 -0
- package/lib/schemas/types/materialized_tenant_sales_overview_reports.d.ts +7 -0
- package/lib/tests/deliveries-schema.test.d.ts +1 -0
- package/lib/tests/deliveries-schema.test.js +70 -0
- package/lib/tests/materialized-reports/analytics-growth-helpers.test.d.ts +1 -0
- package/lib/tests/materialized-reports/analytics-overview-helpers.test.d.ts +1 -0
- package/lib/tests/materialized-reports/analytics-performance-helpers.test.d.ts +1 -0
- package/lib/tests/materialized-reports/fixtures.d.ts +15 -1
- package/lib/tests/materialized-reports/fixtures.js +1 -0
- package/lib/tests/materialized-reports/materialized-cash-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-cash-compile.test.js +197 -0
- package/lib/tests/materialized-reports/materialized-cash-fold.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-cash-fold.test.js +116 -0
- package/lib/tests/materialized-reports/materialized-cash-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-cash-formatter.test.js +153 -0
- package/lib/tests/materialized-reports/materialized-cash-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-cash-plan.test.js +168 -0
- package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-cash-reconciliation.test.js +267 -0
- package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-delivery-accumulation.test.js +147 -0
- package/lib/tests/materialized-reports/materialized-delivery-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-delivery-compile.test.js +242 -0
- package/lib/tests/materialized-reports/materialized-delivery-fold.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-delivery-fold.test.js +109 -0
- package/lib/tests/materialized-reports/materialized-delivery-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-delivery-formatter.test.js +142 -0
- package/lib/tests/materialized-reports/materialized-delivery-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-delivery-plan.test.js +198 -0
- package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-aggregated-formatter.test.js +173 -0
- package/lib/tests/materialized-reports/materialized-discount-classification.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-classification.test.js +339 -0
- package/lib/tests/materialized-reports/materialized-discount-close-day.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-close-day.test.js +506 -0
- package/lib/tests/materialized-reports/materialized-discount-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-compile.test.js +161 -0
- package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-counter-rows.test.js +107 -0
- package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-discount-entries-accumulation.test.js +125 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-compile.test.js +146 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-formatter.test.js +127 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-plan.test.js +138 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-hourly-comparison-selection.test.js +90 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-compile.test.js +164 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-formatter.test.js +117 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-payments-comparison-plan.test.js +149 -0
- package/lib/tests/materialized-reports/materialized-prep-time-classification.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-prep-time-classification.test.js +273 -0
- package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-prep-time-close-day.test.js +271 -0
- package/lib/tests/materialized-reports/materialized-prep-time-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-prep-time-compile.test.js +217 -0
- package/lib/tests/materialized-reports/materialized-prep-time-constants.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-prep-time-constants.test.js +84 -0
- package/lib/tests/materialized-reports/materialized-prep-time-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-prep-time-plan.test.js +176 -0
- package/lib/tests/materialized-reports/materialized-reports-scope-group-helpers.test.js +13 -13
- package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-baseline.test.js +126 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-compile.test.js +207 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-formatter.test.js +179 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-parity.test.js +196 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-sales-comparison-plan.test.js +241 -0
- package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-tenant-hourly-comparison-schema.test.js +96 -0
- package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-tenant-payments-comparison-schema.test.js +112 -0
- package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-tenant-sales-comparison-schema.test.js +142 -0
- package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +8 -1
- package/lib/tests/materialized-reports/sales-comparison-reference.d.ts +55 -0
- package/lib/tests/materialized-reports/sales-comparison-reference.js +86 -0
- package/lib/tests/materialized-reports/tenant-discount-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/tenant-discount-formatter.test.js +289 -0
- package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.d.ts +1 -0
- package/lib/tests/materialized-reports/tenant-prep-time-formatter.test.js +354 -0
- package/lib/tests/reporting-contract.test.d.ts +1 -0
- package/lib/tests/reporting-contract.test.js +267 -0
- package/lib/tests/rider-daily-report.test.d.ts +1 -0
- package/lib/tests/rider-daily-report.test.js +86 -0
- package/lib/tests/rider-earnings.test.d.ts +1 -0
- package/lib/tests/rider-earnings.test.js +65 -0
- package/lib/tests/rider-report.test.d.ts +1 -0
- package/lib/tests/rider-report.test.js +98 -0
- package/package.json +10 -1
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
import { MATERIALIZED_DELIVERY_DISTANCE_BUCKETS } from '../../constants/MATERIALIZED_REPORTS';
|
|
2
|
+
/**
|
|
3
|
+
* M4 delivery - folding counters across days into a PERIOD document.
|
|
4
|
+
*
|
|
5
|
+
* ## What is additive, and what is NOT
|
|
6
|
+
*
|
|
7
|
+
* Additive: every count, every money total, every distance total, every timing sum, and
|
|
8
|
+
* the whole ADOPTION block. Adoption folds safely because each order belongs to exactly
|
|
9
|
+
* one day, so summing `delivery_order_count` / `delivered_via_app_count` / `off_app_count`
|
|
10
|
+
* across days preserves the set relationship - there is no double counting to worry about,
|
|
11
|
+
* which is why this report does NOT need to carry id sets through the fold the way the
|
|
12
|
+
* cash report carries a staff roster.
|
|
13
|
+
*
|
|
14
|
+
* NOT additive, and this is the trap: the rider leaderboard's `first_delivery_at` and
|
|
15
|
+
* `last_delivery_at`. A rider who worked two days must keep the EARLIEST first and the
|
|
16
|
+
* LATEST last, so the fold takes a MINIMUM and a MAXIMUM rather than a sum. Summing them
|
|
17
|
+
* (or taking the last one seen) silently reports a rider's tenure as starting after it
|
|
18
|
+
* did - the same class of error as summing a minimum in the prep time report.
|
|
19
|
+
*
|
|
20
|
+
* The distance HISTOGRAM folds by sum, bucket by bucket, because each delivery lands in
|
|
21
|
+
* exactly one bucket per document.
|
|
22
|
+
*/
|
|
23
|
+
const num = (value) => Number(value) || 0;
|
|
24
|
+
const earlierOf = (current, candidate) => {
|
|
25
|
+
const time = candidate == null ? NaN : new Date(candidate).getTime();
|
|
26
|
+
if (Number.isNaN(time))
|
|
27
|
+
return current;
|
|
28
|
+
if (current == null || time < new Date(current).getTime())
|
|
29
|
+
return new Date(time);
|
|
30
|
+
return current;
|
|
31
|
+
};
|
|
32
|
+
const laterOf = (current, candidate) => {
|
|
33
|
+
const time = candidate == null ? NaN : new Date(candidate).getTime();
|
|
34
|
+
if (Number.isNaN(time))
|
|
35
|
+
return current;
|
|
36
|
+
if (current == null || time > new Date(current).getTime())
|
|
37
|
+
return new Date(time);
|
|
38
|
+
return current;
|
|
39
|
+
};
|
|
40
|
+
/** Merges one rider row into another, MIN/MAX on the tenure bounds. */
|
|
41
|
+
function mergeRiderRow(target, source) {
|
|
42
|
+
target.count += num(source?.count);
|
|
43
|
+
target.completed_count += num(source?.completed_count);
|
|
44
|
+
target.cancelled_count += num(source?.cancelled_count);
|
|
45
|
+
target.in_progress_count += num(source?.in_progress_count);
|
|
46
|
+
target.rider_revenue_amount += num(source?.rider_revenue_amount);
|
|
47
|
+
target.distance_sum_meters += num(source?.distance_sum_meters);
|
|
48
|
+
target.rider_name ?? (target.rider_name = source?.rider_name ?? null);
|
|
49
|
+
// MIN / MAX - never a sum, and never just the newest document value.
|
|
50
|
+
target.first_delivery_at = earlierOf(target.first_delivery_at, source?.first_delivery_at);
|
|
51
|
+
target.last_delivery_at = laterOf(target.last_delivery_at, source?.last_delivery_at);
|
|
52
|
+
}
|
|
53
|
+
/** Merges one area row into another, summing the hour heat map. */
|
|
54
|
+
function mergeAreaRow(target, source) {
|
|
55
|
+
target.count += num(source?.count);
|
|
56
|
+
target.completed_count += num(source?.completed_count);
|
|
57
|
+
target.cancelled_count += num(source?.cancelled_count);
|
|
58
|
+
target.rider_revenue_amount += num(source?.rider_revenue_amount);
|
|
59
|
+
target.distance_sum_meters += num(source?.distance_sum_meters);
|
|
60
|
+
target.by_hour ?? (target.by_hour = {});
|
|
61
|
+
for (const [hour, value] of Object.entries(source?.by_hour ?? {})) {
|
|
62
|
+
target.by_hour[hour] = num(target.by_hour[hour]) + num(value);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Merges `source` into `target`, IN PLACE. Null-safe: a source block missing a sub-object
|
|
67
|
+
* is treated as zeroes rather than throwing, so one malformed historical document cannot
|
|
68
|
+
* break a whole period fold.
|
|
69
|
+
*/
|
|
70
|
+
export function mergeMaterializedDeliveryCounters(target, source) {
|
|
71
|
+
var _a, _b;
|
|
72
|
+
if (target == null || source == null)
|
|
73
|
+
return target;
|
|
74
|
+
const ta = target.adoption;
|
|
75
|
+
const sa = source.adoption;
|
|
76
|
+
if (ta != null && sa != null) {
|
|
77
|
+
ta.delivery_order_count += num(sa.delivery_order_count);
|
|
78
|
+
ta.delivered_via_app_count += num(sa.delivered_via_app_count);
|
|
79
|
+
ta.off_app_count += num(sa.off_app_count);
|
|
80
|
+
ta.tracking_enabled_count += num(sa.tracking_enabled_count);
|
|
81
|
+
ta.proof_pickup_count += num(sa.proof_pickup_count);
|
|
82
|
+
ta.proof_dropoff_count += num(sa.proof_dropoff_count);
|
|
83
|
+
}
|
|
84
|
+
const td = target.deliveries;
|
|
85
|
+
const sd = source.deliveries;
|
|
86
|
+
if (td != null && sd != null) {
|
|
87
|
+
td.count += num(sd.count);
|
|
88
|
+
td.pending_count += num(sd.pending_count);
|
|
89
|
+
td.assigned_count += num(sd.assigned_count);
|
|
90
|
+
td.in_progress_count += num(sd.in_progress_count);
|
|
91
|
+
td.completed_count += num(sd.completed_count);
|
|
92
|
+
td.cancelled_count += num(sd.cancelled_count);
|
|
93
|
+
td.cancel_reason_count += num(sd.cancel_reason_count);
|
|
94
|
+
}
|
|
95
|
+
const tm = target.money;
|
|
96
|
+
const sm = source.money;
|
|
97
|
+
if (tm != null && sm != null) {
|
|
98
|
+
tm.rider_revenue_amount += num(sm.rider_revenue_amount);
|
|
99
|
+
tm.rider_revenue_count += num(sm.rider_revenue_count);
|
|
100
|
+
tm.net_sale_amount += num(sm.net_sale_amount);
|
|
101
|
+
tm.collected_amount += num(sm.collected_amount);
|
|
102
|
+
tm.delivery_charge_amount += num(sm.delivery_charge_amount);
|
|
103
|
+
tm.delivery_charge_count += num(sm.delivery_charge_count);
|
|
104
|
+
tm.tip_amount += num(sm.tip_amount);
|
|
105
|
+
tm.discount_amount += num(sm.discount_amount);
|
|
106
|
+
tm.refund_amount += num(sm.refund_amount);
|
|
107
|
+
tm.tax_amount += num(sm.tax_amount);
|
|
108
|
+
}
|
|
109
|
+
if (target.distance != null && source.distance != null) {
|
|
110
|
+
const tDist = target.distance;
|
|
111
|
+
const sDist = source.distance;
|
|
112
|
+
tDist.sum_meters = num(tDist.sum_meters) + num(sDist.sum_meters);
|
|
113
|
+
tDist.count = num(tDist.count) + num(sDist.count);
|
|
114
|
+
for (const bucket of MATERIALIZED_DELIVERY_DISTANCE_BUCKETS) {
|
|
115
|
+
tDist[bucket.key] = num(tDist[bucket.key]) + num(sDist[bucket.key]);
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
if (target.timing != null && source.timing != null) {
|
|
119
|
+
const tt = target.timing;
|
|
120
|
+
const st = source.timing;
|
|
121
|
+
tt.graded_count += num(st.graded_count);
|
|
122
|
+
tt.dispatch_lag_sum_minutes += num(st.dispatch_lag_sum_minutes);
|
|
123
|
+
tt.complete_sum_minutes += num(st.complete_sum_minutes);
|
|
124
|
+
tt.total_sum_minutes += num(st.total_sum_minutes);
|
|
125
|
+
tt.exact_completion_count += num(st.exact_completion_count);
|
|
126
|
+
tt.assignment_sum_minutes += num(st.assignment_sum_minutes);
|
|
127
|
+
tt.assignment_count += num(st.assignment_count);
|
|
128
|
+
tt.pickup_wait_sum_minutes += num(st.pickup_wait_sum_minutes);
|
|
129
|
+
tt.pickup_wait_count += num(st.pickup_wait_count);
|
|
130
|
+
tt.transit_sum_minutes += num(st.transit_sum_minutes);
|
|
131
|
+
tt.transit_count += num(st.transit_count);
|
|
132
|
+
tt.cancel_sum_minutes += num(st.cancel_sum_minutes);
|
|
133
|
+
tt.cancel_count += num(st.cancel_count);
|
|
134
|
+
tt.cancelled_after_pickup_count += num(st.cancelled_after_pickup_count);
|
|
135
|
+
tt.status_updates_sum += num(st.status_updates_sum);
|
|
136
|
+
tt.status_updates_count += num(st.status_updates_count);
|
|
137
|
+
tt.promise_known_count += num(st.promise_known_count);
|
|
138
|
+
tt.on_time_count += num(st.on_time_count);
|
|
139
|
+
tt.late_count += num(st.late_count);
|
|
140
|
+
tt.late_minutes_sum += num(st.late_minutes_sum);
|
|
141
|
+
}
|
|
142
|
+
for (const [riderId, row] of Object.entries(source.riders ?? {})) {
|
|
143
|
+
target.riders ?? (target.riders = {});
|
|
144
|
+
(_a = target.riders)[riderId] ?? (_a[riderId] = {
|
|
145
|
+
rider_name: null,
|
|
146
|
+
count: 0,
|
|
147
|
+
completed_count: 0,
|
|
148
|
+
cancelled_count: 0,
|
|
149
|
+
in_progress_count: 0,
|
|
150
|
+
rider_revenue_amount: 0,
|
|
151
|
+
distance_sum_meters: 0,
|
|
152
|
+
first_delivery_at: null,
|
|
153
|
+
last_delivery_at: null,
|
|
154
|
+
});
|
|
155
|
+
mergeRiderRow(target.riders[riderId], row);
|
|
156
|
+
}
|
|
157
|
+
for (const [city, row] of Object.entries(source.areas ?? {})) {
|
|
158
|
+
target.areas ?? (target.areas = {});
|
|
159
|
+
(_b = target.areas)[city] ?? (_b[city] = {
|
|
160
|
+
count: 0,
|
|
161
|
+
completed_count: 0,
|
|
162
|
+
cancelled_count: 0,
|
|
163
|
+
rider_revenue_amount: 0,
|
|
164
|
+
distance_sum_meters: 0,
|
|
165
|
+
by_hour: {},
|
|
166
|
+
});
|
|
167
|
+
mergeAreaRow(target.areas[city], row);
|
|
168
|
+
}
|
|
169
|
+
return target;
|
|
170
|
+
}
|
|
@@ -0,0 +1,430 @@
|
|
|
1
|
+
import { DELIVERY_STATUS_ENUM, RIDER_EARNINGS_STATUS_ENUM } from '../../constants/enums/delivery';
|
|
2
|
+
import { MATERIALIZED_DELIVERY_AREA_LIMIT, MATERIALIZED_DELIVERY_DISTANCE_BUCKETS, MATERIALIZED_DELIVERY_RIDER_LIMIT, } from '../../constants/MATERIALIZED_REPORTS';
|
|
3
|
+
/**
|
|
4
|
+
* M4 delivery - key grammar, the order join, and the accumulators.
|
|
5
|
+
*
|
|
6
|
+
* ## Adoption is the headline, and it needs BOTH populations
|
|
7
|
+
*
|
|
8
|
+
* The `deliveries` collection is written ONLY by the rider app, so for a tenant that does
|
|
9
|
+
* not use it the collection is EMPTY. An empty collection renders as "no deliveries"
|
|
10
|
+
* rather than "no visibility" - which is why the counters always carry
|
|
11
|
+
* `delivery_order_count` (from the ORDERS stage) beside `delivered_via_app_count` (from the
|
|
12
|
+
* DELIVERIES stage). Neither stage alone can compute `off_app_count`.
|
|
13
|
+
*
|
|
14
|
+
* `off_app_count` is NOT an error state: it is the pool the rider app can win.
|
|
15
|
+
*
|
|
16
|
+
* ## The join
|
|
17
|
+
*
|
|
18
|
+
* A delivery document carries neither the platform nor the city, so the key
|
|
19
|
+
* `<PLATFORM>:<CITY>` and every order-derived money figure come from joining by
|
|
20
|
+
* `order_id`. An order with no platform/city details falls into an explicit UNKNOWN
|
|
21
|
+
* bucket rather than being dropped silently - a missing dimension must still show up in
|
|
22
|
+
* the totals.
|
|
23
|
+
*
|
|
24
|
+
* ## One order, N attempts
|
|
25
|
+
*
|
|
26
|
+
* The unique `order_id + rider_id` index allows a re-assignment to create a SECOND
|
|
27
|
+
* delivery for the same order. `deliveries.count` therefore counts ATTEMPTS while
|
|
28
|
+
* `delivery_order_count` counts ORDERS, and the two are deliberately not expected to
|
|
29
|
+
* match. `off_app_count` is computed from a SET difference so a reassigned order is never
|
|
30
|
+
* counted as off-app.
|
|
31
|
+
*/
|
|
32
|
+
/** The key token used when a dimension is missing, so nothing is silently dropped. */
|
|
33
|
+
export const DELIVERY_UNKNOWN_TOKEN = 'UNKNOWN';
|
|
34
|
+
export const MATERIALIZED_DELIVERY_KEY_SEPARATOR = ':';
|
|
35
|
+
/** Builds `<PLATFORM>:<CITY>`, substituting UNKNOWN for missing dimensions. */
|
|
36
|
+
export function buildMaterializedDeliveryKey(platform, city) {
|
|
37
|
+
return normalizeDimension(platform) + MATERIALIZED_DELIVERY_KEY_SEPARATOR + normalizeDimension(city);
|
|
38
|
+
}
|
|
39
|
+
function normalizeDimension(value) {
|
|
40
|
+
if (value == null)
|
|
41
|
+
return DELIVERY_UNKNOWN_TOKEN;
|
|
42
|
+
const text = String(value).trim();
|
|
43
|
+
if (text === '')
|
|
44
|
+
return DELIVERY_UNKNOWN_TOKEN;
|
|
45
|
+
// The separator must never appear inside a component, or the key is ambiguous;
|
|
46
|
+
// collapsing it to a dash keeps the row rather than dropping it.
|
|
47
|
+
return text.split(MATERIALIZED_DELIVERY_KEY_SEPARATOR).join('-');
|
|
48
|
+
}
|
|
49
|
+
/** Splits a key back into its parts, or null when it is malformed. */
|
|
50
|
+
export function parseMaterializedDeliveryKey(key) {
|
|
51
|
+
if (key == null)
|
|
52
|
+
return null;
|
|
53
|
+
const parts = String(key).split(MATERIALIZED_DELIVERY_KEY_SEPARATOR);
|
|
54
|
+
if (parts.length !== 2)
|
|
55
|
+
return null;
|
|
56
|
+
const [platform, city] = parts;
|
|
57
|
+
if (platform === '' || city === '')
|
|
58
|
+
return null;
|
|
59
|
+
return { platform, city };
|
|
60
|
+
}
|
|
61
|
+
const emptyRiderRow = (name) => ({
|
|
62
|
+
rider_name: name,
|
|
63
|
+
count: 0,
|
|
64
|
+
completed_count: 0,
|
|
65
|
+
cancelled_count: 0,
|
|
66
|
+
in_progress_count: 0,
|
|
67
|
+
rider_revenue_amount: 0,
|
|
68
|
+
distance_sum_meters: 0,
|
|
69
|
+
first_delivery_at: null,
|
|
70
|
+
last_delivery_at: null,
|
|
71
|
+
});
|
|
72
|
+
const emptyAreaRow = () => ({
|
|
73
|
+
count: 0,
|
|
74
|
+
completed_count: 0,
|
|
75
|
+
cancelled_count: 0,
|
|
76
|
+
rider_revenue_amount: 0,
|
|
77
|
+
distance_sum_meters: 0,
|
|
78
|
+
by_hour: {},
|
|
79
|
+
});
|
|
80
|
+
/** A zeroed counter block. */
|
|
81
|
+
export function freshDeliveryCounters() {
|
|
82
|
+
const distance = { sum_meters: 0, count: 0 };
|
|
83
|
+
for (const bucket of MATERIALIZED_DELIVERY_DISTANCE_BUCKETS)
|
|
84
|
+
distance[bucket.key] = 0;
|
|
85
|
+
return {
|
|
86
|
+
adoption: {
|
|
87
|
+
delivery_order_count: 0,
|
|
88
|
+
delivered_via_app_count: 0,
|
|
89
|
+
off_app_count: 0,
|
|
90
|
+
tracking_enabled_count: 0,
|
|
91
|
+
proof_pickup_count: 0,
|
|
92
|
+
proof_dropoff_count: 0,
|
|
93
|
+
},
|
|
94
|
+
deliveries: {
|
|
95
|
+
count: 0,
|
|
96
|
+
pending_count: 0,
|
|
97
|
+
assigned_count: 0,
|
|
98
|
+
in_progress_count: 0,
|
|
99
|
+
completed_count: 0,
|
|
100
|
+
cancelled_count: 0,
|
|
101
|
+
cancel_reason_count: 0,
|
|
102
|
+
},
|
|
103
|
+
money: {
|
|
104
|
+
rider_revenue_amount: 0,
|
|
105
|
+
rider_revenue_count: 0,
|
|
106
|
+
net_sale_amount: 0,
|
|
107
|
+
collected_amount: 0,
|
|
108
|
+
delivery_charge_amount: 0,
|
|
109
|
+
delivery_charge_count: 0,
|
|
110
|
+
tip_amount: 0,
|
|
111
|
+
discount_amount: 0,
|
|
112
|
+
refund_amount: 0,
|
|
113
|
+
tax_amount: 0,
|
|
114
|
+
},
|
|
115
|
+
distance: distance,
|
|
116
|
+
riders: {},
|
|
117
|
+
areas: {},
|
|
118
|
+
timing: {
|
|
119
|
+
graded_count: 0,
|
|
120
|
+
dispatch_lag_sum_minutes: 0,
|
|
121
|
+
complete_sum_minutes: 0,
|
|
122
|
+
total_sum_minutes: 0,
|
|
123
|
+
exact_completion_count: 0,
|
|
124
|
+
assignment_sum_minutes: 0,
|
|
125
|
+
assignment_count: 0,
|
|
126
|
+
pickup_wait_sum_minutes: 0,
|
|
127
|
+
pickup_wait_count: 0,
|
|
128
|
+
transit_sum_minutes: 0,
|
|
129
|
+
transit_count: 0,
|
|
130
|
+
cancel_sum_minutes: 0,
|
|
131
|
+
cancel_count: 0,
|
|
132
|
+
cancelled_after_pickup_count: 0,
|
|
133
|
+
status_updates_sum: 0,
|
|
134
|
+
status_updates_count: 0,
|
|
135
|
+
promise_known_count: 0,
|
|
136
|
+
on_time_count: 0,
|
|
137
|
+
late_count: 0,
|
|
138
|
+
late_minutes_sum: 0,
|
|
139
|
+
},
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
/** Which fixed distance bucket a metre value falls in. */
|
|
143
|
+
export function deliveryDistanceBucketKey(meters) {
|
|
144
|
+
const value = Math.abs(Number(meters) || 0);
|
|
145
|
+
for (const bucket of MATERIALIZED_DELIVERY_DISTANCE_BUCKETS) {
|
|
146
|
+
if (value >= bucket.min && (bucket.max == null || value < bucket.max))
|
|
147
|
+
return bucket.key;
|
|
148
|
+
}
|
|
149
|
+
const last = MATERIALIZED_DELIVERY_DISTANCE_BUCKETS[MATERIALIZED_DELIVERY_DISTANCE_BUCKETS.length - 1];
|
|
150
|
+
return last.key;
|
|
151
|
+
}
|
|
152
|
+
/** A fresh buffer. */
|
|
153
|
+
export function freshDeliveryAccumulator() {
|
|
154
|
+
return {
|
|
155
|
+
counters: freshDeliveryCounters(),
|
|
156
|
+
deliveryOrderIds: new Set(),
|
|
157
|
+
deliveredOrderIds: new Set(),
|
|
158
|
+
watermark: null,
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
const minutesBetween = (from, to) => {
|
|
162
|
+
const a = from == null ? NaN : new Date(from).getTime();
|
|
163
|
+
const b = to == null ? NaN : new Date(to).getTime();
|
|
164
|
+
if (Number.isNaN(a) || Number.isNaN(b))
|
|
165
|
+
return null;
|
|
166
|
+
return Math.round((b - a) / 60000);
|
|
167
|
+
};
|
|
168
|
+
const laterOf = (current, candidate) => {
|
|
169
|
+
const time = candidate == null ? NaN : new Date(candidate).getTime();
|
|
170
|
+
if (Number.isNaN(time))
|
|
171
|
+
return current;
|
|
172
|
+
if (current == null || time > current.getTime())
|
|
173
|
+
return new Date(time);
|
|
174
|
+
return current;
|
|
175
|
+
};
|
|
176
|
+
const earlierOf = (current, candidate) => {
|
|
177
|
+
const time = candidate == null ? NaN : new Date(candidate).getTime();
|
|
178
|
+
if (Number.isNaN(time))
|
|
179
|
+
return current;
|
|
180
|
+
if (current == null || time < current.getTime())
|
|
181
|
+
return new Date(time);
|
|
182
|
+
return current;
|
|
183
|
+
};
|
|
184
|
+
/** True when an order is a DELIVERY order (it has delivery details). */
|
|
185
|
+
export function isDeliveryOrder(order) {
|
|
186
|
+
return order?.delivery_details != null;
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* Consumes ONE delivery ORDER - the ADOPTION half of the join.
|
|
190
|
+
*
|
|
191
|
+
* Order-side money is counted HERE rather than on the delivery, because a cancelled
|
|
192
|
+
* delivery must not lose the order figures the operator recognises.
|
|
193
|
+
*/
|
|
194
|
+
export function addDeliveryOrder(acc, order) {
|
|
195
|
+
if (acc == null || order == null)
|
|
196
|
+
return;
|
|
197
|
+
const orderId = order._id == null ? null : String(order._id);
|
|
198
|
+
if (orderId == null)
|
|
199
|
+
return;
|
|
200
|
+
if (acc.deliveryOrderIds.has(orderId))
|
|
201
|
+
return;
|
|
202
|
+
acc.deliveryOrderIds.add(orderId);
|
|
203
|
+
const counters = acc.counters;
|
|
204
|
+
counters.adoption.delivery_order_count += 1;
|
|
205
|
+
const details = order.delivery_details ?? {};
|
|
206
|
+
counters.money.net_sale_amount += Number(order.net_sale_amount ?? order.amount_earned) || 0;
|
|
207
|
+
counters.money.collected_amount += Number(order.amount_collected) || 0;
|
|
208
|
+
counters.money.tip_amount += Number(order.tip_amount) || 0;
|
|
209
|
+
counters.money.discount_amount += Number(order.total_discount_applied) || 0;
|
|
210
|
+
counters.money.refund_amount += Number(order.amount_refunded) || 0;
|
|
211
|
+
counters.money.tax_amount += (Number(order.gst_amount) || 0) + (Number(order.tax_amount) || 0);
|
|
212
|
+
// `delivery_cost` is the field IOrderDeliveryDetails ACTUALLY declares; the other two
|
|
213
|
+
// names are tolerated fallbacks. Reading the wrong one silently reported every charge
|
|
214
|
+
// as ZERO while the statement row (which used the right field) showed the real value -
|
|
215
|
+
// an inconsistency the formatter test caught.
|
|
216
|
+
const charge = Number(details.delivery_cost ?? details.delivery_charge ?? details.delivery_charge_amount) || 0;
|
|
217
|
+
if (charge !== 0) {
|
|
218
|
+
counters.money.delivery_charge_amount += charge;
|
|
219
|
+
counters.money.delivery_charge_count += 1;
|
|
220
|
+
}
|
|
221
|
+
acc.watermark = laterOf(acc.watermark, order.updatedAt ?? order.createdAt);
|
|
222
|
+
}
|
|
223
|
+
/**
|
|
224
|
+
* Consumes ONE delivery document - the APP-SIDE half of the join.
|
|
225
|
+
*
|
|
226
|
+
* `order` may be null (the order was not staged): the delivery still counts toward
|
|
227
|
+
* adoption and its own fields, but the order-derived money and the area cannot be
|
|
228
|
+
* attributed, so it lands in the UNKNOWN bucket.
|
|
229
|
+
*/
|
|
230
|
+
export function addDelivery(acc, delivery, order, key) {
|
|
231
|
+
var _a, _b;
|
|
232
|
+
if (acc == null || delivery == null)
|
|
233
|
+
return;
|
|
234
|
+
const counters = acc.counters;
|
|
235
|
+
const orderId = delivery.order_id == null ? null : String(delivery.order_id);
|
|
236
|
+
if (orderId != null)
|
|
237
|
+
acc.deliveredOrderIds.add(orderId);
|
|
238
|
+
counters.deliveries.count += 1;
|
|
239
|
+
const status = String(delivery.status ?? '');
|
|
240
|
+
if (status === DELIVERY_STATUS_ENUM.PENDING)
|
|
241
|
+
counters.deliveries.pending_count += 1;
|
|
242
|
+
else if (status === DELIVERY_STATUS_ENUM.ASSIGNED)
|
|
243
|
+
counters.deliveries.assigned_count += 1;
|
|
244
|
+
else if (status === DELIVERY_STATUS_ENUM.IN_PROGRESS)
|
|
245
|
+
counters.deliveries.in_progress_count += 1;
|
|
246
|
+
else if (status === DELIVERY_STATUS_ENUM.COMPLETED)
|
|
247
|
+
counters.deliveries.completed_count += 1;
|
|
248
|
+
else if (status === DELIVERY_STATUS_ENUM.CANCELLED)
|
|
249
|
+
counters.deliveries.cancelled_count += 1;
|
|
250
|
+
if (status === DELIVERY_STATUS_ENUM.CANCELLED && delivery.cancel_reason != null) {
|
|
251
|
+
counters.deliveries.cancel_reason_count += 1;
|
|
252
|
+
}
|
|
253
|
+
if (delivery.tracking_enabled === true)
|
|
254
|
+
counters.adoption.tracking_enabled_count += 1;
|
|
255
|
+
if (delivery.pickup_food_image_url != null)
|
|
256
|
+
counters.adoption.proof_pickup_count += 1;
|
|
257
|
+
if (delivery.dropoff_food_image_url != null)
|
|
258
|
+
counters.adoption.proof_dropoff_count += 1;
|
|
259
|
+
// Only a FINAL snapshot is payout. A PENDING snapshot is an estimate shown to
|
|
260
|
+
// the rider before completion and must not inflate the materialized report.
|
|
261
|
+
const earnings = delivery.rider_earnings;
|
|
262
|
+
const revenue = Number(earnings != null
|
|
263
|
+
? earnings.status === RIDER_EARNINGS_STATUS_ENUM.FINAL
|
|
264
|
+
? earnings.amount
|
|
265
|
+
: 0
|
|
266
|
+
: delivery.rider_revenue);
|
|
267
|
+
const hasRevenue = Number.isFinite(revenue);
|
|
268
|
+
if (hasRevenue) {
|
|
269
|
+
counters.money.rider_revenue_amount += revenue;
|
|
270
|
+
counters.money.rider_revenue_count += 1;
|
|
271
|
+
}
|
|
272
|
+
const meters = Number(delivery.distance_in_meters_from_store) || 0;
|
|
273
|
+
counters.distance.sum_meters += meters;
|
|
274
|
+
counters.distance.count += 1;
|
|
275
|
+
const bucketKey = deliveryDistanceBucketKey(meters);
|
|
276
|
+
const distanceRecord = counters.distance;
|
|
277
|
+
distanceRecord[bucketKey] = (distanceRecord[bucketKey] ?? 0) + 1;
|
|
278
|
+
// ---- the bounded rider leaderboard ----
|
|
279
|
+
const riderId = delivery.rider_id == null ? null : String(delivery.rider_id);
|
|
280
|
+
if (riderId != null) {
|
|
281
|
+
counters.riders ?? (counters.riders = {});
|
|
282
|
+
const row = ((_a = counters.riders)[riderId] ?? (_a[riderId] = emptyRiderRow(delivery.rider_name == null ? null : String(delivery.rider_name))));
|
|
283
|
+
row.count += 1;
|
|
284
|
+
if (status === DELIVERY_STATUS_ENUM.COMPLETED)
|
|
285
|
+
row.completed_count += 1;
|
|
286
|
+
else if (status === DELIVERY_STATUS_ENUM.CANCELLED)
|
|
287
|
+
row.cancelled_count += 1;
|
|
288
|
+
else if (status === DELIVERY_STATUS_ENUM.IN_PROGRESS)
|
|
289
|
+
row.in_progress_count += 1;
|
|
290
|
+
if (hasRevenue)
|
|
291
|
+
row.rider_revenue_amount += revenue;
|
|
292
|
+
row.distance_sum_meters += meters;
|
|
293
|
+
row.first_delivery_at = earlierOf(row.first_delivery_at, delivery.createdAt);
|
|
294
|
+
row.last_delivery_at = laterOf(row.last_delivery_at, delivery.createdAt);
|
|
295
|
+
}
|
|
296
|
+
// ---- the bounded area heat map (city from the JOIN) ----
|
|
297
|
+
const parsed = parseMaterializedDeliveryKey(key);
|
|
298
|
+
const city = parsed == null ? DELIVERY_UNKNOWN_TOKEN : parsed.city;
|
|
299
|
+
counters.areas ?? (counters.areas = {});
|
|
300
|
+
const area = ((_b = counters.areas)[city] ?? (_b[city] = emptyAreaRow()));
|
|
301
|
+
area.count += 1;
|
|
302
|
+
if (status === DELIVERY_STATUS_ENUM.COMPLETED)
|
|
303
|
+
area.completed_count += 1;
|
|
304
|
+
else if (status === DELIVERY_STATUS_ENUM.CANCELLED)
|
|
305
|
+
area.cancelled_count += 1;
|
|
306
|
+
if (hasRevenue)
|
|
307
|
+
area.rider_revenue_amount += revenue;
|
|
308
|
+
area.distance_sum_meters += meters;
|
|
309
|
+
const hour = hourKeyOf(delivery);
|
|
310
|
+
if (hour != null)
|
|
311
|
+
area.by_hour[hour] = (area.by_hour[hour] ?? 0) + 1;
|
|
312
|
+
// ---- timing ----
|
|
313
|
+
const timing = (counters.timing ?? (counters.timing = freshDeliveryCounters().timing));
|
|
314
|
+
let graded = false;
|
|
315
|
+
const orderCreatedAt = order?.createdAt ?? null;
|
|
316
|
+
const dispatchLag = minutesBetween(orderCreatedAt, delivery.createdAt);
|
|
317
|
+
if (dispatchLag != null) {
|
|
318
|
+
timing.dispatch_lag_sum_minutes += dispatchLag;
|
|
319
|
+
graded = true;
|
|
320
|
+
}
|
|
321
|
+
if (status === DELIVERY_STATUS_ENUM.COMPLETED) {
|
|
322
|
+
// `delivered_at` is EXACT once the capture has run; before that the only available
|
|
323
|
+
// instant is `updatedAt`, which moves on ANY later mutation - so the report records
|
|
324
|
+
// WHICH one it used rather than presenting a proxy as exact.
|
|
325
|
+
const exact = delivery.delivered_at != null;
|
|
326
|
+
const completedAt = exact ? delivery.delivered_at : delivery.updatedAt;
|
|
327
|
+
const complete = minutesBetween(delivery.createdAt, completedAt);
|
|
328
|
+
if (complete != null) {
|
|
329
|
+
timing.complete_sum_minutes += complete;
|
|
330
|
+
graded = true;
|
|
331
|
+
if (exact)
|
|
332
|
+
timing.exact_completion_count += 1;
|
|
333
|
+
}
|
|
334
|
+
const total = minutesBetween(orderCreatedAt, completedAt);
|
|
335
|
+
if (total != null)
|
|
336
|
+
timing.total_sum_minutes += total;
|
|
337
|
+
// Explicit ETA only. ASAP orders need tenant settings the compile does not
|
|
338
|
+
// receive, so they stay UNMEASURED rather than being given an invented promise.
|
|
339
|
+
const expectedRaw = delivery.expected_delivery_at ?? order?.delivery_details?.estimated_delivery_time;
|
|
340
|
+
const deliveredRaw = delivery.delivered_at;
|
|
341
|
+
if (expectedRaw != null && deliveredRaw != null) {
|
|
342
|
+
const expected = new Date(expectedRaw).getTime();
|
|
343
|
+
const delivered = new Date(deliveredRaw).getTime();
|
|
344
|
+
if (!Number.isNaN(expected) && !Number.isNaN(delivered)) {
|
|
345
|
+
timing.promise_known_count += 1;
|
|
346
|
+
if (delivered <= expected) {
|
|
347
|
+
timing.on_time_count += 1;
|
|
348
|
+
}
|
|
349
|
+
else {
|
|
350
|
+
timing.late_count += 1;
|
|
351
|
+
timing.late_minutes_sum += Math.round((delivered - expected) / 60000);
|
|
352
|
+
}
|
|
353
|
+
}
|
|
354
|
+
}
|
|
355
|
+
}
|
|
356
|
+
if (graded)
|
|
357
|
+
timing.graded_count += 1;
|
|
358
|
+
// ---- captured stage timings / churn ----
|
|
359
|
+
const assignment = minutesBetween(delivery.createdAt, delivery.assigned_at);
|
|
360
|
+
if (assignment != null) {
|
|
361
|
+
timing.assignment_sum_minutes += assignment;
|
|
362
|
+
timing.assignment_count += 1;
|
|
363
|
+
}
|
|
364
|
+
const pickupWait = minutesBetween(delivery.assigned_at, delivery.picked_up_at);
|
|
365
|
+
if (pickupWait != null) {
|
|
366
|
+
timing.pickup_wait_sum_minutes += pickupWait;
|
|
367
|
+
timing.pickup_wait_count += 1;
|
|
368
|
+
}
|
|
369
|
+
const transit = minutesBetween(delivery.picked_up_at, delivery.delivered_at);
|
|
370
|
+
if (transit != null) {
|
|
371
|
+
timing.transit_sum_minutes += transit;
|
|
372
|
+
timing.transit_count += 1;
|
|
373
|
+
}
|
|
374
|
+
const cancel = minutesBetween(delivery.createdAt, delivery.cancelled_at);
|
|
375
|
+
if (cancel != null) {
|
|
376
|
+
timing.cancel_sum_minutes += cancel;
|
|
377
|
+
timing.cancel_count += 1;
|
|
378
|
+
}
|
|
379
|
+
if (status === DELIVERY_STATUS_ENUM.CANCELLED && delivery.picked_up_at != null) {
|
|
380
|
+
timing.cancelled_after_pickup_count += 1;
|
|
381
|
+
}
|
|
382
|
+
if (delivery.status_updated_count != null) {
|
|
383
|
+
timing.status_updates_sum += Number(delivery.status_updated_count) || 0;
|
|
384
|
+
timing.status_updates_count += 1;
|
|
385
|
+
}
|
|
386
|
+
acc.watermark = laterOf(acc.watermark, delivery.updatedAt ?? delivery.createdAt);
|
|
387
|
+
}
|
|
388
|
+
/** `HH` of a delivery, from the local hour when present. */
|
|
389
|
+
function hourKeyOf(delivery) {
|
|
390
|
+
const explicit = delivery.localHour;
|
|
391
|
+
if (typeof explicit === 'number' && Number.isFinite(explicit)) {
|
|
392
|
+
return String(Math.max(0, Math.min(23, Math.floor(explicit)))).padStart(2, '0');
|
|
393
|
+
}
|
|
394
|
+
const raw = delivery.createdAt;
|
|
395
|
+
if (raw == null)
|
|
396
|
+
return null;
|
|
397
|
+
const date = new Date(raw);
|
|
398
|
+
if (Number.isNaN(date.getTime()))
|
|
399
|
+
return null;
|
|
400
|
+
return String(date.getHours()).padStart(2, '0');
|
|
401
|
+
}
|
|
402
|
+
/**
|
|
403
|
+
* Computes the DERIVED adoption figures and prunes the bounded maps.
|
|
404
|
+
*
|
|
405
|
+
* Call ONCE per key, after both stages have been consumed. `off_app_count` is a set
|
|
406
|
+
* difference, so an order reassigned to a second rider is NOT counted as off-app even
|
|
407
|
+
* though there are more deliveries than orders.
|
|
408
|
+
*/
|
|
409
|
+
export function finalizeDeliveryAccumulator(acc) {
|
|
410
|
+
const counters = acc.counters;
|
|
411
|
+
const deliveredOrders = [...acc.deliveredOrderIds].filter((id) => acc.deliveryOrderIds.has(id)).length;
|
|
412
|
+
counters.adoption.delivered_via_app_count = deliveredOrders;
|
|
413
|
+
counters.adoption.off_app_count = Math.max(0, acc.deliveryOrderIds.size - deliveredOrders);
|
|
414
|
+
counters.riders = pruneMap(counters.riders, MATERIALIZED_DELIVERY_RIDER_LIMIT, (row) => Number(row.count) || 0);
|
|
415
|
+
counters.areas = pruneMap(counters.areas, MATERIALIZED_DELIVERY_AREA_LIMIT, (row) => Number(row.count) || 0);
|
|
416
|
+
return counters;
|
|
417
|
+
}
|
|
418
|
+
/** Keeps the N busiest entries, so a document stays bounded. */
|
|
419
|
+
function pruneMap(source, limit, weightOf) {
|
|
420
|
+
if (source == null)
|
|
421
|
+
return null;
|
|
422
|
+
const entries = Object.entries(source);
|
|
423
|
+
if (entries.length <= limit)
|
|
424
|
+
return source;
|
|
425
|
+
entries.sort((a, b) => weightOf(b[1]) - weightOf(a[1]));
|
|
426
|
+
const kept = {};
|
|
427
|
+
for (const [key, value] of entries.slice(0, limit))
|
|
428
|
+
kept[key] = value;
|
|
429
|
+
return kept;
|
|
430
|
+
}
|