config: 빌드된 .exe 에도 .env 가 적용되도록 보강

- electron-builder.yml
  - dist/shared/** 추가 (env.js 등이 패키지에 들어가도록)
  - extraResources 로 빌드 시점 .env 를 resources/.env 에 배포
- loadEnv: 패키징된 Electron 앱이면 process.resourcesPath/.env 를 먼저 시도하고
  없으면 프로젝트 루트 .env 로 폴백
- docs/admin-site.md: .exe 빌드에도 .env 가 따라가는 동작 설명 추가

docs/admin-site.md

@@ -25,6 +25,14 @@ npm start              # 기본 포트 3000.
 
 `.env` 는 `.gitignore` 로 제외되어 있습니다. 새 환경을 셋업할 때 `.env.example` 을 복사해서 시작하세요. 쉘에서 직접 환경변수를 지정한 경우에는 `.env` 값을 덮어쓰지 않습니다.
 
+#### 설치기 `.exe` 빌드에도 적용됨
+
+`npm run dist:win` 으로 만든 설치기 `.exe` 도 빌드 시점의 `.env` 를 함께 가져갑니다 (`electron-builder` 의 `extraResources` 로 `resources/.env` 에 배포). 런타임에서는 `process.resourcesPath/.env` → `<프로젝트 루트>/.env` 순으로 찾기 때문에:
+
+- 운영자가 `SITE_BASE_URL=https://mq.example.com` 으로 `.env` 를 설정해 두고 빌드 → 최종 사용자가 받은 `.exe` 가 그 도메인의 `manifest.json` 을 자동으로 받아옴.
+- 빌드 이후라도 설치된 폴더(`resources/.env`) 를 텍스트 편집기로 고치면 도메인을 바꿀 수 있음.
+- 빌드 시점에 `.env` 가 없으면 단순히 빠진 채로 패키징되고, 코드 기본값(`http://127.0.0.1:3000`) 이 그대로 사용됩니다.
+
 ## 도메인 / 경로 구성
 
 | 경로 | 내용 |

electron-builder.yml

@@ -4,8 +4,16 @@ directories:
   output: release
 files:
   - dist/installer/**
+  - dist/shared/**
   - installer/**
   - package.json
+# 빌드 시점의 .env 를 설치기 옆에 함께 배포(없으면 조용히 패스).
+# 패키징 후 운영자가 resources/.env 만 교체해서 도메인을 바꿀 수도 있음.
+extraResources:
+  - from: .
+    to: .
+    filter:
+      - .env
 win:
   target: nsis
   artifactName: ${productName}-${version}-Setup.${ext}

src/shared/env.ts

@@ -4,16 +4,32 @@ import dotenv from 'dotenv'
 import { projectRoot } from './paths.js'
 
 /**
- * 프로젝트 루트의 `.env` 를 읽어 `process.env` 에 주입.
+ * `.env` 를 읽어 `process.env` 에 주입.
  *
- * - 이미 설정된 환경변수는 덮어쓰지 않음(쉘에서 넘긴 값이 우선).
- * - 파일이 없으면 조용히 통과 — 운영 환경에서는 시스템 env 만으로도 동작해야 함.
+ * 탐색 순서(처음 발견된 것만 사용):
+ *   1. 패키징된 Electron 앱이면 `process.resourcesPath/.env`
+ *      — electron-builder 의 extraResources 로 빌드 시점 `.env` 가 함께 배포됨.
+ *   2. `<프로젝트 루트>/.env`
+ *      — 개발 실행(npm start / npm run installer*) 및 서버 운영용.
+ *
+ * - 이미 설정된 환경변수는 덮어쓰지 않음(쉘/systemd 에서 넘긴 값이 우선).
+ * - 파일이 없으면 조용히 통과.
  * - 서버/설치기/리소스팩설치기 진입점에서 한 번씩 호출.
  */
 export function loadEnv(): void {
-  const envPath = path.join(projectRoot, '.env')
-  if (!fs.existsSync(envPath)) return
-  dotenv.config({ path: envPath, override: false, quiet: true })
+  const candidates: string[] = []
+  const resourcesPath = (process as NodeJS.Process & { resourcesPath?: string }).resourcesPath
+  if (typeof resourcesPath === 'string' && resourcesPath.length > 0) {
+    candidates.push(path.join(resourcesPath, '.env'))
+  }
+  candidates.push(path.join(projectRoot, '.env'))
+
+  for (const envPath of candidates) {
+    if (fs.existsSync(envPath)) {
+      dotenv.config({ path: envPath, override: false, quiet: true })
+      return
+    }
+  }
 }
 
 /**