@managesome/eposmatic-toolkit 0.4.7 → 0.4.8
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 +33 -0
- package/esm/helpers/materialized-reports/index.js +1 -0
- package/esm/helpers/materialized-reports/materialized-credit-bills-helpers.js +982 -0
- package/esm/helpers/materialized-reports/materialized-reports-selection-helpers.js +276 -33
- package/esm/helpers/materialized-reports/tenant-sales-overview-close-day-helpers.js +327 -41
- package/esm/helpers/materialized-reports/tenant-sales-overview-formatter.js +72 -11
- package/esm/helpers/materialized-reports/tenant-sales-overview-helpers.js +118 -235
- package/esm/schemas/models/index.js +1 -0
- package/esm/schemas/models/materialized_credit_bills.js +265 -0
- package/esm/schemas/models/materialized_tenant_reports_iterations.js +13 -0
- package/esm/schemas/models/materialized_tenant_sales_overview_reports.js +39 -97
- package/esm/schemas/types/index.js +1 -0
- package/esm/schemas/types/materialized_credit_bills.js +1 -0
- package/lib/constants/MATERIALIZED_REPORTS.d.ts +28 -2
- package/lib/constants/MATERIALIZED_REPORTS.js +34 -1
- package/lib/helpers/materialized-reports/index.d.ts +1 -0
- package/lib/helpers/materialized-reports/index.js +1 -0
- package/lib/helpers/materialized-reports/materialized-credit-bills-helpers.d.ts +307 -0
- package/lib/helpers/materialized-reports/materialized-credit-bills-helpers.js +1003 -0
- package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.d.ts +36 -2
- package/lib/helpers/materialized-reports/materialized-reports-selection-helpers.js +278 -34
- package/lib/helpers/materialized-reports/tenant-sales-overview-close-day-helpers.d.ts +66 -8
- package/lib/helpers/materialized-reports/tenant-sales-overview-close-day-helpers.js +326 -40
- package/lib/helpers/materialized-reports/tenant-sales-overview-formatter.d.ts +18 -2
- package/lib/helpers/materialized-reports/tenant-sales-overview-formatter.js +72 -11
- package/lib/helpers/materialized-reports/tenant-sales-overview-helpers.d.ts +46 -37
- package/lib/helpers/materialized-reports/tenant-sales-overview-helpers.js +119 -238
- package/lib/helpers/types/materialized-reports-apis.d.ts +32 -5
- package/lib/schemas/models/index.d.ts +1 -0
- package/lib/schemas/models/index.js +1 -0
- package/lib/schemas/models/materialized_credit_bills.d.ts +337 -0
- package/lib/schemas/models/materialized_credit_bills.js +268 -0
- package/lib/schemas/models/materialized_tenant_reports_iterations.d.ts +20 -6
- package/lib/schemas/models/materialized_tenant_reports_iterations.js +14 -1
- package/lib/schemas/models/materialized_tenant_sales_overview_reports.d.ts +37 -165
- package/lib/schemas/models/materialized_tenant_sales_overview_reports.js +40 -98
- package/lib/schemas/types/index.d.ts +1 -0
- package/lib/schemas/types/index.js +1 -0
- package/lib/schemas/types/materialized_credit_bills.d.ts +139 -0
- package/lib/schemas/types/materialized_credit_bills.js +2 -0
- package/lib/schemas/types/materialized_tenant_sales_overview_reports.d.ts +32 -77
- package/lib/tests/materialized-reports/materialized-credit-bills-helpers.test.d.ts +1 -0
- package/lib/tests/materialized-reports/materialized-credit-bills-helpers.test.js +715 -0
- package/lib/tests/materialized-reports/materialized-reports-selection-helpers.test.js +96 -0
- package/lib/tests/materialized-reports/materialized-tenant-reports-iterations-schema.test.js +9 -0
- package/lib/tests/materialized-reports/materialized-tenant-sales-overview-reports-schema.test.js +23 -24
- package/lib/tests/materialized-reports/tenant-sales-overview-close-day-helpers.test.js +327 -22
- package/lib/tests/materialized-reports/tenant-sales-overview-formatter-aggregated.test.js +27 -2
- package/lib/tests/materialized-reports/tenant-sales-overview-formatter.test.js +12 -27
- package/lib/tests/materialized-reports/tenant-sales-overview-helpers.test.js +79 -146
- package/package.json +1 -1
|
@@ -9,17 +9,20 @@ import { Schema } from 'mongoose';
|
|
|
9
9
|
* `MATERIALIZED_REPORTS.md`). The report's time-bias toggle (Punched At /
|
|
10
10
|
* `createdAt`) is out of scope. `scope_field` formats are documented on
|
|
11
11
|
* `MATERIALIZED_REPORT_SCOPE_ENUM` and in `MATERIALIZED_REPORTS.md`.
|
|
12
|
-
*
|
|
13
|
-
* `CREDIT_BILLS` slot
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
12
|
+
* NUMBERS ONLY: credit-bill COUNTERS (issued / settled / received) live in
|
|
13
|
+
* each `sale_type_metrics` key's `CREDIT_BILLS` slot — constant-size numbers.
|
|
14
|
+
* The ITEMIZED ledger (one row per bill + its receipt events) lives in the
|
|
15
|
+
* SHARED `materialized_tenant_credit_bills` collection, so these documents carry no
|
|
16
|
+
* bill rows/ids and their size no longer grows with the ledger over time.
|
|
17
|
+
* Iteration history (every structural write's full post-write snapshot)
|
|
18
|
+
* lives in the shared `materialized_tenant_reports_iterations` collection.
|
|
17
19
|
*/
|
|
18
20
|
/**
|
|
19
21
|
* Version of the key grammar + metric rules of this collection. Bump when
|
|
20
22
|
* `sale_type_key_filters`, their order, or metric semantics change —
|
|
21
23
|
* historical documents must then be re-materialized (readers may branch on
|
|
22
|
-
* this value during a rollout).
|
|
24
|
+
* this value during a rollout). PRE-RELEASE: the collection has no live
|
|
25
|
+
* tenants/consumers yet, so every change so far folds into version `1`.
|
|
23
26
|
*/
|
|
24
27
|
export declare const MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_SCHEMA_VERSION = 1;
|
|
25
28
|
export declare const MaterializedTenantSalesOverviewReportSchema: Schema<any, import("mongoose").Model<any, any, any, any, any, any>, {}, {}, {}, {}, {
|
|
@@ -37,10 +40,12 @@ export declare const MaterializedTenantSalesOverviewReportSchema: Schema<any, im
|
|
|
37
40
|
brand_id: string;
|
|
38
41
|
day_index: import("../../constants").DAY_INDEX_ENUM;
|
|
39
42
|
iteration: number;
|
|
40
|
-
schema_version: number;
|
|
41
43
|
scope_context: import("../../constants").MATERIALIZED_REPORT_SCOPE_ENUM;
|
|
42
44
|
scope_field: string;
|
|
43
45
|
sale_type_key_filters: string[];
|
|
46
|
+
schema_version: number;
|
|
47
|
+
source_watermark: NativeDate;
|
|
48
|
+
computed_at: NativeDate;
|
|
44
49
|
sale_type_metrics: Map<string, {
|
|
45
50
|
TOTAL_SALES: {
|
|
46
51
|
orders: {
|
|
@@ -132,65 +137,13 @@ export declare const MaterializedTenantSalesOverviewReportSchema: Schema<any, im
|
|
|
132
137
|
amount: number;
|
|
133
138
|
settled_count: number;
|
|
134
139
|
settled_amount: number;
|
|
135
|
-
bills: import("mongoose").Types.DocumentArray<{
|
|
136
|
-
order_id: string;
|
|
137
|
-
payment_id: string;
|
|
138
|
-
amount: number;
|
|
139
|
-
received_amount: number;
|
|
140
|
-
credit_note: string;
|
|
141
|
-
issued_at: NativeDate;
|
|
142
|
-
settled_at: NativeDate;
|
|
143
|
-
}, import("mongoose").Types.Subdocument<import("mongoose").Types.ObjectId, any, {
|
|
144
|
-
order_id: string;
|
|
145
|
-
payment_id: string;
|
|
146
|
-
amount: number;
|
|
147
|
-
received_amount: number;
|
|
148
|
-
credit_note: string;
|
|
149
|
-
issued_at: NativeDate;
|
|
150
|
-
settled_at: NativeDate;
|
|
151
|
-
}> & {
|
|
152
|
-
order_id: string;
|
|
153
|
-
payment_id: string;
|
|
154
|
-
amount: number;
|
|
155
|
-
received_amount: number;
|
|
156
|
-
credit_note: string;
|
|
157
|
-
issued_at: NativeDate;
|
|
158
|
-
settled_at: NativeDate;
|
|
159
|
-
}>;
|
|
160
140
|
} | null | undefined;
|
|
161
141
|
received?: {
|
|
162
142
|
count: number;
|
|
163
143
|
amount: number;
|
|
164
|
-
bills: import("mongoose").Types.DocumentArray<{
|
|
165
|
-
order_id: string;
|
|
166
|
-
payment_id: string;
|
|
167
|
-
amount: number;
|
|
168
|
-
received_amount: number;
|
|
169
|
-
credit_note: string;
|
|
170
|
-
settled_at: NativeDate;
|
|
171
|
-
issued_local_date: string;
|
|
172
|
-
}, import("mongoose").Types.Subdocument<import("mongoose").Types.ObjectId, any, {
|
|
173
|
-
order_id: string;
|
|
174
|
-
payment_id: string;
|
|
175
|
-
amount: number;
|
|
176
|
-
received_amount: number;
|
|
177
|
-
credit_note: string;
|
|
178
|
-
settled_at: NativeDate;
|
|
179
|
-
issued_local_date: string;
|
|
180
|
-
}> & {
|
|
181
|
-
order_id: string;
|
|
182
|
-
payment_id: string;
|
|
183
|
-
amount: number;
|
|
184
|
-
received_amount: number;
|
|
185
|
-
credit_note: string;
|
|
186
|
-
settled_at: NativeDate;
|
|
187
|
-
issued_local_date: string;
|
|
188
|
-
}>;
|
|
189
144
|
} | null | undefined;
|
|
190
145
|
};
|
|
191
146
|
}>;
|
|
192
|
-
source_watermark: NativeDate;
|
|
193
|
-
computed_at: NativeDate;
|
|
194
147
|
}, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<{
|
|
195
148
|
createdAt: NativeDate;
|
|
196
149
|
updatedAt: NativeDate;
|
|
@@ -202,10 +155,12 @@ export declare const MaterializedTenantSalesOverviewReportSchema: Schema<any, im
|
|
|
202
155
|
brand_id: string;
|
|
203
156
|
day_index: import("../../constants").DAY_INDEX_ENUM;
|
|
204
157
|
iteration: number;
|
|
205
|
-
schema_version: number;
|
|
206
158
|
scope_context: import("../../constants").MATERIALIZED_REPORT_SCOPE_ENUM;
|
|
207
159
|
scope_field: string;
|
|
208
160
|
sale_type_key_filters: string[];
|
|
161
|
+
schema_version: number;
|
|
162
|
+
source_watermark: NativeDate;
|
|
163
|
+
computed_at: NativeDate;
|
|
209
164
|
sale_type_metrics: Map<string, {
|
|
210
165
|
TOTAL_SALES: {
|
|
211
166
|
orders: {
|
|
@@ -297,65 +252,13 @@ export declare const MaterializedTenantSalesOverviewReportSchema: Schema<any, im
|
|
|
297
252
|
amount: number;
|
|
298
253
|
settled_count: number;
|
|
299
254
|
settled_amount: number;
|
|
300
|
-
bills: import("mongoose").Types.DocumentArray<{
|
|
301
|
-
order_id: string;
|
|
302
|
-
payment_id: string;
|
|
303
|
-
amount: number;
|
|
304
|
-
received_amount: number;
|
|
305
|
-
credit_note: string;
|
|
306
|
-
issued_at: NativeDate;
|
|
307
|
-
settled_at: NativeDate;
|
|
308
|
-
}, import("mongoose").Types.Subdocument<import("mongoose").Types.ObjectId, any, {
|
|
309
|
-
order_id: string;
|
|
310
|
-
payment_id: string;
|
|
311
|
-
amount: number;
|
|
312
|
-
received_amount: number;
|
|
313
|
-
credit_note: string;
|
|
314
|
-
issued_at: NativeDate;
|
|
315
|
-
settled_at: NativeDate;
|
|
316
|
-
}> & {
|
|
317
|
-
order_id: string;
|
|
318
|
-
payment_id: string;
|
|
319
|
-
amount: number;
|
|
320
|
-
received_amount: number;
|
|
321
|
-
credit_note: string;
|
|
322
|
-
issued_at: NativeDate;
|
|
323
|
-
settled_at: NativeDate;
|
|
324
|
-
}>;
|
|
325
255
|
} | null | undefined;
|
|
326
256
|
received?: {
|
|
327
257
|
count: number;
|
|
328
258
|
amount: number;
|
|
329
|
-
bills: import("mongoose").Types.DocumentArray<{
|
|
330
|
-
order_id: string;
|
|
331
|
-
payment_id: string;
|
|
332
|
-
amount: number;
|
|
333
|
-
received_amount: number;
|
|
334
|
-
credit_note: string;
|
|
335
|
-
settled_at: NativeDate;
|
|
336
|
-
issued_local_date: string;
|
|
337
|
-
}, import("mongoose").Types.Subdocument<import("mongoose").Types.ObjectId, any, {
|
|
338
|
-
order_id: string;
|
|
339
|
-
payment_id: string;
|
|
340
|
-
amount: number;
|
|
341
|
-
received_amount: number;
|
|
342
|
-
credit_note: string;
|
|
343
|
-
settled_at: NativeDate;
|
|
344
|
-
issued_local_date: string;
|
|
345
|
-
}> & {
|
|
346
|
-
order_id: string;
|
|
347
|
-
payment_id: string;
|
|
348
|
-
amount: number;
|
|
349
|
-
received_amount: number;
|
|
350
|
-
credit_note: string;
|
|
351
|
-
settled_at: NativeDate;
|
|
352
|
-
issued_local_date: string;
|
|
353
|
-
}>;
|
|
354
259
|
} | null | undefined;
|
|
355
260
|
};
|
|
356
261
|
}>;
|
|
357
|
-
source_watermark: NativeDate;
|
|
358
|
-
computed_at: NativeDate;
|
|
359
262
|
}>> & import("mongoose").FlatRecord<{
|
|
360
263
|
createdAt: NativeDate;
|
|
361
264
|
updatedAt: NativeDate;
|
|
@@ -367,10 +270,12 @@ export declare const MaterializedTenantSalesOverviewReportSchema: Schema<any, im
|
|
|
367
270
|
brand_id: string;
|
|
368
271
|
day_index: import("../../constants").DAY_INDEX_ENUM;
|
|
369
272
|
iteration: number;
|
|
370
|
-
schema_version: number;
|
|
371
273
|
scope_context: import("../../constants").MATERIALIZED_REPORT_SCOPE_ENUM;
|
|
372
274
|
scope_field: string;
|
|
373
275
|
sale_type_key_filters: string[];
|
|
276
|
+
schema_version: number;
|
|
277
|
+
source_watermark: NativeDate;
|
|
278
|
+
computed_at: NativeDate;
|
|
374
279
|
sale_type_metrics: Map<string, {
|
|
375
280
|
TOTAL_SALES: {
|
|
376
281
|
orders: {
|
|
@@ -462,65 +367,13 @@ export declare const MaterializedTenantSalesOverviewReportSchema: Schema<any, im
|
|
|
462
367
|
amount: number;
|
|
463
368
|
settled_count: number;
|
|
464
369
|
settled_amount: number;
|
|
465
|
-
bills: import("mongoose").Types.DocumentArray<{
|
|
466
|
-
order_id: string;
|
|
467
|
-
payment_id: string;
|
|
468
|
-
amount: number;
|
|
469
|
-
received_amount: number;
|
|
470
|
-
credit_note: string;
|
|
471
|
-
issued_at: NativeDate;
|
|
472
|
-
settled_at: NativeDate;
|
|
473
|
-
}, import("mongoose").Types.Subdocument<import("mongoose").Types.ObjectId, any, {
|
|
474
|
-
order_id: string;
|
|
475
|
-
payment_id: string;
|
|
476
|
-
amount: number;
|
|
477
|
-
received_amount: number;
|
|
478
|
-
credit_note: string;
|
|
479
|
-
issued_at: NativeDate;
|
|
480
|
-
settled_at: NativeDate;
|
|
481
|
-
}> & {
|
|
482
|
-
order_id: string;
|
|
483
|
-
payment_id: string;
|
|
484
|
-
amount: number;
|
|
485
|
-
received_amount: number;
|
|
486
|
-
credit_note: string;
|
|
487
|
-
issued_at: NativeDate;
|
|
488
|
-
settled_at: NativeDate;
|
|
489
|
-
}>;
|
|
490
370
|
} | null | undefined;
|
|
491
371
|
received?: {
|
|
492
372
|
count: number;
|
|
493
373
|
amount: number;
|
|
494
|
-
bills: import("mongoose").Types.DocumentArray<{
|
|
495
|
-
order_id: string;
|
|
496
|
-
payment_id: string;
|
|
497
|
-
amount: number;
|
|
498
|
-
received_amount: number;
|
|
499
|
-
credit_note: string;
|
|
500
|
-
settled_at: NativeDate;
|
|
501
|
-
issued_local_date: string;
|
|
502
|
-
}, import("mongoose").Types.Subdocument<import("mongoose").Types.ObjectId, any, {
|
|
503
|
-
order_id: string;
|
|
504
|
-
payment_id: string;
|
|
505
|
-
amount: number;
|
|
506
|
-
received_amount: number;
|
|
507
|
-
credit_note: string;
|
|
508
|
-
settled_at: NativeDate;
|
|
509
|
-
issued_local_date: string;
|
|
510
|
-
}> & {
|
|
511
|
-
order_id: string;
|
|
512
|
-
payment_id: string;
|
|
513
|
-
amount: number;
|
|
514
|
-
received_amount: number;
|
|
515
|
-
credit_note: string;
|
|
516
|
-
settled_at: NativeDate;
|
|
517
|
-
issued_local_date: string;
|
|
518
|
-
}>;
|
|
519
374
|
} | null | undefined;
|
|
520
375
|
};
|
|
521
376
|
}>;
|
|
522
|
-
source_watermark: NativeDate;
|
|
523
|
-
computed_at: NativeDate;
|
|
524
377
|
}> & Required<{
|
|
525
378
|
_id: import("mongoose").Types.ObjectId;
|
|
526
379
|
}> & {
|
|
@@ -559,3 +412,22 @@ export declare const MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_INDEX
|
|
|
559
412
|
day_index: number;
|
|
560
413
|
};
|
|
561
414
|
};
|
|
415
|
+
/**
|
|
416
|
+
* Index OPTIONS the materializer must CREATE — the identity index is a UNIQUE
|
|
417
|
+
* business invariant (one document per tenant × scope context × scope value;
|
|
418
|
+
* the close-day writes upsert against it and silently degrade without it),
|
|
419
|
+
* so it must be created with `unique: true`. The key patterns above are what
|
|
420
|
+
* the read `.hint()` consumes; these options are what creation must apply.
|
|
421
|
+
* The materializer boot should assert them (`listIndexes`, fail closed — the
|
|
422
|
+
* read hint already fails closed without the index itself).
|
|
423
|
+
*/
|
|
424
|
+
export declare const MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_INDEX_OPTIONS: {
|
|
425
|
+
key: {
|
|
426
|
+
tenant_id: number;
|
|
427
|
+
scope_context: number;
|
|
428
|
+
scope_field: number;
|
|
429
|
+
day_index: number;
|
|
430
|
+
};
|
|
431
|
+
name: string;
|
|
432
|
+
unique: boolean;
|
|
433
|
+
}[];
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_INDEXES = exports.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_NAME = exports.MaterializedTenantSalesOverviewReportSchema = exports.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_SCHEMA_VERSION = void 0;
|
|
3
|
+
exports.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_INDEX_OPTIONS = exports.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_INDEXES = exports.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_NAME = exports.MaterializedTenantSalesOverviewReportSchema = exports.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_SCHEMA_VERSION = void 0;
|
|
4
4
|
const mongoose_1 = require("mongoose");
|
|
5
5
|
const constants_1 = require("../../constants");
|
|
6
6
|
const ENUMS_1 = require("../../constants/ENUMS");
|
|
@@ -15,17 +15,20 @@ const MATERIALIZED_REPORTS_1 = require("../../constants/MATERIALIZED_REPORTS");
|
|
|
15
15
|
* `MATERIALIZED_REPORTS.md`). The report's time-bias toggle (Punched At /
|
|
16
16
|
* `createdAt`) is out of scope. `scope_field` formats are documented on
|
|
17
17
|
* `MATERIALIZED_REPORT_SCOPE_ENUM` and in `MATERIALIZED_REPORTS.md`.
|
|
18
|
-
*
|
|
19
|
-
* `CREDIT_BILLS` slot
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
18
|
+
* NUMBERS ONLY: credit-bill COUNTERS (issued / settled / received) live in
|
|
19
|
+
* each `sale_type_metrics` key's `CREDIT_BILLS` slot — constant-size numbers.
|
|
20
|
+
* The ITEMIZED ledger (one row per bill + its receipt events) lives in the
|
|
21
|
+
* SHARED `materialized_tenant_credit_bills` collection, so these documents carry no
|
|
22
|
+
* bill rows/ids and their size no longer grows with the ledger over time.
|
|
23
|
+
* Iteration history (every structural write's full post-write snapshot)
|
|
24
|
+
* lives in the shared `materialized_tenant_reports_iterations` collection.
|
|
23
25
|
*/
|
|
24
26
|
/**
|
|
25
27
|
* Version of the key grammar + metric rules of this collection. Bump when
|
|
26
28
|
* `sale_type_key_filters`, their order, or metric semantics change —
|
|
27
29
|
* historical documents must then be re-materialized (readers may branch on
|
|
28
|
-
* this value during a rollout).
|
|
30
|
+
* this value during a rollout). PRE-RELEASE: the collection has no live
|
|
31
|
+
* tenants/consumers yet, so every change so far folds into version `1`.
|
|
29
32
|
*/
|
|
30
33
|
exports.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_SCHEMA_VERSION = 1;
|
|
31
34
|
const ReportDiscountByTypeSchema = new mongoose_1.Schema({
|
|
@@ -129,77 +132,9 @@ const ReportSaleTypeMetricSchema = new mongoose_1.Schema({
|
|
|
129
132
|
default: [],
|
|
130
133
|
},
|
|
131
134
|
}, { _id: false, minimize: false });
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
required: true,
|
|
136
|
-
},
|
|
137
|
-
payment_id: {
|
|
138
|
-
type: String,
|
|
139
|
-
required: true,
|
|
140
|
-
},
|
|
141
|
-
amount: {
|
|
142
|
-
type: Number, // cents — the bill's amount at issue
|
|
143
|
-
required: true,
|
|
144
|
-
},
|
|
145
|
-
// Cumulative amount received against this bill so far (0 while unpaid;
|
|
146
|
-
// less than `amount` while partially paid). Replaces the old `is_settled`
|
|
147
|
-
// flag: the bill is settled when `received_amount >= amount` (`settled_at`
|
|
148
|
-
// is stamped by the collection patch). Never an event delta, so patches
|
|
149
|
-
// stay idempotent.
|
|
150
|
-
received_amount: {
|
|
151
|
-
type: Number,
|
|
152
|
-
required: true,
|
|
153
|
-
default: 0,
|
|
154
|
-
},
|
|
155
|
-
credit_note: {
|
|
156
|
-
type: String, // optional note/reference recorded with the collection
|
|
157
|
-
default: null,
|
|
158
|
-
},
|
|
159
|
-
issued_at: {
|
|
160
|
-
type: mongoose_1.Schema.Types.Date,
|
|
161
|
-
required: true,
|
|
162
|
-
},
|
|
163
|
-
// Stamped when the bill is fully collected (received_amount >= amount).
|
|
164
|
-
settled_at: {
|
|
165
|
-
type: mongoose_1.Schema.Types.Date,
|
|
166
|
-
default: null,
|
|
167
|
-
},
|
|
168
|
-
}, { _id: false, minimize: false });
|
|
169
|
-
const ReportReceivedCreditBillSchema = new mongoose_1.Schema({
|
|
170
|
-
order_id: {
|
|
171
|
-
type: String,
|
|
172
|
-
required: true,
|
|
173
|
-
},
|
|
174
|
-
payment_id: {
|
|
175
|
-
type: String,
|
|
176
|
-
required: true,
|
|
177
|
-
},
|
|
178
|
-
amount: {
|
|
179
|
-
type: Number, // cents — the bill's amount at issue
|
|
180
|
-
required: true,
|
|
181
|
-
},
|
|
182
|
-
// Cumulative amount received for this bill as of the collection compile
|
|
183
|
-
// (≤ `amount` while partially paid; reaches `amount` when fully collected).
|
|
184
|
-
received_amount: {
|
|
185
|
-
type: Number,
|
|
186
|
-
required: true,
|
|
187
|
-
},
|
|
188
|
-
credit_note: {
|
|
189
|
-
type: String, // optional note/reference recorded with the collection
|
|
190
|
-
default: null,
|
|
191
|
-
},
|
|
192
|
-
issued_local_date: {
|
|
193
|
-
type: String, // 'YYYY-MM-DD' — the sale's day (bill issue day)
|
|
194
|
-
required: true,
|
|
195
|
-
},
|
|
196
|
-
// Collection timestamp (`order_settled_at`) when known — stamped onto the
|
|
197
|
-
// issue-day bill's `settled_at` by the collection patch.
|
|
198
|
-
settled_at: {
|
|
199
|
-
type: mongoose_1.Schema.Types.Date,
|
|
200
|
-
default: null,
|
|
201
|
-
},
|
|
202
|
-
}, { _id: false, minimize: false });
|
|
135
|
+
// Credit-bill COUNTERS live here (numbers only — the itemized ledger lives in
|
|
136
|
+
// the shared `materialized_tenant_credit_bills` collection; these documents never
|
|
137
|
+
// carry bill rows/ids, so their size is stable over time).
|
|
203
138
|
const ReportCreditBillsSchema = new mongoose_1.Schema({
|
|
204
139
|
issued: {
|
|
205
140
|
count: {
|
|
@@ -213,8 +148,9 @@ const ReportCreditBillsSchema = new mongoose_1.Schema({
|
|
|
213
148
|
required: true,
|
|
214
149
|
default: 0,
|
|
215
150
|
},
|
|
216
|
-
// How much of the issued bills
|
|
217
|
-
//
|
|
151
|
+
// How many / how much (Σ amount) of the issued bills have been FULLY
|
|
152
|
+
// collected — patched when a collection covers the bill (partial
|
|
153
|
+
// receipts never count here).
|
|
218
154
|
settled_count: {
|
|
219
155
|
type: Number,
|
|
220
156
|
required: true,
|
|
@@ -226,10 +162,6 @@ const ReportCreditBillsSchema = new mongoose_1.Schema({
|
|
|
226
162
|
required: true,
|
|
227
163
|
default: 0,
|
|
228
164
|
},
|
|
229
|
-
bills: {
|
|
230
|
-
type: [ReportCreditBillSchema],
|
|
231
|
-
default: [],
|
|
232
|
-
},
|
|
233
165
|
},
|
|
234
166
|
received: {
|
|
235
167
|
count: {
|
|
@@ -243,15 +175,8 @@ const ReportCreditBillsSchema = new mongoose_1.Schema({
|
|
|
243
175
|
required: true,
|
|
244
176
|
default: 0,
|
|
245
177
|
},
|
|
246
|
-
bills: {
|
|
247
|
-
type: [ReportReceivedCreditBillSchema],
|
|
248
|
-
default: [],
|
|
249
|
-
},
|
|
250
178
|
},
|
|
251
179
|
}, { _id: false, minimize: false });
|
|
252
|
-
// Credit bills carry the PAY_LATER ledger (issued + settled tracking /
|
|
253
|
-
// received) — report views (including the Credit Bills sale-type numbers) are
|
|
254
|
-
// derived by the frontend formatter, not stored separately.
|
|
255
180
|
const ReportKeyMetricsSchema = new mongoose_1.Schema({
|
|
256
181
|
[constants_1.REPORT_SALE_TYPE_ENUM.TOTAL_SALES]: {
|
|
257
182
|
type: ReportSaleTypeMetricSchema,
|
|
@@ -265,8 +190,8 @@ const ReportKeyMetricsSchema = new mongoose_1.Schema({
|
|
|
265
190
|
type: ReportCreditBillsSchema,
|
|
266
191
|
required: true,
|
|
267
192
|
default: () => ({
|
|
268
|
-
issued: { count: 0, amount: 0, settled_count: 0, settled_amount: 0
|
|
269
|
-
received: { count: 0, amount: 0
|
|
193
|
+
issued: { count: 0, amount: 0, settled_count: 0, settled_amount: 0 },
|
|
194
|
+
received: { count: 0, amount: 0 },
|
|
270
195
|
}),
|
|
271
196
|
},
|
|
272
197
|
}, { _id: false, minimize: false });
|
|
@@ -320,11 +245,12 @@ exports.MaterializedTenantSalesOverviewReportSchema = new mongoose_1.Schema({
|
|
|
320
245
|
default: {},
|
|
321
246
|
},
|
|
322
247
|
// Versioned writes: bumped by `updateMaterializedTenantSalesOverviewReport`
|
|
323
|
-
// on metric changes (replacement / period deltas) AND on
|
|
324
|
-
// patches that change the
|
|
325
|
-
//
|
|
326
|
-
//
|
|
327
|
-
//
|
|
248
|
+
// on metric changes (replacement / period deltas) AND on credit-bill
|
|
249
|
+
// collection patches that change the counters (the itemized ledger lives
|
|
250
|
+
// in `materialized_tenant_credit_bills` and is never embedded here); 1 = first
|
|
251
|
+
// materialization. Every bump is recorded in the shared
|
|
252
|
+
// `materialized_tenant_reports_iterations` history (full post-write
|
|
253
|
+
// snapshot + reason) — this document carries no embedded snapshot.
|
|
328
254
|
iteration: {
|
|
329
255
|
type: Number,
|
|
330
256
|
required: true,
|
|
@@ -394,3 +320,19 @@ exports.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_COLLECTION_INDEXES = {
|
|
|
394
320
|
day_index: 1,
|
|
395
321
|
},
|
|
396
322
|
};
|
|
323
|
+
/**
|
|
324
|
+
* Index OPTIONS the materializer must CREATE — the identity index is a UNIQUE
|
|
325
|
+
* business invariant (one document per tenant × scope context × scope value;
|
|
326
|
+
* the close-day writes upsert against it and silently degrade without it),
|
|
327
|
+
* so it must be created with `unique: true`. The key patterns above are what
|
|
328
|
+
* the read `.hint()` consumes; these options are what creation must apply.
|
|
329
|
+
* The materializer boot should assert them (`listIndexes`, fail closed — the
|
|
330
|
+
* read hint already fails closed without the index itself).
|
|
331
|
+
*/
|
|
332
|
+
exports.MATERIALIZED_TENANT_SALES_OVERVIEW_REPORTS_INDEX_OPTIONS = [
|
|
333
|
+
{
|
|
334
|
+
key: { tenant_id: 1, scope_context: 1, scope_field: 1, day_index: 1 },
|
|
335
|
+
name: 'tenant_id__scope_context__scope_field__day_index',
|
|
336
|
+
unique: true,
|
|
337
|
+
},
|
|
338
|
+
];
|
|
@@ -31,6 +31,7 @@ export * from './inventory_transactions';
|
|
|
31
31
|
export * from './item_transactions';
|
|
32
32
|
export * from './items';
|
|
33
33
|
export * from './marketing_fingerprints';
|
|
34
|
+
export * from './materialized_credit_bills';
|
|
34
35
|
export * from './materialized_tenant_reports_iterations';
|
|
35
36
|
export * from './materialized_tenant_sales_overview_reports';
|
|
36
37
|
export * from './menus';
|
|
@@ -47,6 +47,7 @@ __exportStar(require("./inventory_transactions"), exports);
|
|
|
47
47
|
__exportStar(require("./item_transactions"), exports);
|
|
48
48
|
__exportStar(require("./items"), exports);
|
|
49
49
|
__exportStar(require("./marketing_fingerprints"), exports);
|
|
50
|
+
__exportStar(require("./materialized_credit_bills"), exports);
|
|
50
51
|
__exportStar(require("./materialized_tenant_reports_iterations"), exports);
|
|
51
52
|
__exportStar(require("./materialized_tenant_sales_overview_reports"), exports);
|
|
52
53
|
__exportStar(require("./menus"), exports);
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
import { DAY_INDEX_ENUM } from '../../constants/ENUMS';
|
|
2
|
+
import { MATERIALIZED_REPORT_CREDIT_BILL_EVENT_TYPE_ENUM, MATERIALIZED_REPORT_KEY_FILTER_ENUM, MATERIALIZED_REPORT_SCOPE_ENUM } from '../../constants/MATERIALIZED_REPORTS';
|
|
3
|
+
/**
|
|
4
|
+
* Document types for `materialized_tenant_credit_bills` — the SHARED
|
|
5
|
+
* credit-bill ledger of the materialized reports (see `MATERIALIZED_REPORTS.md`).
|
|
6
|
+
*
|
|
7
|
+
* ONE document per (tenant, scope context, scope value) — the same
|
|
8
|
+
* materialization convention as every other report collection, but the scope
|
|
9
|
+
* set is CAPPED AT `LOCAL_MONTH` (`MATERIALIZED_CREDIT_BILLS_SCOPES`): a
|
|
10
|
+
* month bounds how many bills a document accumulates, so no document can
|
|
11
|
+
* grow unboundedly over time. Whole-year / multi-year reads simply cover
|
|
12
|
+
* their range with the month documents (plus date/hour documents at range
|
|
13
|
+
* edges and for hour-precise windows).
|
|
14
|
+
*
|
|
15
|
+
* Every document carries a per-key map `credit_bills`:
|
|
16
|
+
* `{ [sale_type_key]: { issued: [...], received: [...] } }` — the key
|
|
17
|
+
* grammar is the same `ORDER_STATUS:PLATFORM` grammar as the report
|
|
18
|
+
* documents, so platform / status filters apply to credit numbers and
|
|
19
|
+
* drill-downs alike. Entries keep the identity IDS (`order_id`,
|
|
20
|
+
* `payment_id`) and are slim by design: the order document remains the
|
|
21
|
+
* single source of the sale, this collection only materializes the CREDIT
|
|
22
|
+
* timeline + an indexed, paginated identity list.
|
|
23
|
+
*
|
|
24
|
+
* - `issued[]` = bills ISSUED in the document's scope (one entry per bill):
|
|
25
|
+
* amount + issue anchors + the stateful receipt anchors (`received_at_issue`
|
|
26
|
+
* carried forward; `received_amount` cumulative NOW; `settled_at` /
|
|
27
|
+
* `settled_local_date` filled when the bill settles). Settlement closes
|
|
28
|
+
* PATCH these entries on the issue-scope documents (bounded fan-out).
|
|
29
|
+
* - `received[]` = receipt events COLLECTED in the document's scope (one entry
|
|
30
|
+
* per `(bill, event day)`): `received_delta` is the money collected BY that
|
|
31
|
+
* event (incremental, never a running total) plus the cumulative
|
|
32
|
+
* `received_amount` and the display anchors (`issued_local_date`,
|
|
33
|
+
* `received_at` for ordering, note).
|
|
34
|
+
* - Hour labels exist on entries so hour-precise selections (time windows)
|
|
35
|
+
* can match like the report documents' `localHour` scopes do (null =
|
|
36
|
+
* unresolvable).
|
|
37
|
+
*
|
|
38
|
+
* Amounts are CENTS. Reads pin `schema_version`. The iteration history of
|
|
39
|
+
* these documents lives in the shared `materialized_tenant_reports_iterations`
|
|
40
|
+
* collection like every other materialized report.
|
|
41
|
+
*/
|
|
42
|
+
/** One receipt event of a credit bill (money collected on one business day). */
|
|
43
|
+
export interface IMaterializedCreditBillEvent {
|
|
44
|
+
/** `'YYYY-MM-DD'` tenant-local day the money was collected on. */
|
|
45
|
+
event_local_date: string;
|
|
46
|
+
/** `'YYYY-MM-DD HH'` tenant-local hour of the collection (null when unknown). */
|
|
47
|
+
event_local_hour: string | null;
|
|
48
|
+
/** Cents collected BY this event — incremental, never cumulative. */
|
|
49
|
+
received_delta: number;
|
|
50
|
+
/** Reserved ledger kind — `RECEIPT` today (`REFUND` / `WRITE_OFF` would be signed). */
|
|
51
|
+
event_type: MATERIALIZED_REPORT_CREDIT_BILL_EVENT_TYPE_ENUM;
|
|
52
|
+
credit_note?: string | null;
|
|
53
|
+
/** Collection timestamp (`order_settled_at`) when known. */
|
|
54
|
+
settled_at?: Date | null;
|
|
55
|
+
}
|
|
56
|
+
/** ISSUE entry — one issued bill, slim (ids + credit facts, no order body). */
|
|
57
|
+
export interface IMaterializedCreditBillIssuedEntry {
|
|
58
|
+
order_id: string;
|
|
59
|
+
payment_id: string;
|
|
60
|
+
/** Cents — the bill's amount at issue. */
|
|
61
|
+
amount: number;
|
|
62
|
+
/** Punch time (`order.createdAt`) — never `order_settled_at`. */
|
|
63
|
+
issued_at: Date;
|
|
64
|
+
/** `'YYYY-MM-DD HH'` punch hour (null when unresolvable). */
|
|
65
|
+
issued_local_hour: string | null;
|
|
66
|
+
/** Cents received BEFORE the issue day closed (prepaid + same-day settled). */
|
|
67
|
+
received_at_issue: number;
|
|
68
|
+
/** Cumulative received so far (NOW state) — patched by collection closes. */
|
|
69
|
+
received_amount: number;
|
|
70
|
+
settled_at: Date | null;
|
|
71
|
+
/** `'YYYY-MM-DD'` of the settling receipt event. */
|
|
72
|
+
settled_local_date: string | null;
|
|
73
|
+
credit_note?: string | null;
|
|
74
|
+
}
|
|
75
|
+
/** RECEIPT entry — one collection event of a bill, keyed by its event day. */
|
|
76
|
+
export interface IMaterializedCreditBillReceivedEntry {
|
|
77
|
+
order_id: string;
|
|
78
|
+
payment_id: string;
|
|
79
|
+
/** `'YYYY-MM-DD'` tenant-local day the money was collected on — entry identity. */
|
|
80
|
+
event_local_date: string;
|
|
81
|
+
/** Cents — the bill's amount at issue (context for the receipt). */
|
|
82
|
+
amount: number;
|
|
83
|
+
/** Cumulative received right AFTER this event — idempotence anchor. */
|
|
84
|
+
received_amount: number;
|
|
85
|
+
/** Cents collected BY this event — incremental, never cumulative. */
|
|
86
|
+
received_delta: number;
|
|
87
|
+
/** Collection timestamp (`order_settled_at`) when known — drill-down ordering. */
|
|
88
|
+
received_at: Date | null;
|
|
89
|
+
/** `'YYYY-MM-DD HH'` settlement hour (null when unknown). */
|
|
90
|
+
event_local_hour: string | null;
|
|
91
|
+
credit_note?: string | null;
|
|
92
|
+
/** `'YYYY-MM-DD'` the bill was issued on — display anchor. */
|
|
93
|
+
issued_local_date: string;
|
|
94
|
+
}
|
|
95
|
+
/** Per-key credit section of one document (arrays may be empty, never absent-on-zero). */
|
|
96
|
+
export interface IMaterializedCreditBillKeySection {
|
|
97
|
+
issued: IMaterializedCreditBillIssuedEntry[];
|
|
98
|
+
received: IMaterializedCreditBillReceivedEntry[];
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* One `materialized_tenant_credit_bills` document — tenant × scope context ×
|
|
102
|
+
* scope value. `scope_context` is always one of the month-capped credit scopes
|
|
103
|
+
* (`MATERIALIZED_CREDIT_BILLS_SCOPES`).
|
|
104
|
+
*/
|
|
105
|
+
export interface IMaterializedTenantCreditBillsReport {
|
|
106
|
+
_id: string;
|
|
107
|
+
tenant_id: string;
|
|
108
|
+
/** Required for brand-level reads (sum across the brand's tenants). */
|
|
109
|
+
brand_id: string;
|
|
110
|
+
scope_context: MATERIALIZED_REPORT_SCOPE_ENUM;
|
|
111
|
+
/** Format depends on `scope_context` (see `MATERIALIZED_REPORT_SCOPE_ENUM`). */
|
|
112
|
+
scope_field: string;
|
|
113
|
+
/** Denormalized weekday — set ONLY on `LOCAL_HOUR` / `LOCAL_DATE` documents. */
|
|
114
|
+
day_index?: DAY_INDEX_ENUM | null;
|
|
115
|
+
/**
|
|
116
|
+
* Ordered filter dimensions encoded into `credit_bills` keys; the order
|
|
117
|
+
* defines the key grammar (`"COMPLETED:POS_WALK-IN"`).
|
|
118
|
+
*/
|
|
119
|
+
sale_type_key_filters: MATERIALIZED_REPORT_KEY_FILTER_ENUM[];
|
|
120
|
+
/**
|
|
121
|
+
* One section per observed filter-combination key. Keys with no entries in
|
|
122
|
+
* the document's scope are absent (pruned); an empty map is never written.
|
|
123
|
+
*/
|
|
124
|
+
credit_bills: Record<string, IMaterializedCreditBillKeySection> | null;
|
|
125
|
+
/**
|
|
126
|
+
* Versioned writes applied to this document (replacement / deltas /
|
|
127
|
+
* settlement patches; 1 = first materialization). Every bump is recorded in
|
|
128
|
+
* the shared `materialized_tenant_reports_iterations` history.
|
|
129
|
+
*/
|
|
130
|
+
iteration?: number;
|
|
131
|
+
/** Bump on entry-rule changes; readers pin it. PRE-RELEASE folds into `1`. */
|
|
132
|
+
schema_version: number;
|
|
133
|
+
/** Max source `orders.updatedAt` folded into this document. */
|
|
134
|
+
source_watermark: Date;
|
|
135
|
+
/** When the materializer last rebuilt this document. */
|
|
136
|
+
computed_at: Date;
|
|
137
|
+
createdAt: Date;
|
|
138
|
+
updatedAt: Date;
|
|
139
|
+
}
|