@reglow/reglow 0.9.0 → 0.12.0

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.
Files changed (163) hide show
  1. package/dist/reglow/common/errors.js +1 -1
  2. package/dist/reglow/common/errors.js.map +1 -1
  3. package/dist/reglow/core/config.js +1 -1
  4. package/dist/reglow/core/config.js.map +1 -1
  5. package/dist/reglow/core/entities.d.ts +113 -1
  6. package/dist/reglow/core/models.d.ts +16 -0
  7. package/dist/reglow/core/models.js +9 -0
  8. package/dist/reglow/core/models.js.map +1 -1
  9. package/dist/reglow/modules/ai/controller.d.ts +15 -0
  10. package/dist/reglow/modules/ai/controller.js +21 -16
  11. package/dist/reglow/modules/ai/controller.js.map +1 -1
  12. package/dist/reglow/modules/ai/service.d.ts +4 -0
  13. package/dist/reglow/modules/ai/service.js +31 -1
  14. package/dist/reglow/modules/ai/service.js.map +1 -1
  15. package/dist/reglow/modules/analytics/collect.d.ts +13 -0
  16. package/dist/reglow/modules/analytics/collect.js +237 -0
  17. package/dist/reglow/modules/analytics/collect.js.map +1 -0
  18. package/dist/reglow/modules/analytics/controller.d.ts +6 -0
  19. package/dist/reglow/modules/analytics/controller.js +338 -0
  20. package/dist/reglow/modules/analytics/controller.js.map +1 -0
  21. package/dist/reglow/modules/analytics/controller_client.d.ts +6 -0
  22. package/dist/reglow/modules/analytics/controller_client.js +34 -0
  23. package/dist/reglow/modules/analytics/controller_client.js.map +1 -0
  24. package/dist/reglow/modules/analytics/gov.d.ts +30 -0
  25. package/dist/reglow/modules/analytics/gov.js +140 -0
  26. package/dist/reglow/modules/analytics/gov.js.map +1 -0
  27. package/dist/reglow/modules/analytics/model.d.ts +190 -0
  28. package/dist/reglow/modules/analytics/model.js +14 -0
  29. package/dist/reglow/modules/analytics/model.js.map +1 -0
  30. package/dist/reglow/modules/analytics/repository.d.ts +66 -0
  31. package/dist/reglow/modules/analytics/repository.js +451 -0
  32. package/dist/reglow/modules/analytics/repository.js.map +1 -0
  33. package/dist/reglow/modules/analytics/rollup.d.ts +17 -0
  34. package/dist/reglow/modules/analytics/rollup.js +299 -0
  35. package/dist/reglow/modules/analytics/rollup.js.map +1 -0
  36. package/dist/reglow/modules/analytics/router.d.ts +16 -0
  37. package/dist/reglow/modules/analytics/router.js +11 -0
  38. package/dist/reglow/modules/analytics/router.js.map +1 -0
  39. package/dist/reglow/modules/analytics/schema.d.ts +275 -0
  40. package/dist/reglow/modules/analytics/schema.js +7 -0
  41. package/dist/reglow/modules/analytics/schema.js.map +1 -0
  42. package/dist/reglow/modules/analytics/service.d.ts +51 -0
  43. package/dist/reglow/modules/analytics/service.js +653 -0
  44. package/dist/reglow/modules/analytics/service.js.map +1 -0
  45. package/dist/reglow/modules/analytics/snapshot.d.ts +10 -0
  46. package/dist/reglow/modules/analytics/snapshot.js +63 -0
  47. package/dist/reglow/modules/analytics/snapshot.js.map +1 -0
  48. package/dist/reglow/modules/article/controller.js +1 -0
  49. package/dist/reglow/modules/article/controller.js.map +1 -1
  50. package/dist/reglow/modules/article/schema.d.ts +2 -0
  51. package/dist/reglow/modules/article/schema.js +2 -0
  52. package/dist/reglow/modules/article/schema.js.map +1 -1
  53. package/dist/reglow/modules/article/service.d.ts +5 -0
  54. package/dist/reglow/modules/article/service.js +26 -1
  55. package/dist/reglow/modules/article/service.js.map +1 -1
  56. package/dist/reglow/modules/config/controller.js +3 -1
  57. package/dist/reglow/modules/config/controller.js.map +1 -1
  58. package/dist/reglow/modules/customer_service/repository.js +4 -2
  59. package/dist/reglow/modules/customer_service/repository.js.map +1 -1
  60. package/dist/reglow/modules/customer_service/sdk_template.html +4 -3
  61. package/dist/reglow/modules/dashboard/controller.js +7 -1
  62. package/dist/reglow/modules/dashboard/controller.js.map +1 -1
  63. package/dist/reglow/modules/dashboard/service.d.ts +1 -0
  64. package/dist/reglow/modules/dashboard/service.js +152 -0
  65. package/dist/reglow/modules/dashboard/service.js.map +1 -1
  66. package/dist/reglow/modules/material/controller.js +16 -0
  67. package/dist/reglow/modules/material/controller.js.map +1 -1
  68. package/dist/reglow/modules/material/repository.js +2 -2
  69. package/dist/reglow/modules/material/repository.js.map +1 -1
  70. package/dist/reglow/modules/material/service.d.ts +2 -0
  71. package/dist/reglow/modules/material/service.js +46 -4
  72. package/dist/reglow/modules/material/service.js.map +1 -1
  73. package/dist/reglow/modules/payment/service.js +7 -1
  74. package/dist/reglow/modules/payment/service.js.map +1 -1
  75. package/dist/reglow/modules/photo/controller.js +81 -55
  76. package/dist/reglow/modules/photo/controller.js.map +1 -1
  77. package/dist/reglow/modules/photo/repository.js +1 -1
  78. package/dist/reglow/modules/photo/repository.js.map +1 -1
  79. package/dist/reglow/modules/photo/service.d.ts +11 -1
  80. package/dist/reglow/modules/photo/service.js +65 -3
  81. package/dist/reglow/modules/photo/service.js.map +1 -1
  82. package/dist/reglow/modules/skill/controller.d.ts +8 -0
  83. package/dist/reglow/modules/skill/controller.js +93 -0
  84. package/dist/reglow/modules/skill/controller.js.map +1 -0
  85. package/dist/reglow/modules/skill/model.d.ts +19 -0
  86. package/dist/reglow/modules/skill/model.js +49 -0
  87. package/dist/reglow/modules/skill/model.js.map +1 -0
  88. package/dist/reglow/modules/skill/repository.d.ts +8 -0
  89. package/dist/reglow/modules/skill/repository.js +101 -0
  90. package/dist/reglow/modules/skill/repository.js.map +1 -0
  91. package/dist/reglow/modules/skill/router.d.ts +10 -0
  92. package/dist/reglow/modules/skill/router.js +8 -0
  93. package/dist/reglow/modules/skill/router.js.map +1 -0
  94. package/dist/reglow/modules/skill/schema.d.ts +39 -0
  95. package/dist/reglow/modules/skill/schema.js +38 -0
  96. package/dist/reglow/modules/skill/schema.js.map +1 -0
  97. package/dist/reglow/modules/skill/service.d.ts +62 -0
  98. package/dist/reglow/modules/skill/service.js +285 -0
  99. package/dist/reglow/modules/skill/service.js.map +1 -0
  100. package/dist/reglow/modules/studio/controller.d.ts +9 -0
  101. package/dist/reglow/modules/studio/controller.js +303 -0
  102. package/dist/reglow/modules/studio/controller.js.map +1 -0
  103. package/dist/reglow/modules/studio/deps.d.ts +47 -0
  104. package/dist/reglow/modules/studio/deps.js +175 -0
  105. package/dist/reglow/modules/studio/deps.js.map +1 -0
  106. package/dist/reglow/modules/studio/engine.d.ts +85 -0
  107. package/dist/reglow/modules/studio/engine.js +881 -0
  108. package/dist/reglow/modules/studio/engine.js.map +1 -0
  109. package/dist/reglow/modules/studio/llm.d.ts +30 -0
  110. package/dist/reglow/modules/studio/llm.js +151 -0
  111. package/dist/reglow/modules/studio/llm.js.map +1 -0
  112. package/dist/reglow/modules/studio/mcp/client.d.ts +22 -0
  113. package/dist/reglow/modules/studio/mcp/client.js +99 -0
  114. package/dist/reglow/modules/studio/mcp/client.js.map +1 -0
  115. package/dist/reglow/modules/studio/mcp/transport.d.ts +59 -0
  116. package/dist/reglow/modules/studio/mcp/transport.js +259 -0
  117. package/dist/reglow/modules/studio/mcp/transport.js.map +1 -0
  118. package/dist/reglow/modules/studio/media.d.ts +52 -0
  119. package/dist/reglow/modules/studio/media.js +484 -0
  120. package/dist/reglow/modules/studio/media.js.map +1 -0
  121. package/dist/reglow/modules/studio/model.d.ts +23 -0
  122. package/dist/reglow/modules/studio/model.js +35 -0
  123. package/dist/reglow/modules/studio/model.js.map +1 -0
  124. package/dist/reglow/modules/studio/repository.d.ts +31 -0
  125. package/dist/reglow/modules/studio/repository.js +300 -0
  126. package/dist/reglow/modules/studio/repository.js.map +1 -0
  127. package/dist/reglow/modules/studio/router.d.ts +10 -0
  128. package/dist/reglow/modules/studio/router.js +8 -0
  129. package/dist/reglow/modules/studio/router.js.map +1 -0
  130. package/dist/reglow/modules/studio/schema.d.ts +194 -0
  131. package/dist/reglow/modules/studio/schema.js +739 -0
  132. package/dist/reglow/modules/studio/schema.js.map +1 -0
  133. package/dist/reglow/modules/studio/service.d.ts +168 -0
  134. package/dist/reglow/modules/studio/service.js +673 -0
  135. package/dist/reglow/modules/studio/service.js.map +1 -0
  136. package/dist/reglow/modules/studio/tools/builtins.d.ts +9 -0
  137. package/dist/reglow/modules/studio/tools/builtins.js +162 -0
  138. package/dist/reglow/modules/studio/tools/builtins.js.map +1 -0
  139. package/dist/reglow/modules/studio/tools/media_tools.d.ts +31 -0
  140. package/dist/reglow/modules/studio/tools/media_tools.js +412 -0
  141. package/dist/reglow/modules/studio/tools/media_tools.js.map +1 -0
  142. package/dist/reglow/modules/studio/tools/registry.d.ts +46 -0
  143. package/dist/reglow/modules/studio/tools/registry.js +160 -0
  144. package/dist/reglow/modules/studio/tools/registry.js.map +1 -0
  145. package/dist/reglow/modules/studio/tools/runner.d.ts +18 -0
  146. package/dist/reglow/modules/studio/tools/runner.js +89 -0
  147. package/dist/reglow/modules/studio/tools/runner.js.map +1 -0
  148. package/dist/reglow/modules/user/controller_client.js +1 -1
  149. package/dist/reglow/modules/user/controller_client.js.map +1 -1
  150. package/dist/reglow/modules/video/controller.js +1 -0
  151. package/dist/reglow/modules/video/controller.js.map +1 -1
  152. package/dist/reglow/modules/video/schema.d.ts +2 -0
  153. package/dist/reglow/modules/video/schema.js +2 -0
  154. package/dist/reglow/modules/video/schema.js.map +1 -1
  155. package/dist/reglow/modules/video/service.d.ts +5 -0
  156. package/dist/reglow/modules/video/service.js +26 -1
  157. package/dist/reglow/modules/video/service.js.map +1 -1
  158. package/dist/reglow/scripts/init-data.js +423 -2
  159. package/dist/reglow/scripts/init-data.js.map +1 -1
  160. package/dist/reglow/scripts/schema.d.ts +9 -0
  161. package/dist/reglow/scripts/schema.js +448 -1
  162. package/dist/reglow/scripts/schema.js.map +1 -1
  163. package/package.json +83 -83
@@ -0,0 +1,653 @@
1
+ /**
2
+ * 数据埋点与分析 - Service(应用管理 + 分析查询 + 治理)
3
+ * 对应 backend-python 的 reglow/modules/analytics/service.py
4
+ */
5
+ import { AppException, ErrorCode, NotFoundException } from "../../common/errors.js";
6
+ import * as repo from "./repository.js";
7
+ import { parseJson } from "./repository.js";
8
+ import { buildPolicy, policyPublic, cleanupExpired } from "./gov.js";
9
+ import { HEAT_GRID_SIZE, rebuildAggEvent, rebuildAggPageDay } from "./rollup.js";
10
+ import { captureAndSave, saveSnapshotBytes, listSnapshots as listSnapshotRows } from "./snapshot.js";
11
+ import { ANA_APP_TABLE, ANA_EVENT_TABLE, ANA_TRACK_RULE_TABLE, ANA_GOV_RULE_TABLE, } from "./model.js";
12
+ function num(v, def = 0) {
13
+ const n = Number(v);
14
+ return Number.isFinite(n) ? n : def;
15
+ }
16
+ function round4(v) {
17
+ return Math.round(v * 10000) / 10000;
18
+ }
19
+ function round2(v) {
20
+ return Math.round(v * 100) / 100;
21
+ }
22
+ function pad2(n) {
23
+ return String(n).padStart(2, "0");
24
+ }
25
+ function dayOfDate(d) {
26
+ return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())}`;
27
+ }
28
+ /** 把 'YYYY-MM-DD' 日期区间转为毫秒时间戳区间;缺省最近 7 天(含今天) */
29
+ function parseRange(start, end) {
30
+ const today = new Date();
31
+ const endD = end ? new Date(end.slice(0, 10)) : today;
32
+ const startD = start
33
+ ? new Date(start.slice(0, 10))
34
+ : new Date(endD.getFullYear(), endD.getMonth(), endD.getDate() - 6);
35
+ const startTs = new Date(startD.getFullYear(), startD.getMonth(), startD.getDate(), 0, 0, 0, 0).getTime();
36
+ const endTs = new Date(endD.getFullYear(), endD.getMonth(), endD.getDate(), 23, 59, 59, 999).getTime();
37
+ return [startTs, endTs];
38
+ }
39
+ /** 日期区间 → 按天聚合表用 (start_day, end_day) 字符串 */
40
+ function parseDayRange(start, end) {
41
+ const today = new Date();
42
+ const endD = end ? new Date(end.slice(0, 10)) : today;
43
+ const startD = start
44
+ ? new Date(start.slice(0, 10))
45
+ : new Date(endD.getFullYear(), endD.getMonth(), endD.getDate() - 6);
46
+ return [dayOfDate(startD), dayOfDate(endD)];
47
+ }
48
+ export class AnalyticsService {
49
+ // ───────────── 应用管理 ─────────────
50
+ static appResp(app) {
51
+ return {
52
+ id: app.id,
53
+ app_id: app.app_id,
54
+ name: app.name,
55
+ platform_type: app.platform_type ?? null,
56
+ secret_ref: app.secret_ref ?? null,
57
+ enabled: app.enabled,
58
+ sample_rate: app.sample_rate ?? null,
59
+ config: parseJson(app.config, null),
60
+ created_at: app.created_at ?? null,
61
+ updated_at: app.updated_at ?? null,
62
+ };
63
+ }
64
+ async listApps(page, size, keyword) {
65
+ const { items, total } = await repo.listApps(page, size, keyword);
66
+ return { items: items.map((a) => AnalyticsService.appResp(a)), total };
67
+ }
68
+ async createApp(data, createdBy) {
69
+ if (await repo.findAppByAppid(data.app_id)) {
70
+ throw new AppException(ErrorCode.PARAM_ERROR, `应用标识已存在: ${data.app_id}`);
71
+ }
72
+ const app = await repo.createApp({
73
+ app_id: data.app_id,
74
+ name: data.name,
75
+ tenant_id: null,
76
+ platform_type: data.platform_type ?? "web",
77
+ secret_ref: data.secret_ref ?? null,
78
+ enabled: data.enabled ?? 1,
79
+ sample_rate: data.sample_rate ?? 1.0,
80
+ config: data.config ? JSON.stringify(data.config) : null,
81
+ created_by: createdBy ?? null,
82
+ });
83
+ return AnalyticsService.appResp(app);
84
+ }
85
+ async updateApp(appPk, data) {
86
+ const app = await repo.findApp(appPk);
87
+ if (!app)
88
+ throw new NotFoundException("应用不存在");
89
+ const patch = {};
90
+ if (data.name !== undefined)
91
+ patch.name = data.name;
92
+ if (data.platform_type !== undefined)
93
+ patch.platform_type = data.platform_type;
94
+ if (data.secret_ref !== undefined)
95
+ patch.secret_ref = data.secret_ref;
96
+ if (data.enabled !== undefined)
97
+ patch.enabled = data.enabled;
98
+ if (data.sample_rate !== undefined)
99
+ patch.sample_rate = data.sample_rate;
100
+ if (data.config !== undefined)
101
+ patch.config = data.config ? JSON.stringify(data.config) : null;
102
+ const updated = await repo.updateApp(appPk, patch);
103
+ return AnalyticsService.appResp(updated);
104
+ }
105
+ async deleteApp(appPk) {
106
+ const app = await repo.findApp(appPk);
107
+ if (!app)
108
+ throw new NotFoundException("应用不存在");
109
+ await repo.deleteApp(appPk);
110
+ }
111
+ async ensureApp(appId) {
112
+ const app = await repo.findAppByAppid(appId);
113
+ if (!app)
114
+ throw new NotFoundException("应用不存在");
115
+ }
116
+ // ───────────── 概览统计 ─────────────
117
+ async overview(appId, start, end) {
118
+ await this.ensureApp(appId);
119
+ const [startTs, endTs] = parseRange(start, end);
120
+ const [ev, sess] = await Promise.all([
121
+ repo.eventStats(appId, startTs, endTs),
122
+ repo.sessionStats(appId, startTs, endTs),
123
+ ]);
124
+ const [trendRows, platform, region, channel] = await Promise.all([
125
+ repo.trend(appId, startTs, endTs),
126
+ repo.distBy("platform", appId, startTs, endTs),
127
+ repo.distBy("ip_region", appId, startTs, endTs),
128
+ repo.channelDist(appId, startTs, endTs),
129
+ ]);
130
+ const bounceRate = sess.total ? round4(sess.bounce / sess.total) : 0.0;
131
+ return {
132
+ pv: ev.pv,
133
+ uv: ev.uv,
134
+ sessions: ev.sessions || sess.total,
135
+ avg_stay_ms: sess.avgStay,
136
+ bounce_rate: bounceRate,
137
+ new_users: sess.newUsers,
138
+ trend: trendRows.map(([d, p, u]) => ({ day: d, pv: p, uv: u })),
139
+ platform_dist: platform.map(([n, v]) => ({ name: n, value: v })),
140
+ region_dist: region.map(([n, v]) => ({ name: n, value: v })),
141
+ channel_dist: channel.map(([n, v]) => ({ name: n, value: v })),
142
+ };
143
+ }
144
+ // ───────────── 事件分析 ─────────────
145
+ async eventList(appId, start, end) {
146
+ await this.ensureApp(appId);
147
+ const [startTs, endTs] = parseRange(start, end);
148
+ const rows = await repo.eventList(appId, startTs, endTs);
149
+ return rows.map((r) => ({
150
+ event_code: r.event_code,
151
+ total: r.total,
152
+ uv: r.uv,
153
+ first_day: r.first_day,
154
+ last_day: r.last_day,
155
+ }));
156
+ }
157
+ async eventAggregate(appId, eventCode, start, end) {
158
+ await this.ensureApp(appId);
159
+ const [startTs, endTs] = parseRange(start, end);
160
+ const rows = await repo.eventTrend(appId, eventCode, startTs, endTs);
161
+ return {
162
+ event_code: eventCode,
163
+ total: rows.reduce((s, r) => s + r[1], 0),
164
+ uv: rows.reduce((s, r) => s + r[2], 0),
165
+ trend: rows.map(([d, c, u]) => ({ day: d, pv: c, uv: u })),
166
+ };
167
+ }
168
+ // ───────────── 页面分析 ─────────────
169
+ async pages(appId, start, end) {
170
+ await this.ensureApp(appId);
171
+ const [startTs, endTs] = parseRange(start, end);
172
+ const rows = await repo.pageStats(appId, startTs, endTs);
173
+ return rows.map(([p, c, u]) => ({ page_key: p, pv: c, uv: u }));
174
+ }
175
+ // ───────────── 元素点击 / 曝光 ─────────────
176
+ async elements(appId, start, end, eventType = "click") {
177
+ await this.ensureApp(appId);
178
+ const [startTs, endTs] = parseRange(start, end);
179
+ const code = eventType === "exposure" ? "$exposure" : "$click";
180
+ const rows = await repo.elementRanking(appId, startTs, endTs, code);
181
+ return rows.map(([e, et, pk, c, u]) => ({
182
+ elem_id: e,
183
+ elem_type: et,
184
+ page_key: pk,
185
+ cnt: c,
186
+ uv: u,
187
+ }));
188
+ }
189
+ // ───────────── 搜索分析 ─────────────
190
+ async search(appId, start, end, onlyZeroResult = false) {
191
+ await this.ensureApp(appId);
192
+ const [startDay, endDay] = parseDayRange(start, end);
193
+ const rows = await repo.searchStats(appId, startDay, endDay, onlyZeroResult);
194
+ return rows.map(([q, s, z, c, conv, rs]) => ({
195
+ query_norm: q,
196
+ search_cnt: s,
197
+ zero_result_cnt: z,
198
+ click_cnt: c,
199
+ convert_cnt: conv,
200
+ avg_rank: c ? round2(rs / c) : null,
201
+ }));
202
+ }
203
+ // ───────────── 偏好 / 口碑 ─────────────
204
+ async preferences(appId, start, end, action) {
205
+ await this.ensureApp(appId);
206
+ const [startDay, endDay] = parseDayRange(start, end);
207
+ const rows = await repo.prefStats(appId, startDay, endDay, action);
208
+ return rows.map(([tt, ti, a, c, ss]) => ({
209
+ target_type: tt,
210
+ target_id: ti,
211
+ action: a,
212
+ cnt: c,
213
+ avg_score: a === "rate" && c ? round2(ss / c) : null,
214
+ }));
215
+ }
216
+ // ───────────── 漏斗分析 ─────────────
217
+ async funnel(appId, steps, start, end) {
218
+ await this.ensureApp(appId);
219
+ if (!steps.length)
220
+ throw new AppException(ErrorCode.PARAM_ERROR, "steps 不能为空");
221
+ const [startTs, endTs] = parseRange(start, end);
222
+ const rows = await repo.eventsForAnalysis(appId, startTs, endTs, steps);
223
+ // 每个用户对每一步的首达时间
224
+ const first = new Map();
225
+ for (const [device, code, ts] of rows) {
226
+ if (!device)
227
+ continue;
228
+ let d = first.get(device);
229
+ if (!d) {
230
+ d = new Map();
231
+ first.set(device, d);
232
+ }
233
+ if (code && (!d.has(code) || ts < d.get(code)))
234
+ d.set(code, ts);
235
+ }
236
+ const results = [];
237
+ let prev = new Map();
238
+ let total = 0;
239
+ steps.forEach((code, i) => {
240
+ const cur = new Map();
241
+ if (i === 0) {
242
+ for (const [device, d] of first.entries()) {
243
+ if (d.has(code))
244
+ cur.set(device, d.get(code));
245
+ }
246
+ total = cur.size;
247
+ }
248
+ else {
249
+ for (const [device, t] of prev.entries()) {
250
+ const d = first.get(device);
251
+ if (d && d.has(code) && d.get(code) >= t) {
252
+ cur.set(device, d.get(code));
253
+ }
254
+ }
255
+ }
256
+ const count = cur.size;
257
+ results.push({
258
+ step: i + 1,
259
+ event_code: code,
260
+ count,
261
+ rate: total ? round4(count / total) : 0.0,
262
+ });
263
+ prev = cur;
264
+ });
265
+ return {
266
+ steps: results,
267
+ total_conversion: results.length ? results[results.length - 1].rate : 0.0,
268
+ };
269
+ }
270
+ // ───────────── 留存分析 ─────────────
271
+ async retention(appId, start, end, days = 7) {
272
+ await this.ensureApp(appId);
273
+ const [startTs, endTs] = parseRange(start, end);
274
+ const rows = await repo.eventsForAnalysis(appId, startTs, endTs);
275
+ const devDays = new Map();
276
+ for (const [device, , , day] of rows) {
277
+ if (device && day) {
278
+ let set = devDays.get(device);
279
+ if (!set) {
280
+ set = new Set();
281
+ devDays.set(device, set);
282
+ }
283
+ set.add(day);
284
+ }
285
+ }
286
+ if (!devDays.size)
287
+ return { days, rows: [] };
288
+ const firstDay = new Map();
289
+ const byCohort = new Map();
290
+ for (const [dev, ds] of devDays.entries()) {
291
+ const fd = Array.from(ds).sort()[0];
292
+ firstDay.set(dev, fd);
293
+ let list = byCohort.get(fd);
294
+ if (!list) {
295
+ list = [];
296
+ byCohort.set(fd, list);
297
+ }
298
+ list.push(dev);
299
+ }
300
+ const out = [];
301
+ for (const cohortDay of Array.from(byCohort.keys()).sort()) {
302
+ const devices = byCohort.get(cohortDay);
303
+ const base = new Date(cohortDay + "T00:00:00");
304
+ const values = [];
305
+ for (let k = 0; k < Math.max(1, days); k++) {
306
+ const target = new Date(base.getFullYear(), base.getMonth(), base.getDate() + k);
307
+ const targetDay = dayOfDate(target);
308
+ values.push(devices.filter((dev) => devDays.get(dev).has(targetDay)).length);
309
+ }
310
+ out.push({ cohort_day: cohortDay, size: devices.length, values });
311
+ }
312
+ return { days, rows: out };
313
+ }
314
+ // ───────────── 聚合重建 ─────────────
315
+ async rebuild(data) {
316
+ const [startTs, endTs] = parseRange(data.start, data.end);
317
+ let groups = 0;
318
+ if (data.granularity === "hour") {
319
+ groups += await rebuildAggEvent("hour", startTs, endTs);
320
+ }
321
+ else if (data.granularity === "day") {
322
+ groups += await rebuildAggEvent("day", startTs, endTs);
323
+ groups += await rebuildAggPageDay(startTs, endTs);
324
+ }
325
+ else {
326
+ throw new AppException(ErrorCode.PARAM_ERROR, "granularity 仅支持 hour / day");
327
+ }
328
+ return { granularity: data.granularity, groups };
329
+ }
330
+ // ───────────── 热点图 ─────────────
331
+ async heatmap(appId, pageKey, pageVersion, kind = "click") {
332
+ await this.ensureApp(appId);
333
+ if (!pageKey)
334
+ throw new AppException(ErrorCode.PARAM_ERROR, "page_key 不能为空");
335
+ const grid = await repo.heatGrid(appId, pageKey, pageVersion, kind);
336
+ const snaps = await listSnapshotRows(appId, pageKey);
337
+ const maxCnt = grid.reduce((m, g) => Math.max(m, g[2]), 0);
338
+ return {
339
+ page_key: pageKey,
340
+ page_version: pageVersion ?? null,
341
+ kind,
342
+ grid_size: HEAT_GRID_SIZE,
343
+ max_cnt: maxCnt,
344
+ grid: grid.map(([x, y, c]) => ({ x, y, cnt: c })),
345
+ snapshots: snaps.map((s) => AnalyticsService.snapshotResp(s)),
346
+ };
347
+ }
348
+ // ───────────── 页面快照 ─────────────
349
+ static snapshotResp(s) {
350
+ return {
351
+ id: s.id,
352
+ page_key: s.page_key,
353
+ page_version: s.page_version ?? null,
354
+ url: s.url ?? null,
355
+ width: s.width ?? null,
356
+ height: s.height ?? null,
357
+ source: s.source ?? null,
358
+ captured_at: s.captured_at ?? null,
359
+ };
360
+ }
361
+ async listSnapshots(appId, pageKey) {
362
+ const rows = await listSnapshotRows(appId, pageKey);
363
+ return rows.map((s) => AnalyticsService.snapshotResp(s));
364
+ }
365
+ async uploadSnapshot(appId, pageKey, pageVersion, data, contentType, filename, width, height) {
366
+ await this.ensureApp(appId);
367
+ const row = await saveSnapshotBytes(appId, pageKey, pageVersion, data, contentType, filename, width, height, "manual");
368
+ return AnalyticsService.snapshotResp(row);
369
+ }
370
+ async captureSnapshot(data) {
371
+ await this.ensureApp(data.app_id);
372
+ const row = await captureAndSave(data.app_id, data.page_key, data.url, data.page_version);
373
+ return AnalyticsService.snapshotResp(row);
374
+ }
375
+ // ───────────── 路径分析 ─────────────
376
+ async path(appId, nodeType, start, end, limit = 20) {
377
+ await this.ensureApp(appId);
378
+ if (nodeType !== "page" && nodeType !== "event") {
379
+ throw new AppException(ErrorCode.PARAM_ERROR, "node_type 仅支持 page / event");
380
+ }
381
+ const [startTs, endTs] = parseRange(start, end);
382
+ const rows = await repo.orderedEvents(appId, startTs, endTs, nodeType);
383
+ const prev = new Map();
384
+ const counts = new Map();
385
+ for (const [device, node] of rows) {
386
+ const before = prev.get(device);
387
+ if (before !== undefined && before !== node) {
388
+ const key = `${before}|${node}`;
389
+ counts.set(key, (counts.get(key) ?? 0) + 1);
390
+ }
391
+ prev.set(device, node);
392
+ }
393
+ const top = Array.from(counts.entries())
394
+ .sort((a, b) => b[1] - a[1])
395
+ .slice(0, limit);
396
+ const links = top.map(([k, v]) => {
397
+ const [s, t] = k.split("|");
398
+ return { source: s, target: t, value: v };
399
+ });
400
+ const nodes = Array.from(new Set([...links.map((l) => l.source), ...links.map((l) => l.target)])).sort();
401
+ return { node_type: nodeType, nodes, links };
402
+ }
403
+ // ───────────── 分布分析 ─────────────
404
+ async distribution(appId, metric, bucketCount, start, end) {
405
+ await this.ensureApp(appId);
406
+ const [startTs, endTs] = parseRange(start, end);
407
+ let values = [];
408
+ let unit = "";
409
+ if (metric === "session_duration") {
410
+ values = (await repo.sessionsWindow(appId, startTs, endTs)).map(([d]) => num(d));
411
+ unit = "ms";
412
+ }
413
+ else if (metric === "page_views") {
414
+ values = (await repo.sessionsWindow(appId, startTs, endTs)).map(([, pv]) => num(pv));
415
+ }
416
+ else if (metric === "event_count") {
417
+ values = await repo.deviceEventCounts(appId, startTs, endTs);
418
+ }
419
+ else {
420
+ throw new AppException(ErrorCode.PARAM_ERROR, "metric 仅支持 session_duration / page_views / event_count");
421
+ }
422
+ const total = values.length;
423
+ if (total === 0)
424
+ return { metric, total: 0, buckets: [] };
425
+ const lo = Math.min(...values);
426
+ const hi = Math.max(...values);
427
+ const bc = Math.max(1, Math.min(bucketCount, 50));
428
+ if (hi === lo) {
429
+ return {
430
+ metric,
431
+ total,
432
+ buckets: [{ label: String(lo), min: lo, max: hi, count: total }],
433
+ };
434
+ }
435
+ const width = (hi - lo) / bc;
436
+ const buckets = Array.from({ length: bc }, (_, i) => ({
437
+ label: "",
438
+ min: lo + i * width,
439
+ max: lo + (i + 1) * width,
440
+ count: 0,
441
+ }));
442
+ for (const v of values) {
443
+ const idx = Math.min(bc - 1, Math.floor((v - lo) / width));
444
+ buckets[idx].count += 1;
445
+ }
446
+ for (const b of buckets) {
447
+ b.label = `${Math.floor(b.min)}~${Math.floor(b.max)}${unit}`;
448
+ }
449
+ return { metric, total, buckets };
450
+ }
451
+ // ───────────── 埋点规则(可视化圈选) ─────────────
452
+ static ruleResp(r) {
453
+ return {
454
+ id: r.id,
455
+ app_id: r.app_id,
456
+ page_key: r.page_key ?? null,
457
+ elem_selector: r.elem_selector,
458
+ elem_id: r.elem_id,
459
+ elem_type: r.elem_type ?? null,
460
+ events: r.events ?? null,
461
+ enabled: r.enabled,
462
+ remark: r.remark ?? null,
463
+ created_at: r.created_at ?? null,
464
+ updated_at: r.updated_at ?? null,
465
+ };
466
+ }
467
+ async listRules(appId, page, size, keyword) {
468
+ await this.ensureApp(appId);
469
+ const { items, total } = await repo.listRules(appId, page, size, keyword);
470
+ return { items: items.map((r) => AnalyticsService.ruleResp(r)), total };
471
+ }
472
+ async createRule(data, createdBy) {
473
+ await this.ensureApp(data.app_id);
474
+ const rule = await repo.createRule({
475
+ app_id: data.app_id,
476
+ tenant_id: null,
477
+ page_key: data.page_key ?? null,
478
+ elem_selector: data.elem_selector,
479
+ elem_id: data.elem_id,
480
+ elem_type: data.elem_type ?? null,
481
+ events: data.events ?? "click",
482
+ enabled: data.enabled ?? 1,
483
+ remark: data.remark ?? null,
484
+ created_by: createdBy ?? null,
485
+ });
486
+ return AnalyticsService.ruleResp(rule);
487
+ }
488
+ async updateRule(ruleId, data) {
489
+ const rule = await repo.findRule(ruleId);
490
+ if (!rule)
491
+ throw new NotFoundException("埋点规则不存在");
492
+ const patch = {};
493
+ if (data.page_key !== undefined)
494
+ patch.page_key = data.page_key;
495
+ if (data.elem_selector !== undefined)
496
+ patch.elem_selector = data.elem_selector;
497
+ if (data.elem_id !== undefined)
498
+ patch.elem_id = data.elem_id;
499
+ if (data.elem_type !== undefined)
500
+ patch.elem_type = data.elem_type;
501
+ if (data.events !== undefined)
502
+ patch.events = data.events;
503
+ if (data.enabled !== undefined)
504
+ patch.enabled = data.enabled;
505
+ if (data.remark !== undefined)
506
+ patch.remark = data.remark;
507
+ const updated = await repo.updateRule(ruleId, patch);
508
+ return AnalyticsService.ruleResp(updated);
509
+ }
510
+ async deleteRule(ruleId) {
511
+ const rule = await repo.findRule(ruleId);
512
+ if (!rule)
513
+ throw new NotFoundException("埋点规则不存在");
514
+ await repo.deleteRule(ruleId);
515
+ }
516
+ async rulesForSdk(appId, pageKey) {
517
+ const rules = await repo.enabledRules(appId, pageKey);
518
+ return rules.map((r) => ({
519
+ selector: r.elem_selector,
520
+ elem_id: r.elem_id,
521
+ elem_type: r.elem_type,
522
+ events: r.events ?? "click",
523
+ page_key: r.page_key,
524
+ }));
525
+ }
526
+ // ───────────── 数据导出 ─────────────
527
+ async exportCsv(appId, exportType, start, end) {
528
+ await this.ensureApp(appId);
529
+ const [startTs, endTs] = parseRange(start, end);
530
+ const lines = [];
531
+ const csvEscape = (v) => {
532
+ const s = v === null || v === undefined ? "" : String(v);
533
+ return /[",\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
534
+ };
535
+ if (exportType === "events") {
536
+ lines.push(["event_code", "total", "uv", "first_day", "last_day"].join(","));
537
+ for (const r of await repo.eventList(appId, startTs, endTs)) {
538
+ lines.push([r.event_code, r.total, r.uv, r.first_day ?? "", r.last_day ?? ""].map(csvEscape).join(","));
539
+ }
540
+ }
541
+ else if (exportType === "pages") {
542
+ lines.push(["page_key", "pv", "uv"].join(","));
543
+ for (const [p, c, u] of await repo.pageStats(appId, startTs, endTs)) {
544
+ lines.push([p, c, u].map(csvEscape).join(","));
545
+ }
546
+ }
547
+ else if (exportType === "elements") {
548
+ lines.push(["elem_id", "elem_type", "page_key", "cnt", "uv"].join(","));
549
+ for (const r of await repo.elementRanking(appId, startTs, endTs, "$click")) {
550
+ lines.push(r.map(csvEscape).join(","));
551
+ }
552
+ }
553
+ else if (exportType === "search") {
554
+ const [startDay, endDay] = parseDayRange(start, end);
555
+ lines.push(["query_norm", "search_cnt", "zero_result_cnt", "click_cnt", "convert_cnt", "rank_sum"].join(","));
556
+ for (const r of await repo.searchStats(appId, startDay, endDay, false)) {
557
+ lines.push(r.map(csvEscape).join(","));
558
+ }
559
+ }
560
+ else if (exportType === "preferences") {
561
+ const [startDay, endDay] = parseDayRange(start, end);
562
+ lines.push(["target_type", "target_id", "action", "cnt", "score_sum"].join(","));
563
+ for (const r of await repo.prefStats(appId, startDay, endDay, null)) {
564
+ lines.push(r.map(csvEscape).join(","));
565
+ }
566
+ }
567
+ else {
568
+ throw new AppException(ErrorCode.PARAM_ERROR, "export_type 不支持");
569
+ }
570
+ const content = "\ufeff" + lines.join("\n");
571
+ return [`analytics_${exportType}_${appId}.csv`, content];
572
+ }
573
+ // ───────────── 治理规则 / 配置 / 清理 ─────────────
574
+ static govResp(r) {
575
+ return {
576
+ id: r.id,
577
+ app_id: r.app_id ?? null,
578
+ rule_type: r.rule_type,
579
+ target: parseJson(r.target, null),
580
+ value: parseJson(r.value, null),
581
+ priority: r.priority,
582
+ enabled: r.enabled,
583
+ remark: r.remark ?? null,
584
+ created_at: r.created_at ?? null,
585
+ updated_at: r.updated_at ?? null,
586
+ };
587
+ }
588
+ async listGovRules(page, size, keyword) {
589
+ const { items, total } = await repo.listGovRules(page, size, keyword);
590
+ return { items: items.map((r) => AnalyticsService.govResp(r)), total };
591
+ }
592
+ async createGovRule(data, createdBy) {
593
+ const rule = await repo.createGovRule({
594
+ app_id: data.app_id ?? null,
595
+ tenant_id: null,
596
+ rule_type: data.rule_type,
597
+ target: data.target ? JSON.stringify(data.target) : null,
598
+ value: data.value ? JSON.stringify(data.value) : null,
599
+ priority: data.priority ?? 100,
600
+ enabled: data.enabled ?? 1,
601
+ remark: data.remark ?? null,
602
+ created_by: createdBy ?? null,
603
+ });
604
+ return AnalyticsService.govResp(rule);
605
+ }
606
+ async updateGovRule(ruleId, data) {
607
+ const rule = await repo.findGovRule(ruleId);
608
+ if (!rule)
609
+ throw new NotFoundException("治理规则不存在");
610
+ const patch = {};
611
+ if (data.app_id !== undefined)
612
+ patch.app_id = data.app_id;
613
+ if (data.rule_type !== undefined)
614
+ patch.rule_type = data.rule_type;
615
+ if (data.target !== undefined)
616
+ patch.target = data.target ? JSON.stringify(data.target) : null;
617
+ if (data.value !== undefined)
618
+ patch.value = data.value ? JSON.stringify(data.value) : null;
619
+ if (data.priority !== undefined)
620
+ patch.priority = data.priority;
621
+ if (data.enabled !== undefined)
622
+ patch.enabled = data.enabled;
623
+ if (data.remark !== undefined)
624
+ patch.remark = data.remark;
625
+ const updated = await repo.updateGovRule(ruleId, patch);
626
+ return AnalyticsService.govResp(updated);
627
+ }
628
+ async deleteGovRule(ruleId) {
629
+ const rule = await repo.findGovRule(ruleId);
630
+ if (!rule)
631
+ throw new NotFoundException("治理规则不存在");
632
+ await repo.deleteGovRule(ruleId);
633
+ }
634
+ async govConfig(appId) {
635
+ const policy = await buildPolicy(appId);
636
+ const pub = policyPublic(policy);
637
+ return {
638
+ app_id: appId,
639
+ collect: pub["collect"],
640
+ sample_rate: pub["sample_rate"],
641
+ switches: pub["switches"],
642
+ retention: pub["retention"],
643
+ privacy: { sensitive_fields: policy.privacy.sensitive_fields },
644
+ };
645
+ }
646
+ async cleanup() {
647
+ const policy = await buildPolicy("");
648
+ const deleted = await cleanupExpired(policy);
649
+ return { deleted };
650
+ }
651
+ }
652
+ export { ANA_APP_TABLE, ANA_EVENT_TABLE, ANA_TRACK_RULE_TABLE, ANA_GOV_RULE_TABLE };
653
+ //# sourceMappingURL=service.js.map