feat: dev bypass 실행 모드와 env 기반 설정 추가

Author: SOIV

.gitignore

@@ -3,6 +3,9 @@ node_modules/
 **/node_modules/
 
 # Environment variables
+**/.env
+**/.env.*
+!**/.env*.example
 
 # Build outputs
 dist/
@@ -27,3 +30,4 @@ coverage/
 # Misc
 
 # ETC
+local

apps/api/.env.development.local.example

@@ -0,0 +1,2 @@
+INSTALL_MODE=normal
+# INSTALL_MODE=bypass

apps/api/package.json

@@ -4,13 +4,18 @@
   "version": "0.0.0",
   "main": "dist/index.js",
   "scripts": {
-    "dev": "tsx watch src/index.ts",
+    "dev": "NODE_ENV=development pnpm exec tsx watch src/index.ts",
+    "dev:bypass": "NODE_ENV=development INSTALL_MODE=bypass pnpm exec tsx watch src/index.ts",
     "build": "tsc",
     "start": "node dist/index.js",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
+    "tsx": "^4.21.0",
     "vitest": "^2.1.9"
+  },
+  "dependencies": {
+    "dotenv": "^17.3.1"
   }
 }

apps/api/src/index.ts

@@ -1,3 +1,29 @@
+import "dotenv/config";
+
+type InstallMode = "normal" | "bypass";
+
 const BOOTSTRAP_MESSAGE = "Fieldstack API bootstrap initialized";
 
+function resolveInstallMode(env: NodeJS.ProcessEnv): InstallMode {
+  const requestedMode = env.INSTALL_MODE;
+  const isDevelopment = env.NODE_ENV === "development";
+
+  if (requestedMode === "bypass") {
+    if (isDevelopment) {
+      return "bypass";
+    }
+
+    console.warn("[fieldstack][api] INSTALL_MODE=bypass ignored outside development");
+  }
+
+  return "normal";
+}
+
+const installMode = resolveInstallMode(process.env);
+
 console.log(BOOTSTRAP_MESSAGE);
+console.log(`[fieldstack][api] install mode: ${installMode}`);
+
+if (installMode === "bypass") {
+  console.warn("[fieldstack][api] DEV INSTALL BYPASS ACTIVE");
+}

apps/web/.env.development.local.example

@@ -0,0 +1,2 @@
+VITE_INSTALL_MODE=normal
+# VITE_INSTALL_MODE=bypass

apps/web/package.json

@@ -4,6 +4,7 @@
   "version": "0.0.0",
   "scripts": {
     "dev": "vite",
+    "dev:bypass": "VITE_INSTALL_MODE=bypass vite",
     "build": "tsc && vite build",
     "preview": "vite preview",
     "test": "vitest run --passWithNoTests",

apps/web/src/main.ts

@@ -1,3 +1,34 @@
+type InstallMode = "normal" | "bypass";
+
+interface WebRuntimeEnv {
+  MODE?: string;
+  DEV?: boolean;
+  VITE_INSTALL_MODE?: string;
+}
+
 const WEB_BOOTSTRAP_MESSAGE = "Fieldstack Web bootstrap initialized";
 
+function resolveInstallMode(runtimeEnv: WebRuntimeEnv): InstallMode {
+  const requestedMode = runtimeEnv.VITE_INSTALL_MODE;
+  const isDevelopment = runtimeEnv.DEV === true || runtimeEnv.MODE === "development";
+
+  if (requestedMode === "bypass") {
+    if (isDevelopment) {
+      return "bypass";
+    }
+
+    console.warn("[fieldstack][web] VITE_INSTALL_MODE=bypass ignored outside development");
+  }
+
+  return "normal";
+}
+
+const runtimeEnv = (import.meta as ImportMeta & { env?: WebRuntimeEnv }).env ?? {};
+const installMode = resolveInstallMode(runtimeEnv);
+
 console.log(WEB_BOOTSTRAP_MESSAGE);
+console.log(`[fieldstack][web] install mode: ${installMode}`);
+
+if (installMode === "bypass") {
+  console.warn("[fieldstack][web] DEV INSTALL BYPASS ACTIVE");
+}

package.json

@@ -10,8 +10,11 @@
   },
   "scripts": {
     "dev": "pnpm --parallel dev",
+    "dev:bypass": "INSTALL_MODE=bypass pnpm --parallel dev",
     "dev:api": "pnpm --filter api dev",
+    "dev:api:bypass": "pnpm --filter api dev:bypass",
     "dev:web": "pnpm --filter web dev",
+    "dev:web:bypass": "pnpm --filter web dev:bypass",
     "build": "pnpm build:web && pnpm build:api && pnpm postbuild",
     "build:web": "pnpm --filter web build",
     "build:api": "pnpm --filter api build",