@gct-paas/core 0.1.6-dev.4 → 0.1.6-dev.40

package/es/modules/platform-config/store.d.ts

@@ -9,18 +9,18 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
     deploySetting: {
         deployMode: import('./enums').DeployModeEnum;
     };
-    setDeploySetting: (data: SysConfigResponse) => void;
+    setDeploySetting: (data: IObject | undefined) => void;
     isIndependentApp: import('vue').ComputedRef<boolean>;
     loginSetting: import('@gct-paas/api/platform').AuthConfig;
     postLoginSetting: () => Promise<void>;
-    setLoginSetting: (config: SysConfigResponse | undefined) => void;
+    setLoginSetting: (config: IObject | undefined) => void;
     loginModeAuthTypes: import('vue').Ref<string[], string[]>;
     openIDOAuthAuthTypes: import('vue').Ref<string[], string[]>;
     sysLoginSort: import('vue').Ref<IObject[], IObject[]>;
     openIDOAuthAuthSort: import('vue').Ref<IObject[], IObject[]>;
     loginModeConfig: Map<string, IObject>;
     orgSetting: import('@gct-paas/api/platform').OrgConfig;
-    setOrgSetting: (data: SysConfigResponse) => void;
+    setOrgSetting: (data: IObject) => void;
     postOrgSetting: () => Promise<void>;
     relationFields: import('vue').Ref<{
         label: string;
@@ -47,7 +47,7 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
     }[]>;
     securitySetting: import('@gct-paas/api/platform').SecurityConfig;
     postSecuritySetting: () => Promise<void>;
-    setSecuritySetting: (data: SysConfigResponse) => void;
+    setSecuritySetting: (data: IObject | undefined) => void;
     getSignWay: () => "DOMAIN" | "LOGIN" | "SIGN";
     themeSetting: import('./interfaces').IThemeSetting;
     setThemeSetting: (data: SysConfigResponse) => void;
@@ -56,7 +56,7 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
     toggleMenuCollapsed: () => void;
     menuCollapsedWidth: number;
     menuWidthRange: number[];
-    themeColors: string[];
+    themeColors: readonly ["#026AC8", "#0DAA9C"];
     watermarkSetting: {
         openWatermark: boolean;
         watermarkContent: string;
@@ -70,7 +70,7 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
         height: number;
     };
     postWatermarkSetting: () => Promise<void>;
-    setWatermarkSetting: (data: SysConfigResponse) => void;
+    setWatermarkSetting: (data: IObject | undefined) => void;
     projectSetting: {};
     setProjectConfig: (config: {}) => void;
     init: () => Promise<void>;
@@ -82,18 +82,18 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
     deploySetting: {
         deployMode: import('./enums').DeployModeEnum;
     };
-    setDeploySetting: (data: SysConfigResponse) => void;
+    setDeploySetting: (data: IObject | undefined) => void;
     isIndependentApp: import('vue').ComputedRef<boolean>;
     loginSetting: import('@gct-paas/api/platform').AuthConfig;
     postLoginSetting: () => Promise<void>;
-    setLoginSetting: (config: SysConfigResponse | undefined) => void;
+    setLoginSetting: (config: IObject | undefined) => void;
     loginModeAuthTypes: import('vue').Ref<string[], string[]>;
     openIDOAuthAuthTypes: import('vue').Ref<string[], string[]>;
     sysLoginSort: import('vue').Ref<IObject[], IObject[]>;
     openIDOAuthAuthSort: import('vue').Ref<IObject[], IObject[]>;
     loginModeConfig: Map<string, IObject>;
     orgSetting: import('@gct-paas/api/platform').OrgConfig;
-    setOrgSetting: (data: SysConfigResponse) => void;
+    setOrgSetting: (data: IObject) => void;
     postOrgSetting: () => Promise<void>;
     relationFields: import('vue').Ref<{
         label: string;
@@ -120,7 +120,7 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
     }[]>;
     securitySetting: import('@gct-paas/api/platform').SecurityConfig;
     postSecuritySetting: () => Promise<void>;
-    setSecuritySetting: (data: SysConfigResponse) => void;
+    setSecuritySetting: (data: IObject | undefined) => void;
     getSignWay: () => "DOMAIN" | "LOGIN" | "SIGN";
     themeSetting: import('./interfaces').IThemeSetting;
     setThemeSetting: (data: SysConfigResponse) => void;
@@ -129,7 +129,7 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
     toggleMenuCollapsed: () => void;
     menuCollapsedWidth: number;
     menuWidthRange: number[];
-    themeColors: string[];
+    themeColors: readonly ["#026AC8", "#0DAA9C"];
     watermarkSetting: {
         openWatermark: boolean;
         watermarkContent: string;
@@ -143,7 +143,7 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
         height: number;
     };
     postWatermarkSetting: () => Promise<void>;
-    setWatermarkSetting: (data: SysConfigResponse) => void;
+    setWatermarkSetting: (data: IObject | undefined) => void;
     projectSetting: {};
     setProjectConfig: (config: {}) => void;
     init: () => Promise<void>;
@@ -155,18 +155,18 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
     deploySetting: {
         deployMode: import('./enums').DeployModeEnum;
     };
-    setDeploySetting: (data: SysConfigResponse) => void;
+    setDeploySetting: (data: IObject | undefined) => void;
     isIndependentApp: import('vue').ComputedRef<boolean>;
     loginSetting: import('@gct-paas/api/platform').AuthConfig;
     postLoginSetting: () => Promise<void>;
-    setLoginSetting: (config: SysConfigResponse | undefined) => void;
+    setLoginSetting: (config: IObject | undefined) => void;
     loginModeAuthTypes: import('vue').Ref<string[], string[]>;
     openIDOAuthAuthTypes: import('vue').Ref<string[], string[]>;
     sysLoginSort: import('vue').Ref<IObject[], IObject[]>;
     openIDOAuthAuthSort: import('vue').Ref<IObject[], IObject[]>;
     loginModeConfig: Map<string, IObject>;
     orgSetting: import('@gct-paas/api/platform').OrgConfig;
-    setOrgSetting: (data: SysConfigResponse) => void;
+    setOrgSetting: (data: IObject) => void;
     postOrgSetting: () => Promise<void>;
     relationFields: import('vue').Ref<{
         label: string;
@@ -193,7 +193,7 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
     }[]>;
     securitySetting: import('@gct-paas/api/platform').SecurityConfig;
     postSecuritySetting: () => Promise<void>;
-    setSecuritySetting: (data: SysConfigResponse) => void;
+    setSecuritySetting: (data: IObject | undefined) => void;
     getSignWay: () => "DOMAIN" | "LOGIN" | "SIGN";
     themeSetting: import('./interfaces').IThemeSetting;
     setThemeSetting: (data: SysConfigResponse) => void;
@@ -202,7 +202,7 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
     toggleMenuCollapsed: () => void;
     menuCollapsedWidth: number;
     menuWidthRange: number[];
-    themeColors: string[];
+    themeColors: readonly ["#026AC8", "#0DAA9C"];
     watermarkSetting: {
         openWatermark: boolean;
         watermarkContent: string;
@@ -216,7 +216,7 @@ export declare const usePlatformConfigStore: import('pinia').StoreDefinition<"pl
         height: number;
     };
     postWatermarkSetting: () => Promise<void>;
-    setWatermarkSetting: (data: SysConfigResponse) => void;
+    setWatermarkSetting: (data: IObject | undefined) => void;
     projectSetting: {};
     setProjectConfig: (config: {}) => void;
     init: () => Promise<void>;

package/es/modules/platform-config/useDeploySetting.d.ts

@@ -1,10 +1,9 @@
-import { SysConfigResponse } from '@gct-paas/api/platform';
 import { DeployModeEnum } from './enums/deploy.enum';
 /**
  * 设置部署配置信息
  * @param data - 系统配置响应数据
  */
-declare function setDeploySetting(data: SysConfigResponse): void;
+declare function setDeploySetting(data: IObject | undefined): void;
 /**
  * 部署设置 Composable 函数
  * @returns 返回部署设置相关的响应式数据和方法

package/es/modules/platform-config/useDeploySetting.mjs

@@ -1,6 +1,10 @@
 import { DeployModeEnum } from "./enums/deploy.enum.mjs";
 import { computed, reactive } from "vue";
 //#region src/modules/platform-config/useDeploySetting.ts
+/**
+* 部署设置 Composable
+* 用于管理应用的部署模式配置
+*/
 /** 部署设置响应式对象 */
 var deploySetting = reactive({ deployMode: DeployModeEnum.STANDARD });
 /** 是否为独立应用部署模式的计算属性 */
@@ -12,10 +16,9 @@ var isIndependentApp = computed(() => {
 * @param data - 系统配置响应数据
 */
 function setDeploySetting(data) {
-	const { value } = data;
-	if (!value) return;
+	if (!data || !data.id) return;
 	try {
-		Object.assign(deploySetting, JSON.parse(value));
+		Object.assign(deploySetting, data);
 	} catch (err) {
 		console.warn(err);
 	}

package/es/modules/platform-config/useLoginSetting.d.ts

@@ -1,4 +1,4 @@
-import { AuthConfig, SysConfigResponse } from '@gct-paas/api/platform';
+import { AuthConfig } from '@gct-paas/api/platform';
 /**
  * 登录设置 Composable 函数
  * @returns 返回登录设置相关的响应式数据和方法
@@ -6,7 +6,7 @@ import { AuthConfig, SysConfigResponse } from '@gct-paas/api/platform';
 export declare function useLoginSetting(): {
     loginSetting: AuthConfig;
     postLoginSetting: () => Promise<void>;
-    setLoginSetting: (config: SysConfigResponse | undefined) => void;
+    setLoginSetting: (config: IObject | undefined) => void;
     loginModeAuthTypes: import('vue').Ref<string[], string[]>;
     openIDOAuthAuthTypes: import('vue').Ref<string[], string[]>;
     sysLoginSort: import('vue').Ref<IObject[], IObject[]>;

package/es/modules/platform-config/useLoginSetting.mjs

@@ -106,39 +106,37 @@ function useLoginSetting() {
 	* @param config - 系统配置响应数据
 	*/
 	const setLoginSetting = (config) => {
-		if (config && config.value) {
-			const value = JSON.parse(config.value);
-			for (const k in value) if (k in loginSetting) loginSetting[k] = value[k];
-			if (has(value, "sortJson") && !isEmpty(value.sortJson)) {
-				const sortObj = JSON.parse(value.sortJson);
-				if (has(sortObj, LoginSortTypeEnum.SYSTEM)) sysLoginSort.value = getLoginTypeOptions(sortObj[LoginSortTypeEnum.SYSTEM]);
-				if (has(sortObj, LoginSortTypeEnum.THIRD_PARTY)) openIDOAuthAuthSort.value = getLoginTypeOptions(sortObj[LoginSortTypeEnum.THIRD_PARTY]);
-			}
-			loginSetting.loginModeConfigs?.forEach((item) => {
-				loginModeConfig.set(item.authType, {
-					...item,
-					enabled: 0
-				});
+		if (!config || !config.id) return;
+		for (const k in config) if (k in loginSetting) loginSetting[k] = config[k];
+		if (has(config, "sortJson") && !isEmpty(config.sortJson)) {
+			const sortObj = JSON.parse(config.sortJson);
+			if (has(sortObj, LoginSortTypeEnum.SYSTEM)) sysLoginSort.value = getLoginTypeOptions(sortObj[LoginSortTypeEnum.SYSTEM]);
+			if (has(sortObj, LoginSortTypeEnum.THIRD_PARTY)) openIDOAuthAuthSort.value = getLoginTypeOptions(sortObj[LoginSortTypeEnum.THIRD_PARTY]);
+		}
+		loginSetting.loginModeConfigs?.forEach((item) => {
+			loginModeConfig.set(item.authType, {
+				...item,
+				enabled: 0
 			});
-			const loginModeConfigs = loginSetting.loginModeConfigs?.filter((item) => {
-				return item.enabled;
-			}).map((i) => {
-				return i.authType;
-			}) || [];
-			loginModeConfigs.push(LoginTypeEnum.ACCOUNT);
-			loginModeAuthTypes.value = [...new Set(loginModeConfigs)];
-			loginSetting.openIDOAuthConfigs?.forEach((item) => {
-				loginModeConfig.set(item.authType, {
-					...item,
-					enabled: 0
-				});
+		});
+		const loginModeConfigs = loginSetting.loginModeConfigs?.filter((item) => {
+			return item.enabled;
+		}).map((i) => {
+			return i.authType;
+		}) || [];
+		loginModeConfigs.push(LoginTypeEnum.ACCOUNT);
+		loginModeAuthTypes.value = [...new Set(loginModeConfigs)];
+		loginSetting.openIDOAuthConfigs?.forEach((item) => {
+			loginModeConfig.set(item.authType, {
+				...item,
+				enabled: 0
 			});
-			openIDOAuthAuthTypes.value = loginSetting.openIDOAuthConfigs?.filter((item) => {
-				return item.enabled;
-			}).map((i) => {
-				return i.authType;
-			}) || [];
-		}
+		});
+		openIDOAuthAuthTypes.value = loginSetting.openIDOAuthConfigs?.filter((item) => {
+			return item.enabled;
+		}).map((i) => {
+			return i.authType;
+		}) || [];
 	};
 	return {
 		loginSetting,

package/es/modules/platform-config/useOrgSetting.d.ts

@@ -1,4 +1,4 @@
-import { OrgConfig, SysConfigResponse } from '@gct-paas/api/platform';
+import { OrgConfig } from '@gct-paas/api/platform';
 /**
  * 组织设置 Composable 函数
  * @param isPlatform - 是否为平台模式，默认为 true
@@ -6,7 +6,7 @@ import { OrgConfig, SysConfigResponse } from '@gct-paas/api/platform';
  */
 export declare function useOrgSetting(isPlatform?: boolean): {
     orgSetting: OrgConfig;
-    setOrgSetting: (data: SysConfigResponse) => void;
+    setOrgSetting: (data: IObject) => void;
     postOrgSetting: () => Promise<void>;
     relationFields: import('vue').Ref<{
         label: string;

package/es/modules/platform-config/useOrgSetting.mjs

@@ -38,19 +38,17 @@ function useOrgSetting(isPlatform = true) {
 	* @param data - 系统配置响应数据
 	*/
 	function setOrgSetting(data) {
-		const { value } = data;
-		if (!value) return;
+		if (!data || !data.id) return;
 		try {
-			const setting = JSON.parse(value);
-			for (const key in setting) if (key == "supportLoginFields") setting["supportLoginFields"] = setting["supportLoginFields"].filter((i) => i !== "username_");
-			Object.assign(orgSetting, setting);
+			for (const key in data) if (key == "supportLoginFields") data["supportLoginFields"] = data["supportLoginFields"].filter((i) => i !== "username_");
+			Object.assign(orgSetting, data);
 			if (orgSetting.extFieldConfigs && orgSetting.extFieldConfigs.length) orgSetting.extFieldConfigs.forEach((element) => {
 				relationFields.value = relationFields.value.filter((i) => {
 					if (i.value == element.relationField) relationFiledsCopy.value.push(i);
 					return i.value !== element.relationField;
 				});
 			});
-			orgSetting.extFieldConfigs = JSON.parse(JSON.stringify(setting.extFieldConfigs));
+			orgSetting.extFieldConfigs = JSON.parse(JSON.stringify(data.extFieldConfigs));
 		} catch (err) {
 			console.warn(err);
 		}

package/es/modules/platform-config/useSecuritySetting.d.ts

@@ -1,4 +1,4 @@
-import { SecurityConfig, SysConfigResponse } from '@gct-paas/api/platform';
+import { SecurityConfig } from '@gct-paas/api/platform';
 /**
  * 安全设置 Composable 函数
  * @param isPlatform - 是否为平台模式，默认为 true
@@ -7,6 +7,6 @@ import { SecurityConfig, SysConfigResponse } from '@gct-paas/api/platform';
 export declare function useSecuritySetting(isPlatform?: boolean): {
     securitySetting: SecurityConfig;
     postSecuritySetting: () => Promise<void>;
-    setSecuritySetting: (data: SysConfigResponse) => void;
+    setSecuritySetting: (data: IObject | undefined) => void;
     getSignWay: () => "DOMAIN" | "LOGIN" | "SIGN";
 };

package/es/modules/platform-config/useSecuritySetting.mjs

@@ -54,10 +54,9 @@ function useSecuritySetting(isPlatform = true) {
 	* @param data - 系统配置响应数据
 	*/
 	function setSecuritySetting(data) {
-		const { value } = data;
-		if (!value) return;
+		if (!data || !data.id) return;
 		try {
-			Object.assign(securitySetting, JSON.parse(value));
+			Object.assign(securitySetting, data);
 		} catch (err) {
 			console.warn(err);
 		}

package/es/modules/platform-config/useThemeSetting.d.ts

@@ -12,5 +12,5 @@ export declare function useThemeSetting(): {
     toggleMenuCollapsed: () => void;
     menuCollapsedWidth: number;
     menuWidthRange: number[];
-    themeColors: string[];
+    themeColors: readonly ["#026AC8", "#0DAA9C"];
 };

package/es/modules/platform-config/useThemeSetting.mjs

@@ -1,4 +1,4 @@
-import { MENU_WIDTH_RANGE, THEME_COLORS } from "./constants/theme.const.mjs";
+import { MENU_WIDTH_RANGE, THEME_COLORS, THEME_COLOR_CLASS, THEME_COLOR_CLASS_MAP } from "./constants/theme.const.mjs";
 import { reactive, ref, watch } from "vue";
 //#region src/modules/platform-config/useThemeSetting.ts
 /**
@@ -30,20 +30,48 @@ var menuCollapsedWidth = 46;
 var menuWidthRange = MENU_WIDTH_RANGE;
 /** 可选的主题颜色列表 */
 var themeColors = THEME_COLORS;
+function setThemeMode(mode) {
+	if (mode === "colorWeak") {
+		document.body.classList.add("color-weak");
+		document.body.classList.remove("gray-mode");
+		return;
+	}
+	if (mode === "gray") {
+		document.body.classList.add("gray-mode");
+		document.body.classList.remove("color-weak");
+		return;
+	}
+	document.body.classList.remove("gray-mode");
+	document.body.classList.remove("color-weak");
+}
 /**
 * 切换颜色模式
 * 根据当前颜色模式更新界面显示效果
 */
 var toggleColorMode = () => {
 	switch (themeSetting.colorMode) {
-		case "colorWeak": break;
-		case "gray": break;
-		default:
+		case "colorWeak":
+			setThemeMode("colorWeak");
+			break;
+		case "gray":
+			setThemeMode("gray");
+			break;
+		default: setThemeMode();
 	}
 };
 watch(() => themeSetting.colorMode, (value) => {
 	if (value) toggleColorMode();
 });
+function applyThemeColorClass(color) {
+	const normalized = color.toUpperCase();
+	const el = document.documentElement;
+	el.classList.remove(THEME_COLOR_CLASS);
+	const themeClass = THEME_COLOR_CLASS_MAP[normalized];
+	if (themeClass) el.classList.add(themeClass);
+}
+watch(() => themeSetting.themeColor, (value) => {
+	if (value) applyThemeColorClass(value);
+}, { immediate: true });
 /**
 * 主题设置 Composable 函数
 * @returns 返回主题设置相关的响应式数据和方法

package/es/modules/platform-config/useWatermarkSetting.d.ts

@@ -1,4 +1,7 @@
-import { SysConfigResponse } from '@gct-paas/api/platform';
+/**
+ * 水印设置 Composable
+ * 用于管理平台的水印配置
+ */
 /**
  * 水印设置 Composable 函数
  * @returns 返回水印设置相关的响应式数据和方法
@@ -17,5 +20,5 @@ export declare function useWatermarkSetting(): {
         height: number;
     };
     postWatermarkSetting: () => Promise<void>;
-    setWatermarkSetting: (data: SysConfigResponse) => void;
+    setWatermarkSetting: (data: IObject | undefined) => void;
 };

package/es/modules/platform-config/useWatermarkSetting.mjs

@@ -22,10 +22,9 @@ function useWatermarkSetting() {
 	* @param data - 系统配置响应数据
 	*/
 	function setWatermarkSetting(data) {
-		const { value } = data;
-		if (!value) return;
+		if (!data || !data.id) return;
 		try {
-			Object.assign(watermarkSetting, JSON.parse(value));
+			Object.assign(watermarkSetting, data);
 		} catch (err) {
 			console.warn(err);
 		}

package/es/modules/sign-log/index.d.ts

@@ -0,0 +1 @@
+export * from './sign-log';

package/es/modules/sign-log/index.mjs

@@ -0,0 +1 @@
+import "./sign-log.mjs";

package/es/modules/sign-log/sign-log.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 注册登录/切换日志。
+ *
+ * @param type  切入平台（如 WORKTABLE、APPFRONT、ENTERPRISE）
+ * @param appId 切入应用 ID
+ * @param tenantId 切入租户 ID
+ *
+ * 流程：读取上下文 → 计算切换标志 → 上报 → 清理 signWay → 更新 session
+ */
+export declare function signLogRegister(type: string, appId: string, tenantId: string): Promise<void>;

package/es/modules/sign-log/sign-log.mjs

@@ -0,0 +1,109 @@
+import { getBrowserFingerprint, getPageIdentification } from "../../utils/deviceFingerprint.mjs";
+import "../../utils/index.mjs";
+import { LoginTypeEnum } from "../platform-config/enums/login.enum.mjs";
+import "../platform-config/index.mjs";
+//#region src/modules/sign-log/sign-log.ts
+/** 读取并解析上一次记录的平台上下文 */
+function getPlatOrAppSession() {
+	const raw = sessionStorage.getItem("currentPlatOrAppId");
+	return {
+		hasSession: !!raw,
+		prev: raw ? JSON.parse(raw) : {}
+	};
+}
+/**
+* 判定是否为租户切换。
+* 例：在工作台从租户 A 切到租户 B → changeTenant=true
+*/
+function isChangeTenant(tenantId, hasSession, prev) {
+	return !!(tenantId && hasSession && prev.tenantId && tenantId !== prev.tenantId);
+}
+/**
+* 判定是否为应用切换（同平台内 appId 变化）。
+*
+* - samePlatformAppSwitch：通用场景，要求前后都有 appId 且平台类型不变
+* - appFrontAppSwitch：APPFRONT 特例，允许 prev.appId 为空（首次进入某应用后再切换）
+*/
+function isChangeApp(type, appId, hasSession, prev) {
+	const samePlatformAppSwitch = !!(appId && hasSession && prev.appId && type === prev.type && appId !== prev.appId);
+	const appFrontAppSwitch = !!(hasSession && type === prev.type && appId !== prev.appId && type === "APPFRONT");
+	return samePlatformAppSwitch || appFrontAppSwitch;
+}
+/**
+* 判定是否为平台切换。
+*
+* 满足以下任一即视为平台上下文变化：
+* - platformTypeChanged：平台类型变化（如 ENTERPRISE → APPFRONT）
+* - firstPlatformEntry：无历史 session 的首次进入
+* - sameNonAppFrontReentry：同类型重入，但非 APPFRONT（APPFRONT 内切换应用不算平台切换）
+*
+* 以下情况排除，避免与登录 / 租户切换混淆：
+* - loginWithSignWay：首次登录选租户（session 无 tenant 但有 signWay），应记为登录而非平台切换
+* - isChangeTenant：纯租户切换不算平台切换
+*
+* 额外分支 nonAppFrontColdStart：
+* 非 APPFRONT 且无 session 的冷启动记为平台切换，
+* 但 WORKTABLE 且无 tenantId 除外（无租户直接进企业管理后台的场景）
+*/
+function isChangePlatform(type, tenantId, signWay, hasSession, prev) {
+	const loginWithSignWay = !(hasSession && !!prev.tenantId) && !!tenantId && !!signWay;
+	const platformTypeChanged = !!(type && hasSession && prev.type && type !== prev.type);
+	const firstPlatformEntry = !!(type && !hasSession);
+	const sameNonAppFrontReentry = !!(hasSession && type === prev.type && type !== "APPFRONT");
+	return (platformTypeChanged || firstPlatformEntry || sameNonAppFrontReentry) && !loginWithSignWay && !isChangeTenant(tenantId, hasSession, prev) || type !== "APPFRONT" && !hasSession && !(type === "WORKTABLE" && !tenantId);
+}
+/**
+* 判定本次上报是否附带 signWay（登录方式）。
+*
+* - isNormalLogin：常规首次登录，session 无租户且非「WORKTABLE 无 tenantId」，
+*   APPFRONT 需有 appId，其他平台直接附带
+* - isMicrosoftLogin：Microsoft 登录在选租户后仍需附带 signWay（OAuth 回调时 tenant 尚未确定）
+*
+* 附带后会在 postSignLog 完成后清除 sessionStorage 中的 signWay，避免后续切换误用
+*/
+function shouldAttachSignWay(type, appId, tenantId, signWay, hasSession, prev) {
+	const hasPrevTenant = hasSession && !!prev.tenantId;
+	const isMicrosoftLogin = signWay === `${LoginTypeEnum.MICROSOFT}_LOGIN` && !!tenantId;
+	return !hasPrevTenant && !(type === "WORKTABLE" && !tenantId) && !!signWay && (type === "APPFRONT" && !!appId || type !== "APPFRONT") || isMicrosoftLogin;
+}
+/**
+* 注册登录/切换日志。
+*
+* @param type  切入平台（如 WORKTABLE、APPFRONT、ENTERPRISE）
+* @param appId 切入应用 ID
+* @param tenantId 切入租户 ID
+*
+* 流程：读取上下文 → 计算切换标志 → 上报 → 清理 signWay → 更新 session
+*/
+async function signLogRegister(type, appId, tenantId) {
+	const signWay = sessionStorage.getItem("signWay");
+	const { hasSession, prev } = getPlatOrAppSession();
+	const fingerprint = await getBrowserFingerprint();
+	const env = _gct.env.getEnv();
+	const attachSignWay = shouldAttachSignWay(type, appId, tenantId, signWay, hasSession, prev);
+	const data = {
+		appId,
+		appIdOut: hasSession ? prev.appId ?? "" : "",
+		changeApp: isChangeApp(type, appId, hasSession, prev),
+		changePlatform: isChangePlatform(type, tenantId, signWay, hasSession, prev),
+		changeTenant: isChangeTenant(tenantId, hasSession, prev),
+		signWay: attachSignWay ? signWay : "",
+		platformIn: type,
+		platformOut: hasSession ? prev.type ?? "" : "",
+		env,
+		tenantIn: tenantId,
+		tenantOut: hasSession ? prev.tenantId ?? "" : ""
+	};
+	await _api.platform.signLog.post(data, { headers: {
+		pagetag: getPageIdentification(),
+		browser: fingerprint
+	} });
+	if (attachSignWay) sessionStorage.removeItem("signWay");
+	sessionStorage.setItem("currentPlatOrAppId", JSON.stringify({
+		appId,
+		type,
+		tenantId
+	}));
+}
+//#endregion
+export { signLogRegister };

package/es/modules/sign-log/sing-log.interface.d.ts

@@ -0,0 +1,9 @@
+/**
+ * sessionStorage `currentPlatOrAppId` 的结构。
+ * 记录用户当前所在的平台 / 应用 / 租户，作为下次切换时的「切出」基准。
+ */
+export interface PlatOrAppSession {
+    appId?: string;
+    type?: string;
+    tenantId?: string;
+}

package/es/modules/system-mqtt/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './system-mqtt.interface';
+export { SystemMqttService } from './system-mqtt.service';

package/es/modules/system-mqtt/index.mjs

@@ -0,0 +1 @@
+import "./system-mqtt.service.mjs";

package/es/modules/system-mqtt/system-mqtt.interface.d.ts

@@ -0,0 +1,71 @@
+/**
+ * MQTT 订阅消息回调函数类型
+ */
+export type MqttSubCallback<T> = (payload?: T) => void | Promise<void>;
+/**
+ * 登出消息
+ *
+ * @export
+ * @interface IKickOutPayload
+ */
+export interface IKickOutPayload {
+    /**
+     * 用户 token
+     *
+     * @type {string}
+     * @memberof IKickOutPayload
+     */
+    token: string;
+}
+/**
+ * 未读消息变化
+ *
+ * @export
+ * @interface IInternalMessagePayload
+ */
+export interface IInternalMessagePayload {
+    /**
+     * 全局未读消息数量
+     *
+     * @type {number}
+     */
+    totalUnreadCount: number;
+    /**
+     * 应用未读消息数量
+     *
+     * @type {{
+     *     appId: string;
+     *     unreadCount: number;
+     *   }}
+     */
+    appMessageCount: {
+        appId: string;
+        unreadCount: number;
+    };
+}
+/**
+ * 待办消息数量变化
+ *
+ * @export
+ * @interface IToDoMessagePayload
+ */
+export interface IToDoMessagePayload {
+    /**
+     * 待办消息数量
+     *
+     * @type {number}
+     */
+    Count: number;
+    /**
+     * 应用待办消息数量
+     *
+     * @type {{
+     *     appId: string;
+     *     count: number;
+     *   }}
+     */
+    appMessageCount: {
+        appId: string;
+        count: number;
+    };
+}