R26-4 R26-5: 优化开关报错并补部署检查清单

client/src/api/errorMessages.ts

@@ -8,6 +8,31 @@ function readStringList(value: unknown): string[] {
     .filter((item) => item.length > 0);
 }
 
+const FEATURE_FLAG_DISABLED_MESSAGES: Record<string, string> = {
+  portal_home_v1_disabled: "Portal 首页当前未启用，请联系管理员检查环境开关与功能开关配置。",
+  announcements_v1_disabled: "公告模块当前未启用，请联系管理员检查环境开关与功能开关配置。",
+  presence_board_v1_disabled: "团队状态模块当前未启用，请联系管理员检查环境开关与功能开关配置。",
+  weekly_report_v1_disabled: "周报模块当前未启用，请联系管理员检查环境开关与功能开关配置。",
+  employee_lifecycle_v1_disabled: "人员生命周期模块当前未启用，请联系管理员检查环境开关与功能开关配置。",
+  todo_board_v1_disabled: "待办模块当前未启用，请联系管理员检查环境开关与功能开关配置。",
+  project_domain_v1_disabled: "项目模块当前未启用，请联系管理员检查环境开关与功能开关配置。",
+  project_linking_v1_disabled: "项目关联功能当前未启用，请联系管理员检查环境开关与功能开关配置。",
+  project_communication_log_v1_disabled: "项目沟通回填当前未启用，请联系管理员检查环境开关与功能开关配置。",
+  project_closure_checklist_v1_disabled: "项目收口清单当前未启用，请联系管理员检查环境开关与功能开关配置。",
+  confidential_doc_refs_v1_disabled: "涉密资料引用当前未启用，请联系管理员检查环境开关与功能开关配置。",
+};
+
+function resolveFeatureFlagDisabledMessage(value: unknown): string | null {
+  if (typeof value !== "string" || !value.endsWith("_disabled")) {
+    return null;
+  }
+
+  return (
+    FEATURE_FLAG_DISABLED_MESSAGES[value] ??
+    "当前功能未启用，请联系管理员检查环境开关与功能开关配置。"
+  );
+}
+
 export function mapApiErrorMessage(
   code: string,
   details?: Record<string, unknown>,
@@ -90,6 +115,11 @@ export function mapApiErrorMessage(
       return `新密码不符合要求：${passwordErrors.join("；")}。`;
     }
 
+    const featureFlagMessage = resolveFeatureFlagDisabledMessage(details?.featureFlag);
+    if (featureFlagMessage) {
+      return featureFlagMessage;
+    }
+
     if (details?.["x-device-fingerprint"] === "missing") {
       return "当前设备校验信息缺失，请刷新页面后重试。";
     }