feat(api): Setup 모드 시작 시 접속 가능한 IP 주소 콘솔 출력

서버가 설치 마법사 모드로 시작될 때 터미널에 박스 배너를 출력해
원격 서버·Docker 환경에서도 어떤 주소로 브라우저를 열면 되는지 바로 알 수 있도록 함.

- localhost:PORT 항상 표시
- os.networkInterfaces()로 감지된 IPv4 네트워크 주소 목록도 함께 출력
  (루프백 제외, Docker bridge / 로컬 LAN / 외부 인터페이스 포함)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: SOIV

apps/api/src/index.ts

@@ -1,5 +1,6 @@
 import 'dotenv/config';
 
+import os from 'node:os';
 import path from 'node:path';
 
 import { validateEnv } from './config/env';
@@ -40,14 +41,52 @@ if (env.INSTALL_MODE === 'bypass') {
 // modules/ 디렉터리는 프로젝트 루트 기준 (apps/api/src → ../../../modules)
 const MODULES_DIR = path.join(__dirname, '..', '..', '..', 'modules');
 
+// ── 네트워크 인터페이스 IP 수집 ────────────────────────────────
+
+function getLocalIPs(): string[] {
+  const ips: string[] = [];
+  for (const ifaces of Object.values(os.networkInterfaces())) {
+    for (const iface of ifaces ?? []) {
+      // IPv4이고 루프백(127.x)이 아닌 것만
+      if (iface.family === 'IPv4' && !iface.internal) {
+        ips.push(iface.address);
+      }
+    }
+  }
+  return ips;
+}
+
+function printSetupBanner(port: number) {
+  const ips = getLocalIPs();
+  const lines = [
+    '',
+    '  ╔══════════════════════════════════════════════════════╗',
+    '  ║         Fieldstack — 설치 마법사 모드               ║',
+    '  ╠══════════════════════════════════════════════════════╣',
+    '  ║  아래 주소 중 하나를 브라우저에서 열어 설치를       ║',
+    '  ║  진행해 주세요.                                      ║',
+    '  ╠══════════════════════════════════════════════════════╣',
+    `  ║  로컬    →  http://localhost:${port}`.padEnd(56) + '║',
+  ];
+  for (const ip of ips) {
+    lines.push(`  ║  네트워크 →  http://${ip}:${port}`.padEnd(56) + '║');
+  }
+  if (ips.length === 0) {
+    lines.push('  ║  (네트워크 인터페이스를 감지하지 못했습니다)'.padEnd(56) + '║');
+  }
+  lines.push('  ╚══════════════════════════════════════════════════════╝');
+  lines.push('');
+  console.log(lines.join('\n'));
+}
+
 // ── Setup 모드 ─────────────────────────────────────────────────
 // installed.lock 없고 bypass 아닐 때 → Setup 마법사만 서빙
 async function startSetup() {
   console.log('[fieldstack][api] *** SETUP MODE — installation wizard active ***');
   const app = createSetupApp();
   finalizeApp(app);
   app.listen(env.PORT, () => {
-    console.log(`[fieldstack][api] setup server listening on http://localhost:${env.PORT}`);
+    printSetupBanner(env.PORT);
   });
 }