refactor(env): centralize app environment detection

src/utils/app-env.ts

@@ -3,13 +3,34 @@
  *
  * 原始 Dart: lib/utils/app_env_util.dart
  *
- * 替代 `AppEnvUtil.isDevelopment`：基于 Next.js 注入的 `process.env.NODE_ENV`。
+ * 基于 `.env*` 中的 `NEXT_PUBLIC_APP_ENV` 判断当前业务环境。
+ *
+ * 注意：该变量带 `NEXT_PUBLIC_` 前缀，可同时用于服务端和客户端代码。
  */
-export const isDevelopment = (): boolean =>
-  process.env.NODE_ENV !== "production";
+export type AppEnv = "development" | "test" | "production";
 
-export const isProduction = (): boolean =>
-  process.env.NODE_ENV === "production";
+export class AppEnvUtil {
+  private constructor() {}
 
-export const isTest = (): boolean =>
-  process.env.NODE_ENV === "test";
+  static get current(): AppEnv {
+    const env = process.env.NEXT_PUBLIC_APP_ENV;
+    if (env === "production" || env === "test") return env;
+    return "development";
+  }
+
+  static isDevelopment(): boolean {
+    return AppEnvUtil.current === "development";
+  }
+
+  static isProduction(): boolean {
+    return AppEnvUtil.current === "production";
+  }
+
+  static isTest(): boolean {
+    return AppEnvUtil.current === "test";
+  }
+
+  static canOutputLogs(): boolean {
+    return !AppEnvUtil.isProduction();
+  }
+}