R64 A1-A6：新员工入门引导

client/src/lib/onboardingGuide.ts

@@ -0,0 +1,48 @@
+export const ONBOARDING_WELCOME_STORAGE_KEY = "hyb_oa_show_welcome";
+export const ONBOARDING_ACTIVE_STORAGE_KEY = "hyb_oa_onboarding_active";
+export const ONBOARDING_DISMISSED_STORAGE_KEY = "hyb_oa_getting_started_dismissed";
+
+function canUseLocalStorage() {
+  return typeof window !== "undefined" && typeof window.localStorage !== "undefined";
+}
+
+export function markOnboardingEntryReady() {
+  if (!canUseLocalStorage()) {
+    return;
+  }
+
+  window.localStorage.setItem(ONBOARDING_WELCOME_STORAGE_KEY, "1");
+  window.localStorage.setItem(ONBOARDING_ACTIVE_STORAGE_KEY, "1");
+  window.localStorage.removeItem(ONBOARDING_DISMISSED_STORAGE_KEY);
+}
+
+export function shouldShowWelcomeDialog() {
+  return canUseLocalStorage() && window.localStorage.getItem(ONBOARDING_WELCOME_STORAGE_KEY) === "1";
+}
+
+export function clearWelcomeDialogFlag() {
+  if (!canUseLocalStorage()) {
+    return;
+  }
+
+  window.localStorage.removeItem(ONBOARDING_WELCOME_STORAGE_KEY);
+}
+
+export function shouldShowGettingStartedCard() {
+  if (!canUseLocalStorage()) {
+    return false;
+  }
+
+  return (
+    window.localStorage.getItem(ONBOARDING_ACTIVE_STORAGE_KEY) === "1" &&
+    window.localStorage.getItem(ONBOARDING_DISMISSED_STORAGE_KEY) !== "1"
+  );
+}
+
+export function dismissGettingStartedCard() {
+  if (!canUseLocalStorage()) {
+    return;
+  }
+
+  window.localStorage.setItem(ONBOARDING_DISMISSED_STORAGE_KEY, "1");
+}