befly 3.19.0 → 3.19.5

package/sql/befly.sql

@@ -171,4 +171,58 @@ CREATE TABLE IF NOT EXISTS `befly_sys_config` (
     `updated_at` BIGINT NOT NULL DEFAULT 0,
     `deleted_at` BIGINT NULL DEFAULT NULL,
     PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS `befly_visit_stats` (
+    `id` BIGINT NOT NULL,
+    `bucket_time` BIGINT NOT NULL DEFAULT 0,
+    `bucket_date` INT NOT NULL DEFAULT 0,
+    `pv` BIGINT NOT NULL DEFAULT 0,
+    `uv` BIGINT NOT NULL DEFAULT 0,
+    `error_count` BIGINT NOT NULL DEFAULT 0,
+    `duration_sum` BIGINT NOT NULL DEFAULT 0,
+    `duration_count` BIGINT NOT NULL DEFAULT 0,
+    `avg_duration` BIGINT NOT NULL DEFAULT 0,
+    `state` TINYINT NOT NULL DEFAULT 1,
+    `created_at` BIGINT NOT NULL DEFAULT 0,
+    `updated_at` BIGINT NOT NULL DEFAULT 0,
+    `deleted_at` BIGINT NULL DEFAULT NULL,
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uk_befly_visit_stats_bucket_time` (`bucket_time`),
+    KEY `idx_befly_visit_stats_bucket_date` (`bucket_date`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS `befly_error_report` (
+    `id` BIGINT NOT NULL,
+    `report_time` BIGINT NOT NULL DEFAULT 0,
+    `first_report_time` BIGINT NOT NULL DEFAULT 0,
+    `bucket_time` BIGINT NOT NULL DEFAULT 0,
+    `bucket_date` INT NOT NULL DEFAULT 0,
+    `hit_count` BIGINT NOT NULL DEFAULT 1,
+    `source` VARCHAR(50) NOT NULL DEFAULT '',
+    `product_name` VARCHAR(100) NOT NULL DEFAULT '',
+    `product_code` VARCHAR(100) NOT NULL DEFAULT '',
+    `product_version` VARCHAR(100) NOT NULL DEFAULT '',
+    `page_path` VARCHAR(200) NOT NULL DEFAULT '',
+    `page_name` VARCHAR(100) NOT NULL DEFAULT '',
+    `error_type` VARCHAR(50) NOT NULL DEFAULT '',
+    `message` VARCHAR(500) NOT NULL DEFAULT '',
+    `detail` TEXT NULL,
+    `user_agent` VARCHAR(500) NOT NULL DEFAULT '',
+    `browser_name` VARCHAR(100) NOT NULL DEFAULT '',
+    `browser_version` VARCHAR(100) NOT NULL DEFAULT '',
+    `os_name` VARCHAR(100) NOT NULL DEFAULT '',
+    `os_version` VARCHAR(100) NOT NULL DEFAULT '',
+    `device_type` VARCHAR(50) NOT NULL DEFAULT '',
+    `device_vendor` VARCHAR(100) NOT NULL DEFAULT '',
+    `device_model` VARCHAR(100) NOT NULL DEFAULT '',
+    `engine_name` VARCHAR(100) NOT NULL DEFAULT '',
+    `cpu_architecture` VARCHAR(100) NOT NULL DEFAULT '',
+    `state` TINYINT NOT NULL DEFAULT 1,
+    `created_at` BIGINT NOT NULL DEFAULT 0,
+    `updated_at` BIGINT NOT NULL DEFAULT 0,
+    `deleted_at` BIGINT NULL DEFAULT NULL,
+    PRIMARY KEY (`id`),
+    KEY `idx_befly_error_report_time` (`report_time`),
+    KEY `idx_befly_error_report_bucket_date` (`bucket_date`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

package/utils/datetime.js

@@ -0,0 +1,76 @@
+const visitStatsDateFormatter = new Intl.DateTimeFormat("en-CA", {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+});
+
+export const DAY_MS = 24 * 60 * 60 * 1000;
+
+function toDate(value = Date.now()) {
+    if (value instanceof Date) {
+        return value;
+    }
+
+    return Reflect.construct(Date, [value]);
+}
+
+function padDatePart(value) {
+    if (value < 10) {
+        return `0${value}`;
+    }
+
+    return String(value);
+}
+
+export function addDays(timestamp = Date.now(), days = 0) {
+    return Number(timestamp || 0) + Number(days || 0) * DAY_MS;
+}
+
+export function getDateYmdNumber(timestamp = Date.now()) {
+    return Number(visitStatsDateFormatter.format(timestamp).replace(/[^0-9]/g, ""));
+}
+
+export function getDayStartTime(timestamp = Date.now()) {
+    const date = toDate(timestamp);
+    return Reflect.construct(Date, [date.getFullYear(), date.getMonth(), date.getDate(), 0, 0, 0, 0]).getTime();
+}
+
+export function getDayEndTime(timestamp = Date.now()) {
+    return getDayStartTime(timestamp) + DAY_MS - 1;
+}
+
+export function getTimeBucketStart(timestamp = Date.now(), bucketMs = 0) {
+    const bucket = Number(bucketMs || 0);
+    if (bucket <= 0) {
+        return Number(timestamp || 0);
+    }
+
+    const time = Number(timestamp || 0);
+    return time - (time % bucket);
+}
+
+export function formatYmdHms(value = Date.now(), format = "dateTime") {
+    const date = toDate(value);
+    const y = date.getFullYear();
+    const m = date.getMonth() + 1;
+    const d = date.getDate();
+    const h = date.getHours();
+    const mi = date.getMinutes();
+    const s = date.getSeconds();
+
+    const mm = padDatePart(m);
+    const dd = padDatePart(d);
+    const hh = padDatePart(h);
+    const mii = padDatePart(mi);
+    const ss = padDatePart(s);
+
+    if (format === "date") {
+        return `${y}-${mm}-${dd}`;
+    }
+
+    if (format === "time") {
+        return `${hh}:${mii}:${ss}`;
+    }
+
+    return `${y}-${mm}-${dd} ${hh}:${mii}:${ss}`;
+}

package/utils/visitStats.js

@@ -0,0 +1,121 @@
+export const VISIT_STATS_REDIS_TTL_SECONDS = 7 * 24 * 60 * 60;
+export const VISIT_STATS_ONLINE_TTL_SECONDS = 10 * 60;
+export const VISIT_STATS_BUCKET_MS = 30 * 60 * 1000;
+export const VISIT_STATS_UA_FIELDS = [
+    { field: "deviceType", defaultValue: "desktop" },
+    { field: "browserName", defaultValue: "Unknown" },
+    { field: "browserVersion", defaultValue: "Unknown" },
+    { field: "osName", defaultValue: "Unknown" },
+    { field: "osVersion", defaultValue: "Unknown" },
+    { field: "deviceVendor", defaultValue: "Unknown" },
+    { field: "deviceModel", defaultValue: "Unknown" },
+    { field: "engineName", defaultValue: "Unknown" },
+    { field: "cpuArchitecture", defaultValue: "Unknown" }
+];
+export const VISIT_STATS_PRODUCT_FIELDS = [
+    { field: "productName", defaultValue: "Unknown" },
+    { field: "productCode", defaultValue: "unknown" },
+    { field: "productVersion", defaultValue: "Unknown" }
+];
+
+export function getVisitStatsBucketKey(bucketTime) {
+    return `visitStats:bucket:${bucketTime}`;
+}
+
+export function getVisitStatsDayKey(bucketDate) {
+    return `visitStats:day:${bucketDate}`;
+}
+
+export function normalizeVisitStatsUaValue(value, defaultValue = "Unknown") {
+    const text = String(value || "").trim();
+    if (!text) {
+        return defaultValue;
+    }
+
+    return text;
+}
+
+export function normalizeVisitStatsProductValue(value, defaultValue = "Unknown") {
+    const text = String(value || "")
+        .trim()
+        .slice(0, 100);
+
+    if (!text) {
+        return defaultValue;
+    }
+
+    return text;
+}
+
+export function getVisitStatsProductMeta(productData = {}) {
+    return {
+        productName: normalizeVisitStatsProductValue(productData.productName, "Unknown"),
+        productCode: normalizeVisitStatsProductValue(productData.productCode, "unknown"),
+        productVersion: normalizeVisitStatsProductValue(productData.productVersion, "Unknown")
+    };
+}
+
+export function getVisitStatsProductKey(productData = {}) {
+    const meta = getVisitStatsProductMeta(productData);
+    return [meta.productCode, meta.productVersion, meta.productName].map((item) => encodeURIComponent(item)).join("|");
+}
+
+export function parseVisitStatsProductKey(productKey) {
+    const parts = String(productKey || "")
+        .split("|")
+        .map((item) => decodeURIComponent(item || ""));
+
+    return getVisitStatsProductMeta({
+        productCode: parts[0],
+        productVersion: parts[1],
+        productName: parts[2]
+    });
+}
+
+export function getVisitStatsDayUaValuesKey(bucketDate, field) {
+    return `visitStats:day:${bucketDate}:ua:${field}:values`;
+}
+
+export function getVisitStatsDayUaCountKey(bucketDate, field, value) {
+    return `visitStats:day:${bucketDate}:ua:${field}:count:${encodeURIComponent(String(value || ""))}`;
+}
+
+export function getVisitStatsDayProductValuesKey(bucketDate, field) {
+    return `visitStats:day:${bucketDate}:product:${field}:values`;
+}
+
+export function getVisitStatsDayProductCountKey(bucketDate, field, value) {
+    return `visitStats:day:${bucketDate}:product:${field}:count:${encodeURIComponent(String(value || ""))}`;
+}
+
+export function getVisitStatsDayProductKeysKey(bucketDate) {
+    return `visitStats:day:${bucketDate}:product:keys`;
+}
+
+export function getVisitStatsProductMetaKey(productKey) {
+    return `visitStats:product:meta:${productKey}`;
+}
+
+export function getVisitStatsBucketProductPvKey(bucketTime, productKey) {
+    return `visitStats:bucket:${bucketTime}:product:${productKey}:pv`;
+}
+
+export function getVisitStatsBucketProductUvKey(bucketTime, productKey) {
+    return `visitStats:bucket:${bucketTime}:product:${productKey}:uv`;
+}
+
+export function getVisitStatsDayProductPvKey(bucketDate, productKey) {
+    return `visitStats:day:${bucketDate}:product:${productKey}:pv`;
+}
+
+export function getVisitStatsDayProductUvKey(bucketDate, productKey) {
+    return `visitStats:day:${bucketDate}:product:${productKey}:uv`;
+}
+
+export function toVisitStatsNumber(value) {
+    const num = Number(value);
+    if (!Number.isFinite(num)) {
+        return 0;
+    }
+    return num;
+}

package/utils/formatYmdHms.js

@@ -1,23 +0,0 @@
-export function formatYmdHms(date, format = "dateTime") {
-    const y = date.getFullYear();
-    const m = date.getMonth() + 1;
-    const d = date.getDate();
-    const h = date.getHours();
-    const mi = date.getMinutes();
-    const s = date.getSeconds();
-
-    const mm = m < 10 ? `0${m}` : String(m);
-    const dd = d < 10 ? `0${d}` : String(d);
-    const hh = h < 10 ? `0${h}` : String(h);
-    const mii = mi < 10 ? `0${mi}` : String(mi);
-    const ss = s < 10 ? `0${s}` : String(s);
-
-    if (format === "date") {
-        return `${y}-${mm}-${dd}`;
-    }
-    if (format === "time") {
-        return `${hh}:${mii}:${ss}`;
-    }
-
-    return `${y}-${mm}-${dd} ${hh}:${mii}:${ss}`;
-}