feat/refactor: 자산관리 시스템 기능 고도화 및 UI/UX 개선

1. 컬럼 드래그 너비 조정 버그 수정 및 개선 (ListFactory.ts)
   - 드래그 완료 시 click 이벤트 전파 차단으로 정렬(sorting) 오작동 방지
   - getBoundingClientRect().width 활용한 소수점 정밀 너비 고정 및 레이아웃 시프트 방지
   - 마우스 업 시점의 모든 컬럼 너비를 config.columns에 동기화하여 재렌더링 시 너비 영속성 보장

2. PC 자산 모달 필드 잠금 정책 세분화 (HWModal.ts)
   - 자산 추가(add) 모드에서는 모든 필드(사용자 정보 포함) 입력 허용
   - 자산 수정(edit) 모드에서만 사용자/조직 정보 관련 필드(lockedUserFields) 선택적 잠금 적용
   - 시스템 사양, 네트워크, 위치, 구매 등 다른 모든 섹션은 수정 가능하도록 복구 및 안내 배너 갱신

3. 관리자 전용 메뉴 단일 페이지 앱(SPA) 통합 (Navigation.ts, main.ts, MapEditor.ts)
   - 기존의 실사 승인 탭과 독립 실행형 좌표 에디터(MapEditor)를 GNB '관리도구' 하위 메뉴로 통합
   - '실사 승인', '위치지정'을 GNB에서 ↳ 화살표 및 11px 폰트의 계층형 탭 스타일로 렌더링
   - 내부 서브 탭 바를 삭제하고 메인 영역 전체 높이(calc(100vh - var(--header-height) - 48px))를 확보
   - 다른 탭으로 이동 시 MapEditor 인스턴스의 window 이벤트 및 전역 바인딩을 소거하는 destroy() 리사이클 구현

4. 자산 이력(History) 가독성 개선 및 포맷팅 (HWModal.ts, SWModal.ts, DomainModal.ts)
   - 자산 변경 이력 로그를 일자별로 그룹화하여 타임라인 렌더링
   - 최초 등록 데이터에 녹색 '[최초등록]' 배지 추가
   - 기존의 생 JSON 이력 데이터를 친절한 한국어 텍스트 포맷으로 가공하여 가독성 극대화

.dockerignore

@@ -0,0 +1,13 @@
+node_modules
+dist
+build
+.git
+.gitignore
+.env
+npm-debug.log
+uploads
+*.xlsx
+*.log
+mysql_data
+scratch
+*.sql

.env

@@ -1,6 +1,6 @@
-DB_HOST=172.16.8.151
+DB_HOST=itam-mysql
 DB_PORT=3306
-DB_USER=itam_admin
+DB_USER=itam
 DB_PASS=itam1234
 DB_NAME=itam
 PORT=3000

.env.example

@@ -0,0 +1,17 @@
+# Database Configuration
+DB_HOST=172.16.8.151
+DB_PORT=3306
+DB_USER=itam_admin
+DB_PASS=itam1234
+DB_NAME=itam
+
+# Application Configuration
+NODE_ENV=development
+PORT=3000
+
+# Logging (optional)
+LOG_LEVEL=info
+
+# Security (for production)
+# API_KEY=your_api_key_here
+# JWT_SECRET=your_jwt_secret_here

.gitea/coverage.json

@@ -0,0 +1,7 @@
+{
+    "Path": "./backend/coverage.out",
+    "Thresholds": {
+        "baron-sso-backend/internal/handler": 10,
+        "baron-sso-backend/internal/service": 10
+    }
+}

.gitea/workflows/itam_code_check.yml

@@ -0,0 +1,47 @@
+name: ITAM Code Check
+
+on:
+  push:
+    branches:
+      - Dockerizing
+      - main
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build-and-config-check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Prepare CI env file
+        run: |
+          cat <<'EOF' > .env
+          DB_HOST=127.0.0.1
+          DB_PORT=3306
+          DB_USER=itam_ci
+          DB_PASS=itam_ci_password
+          DB_NAME=itam
+          NODE_ENV=production
+          PORT=3000
+          LOG_LEVEL=info
+          EOF
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Frontend TypeScript and Vite build
+        run: npm run build
+
+      - name: Validate test compose
+        run: docker compose -f docker-compose.test.yaml config
+
+      - name: Validate prod compose
+        run: docker compose -f docker-compose.prod.yaml config

.gitea/workflows/itam_docker_build_check.yml

@@ -0,0 +1,69 @@
+name: ITAM Docker Build Check
+
+on:
+  push:
+    branches:
+      - Dockerizing
+      - main
+    paths:
+      - "Dockerfile.frontend.prod"
+      - "Dockerfile.backend.prod"
+      - "docker-compose.prod.yaml"
+      - "docker-compose.test.yaml"
+      - "docker/**"
+      - "src/**"
+      - "server.js"
+      - "package.json"
+      - "package-lock.json"
+      - "vite.config.ts"
+      - "index.html"
+      - "img/**"
+      - "public/**"
+  pull_request:
+    paths:
+      - "Dockerfile.frontend.prod"
+      - "Dockerfile.backend.prod"
+      - "docker-compose.prod.yaml"
+      - "docker-compose.test.yaml"
+      - "docker/**"
+      - "src/**"
+      - "server.js"
+      - "package.json"
+      - "package-lock.json"
+      - "vite.config.ts"
+      - "index.html"
+      - "img/**"
+      - "public/**"
+  workflow_dispatch:
+
+jobs:
+  docker-build-check:
+    runs-on: ubuntu-latest
+    env:
+      DOCKER_BUILDKIT: "1"
+      COMPOSE_DOCKER_CLI_BUILD: "1"
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Prepare CI env file
+        run: |
+          cat <<'EOF' > .env
+          DB_HOST=127.0.0.1
+          DB_PORT=3306
+          DB_USER=itam_ci
+          DB_PASS=itam_ci_password
+          DB_NAME=itam
+          NODE_ENV=production
+          PORT=3000
+          LOG_LEVEL=info
+          EOF
+
+      - name: Build backend production image
+        run: docker build -f Dockerfile.backend.prod -t itam-backend:ci .
+
+      - name: Build frontend production image
+        run: docker build -f Dockerfile.frontend.prod -t itam-frontend:ci .
+
+      - name: Validate production compose with CI env
+        run: docker compose -f docker-compose.prod.yaml config

.gitea/workflows/itam_production_deploy.yml

@@ -0,0 +1,143 @@
+name: ITAM Production Deploy
+
+on:
+  workflow_dispatch:
+    inputs:
+      target_branch:
+        description: "Branch to deploy"
+        required: true
+        default: "main"
+        type: string
+
+jobs:
+  deploy-production:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup SSH agent
+        uses: webfactory/ssh-agent@v0.9.0
+        with:
+          ssh-private-key: ${{ secrets.PROD_SSH_PRIVATE_KEY }}
+
+      - name: Validate required production variables
+        env:
+          PROD_HOST: ${{ vars.PROD_HOST }}
+          PROD_USER: ${{ vars.PROD_USER }}
+          PROD_DEPLOY_PATH: ${{ vars.PROD_DEPLOY_PATH }}
+          PROD_GIT_URL: ${{ vars.PROD_GIT_URL }}
+          DB_HOST: ${{ vars.PROD_DB_HOST }}
+          DB_PORT: ${{ vars.PROD_DB_PORT }}
+          DB_USER: ${{ vars.PROD_DB_USER }}
+          DB_PASS: ${{ secrets.PROD_DB_PASS }}
+          DB_NAME: ${{ vars.PROD_DB_NAME }}
+        run: |
+          set -euo pipefail
+          required_keys="PROD_HOST PROD_USER PROD_DEPLOY_PATH PROD_GIT_URL DB_HOST DB_PORT DB_USER DB_PASS DB_NAME"
+          for key in ${required_keys}; do
+            if [ -z "${!key:-}" ]; then
+              echo "::error::Missing required variable or secret: ${key}"
+              exit 1
+            fi
+          done
+
+      - name: Create production env file
+        env:
+          DB_HOST: ${{ vars.PROD_DB_HOST }}
+          DB_PORT: ${{ vars.PROD_DB_PORT }}
+          DB_USER: ${{ vars.PROD_DB_USER }}
+          DB_PASS: ${{ secrets.PROD_DB_PASS }}
+          DB_NAME: ${{ vars.PROD_DB_NAME }}
+          LOG_LEVEL: ${{ vars.PROD_LOG_LEVEL }}
+        run: |
+          set -euo pipefail
+          EFFECTIVE_LOG_LEVEL="${LOG_LEVEL:-info}"
+          cat > .env.deploy <<EOF
+          DB_HOST=${DB_HOST}
+          DB_PORT=${DB_PORT}
+          DB_USER=${DB_USER}
+          DB_PASS=${DB_PASS}
+          DB_NAME=${DB_NAME}
+          NODE_ENV=production
+          PORT=3000
+          LOG_LEVEL=${EFFECTIVE_LOG_LEVEL}
+          EOF
+
+      - name: Deploy to production host
+        env:
+          PROD_HOST: ${{ vars.PROD_HOST }}
+          PROD_USER: ${{ vars.PROD_USER }}
+          PROD_DEPLOY_PATH: ${{ vars.PROD_DEPLOY_PATH }}
+          PROD_BACKUP_ROOT: ${{ vars.PROD_BACKUP_ROOT }}
+          PROD_GIT_URL: ${{ vars.PROD_GIT_URL }}
+          DB_HOST: ${{ vars.PROD_DB_HOST }}
+          DB_PORT: ${{ vars.PROD_DB_PORT }}
+          DB_USER: ${{ vars.PROD_DB_USER }}
+          DB_PASS: ${{ secrets.PROD_DB_PASS }}
+          DB_NAME: ${{ vars.PROD_DB_NAME }}
+          TARGET_BRANCH: ${{ github.event.inputs.target_branch }}
+        run: |
+          set -euo pipefail
+          ssh-keyscan -H "${PROD_HOST}" >> ~/.ssh/known_hosts
+
+          ssh "${PROD_USER}@${PROD_HOST}" "mkdir -p '${PROD_DEPLOY_PATH}'"
+
+          ssh "${PROD_USER}@${PROD_HOST}" "if [ ! -d '${PROD_DEPLOY_PATH}/.git' ]; then git clone '${PROD_GIT_URL}' '${PROD_DEPLOY_PATH}'; else cd '${PROD_DEPLOY_PATH}' && git remote set-url origin '${PROD_GIT_URL}'; fi"
+
+          ssh "${PROD_USER}@${PROD_HOST}" "cd '${PROD_DEPLOY_PATH}' && git checkout -- .env || true && git fetch origin '${TARGET_BRANCH}' && git checkout -B '${TARGET_BRANCH}' FETCH_HEAD && git reset --hard FETCH_HEAD"
+
+          EFFECTIVE_BACKUP_ROOT="${PROD_BACKUP_ROOT:-/home/user/dachs_backups}"
+
+          ssh "${PROD_USER}@${PROD_HOST}" "export DEPLOY_PATH='${PROD_DEPLOY_PATH}' BACKUP_ROOT='${EFFECTIVE_BACKUP_ROOT}'; sh -eu -s" <<'REMOTE_BACKUP'
+          case "$BACKUP_ROOT" in
+            "$DEPLOY_PATH"|"$DEPLOY_PATH"/*)
+              echo "Backup path must be outside deploy path: $BACKUP_ROOT"
+              exit 1
+              ;;
+          esac
+
+          if [ -d "$DEPLOY_PATH/.git" ]; then
+            mkdir -p "$BACKUP_ROOT"
+            echo "Starting pre-deploy backup..."
+            cd "$DEPLOY_PATH"
+            if [ -f Makefile ] && [ -f scripts/backup.sh ] && [ -f .env ]; then
+              make predeploy-backup ENV_FILE=.env BACKUP_ROOT="$BACKUP_ROOT"
+            else
+              echo "Skipping pre-deploy backup because required backup files are missing in current deployment."
+            fi
+          else
+            echo "Skipping pre-deploy backup because no existing deployment was found."
+          fi
+          REMOTE_BACKUP
+
+          ssh "${PROD_USER}@${PROD_HOST}" "cd '${PROD_DEPLOY_PATH}' && git clean -fd"
+
+          ssh "${PROD_USER}@${PROD_HOST}" "cd '${PROD_DEPLOY_PATH}' && mkdir -p uploads logs/nginx"
+
+          scp .env.deploy "${PROD_USER}@${PROD_HOST}:${PROD_DEPLOY_PATH}/.env"
+
+          ssh "${PROD_USER}@${PROD_HOST}" "cd '${PROD_DEPLOY_PATH}' && chmod 600 .env && docker compose -f docker-compose.prod.yaml config && docker compose -f docker-compose.prod.yaml up -d --build"
+
+      - name: Post-deploy status check
+        env:
+          PROD_HOST: ${{ vars.PROD_HOST }}
+          PROD_USER: ${{ vars.PROD_USER }}
+          PROD_DEPLOY_PATH: ${{ vars.PROD_DEPLOY_PATH }}
+        run: |
+          set -euo pipefail
+          ssh "${PROD_USER}@${PROD_HOST}" "cd '${PROD_DEPLOY_PATH}' && docker compose -f docker-compose.prod.yaml ps"
+
+      - name: Post-deploy smoke checks
+        env:
+          PROD_HOST: ${{ vars.PROD_HOST }}
+          PROD_USER: ${{ vars.PROD_USER }}
+          PROD_DEPLOY_PATH: ${{ vars.PROD_DEPLOY_PATH }}
+        run: |
+          set -euo pipefail
+          ssh "${PROD_USER}@${PROD_HOST}" "curl -fsS http://localhost:9090/health"
+          ssh "${PROD_USER}@${PROD_HOST}" "cd '${PROD_DEPLOY_PATH}' && docker compose -f docker-compose.prod.yaml exec -T backend curl -fsS http://localhost:3000/health"
+
+      - name: Cleanup generated env file
+        if: ${{ always() }}
+        run: rm -f .env.deploy

.gitignore

@@ -5,3 +5,5 @@ dist/
 *.log
 .DS_Store
 Thumbs.db
+backups/
+mysql_data/

Dockerfile.backend

@@ -0,0 +1,12 @@
+FROM node:20-alpine
+
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm ci
+
+COPY . .
+
+EXPOSE 3000
+
+CMD ["npm", "run", "server"]

Dockerfile.backend.prod

@@ -0,0 +1,48 @@
+FROM node:20-alpine
+
+LABEL maintainer="ITAM Team <devops@itam.local>"
+
+# Set production environment
+ENV NODE_ENV=production
+
+WORKDIR /app
+
+# Install curl for health checks and dumb-init for proper signal handling
+RUN apk add --no-cache curl dumb-init mysql-client
+
+# Copy package files
+COPY package*.json ./
+
+# Install production dependencies only
+RUN npm ci --only=production
+
+# Copy application code
+COPY server.js ./
+COPY src ./src
+
+# Create non-root user 'appuser' with UID 1001 (1000 already in use by node image)
+RUN addgroup -g 1001 appuser && \
+    adduser -D -u 1001 -G appuser appuser
+
+# Set ownership of application files to appuser
+RUN chown -R appuser:appuser /app
+
+# Create logs directory
+RUN mkdir -p /app/logs && \
+    chown -R appuser:appuser /app/logs
+
+# Switch to non-root user
+USER appuser
+
+# Expose port
+EXPOSE 3000
+
+# Health check - backend should implement /health endpoint
+HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
+    CMD curl -f http://localhost:3000/health || exit 1
+
+# Use dumb-init from PATH to avoid distro-specific absolute path issues
+ENTRYPOINT ["dumb-init", "--"]
+
+# Run application
+CMD ["npm", "run", "server"]

Dockerfile.frontend

@@ -0,0 +1,12 @@
+FROM node:20-alpine
+
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm ci
+
+COPY . .
+
+EXPOSE 8080
+
+CMD ["npm", "run", "dev", "--", "--host", "0.0.0.0"]

Dockerfile.frontend.prod

@@ -0,0 +1,62 @@
+# Stage 1: Build
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+COPY tsconfig*.json ./
+COPY vite.config.ts ./
+
+# Install all dependencies (including devDependencies for build)
+RUN npm ci
+
+# Copy source code
+COPY src ./src
+COPY public ./public
+COPY index.html map_editor.html mobile.html ./
+
+# Build application
+RUN npm run build
+
+# Verify build output
+RUN ls -la dist/ && echo "Build completed successfully"
+
+# Stage 2: Runtime
+FROM nginx:stable-alpine
+
+LABEL maintainer="ITAM Team <devops@itam.local>"
+
+# Install curl for health checks
+RUN apk add --no-cache curl
+
+WORKDIR /usr/share/nginx/html
+
+# Copy built assets from builder
+COPY --from=builder /app/dist .
+
+# Copy static image assets referenced by literal /img/... paths (Obsolete: img folder is now public/img and copied via dist)
+# COPY img ./img
+
+# Copy root-level logo asset referenced directly by index.html
+# COPY ["image 92.png", "./image 92.png"]
+
+# Copy Nginx static file serving configuration (not reverse proxy)
+COPY docker/frontend/default.conf /etc/nginx/conf.d/default.conf
+
+# Create nginx runtime user and directories
+RUN mkdir -p /var/log/nginx && \
+    chown -R nginx:nginx /usr/share/nginx/html && \
+    chown -R nginx:nginx /var/log/nginx && \
+    chown -R nginx:nginx /var/cache/nginx && \
+    chown -R nginx:nginx /etc/nginx/conf.d
+
+# Expose port
+EXPOSE 80
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=20s --retries=3 \
+    CMD curl -f http://localhost:80/ || exit 1
+
+# Run nginx
+CMD ["nginx", "-g", "daemon off;"]

Makefile

@@ -0,0 +1,33 @@
+SHELL := /bin/sh
+
+ENV_FILE ?= .env
+BACKUP_ROOT ?= backups
+RETENTION_DAYS ?= 14
+BACKUP_SCRIPT := scripts/backup.sh
+
+.PHONY: help db-dump files-backup full-backup predeploy-backup cleanup-backups
+
+help:
+	@echo "Usage: make <target> [ENV_FILE=.env BACKUP_ROOT=backups RETENTION_DAYS=14]"
+	@echo ""
+	@echo "Targets:"
+	@echo "  db-dump         Create a gzip-compressed MySQL dump from .env settings"
+	@echo "  files-backup    Archive runtime files such as uploads/, map_config.json, and .env"
+	@echo "  full-backup     Run both db-dump and files-backup"
+	@echo "  predeploy-backup Alias for the backup step executed before production deploy"
+	@echo "  cleanup-backups Delete backup files older than RETENTION_DAYS"
+
+db-dump:
+	@ENV_FILE="$(ENV_FILE)" BACKUP_ROOT="$(BACKUP_ROOT)" sh "$(BACKUP_SCRIPT)" db
+
+files-backup:
+	@ENV_FILE="$(ENV_FILE)" BACKUP_ROOT="$(BACKUP_ROOT)" sh "$(BACKUP_SCRIPT)" files
+
+full-backup:
+	@ENV_FILE="$(ENV_FILE)" BACKUP_ROOT="$(BACKUP_ROOT)" sh "$(BACKUP_SCRIPT)" full
+
+predeploy-backup:
+	@ENV_FILE="$(ENV_FILE)" BACKUP_ROOT="$(BACKUP_ROOT)" sh "$(BACKUP_SCRIPT)" full
+
+cleanup-backups:
+	@BACKUP_ROOT="$(BACKUP_ROOT)" RETENTION_DAYS="$(RETENTION_DAYS)" sh "$(BACKUP_SCRIPT)" cleanup

README.md

@@ -9,7 +9,10 @@
     - 기존 동작 방식과 성능을 기준(Baseline)으로 삼고, 수정 후에도 **기존의 모든 기능이 무결하게 유지되는지 반드시 테스트하여 입증**한다.
     - 검증 결과를 바탕으로 "무엇을, 왜, 어떻게" 바꿀지 상세 보고 후, 사용자로부터 **'진행시켜'** 승인을 얻은 뒤에만 집행한다.
 4. **선보고 후승인**: 모든 기능 수정 및 코드 변경 전에는 예상 방안을 먼저 보고하고 승인 절차를 거친다.
-5. **RED–GREEN–Refactor 개발 원칙**:
+5. **DB 삭제 및 초기화 절대 엄금 (Strict DB Deletion Policy)**:
+    - 어떠한 경우에도 `DELETE`, `DROP`, `TRUNCATE` 등 데이터를 삭제하거나 테이블을 초기화하는 작업은 사전에 사용자에게 상세 사유를 보고하고 **명시적 승인**을 얻은 후에만 시행한다.
+    - 기존 데이터의 가치를 최우선으로 하며, 작업 전 백업 여부를 반드시 확인한다.
+6. **RED–GREEN–Refactor 개발 원칙**:
     - 모든 기능 개발과 버그 수정은 **RED → GREEN → Refactor** 순서로 진행한다.
     - **RED**: 요구사항을 명확히 표현하는 테스트를 먼저 작성하고, 해당 테스트가 기능 미구현 또는 결함으로 인해 실패하는지 확인한다.
     - **GREEN**: 실패한 테스트를 통과시키는 데 필요한 최소한의 코드만 구현하며, 불필요한 기능 추가나 구조 변경을 하지 않는다.

build/pc_agent/EXE-00.toc

@@ -1,211 +0,0 @@
-('D:\\이태훈\\22전산자산조사\\ITAM\\dist\\pc_agent.exe',
- True,
- False,
- False,
- 'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\PyInstaller\\bootloader\\images\\icon-console.ico',
- None,
- False,
- False,
- b'<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<assembly xmlns='
- b'"urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">\n  <trustInfo x'
- b'mlns="urn:schemas-microsoft-com:asm.v3">\n    <security>\n      <requested'
- b'Privileges>\n        <requestedExecutionLevel level="asInvoker" uiAccess='
- b'"false"/>\n      </requestedPrivileges>\n    </security>\n  </trustInfo>\n  '
- b'<compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">\n    <'
- b'application>\n      <supportedOS Id="{e2011457-1546-43c5-a5fe-008deee3d3f'
- b'0}"/>\n      <supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93a}"/>\n '
- b'     <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}"/>\n      <s'
- b'upportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}"/>\n      <supporte'
- b'dOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}"/>\n    </application>\n  <'
- b'/compatibility>\n  <application xmlns="urn:schemas-microsoft-com:asm.v3">'
- b'\n    <windowsSettings>\n      <longPathAware xmlns="http://schemas.micros'
- b'oft.com/SMI/2016/WindowsSettings">true</longPathAware>\n    </windowsSett'
- b'ings>\n  </application>\n  <dependency>\n    <dependentAssembly>\n      <ass'
- b'emblyIdentity type="win32" name="Microsoft.Windows.Common-Controls" version='
- b'"6.0.0.0" processorArchitecture="*" publicKeyToken="6595b64144ccf1df" langua'
- b'ge="*"/>\n    </dependentAssembly>\n  </dependency>\n</assembly>',
- True,
- False,
- None,
- None,
- None,
- 'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\pc_agent.pkg',
- [('pyi-contents-directory _internal', '', 'OPTION'),
-  ('PYZ-00.pyz', 'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\PYZ-00.pyz', 'PYZ'),
-  ('struct',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\localpycs\\struct.pyc',
-   'PYMODULE'),
-  ('pyimod01_archive',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\localpycs\\pyimod01_archive.pyc',
-   'PYMODULE'),
-  ('pyimod02_importers',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\localpycs\\pyimod02_importers.pyc',
-   'PYMODULE'),
-  ('pyimod03_ctypes',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\localpycs\\pyimod03_ctypes.pyc',
-   'PYMODULE'),
-  ('pyimod04_pywin32',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\localpycs\\pyimod04_pywin32.pyc',
-   'PYMODULE'),
-  ('pyiboot01_bootstrap',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\PyInstaller\\loader\\pyiboot01_bootstrap.py',
-   'PYSOURCE'),
-  ('pyi_rth_inspect',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\PyInstaller\\hooks\\rthooks\\pyi_rth_inspect.py',
-   'PYSOURCE'),
-  ('pyi_rth_pkgutil',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\PyInstaller\\hooks\\rthooks\\pyi_rth_pkgutil.py',
-   'PYSOURCE'),
-  ('pyi_rth_multiprocessing',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\PyInstaller\\hooks\\rthooks\\pyi_rth_multiprocessing.py',
-   'PYSOURCE'),
-  ('pyi_rth_cryptography_openssl',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\_pyinstaller_hooks_contrib\\rthooks\\pyi_rth_cryptography_openssl.py',
-   'PYSOURCE'),
-  ('pyi_rth_pywintypes',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\_pyinstaller_hooks_contrib\\rthooks\\pyi_rth_pywintypes.py',
-   'PYSOURCE'),
-  ('pyi_rth_pythoncom',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\_pyinstaller_hooks_contrib\\rthooks\\pyi_rth_pythoncom.py',
-   'PYSOURCE'),
-  ('pc_agent', 'D:\\이태훈\\22전산자산조사\\ITAM\\pc_agent.py', 'PYSOURCE'),
-  ('python312.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\python312.dll',
-   'BINARY'),
-  ('pywin32_system32\\pywintypes312.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\pywin32_system32\\pywintypes312.dll',
-   'BINARY'),
-  ('pywin32_system32\\pythoncom312.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\pywin32_system32\\pythoncom312.dll',
-   'BINARY'),
-  ('select.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\select.pyd',
-   'EXTENSION'),
-  ('_multiprocessing.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_multiprocessing.pyd',
-   'EXTENSION'),
-  ('pyexpat.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\pyexpat.pyd',
-   'EXTENSION'),
-  ('_ssl.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_ssl.pyd',
-   'EXTENSION'),
-  ('_hashlib.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_hashlib.pyd',
-   'EXTENSION'),
-  ('unicodedata.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\unicodedata.pyd',
-   'EXTENSION'),
-  ('_decimal.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_decimal.pyd',
-   'EXTENSION'),
-  ('_lzma.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_lzma.pyd',
-   'EXTENSION'),
-  ('_bz2.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_bz2.pyd',
-   'EXTENSION'),
-  ('_ctypes.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_ctypes.pyd',
-   'EXTENSION'),
-  ('_queue.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_queue.pyd',
-   'EXTENSION'),
-  ('_wmi.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_wmi.pyd',
-   'EXTENSION'),
-  ('_socket.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_socket.pyd',
-   'EXTENSION'),
-  ('_overlapped.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_overlapped.pyd',
-   'EXTENSION'),
-  ('_asyncio.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_asyncio.pyd',
-   'EXTENSION'),
-  ('_cffi_backend.cp312-win_amd64.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\_cffi_backend.cp312-win_amd64.pyd',
-   'EXTENSION'),
-  ('cryptography\\hazmat\\bindings\\_rust.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography\\hazmat\\bindings\\_rust.pyd',
-   'EXTENSION'),
-  ('charset_normalizer\\md__mypyc.cp312-win_amd64.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\charset_normalizer\\md__mypyc.cp312-win_amd64.pyd',
-   'EXTENSION'),
-  ('charset_normalizer\\md.cp312-win_amd64.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\charset_normalizer\\md.cp312-win_amd64.pyd',
-   'EXTENSION'),
-  ('win32\\_win32sysloader.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\win32\\_win32sysloader.pyd',
-   'EXTENSION'),
-  ('win32\\win32api.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\win32\\win32api.pyd',
-   'EXTENSION'),
-  ('Pythonwin\\win32ui.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\Pythonwin\\win32ui.pyd',
-   'EXTENSION'),
-  ('win32\\win32event.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\win32\\win32event.pyd',
-   'EXTENSION'),
-  ('win32\\win32trace.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\win32\\win32trace.pyd',
-   'EXTENSION'),
-  ('VCRUNTIME140.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\VCRUNTIME140.dll',
-   'BINARY'),
-  ('VCRUNTIME140_1.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\VCRUNTIME140_1.dll',
-   'BINARY'),
-  ('libssl-3.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\libssl-3.dll',
-   'BINARY'),
-  ('libcrypto-3.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\libcrypto-3.dll',
-   'BINARY'),
-  ('libffi-8.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\libffi-8.dll',
-   'BINARY'),
-  ('python3.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\python3.dll',
-   'BINARY'),
-  ('Pythonwin\\mfc140u.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\Pythonwin\\mfc140u.dll',
-   'BINARY'),
-  ('certifi\\cacert.pem',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\certifi\\cacert.pem',
-   'DATA'),
-  ('certifi\\py.typed',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\certifi\\py.typed',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\licenses\\LICENSE.BSD',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\licenses\\LICENSE.BSD',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\licenses\\LICENSE',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\licenses\\LICENSE',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\RECORD',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\RECORD',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\METADATA',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\METADATA',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\WHEEL',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\WHEEL',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\INSTALLER',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\INSTALLER',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\licenses\\LICENSE.APACHE',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\licenses\\LICENSE.APACHE',
-   'DATA'),
-  ('base_library.zip',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\base_library.zip',
-   'DATA')],
- [],
- False,
- False,
- 1779102721,
- [('run.exe',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\PyInstaller\\bootloader\\Windows-64bit-intel\\run.exe',
-   'EXECUTABLE')],
- 'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\python312.dll')

build/pc_agent/PKG-00.toc

@@ -1,189 +0,0 @@
-('D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\pc_agent.pkg',
- {'BINARY': True,
-  'DATA': True,
-  'EXECUTABLE': True,
-  'EXTENSION': True,
-  'PYMODULE': True,
-  'PYSOURCE': True,
-  'PYZ': False,
-  'SPLASH': True,
-  'SYMLINK': False},
- [('pyi-contents-directory _internal', '', 'OPTION'),
-  ('PYZ-00.pyz', 'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\PYZ-00.pyz', 'PYZ'),
-  ('struct',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\localpycs\\struct.pyc',
-   'PYMODULE'),
-  ('pyimod01_archive',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\localpycs\\pyimod01_archive.pyc',
-   'PYMODULE'),
-  ('pyimod02_importers',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\localpycs\\pyimod02_importers.pyc',
-   'PYMODULE'),
-  ('pyimod03_ctypes',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\localpycs\\pyimod03_ctypes.pyc',
-   'PYMODULE'),
-  ('pyimod04_pywin32',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\localpycs\\pyimod04_pywin32.pyc',
-   'PYMODULE'),
-  ('pyiboot01_bootstrap',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\PyInstaller\\loader\\pyiboot01_bootstrap.py',
-   'PYSOURCE'),
-  ('pyi_rth_inspect',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\PyInstaller\\hooks\\rthooks\\pyi_rth_inspect.py',
-   'PYSOURCE'),
-  ('pyi_rth_pkgutil',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\PyInstaller\\hooks\\rthooks\\pyi_rth_pkgutil.py',
-   'PYSOURCE'),
-  ('pyi_rth_multiprocessing',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\PyInstaller\\hooks\\rthooks\\pyi_rth_multiprocessing.py',
-   'PYSOURCE'),
-  ('pyi_rth_cryptography_openssl',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\_pyinstaller_hooks_contrib\\rthooks\\pyi_rth_cryptography_openssl.py',
-   'PYSOURCE'),
-  ('pyi_rth_pywintypes',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\_pyinstaller_hooks_contrib\\rthooks\\pyi_rth_pywintypes.py',
-   'PYSOURCE'),
-  ('pyi_rth_pythoncom',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\_pyinstaller_hooks_contrib\\rthooks\\pyi_rth_pythoncom.py',
-   'PYSOURCE'),
-  ('pc_agent', 'D:\\이태훈\\22전산자산조사\\ITAM\\pc_agent.py', 'PYSOURCE'),
-  ('python312.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\python312.dll',
-   'BINARY'),
-  ('pywin32_system32\\pywintypes312.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\pywin32_system32\\pywintypes312.dll',
-   'BINARY'),
-  ('pywin32_system32\\pythoncom312.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\pywin32_system32\\pythoncom312.dll',
-   'BINARY'),
-  ('select.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\select.pyd',
-   'EXTENSION'),
-  ('_multiprocessing.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_multiprocessing.pyd',
-   'EXTENSION'),
-  ('pyexpat.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\pyexpat.pyd',
-   'EXTENSION'),
-  ('_ssl.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_ssl.pyd',
-   'EXTENSION'),
-  ('_hashlib.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_hashlib.pyd',
-   'EXTENSION'),
-  ('unicodedata.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\unicodedata.pyd',
-   'EXTENSION'),
-  ('_decimal.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_decimal.pyd',
-   'EXTENSION'),
-  ('_lzma.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_lzma.pyd',
-   'EXTENSION'),
-  ('_bz2.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_bz2.pyd',
-   'EXTENSION'),
-  ('_ctypes.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_ctypes.pyd',
-   'EXTENSION'),
-  ('_queue.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_queue.pyd',
-   'EXTENSION'),
-  ('_wmi.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_wmi.pyd',
-   'EXTENSION'),
-  ('_socket.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_socket.pyd',
-   'EXTENSION'),
-  ('_overlapped.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_overlapped.pyd',
-   'EXTENSION'),
-  ('_asyncio.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\_asyncio.pyd',
-   'EXTENSION'),
-  ('_cffi_backend.cp312-win_amd64.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\_cffi_backend.cp312-win_amd64.pyd',
-   'EXTENSION'),
-  ('cryptography\\hazmat\\bindings\\_rust.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography\\hazmat\\bindings\\_rust.pyd',
-   'EXTENSION'),
-  ('charset_normalizer\\md__mypyc.cp312-win_amd64.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\charset_normalizer\\md__mypyc.cp312-win_amd64.pyd',
-   'EXTENSION'),
-  ('charset_normalizer\\md.cp312-win_amd64.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\charset_normalizer\\md.cp312-win_amd64.pyd',
-   'EXTENSION'),
-  ('win32\\_win32sysloader.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\win32\\_win32sysloader.pyd',
-   'EXTENSION'),
-  ('win32\\win32api.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\win32\\win32api.pyd',
-   'EXTENSION'),
-  ('Pythonwin\\win32ui.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\Pythonwin\\win32ui.pyd',
-   'EXTENSION'),
-  ('win32\\win32event.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\win32\\win32event.pyd',
-   'EXTENSION'),
-  ('win32\\win32trace.pyd',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\win32\\win32trace.pyd',
-   'EXTENSION'),
-  ('VCRUNTIME140.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\VCRUNTIME140.dll',
-   'BINARY'),
-  ('VCRUNTIME140_1.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\VCRUNTIME140_1.dll',
-   'BINARY'),
-  ('libssl-3.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\libssl-3.dll',
-   'BINARY'),
-  ('libcrypto-3.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\libcrypto-3.dll',
-   'BINARY'),
-  ('libffi-8.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\DLLs\\libffi-8.dll',
-   'BINARY'),
-  ('python3.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\python3.dll',
-   'BINARY'),
-  ('Pythonwin\\mfc140u.dll',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\Pythonwin\\mfc140u.dll',
-   'BINARY'),
-  ('certifi\\cacert.pem',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\certifi\\cacert.pem',
-   'DATA'),
-  ('certifi\\py.typed',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\certifi\\py.typed',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\licenses\\LICENSE.BSD',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\licenses\\LICENSE.BSD',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\licenses\\LICENSE',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\licenses\\LICENSE',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\RECORD',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\RECORD',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\METADATA',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\METADATA',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\WHEEL',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\WHEEL',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\INSTALLER',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\INSTALLER',
-   'DATA'),
-  ('cryptography-45.0.2.dist-info\\licenses\\LICENSE.APACHE',
-   'C:\\Users\\User\\AppData\\Local\\Programs\\Python\\Python312\\Lib\\site-packages\\cryptography-45.0.2.dist-info\\licenses\\LICENSE.APACHE',
-   'DATA'),
-  ('base_library.zip',
-   'D:\\이태훈\\22전산자산조사\\ITAM\\build\\pc_agent\\base_library.zip',
-   'DATA')],
- 'python312.dll',
- False,
- False,
- False,
- [],
- None,
- None,
- None)

build/pc_agent/warn-pc_agent.txt

@@ -1,58 +0,0 @@
-
-This file lists modules PyInstaller was not able to find. This does not
-necessarily mean these modules are required for running your program. Both
-Python's standard library and 3rd-party Python packages often conditionally
-import optional modules, some of which may be available only on certain
-platforms.
-
-Types of import:
-* top-level: imported at the top-level - look at these first
-* conditional: imported within an if-statement
-* delayed: imported within a function
-* optional: imported within a try-except-statement
-
-IMPORTANT: Do NOT post this list to the issue-tracker. Use it as a basis for
-            tracking down the missing module yourself. Thanks!
-
-missing module named pwd - imported by posixpath (delayed, conditional, optional), shutil (delayed, optional), tarfile (optional), pathlib (delayed, optional), subprocess (delayed, conditional, optional), netrc (delayed, conditional), getpass (delayed)
-missing module named grp - imported by shutil (delayed, optional), tarfile (optional), pathlib (delayed, optional), subprocess (delayed, conditional, optional)
-missing module named _posixsubprocess - imported by subprocess (conditional), multiprocessing.util (delayed)
-missing module named fcntl - imported by subprocess (optional)
-missing module named _posixshmem - imported by multiprocessing.resource_tracker (conditional), multiprocessing.shared_memory (conditional)
-missing module named _scproxy - imported by urllib.request (conditional)
-missing module named termios - imported by getpass (optional)
-missing module named multiprocessing.BufferTooShort - imported by multiprocessing (top-level), multiprocessing.connection (top-level)
-missing module named multiprocessing.AuthenticationError - imported by multiprocessing (top-level), multiprocessing.connection (top-level)
-missing module named _frozen_importlib_external - imported by importlib._bootstrap (delayed), importlib (optional), importlib.abc (optional), zipimport (top-level)
-excluded module named _frozen_importlib - imported by importlib (optional), importlib.abc (optional), zipimport (top-level)
-missing module named posix - imported by os (conditional, optional), posixpath (optional), shutil (conditional), importlib._bootstrap_external (conditional)
-missing module named resource - imported by posix (top-level)
-missing module named multiprocessing.get_context - imported by multiprocessing (top-level), multiprocessing.pool (top-level), multiprocessing.managers (top-level), multiprocessing.sharedctypes (top-level)
-missing module named multiprocessing.TimeoutError - imported by multiprocessing (top-level), multiprocessing.pool (top-level)
-missing module named multiprocessing.set_start_method - imported by multiprocessing (top-level), multiprocessing.spawn (top-level)
-missing module named multiprocessing.get_start_method - imported by multiprocessing (top-level), multiprocessing.spawn (top-level)
-missing module named pyimod02_importers - imported by C:\Users\User\AppData\Local\Programs\Python\Python312\Lib\site-packages\PyInstaller\hooks\rthooks\pyi_rth_pkgutil.py (delayed)
-missing module named collections.Callable - imported by collections (optional), socks (optional)
-missing module named vms_lib - imported by platform (delayed, optional)
-missing module named 'java.lang' - imported by platform (delayed, optional)
-missing module named java - imported by platform (delayed)
-missing module named _winreg - imported by platform (delayed, optional)
-missing module named simplejson - imported by requests.compat (conditional, optional)
-missing module named dummy_threading - imported by requests.cookies (optional)
-missing module named asyncio.DefaultEventLoopPolicy - imported by asyncio (delayed, conditional), asyncio.events (delayed, conditional)
-missing module named annotationlib - imported by typing_extensions (conditional)
-missing module named 'h2.events' - imported by urllib3.http2.connection (top-level)
-missing module named 'h2.connection' - imported by urllib3.http2.connection (top-level)
-missing module named h2 - imported by urllib3.http2.connection (top-level)
-missing module named zstandard - imported by urllib3.util.request (optional), urllib3.response (optional)
-missing module named brotli - imported by urllib3.util.request (optional), urllib3.response (optional)
-missing module named brotlicffi - imported by urllib3.util.request (optional), urllib3.response (optional)
-missing module named win_inet_pton - imported by socks (conditional, optional)
-missing module named bcrypt - imported by cryptography.hazmat.primitives.serialization.ssh (optional)
-missing module named cryptography.x509.UnsupportedExtension - imported by cryptography.x509 (optional), urllib3.contrib.pyopenssl (optional)
-missing module named 'OpenSSL.crypto' - imported by urllib3.contrib.pyopenssl (delayed, conditional)
-missing module named OpenSSL - imported by urllib3.contrib.pyopenssl (top-level)
-missing module named 'pyodide.ffi' - imported by urllib3.contrib.emscripten.fetch (delayed, optional)
-missing module named pyodide - imported by urllib3.contrib.emscripten.fetch (top-level)
-missing module named js - imported by urllib3.contrib.emscripten.fetch (top-level)
-missing module named 'win32com.gen_py' - imported by win32com (conditional, optional)

docker-compose.prod.yaml

@@ -0,0 +1,73 @@
+services:
+  backend:
+    image: itam-backend:prod
+    build:
+      context: .
+      dockerfile: Dockerfile.backend.prod
+    container_name: itam-backend
+    working_dir: /app
+    env_file:
+      - .env
+    environment:
+      NODE_ENV: production
+      PORT: 3000
+    volumes:
+      - ./uploads:/app/uploads
+      - ./map_config.json:/app/map_config.json:ro
+    expose:
+      - "3000"
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+  frontend:
+    image: itam-frontend:prod
+    build:
+      context: .
+      dockerfile: Dockerfile.frontend.prod
+    container_name: itam-frontend
+    expose:
+      - "80"
+    restart: unless-stopped
+
+  nginx:
+    image: nginx:stable-alpine
+    container_name: itam-nginx
+    ports:
+      - "9090:80"
+    volumes:
+      - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf:ro
+      - ./logs/nginx:/var/log/nginx
+    depends_on:
+      backend:
+        condition: service_healthy
+      frontend:
+        condition: service_started
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:80/"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 20s
+
+  database:
+    image: mysql:latest
+    container_name: itam-mysql
+    ports:
+      - "3306:3306"
+    environment:
+      - MYSQL_ROOT_PASSWORD=itam1234  # 여기 직접 기입
+      - MYSQL_DATABASE=itam
+      - MYSQL_USER=itam
+      - MYSQL_PASSWORD=itam1234
+    volumes:
+      - ./mysql_data:/var/lib/mysql
+    restart: always
+    command:
+      - --character-set-server=utf8mb4
+      - --collation-server=utf8mb4_unicode_ci

docker-compose.test.yaml

@@ -0,0 +1,62 @@
+# Local testing compose file - uses relative paths and build contexts
+# Usage: docker compose -f docker-compose.test.yaml up --build
+
+services:
+  backend:
+    build:
+      context: .
+      dockerfile: Dockerfile.backend.prod
+    container_name: itam-backend-test
+    working_dir: /app
+    env_file:
+      - .env
+    environment:
+      NODE_ENV: development
+      PORT: 3000
+      DB_HOST: ${DB_HOST:-172.16.8.151}
+      DB_PORT: ${DB_PORT:-3306}
+      DB_USER: ${DB_USER:-root}
+      DB_PASS: ${DB_PASS:-}
+      DB_NAME: ${DB_NAME:-itam}
+    ports:
+      - "3000:3000"
+    volumes:
+      - ./uploads:/app/uploads
+      - ./map_config.json:/app/map_config.json:ro
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+  frontend:
+    build:
+      context: .
+      dockerfile: Dockerfile.frontend.prod
+    container_name: itam-frontend-test
+    expose:
+      - "80"
+    restart: unless-stopped
+
+  nginx:
+    image: nginx:stable-alpine
+    container_name: itam-nginx-test
+    ports:
+      - "8080:80"
+    volumes:
+      - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf:ro
+      - ./logs/nginx:/var/log/nginx
+    depends_on:
+      backend:
+        condition: service_healthy
+      frontend:
+        condition: service_started
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:80/"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 20s

docker-compose.yaml

@@ -0,0 +1,48 @@
+services:
+  backend:
+    build:
+      context: .
+      dockerfile: Dockerfile.backend
+    container_name: dachs-backend
+    working_dir: /app
+    env_file:
+      - .env
+    environment:
+      DB_HOST: ${DB_HOST}
+      DB_PORT: ${DB_PORT}
+      DB_USER: ${DB_USER}
+      DB_PASS: ${DB_PASS}
+      DB_NAME: ${DB_NAME}
+      PORT: 3000
+    ports:
+      - "3000:3000"
+    volumes:
+      - ./:/app
+      - backend_node_modules:/app/node_modules
+      - ./uploads:/app/uploads
+      - ./map_config.json:/app/map_config.json
+    command: npm run server
+    restart: unless-stopped
+
+  frontend:
+    build:
+      context: .
+      dockerfile: Dockerfile.frontend
+    container_name: dachs-frontend
+    working_dir: /app
+    depends_on:
+      - backend
+    environment:
+      CHOKIDAR_USEPOLLING: "true"
+      VITE_DEV_PROXY_TARGET: http://backend:3000
+    ports:
+      - "8080:8080"
+    volumes:
+      - ./:/app
+      - frontend_node_modules:/app/node_modules
+    command: npm run dev -- --host 0.0.0.0
+    restart: unless-stopped
+
+volumes:
+  backend_node_modules:
+  frontend_node_modules:

docker/frontend/default.conf

@@ -0,0 +1,55 @@
+server {
+    listen 80;
+    listen [::]:80;
+    server_name _;
+
+    root /usr/share/nginx/html;
+
+    # Logging
+    access_log /var/log/nginx/frontend-access.log main;
+    error_log /var/log/nginx/frontend-error.log warn;
+
+    # Security headers
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header X-XSS-Protection "1; mode=block" always;
+    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+
+    # Gzip compression
+    gzip on;
+    gzip_types text/plain text/css text/xml text/javascript 
+               application/x-javascript application/xml+rss 
+               application/json application/javascript;
+    gzip_min_length 1000;
+
+    # Serve static files with SPA fallback
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+
+    # Cache static assets (60 days)
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|webp|woff|woff2|ttf|eot)$ {
+        expires 60d;
+        add_header Cache-Control "public, immutable";
+    }
+
+    # Don't cache HTML files
+    location ~* \.html$ {
+        expires -1;
+        add_header Cache-Control "no-cache, no-store, must-revalidate";
+    }
+
+    # Health check
+    location /health {
+        access_log off;
+        return 200 "OK\n";
+        add_header Content-Type text/plain;
+    }
+
+    # Deny access to sensitive files
+    location ~ /\. {
+        deny all;
+        access_log off;
+        log_not_found off;
+    }
+}

docker/mysql/init/README.md

@@ -0,0 +1,16 @@
+# MySQL init directory
+
+This directory is kept as a legacy hook for file-based MySQL initialization.
+
+Current production path in this repository is not file-based import.
+The live Docker flow uses the `db-bootstrap` service in `docker-compose.yaml` to stream data from the external source DB into the internal `db` container.
+
+Use this directory only if you intentionally switch back to `docker-entrypoint-initdb.d` style initialization.
+
+If you do that, typical naming would be:
+
+- `01_schema.sql`
+- `02_seed.sql`
+- or a single `01_itam_dump.sql`
+
+Remember that files in this directory are executed automatically by the MySQL container only on the first initialization of the data volume.

docker/nginx/default.conf

@@ -0,0 +1,101 @@
+upstream backend {
+    server backend:3000;
+}
+
+upstream frontend {
+    server frontend:80;
+}
+
+server {
+    listen 80;
+    listen [::]:80;
+    server_name _;
+
+    # Client upload size limit (adjust as needed)
+    client_max_body_size 100M;
+
+    # Logging
+    access_log /var/log/nginx/access.log main;
+    error_log /var/log/nginx/error.log warn;
+
+    # Security headers
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header X-XSS-Protection "1; mode=block" always;
+    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+
+    # Gzip compression
+    gzip on;
+    gzip_types text/plain text/css text/xml text/javascript 
+               application/x-javascript application/xml+rss 
+               application/json application/javascript;
+    gzip_min_length 1000;
+
+    # Forward all app requests to the frontend container
+    location / {
+        proxy_pass http://frontend;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_http_version 1.1;
+    }
+
+    # API proxy to backend
+    location /api/ {
+        proxy_pass http://backend/api/;
+        
+        # Preserve original request information
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_set_header X-Forwarded-Host $server_name;
+        proxy_set_header X-Forwarded-Port $server_port;
+        
+        # Connection settings
+        proxy_connect_timeout 60s;
+        proxy_send_timeout 60s;
+        proxy_read_timeout 60s;
+        
+        # Buffering settings
+        proxy_buffering on;
+        proxy_buffer_size 4k;
+        proxy_buffers 8 4k;
+        proxy_busy_buffers_size 8k;
+    }
+
+    # Uploads proxy to backend
+    location /uploads/ {
+        proxy_pass http://backend/uploads/;
+        
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        
+        # Cache uploads
+        expires 30d;
+        add_header Cache-Control "public";
+    }
+
+    # Health check endpoint (for monitoring)
+    location /health {
+        access_log off;
+        return 200 "OK\n";
+        add_header Content-Type text/plain;
+    }
+
+    # Deny access to sensitive files
+    location ~ /\. {
+        deny all;
+        access_log off;
+        log_not_found off;
+    }
+
+    location ~ ~$ {
+        deny all;
+        access_log off;
+        log_not_found off;
+    }
+}

docs/itam_cicd_setup.md

@@ -0,0 +1,226 @@
+# ITAM CI/CD 설정 가이드
+
+## 1. 문서 목적
+
+이 문서는 현재 ITAM 저장소에 구성된 CI/CD 파일을 실제 운영에 연결하기 위해 필요한 기준을 정리한 가이드다.
+
+대상 범위는 아래와 같다.
+
+1. Gitea Actions workflow 역할
+2. Gitea Variables / Secrets 설정값
+3. 운영 서버 배포 디렉토리 기준
+4. 운영 영속 경로 기준
+5. production deploy 실행 전 확인 사항
+
+---
+
+## 2. 현재 CI/CD 구성
+
+현재 `.gitea/workflows`에는 ITAM 관련 workflow만 남겨둔 상태다.
+
+1. `itam_code_check.yml`
+2. `itam_docker_build_check.yml`
+3. `itam_production_deploy.yml`
+
+각 workflow의 역할은 아래와 같다.
+
+1. `itam_code_check.yml`: TypeScript/Vite build와 compose 문법 검증
+2. `itam_docker_build_check.yml`: 운영용 Docker 이미지 빌드 가능 여부 검증
+3. `itam_production_deploy.yml`: 운영 서버에 SSH 접속 후 실제 배포 수행
+
+현재 배포 흐름은 아래와 같다.
+
+```mermaid
+flowchart LR
+  DEV["Developer Push or Manual Run"] --> CODE["ITAM Code Check"]
+  CODE --> BUILD["ITAM Docker Build Check"]
+  BUILD --> DEPLOY["ITAM Production Deploy"]
+  DEPLOY --> HOST["Production Host"]
+  HOST --> APP["docker compose up -d --build"]
+  linkStyle default stroke:#d32f2f,stroke-width:2px;
+```
+
+---
+
+## 3. Gitea Variables / Secrets 기준
+
+`itam_production_deploy.yml`이 정상 동작하려면 아래 값이 필요하다.
+
+### 3.1 Variables
+
+아래 항목은 Gitea repository Variables에 등록한다.
+
+| Key | 설명 | 예시 |
+| --- | --- | --- |
+| `PROD_HOST` | 운영 서버 SSH 접속 호스트 | `10.0.0.25` |
+| `PROD_USER` | 운영 서버 SSH 사용자 | `deploy` |
+| `PROD_DEPLOY_PATH` | 서버에서 저장소를 배포할 경로 | `/opt/itam` |
+| `PROD_BACKUP_ROOT` | 배포 전 백업 저장 경로, 배포 경로 바깥이어야 함 | `/opt/itam-backups` |
+| `PROD_GIT_URL` | 운영 서버에서 pull 가능한 저장소 주소 | `git@gitea.example.com:team/itam.git` |
+| `PROD_DB_HOST` | 외부 MySQL 호스트 | `172.16.8.151` |
+| `PROD_DB_PORT` | 외부 MySQL 포트 | `3306` |
+| `PROD_DB_USER` | 운영 DB 계정 | `itam_admin` |
+| `PROD_DB_NAME` | 운영 DB 이름 | `itam` |
+| `PROD_LOG_LEVEL` | 애플리케이션 로그 레벨 | `info` |
+
+### 3.2 Secrets
+
+아래 항목은 Gitea repository Secrets에 등록한다.
+
+| Key | 설명 |
+| --- | --- |
+| `PROD_SSH_PRIVATE_KEY` | 운영 서버 접속용 개인키 |
+| `PROD_DB_PASS` | 운영 DB 비밀번호 |
+
+### 3.3 운영 원칙
+
+1. `PROD_DB_PASS`는 Variables가 아니라 Secrets에만 둔다.
+2. `PROD_SSH_PRIVATE_KEY`는 배포 전용 계정 키를 사용한다.
+3. `PROD_GIT_URL`은 운영 서버에서 직접 pull 가능한 주소여야 한다.
+4. 운영 서버의 `known_hosts`는 workflow에서 자동 등록되지만, 최초 운영 전 수동 접속 검증도 함께 수행하는 것이 안전하다.
+5. `PROD_BACKUP_ROOT`는 `PROD_DEPLOY_PATH` 내부가 아니라 바깥 경로를 사용해야 한다.
+
+---
+
+## 4. 운영 서버 배포 디렉토리 기준
+
+현재 `itam_production_deploy.yml`은 운영 서버에서 아래 흐름으로 배포를 수행한다.
+
+1. `PROD_DEPLOY_PATH` 디렉토리를 생성한다.
+2. 기존 운영 상태가 있으면 배포 전 백업을 수행한다.
+3. 해당 경로에 저장소를 clone 또는 fetch 한다.
+4. 지정 브랜치로 checkout 한다.
+5. `uploads`, `logs/nginx` 디렉토리를 생성한다.
+6. `.env.deploy`를 서버의 `.env`로 복사한다.
+7. `docker compose -f docker-compose.prod.yaml up -d --build`를 실행한다.
+
+권장 디렉토리 구조는 아래와 같다.
+
+```text
+/opt/itam/
+  .env
+  docker-compose.prod.yaml
+  Dockerfile.frontend.prod
+  Dockerfile.backend.prod
+  map_config.json
+  uploads/
+  logs/
+    nginx/
+  docker/
+    nginx/
+      default.conf
+    frontend/
+      default.conf
+  src/
+  public/
+  img/
+
+/opt/itam-backups/
+  db/
+  files/
+```
+
+현재 구조 기준 배포 관계는 아래와 같다.
+
+```mermaid
+flowchart TB
+  subgraph HOST["Production Host"]
+    REPO["PROD_DEPLOY_PATH"]
+    ENV[".env"]
+    UP["uploads/"]
+    LOGS["logs/nginx/"]
+    MAP["map_config.json"]
+  end
+
+  subgraph CTR["Docker Services"]
+    NGINX["itam-nginx"]
+    FRONT["itam-frontend"]
+    BACK["itam-backend"]
+  end
+
+  DB["External MySQL"]
+
+  REPO --> NGINX
+  ENV --> BACK
+  UP --> BACK
+  MAP --> BACK
+  LOGS --> NGINX
+  REPO --> BAK["PROD_BACKUP_ROOT"]
+  NGINX --> FRONT
+  NGINX --> BACK
+  BACK --> DB
+  linkStyle default stroke:#d32f2f,stroke-width:2px;
+```
+
+---
+
+## 5. 영속 경로 기준
+
+현재 `docker-compose.prod.yaml` 기준으로 운영에서 유지되어야 하는 경로는 아래와 같다.
+
+1. `.env`
+2. `uploads/`
+3. `map_config.json`
+4. `logs/nginx/`
+5. `PROD_BACKUP_ROOT`
+
+각 경로의 의미는 아래와 같다.
+
+1. `.env`: backend 런타임 환경변수
+2. `uploads/`: 업로드 파일 데이터
+3. `map_config.json`: 위치/맵 구성 데이터
+4. `logs/nginx/`: reverse proxy 접근 로그 및 에러 로그
+5. `PROD_BACKUP_ROOT`: 배포 전 DB dump와 운영 파일 아카이브 저장 위치
+
+운영 기준으로 보면 `uploads/`와 `map_config.json`은 애플리케이션 데이터이고, `.env`는 환경 설정이며, `logs/nginx/`는 운영 추적 데이터다.
+
+즉 서버 운영 시 컨테이너만 다시 띄우면 되는 구조가 아니라, 이 경로들이 유지되는 것을 전제로 배포가 성립한다.
+
+---
+
+## 6. 배포 전 체크리스트
+
+`itam_production_deploy.yml` 실행 전 아래 항목을 먼저 확인한다.
+
+1. 운영 서버에 Docker Engine과 `docker compose`가 설치되어 있어야 한다.
+2. 운영 서버의 배포 계정이 Docker 실행 권한을 가져야 한다.
+3. 운영 서버에서 `PROD_GIT_URL`로 직접 `git fetch`가 가능해야 한다.
+4. 외부 MySQL 접속 정보가 실제 운영망 기준으로 열려 있어야 한다.
+5. 운영 서버에 `map_config.json` 초기 파일이 존재해야 한다.
+6. 방화벽 또는 보안 장비에서 80 포트 접근 정책이 정리되어 있어야 한다.
+
+권장 확인 명령 예시는 아래와 같다.
+
+```bash
+docker --version
+docker compose version
+git ls-remote <PROD_GIT_URL>
+test -f map_config.json
+test -d uploads
+```
+
+---
+
+## 7. 현재 구조에서의 해석
+
+현재 ITAM CI/CD는 staging 없이도 운영 배포가 가능한 최소 구조로 정리되어 있다.
+
+이 구조의 장점은 아래와 같다.
+
+1. workflow 수가 적어서 관리가 단순하다.
+2. 운영 배포에 필요한 변수와 시크릿 범위가 명확하다.
+3. staging이 필요해지면 production deploy workflow를 복제해 별도 환경으로 확장하기 쉽다.
+
+즉, 지금 단계에서는 production 기준을 먼저 고정하고, staging은 동일 패턴으로 추후 추가하는 전략이 적절하다.
+
+---
+
+## 8. 다음 권장 작업
+
+현재 문서 기준으로 바로 이어서 할 작업은 아래 순서가 적절하다.
+
+1. `PROD_DEPLOY_PATH` 실제 서버 경로 확정
+2. 운영 서버 배포 계정 생성 및 SSH 키 등록
+3. `map_config.json`, `uploads/` 초기 데이터 준비
+4. production deploy workflow에 smoke check 추가
+5. 로그 로테이션과 백업/복구 절차 문서화

docs/plans/implementation_plan2

@@ -1,51 +0,0 @@
-# 구조 개선 및 다중 탭(Depth 2) 도입 계획
-
-사용자 요청에 따라 H/W와 S/W를 구분하고, 그 하위에 각각 대시보드 및 상세 항목(개인PC, 서버 등) 탭을 나누는 네비게이션 구조를 도입합니다. 바닐라 JS 기반에서 각 탭마다 다른 데이터 테이블을 그려내는 아키텍처로 개선합니다.
-
-## User Review Required
-
-> [!IMPORTANT]
-> 1. **엑셀 관리 방식 (Sheets 분리)**: 단일 엑셀 파일 안에 여러 개의 시트(Sheet)를 나누어 관리하는 방식으로 제안합니다. 한 번 엑셀을 업로드하면, `개인PC`, `서버`, `스토리지`, `전산비품` 등 각각의 시트를 한방에 파싱하여 각 탭에 적용하도록 구성하겠습니다. 
-> 2. **S/W 스키마**: 현재 H/W 기반 데이터 스키마만 정의되어 있습니다. [구독 소프트웨어]와 [영구 소프트웨어] 탭 개발을 위한 데이터 항목들(예: 사용기간, 라이선스키, 결제방식 등)은 아직 정해지지 않았으므로 일단 공통 S/W 데이터 스키마 임시 템플릿(S/W명, 유형, 라이선스키, 할당된 사용자 등)으로 만들어 두고 추후 수정할 수 있도록 개발해도 될까요?
-
-## Proposed Changes
-
-### 1. UI/UX: 2 Depth 네비게이션 (`index.html`, `style.css`)
-- **좌측(또는 상단) GNB (Global Navigation Bar)**: H/W 와 S/W 를 스위치할 수 있는 메인 탭 생성.
-- **LNB (Local Navigation Bar)**: 메인 탭 전환 시 나타나는 서브 탭(H/W: 대시보드/PC/서버/스토리지/비품, S/W: 대시보드/구독/영구).
-- `README.md` 가이드라인에 따라 화면을 분할하고 정보 밀도를 높이기 위해 Box-less, Line-based Layout 유지.
-
-#### [MODIFY] index.html
-#### [MODIFY] src/style.css
-
----
-
-### 2. 다중 데이터 구조 및 상태 관리 (`main.ts`)
-- 현재 선택된 메뉴 뎁스(예: `activeCategory = 'HW'`, `activeSubTab = '개인PC'`)에 따라 렌더링 함수가 동기화되도록 라우팅/상태 관리 로직 추가.
-- `Dashboard` 탭 진입 시, 모든 서브 탭 데이터의 갯수(Total PCs, Total Servers 등)를 한눈에 볼 수 있는 요약 영역(Summary Cards/Charts 영역) 예약 및 구현.
-
-#### [MODIFY] src/main.ts
-
----
-
-### 3. 멀티-시트(Multi-sheet) 엑셀 파싱 (`excelHandler.ts`)
-- `SheetJS` 기능을 확장하여 다운로드/데이터 추출 시 다중 시트 생성.
-- **H/W 템플릿 시트명**: `[개인PC, 서버, 스토리지, 전산비품]`
-- **S/W 템플릿 시트명**: `[구독SW, 영구SW]`
-
-#### [MODIFY] src/excelHandler.ts
-
-## Open Questions
-
-> [!WARNING]
-> * 왼쪽 사이드바로 메뉴를 구성하는 것이 좋을까요, 상단 가로바(Top Nav) 2단으로 구성하는 것이 좋을까요? Reference 이미지가 따로 없다면 범용적으로 관리하기 편한 **왼쪽 사이드바 구조(Sidebar Menu)** 를 제안합니다. (진행 승인 시 사이드바 형태로 구현합니다.)
-
-## Verification Plan
-
-### Automated Tests
-- 좌측 `H/W`, `S/W` 클릭 시 서브 메뉴가 정상 토글되는지 검증(`main.ts` DOM class toggle 확인).
-- 서브 메뉴 `서버` 클릭 시 빈 테이블(또는 서버 자산 테이블)이 그려지는지 확인.
-- 달라진 구조로 `엑셀 템플릿 양식`을 다운로드했을 때 파일에 다수의 시트(Sheet)가 정상 분류되어 있는지 확인.
-
-### Manual Verification
-- 브라우저 에이전트를 통해 바뀐 화면의 스크린샷(LNB 사이드바, Dashboard 화면 등)을 찍어 사용자에게 보고.

docs/plans/implementation_plan3

@@ -1,47 +0,0 @@
-# 임시 DB 생성 및 S/W 사용자 관리 개편
-
-임시 DB 엑셀 파일 생성과 S/W 목록의 '할당자' 속성 UI 개편에 대한 기술 구현 계획입니다.
-
-## User Review Required
-> [!IMPORTANT]
-> **사용자 관리 데이터 저장 방식에 대한 피드백이 필요합니다.**
-> 엑셀을 임시 DB로 사용하고 있기 때문에, "사용자 관리" 팝업에서 추가/삭제된 사용자 목록을 엑셀에 저장할 때 **쉼표(,)로 구분된 하나의 문자열**(예: `홍길동, 김철수, 이영희`)로 기존 `할당자` 컬럼에 업데이트 하는 방식을 제안합니다. 이 방식이 괜찮으신가요?
-
-## Proposed Changes
-
-### 1. 임시 DB 연동
-임시로 사용할 초기 엑셀 파일(`temp_db.xlsx`)을 프로젝트 루트에 스크립트를 통해 생성합니다.
-- 개인PC, 서버, 구독SW, 영구SW 시트에 각각 구성을 확인할 수 있는 dummy 데이터 1~2개씩을 포함하여 생성합니다.
-- 향후 화면에서 '엑셀 업로드'를 통해 이 파일을 업로드하여 데이터를 화면에 뿌려볼 수 있습니다. (원하시면 페이지 로드 시 이 파일을 임포트하도록 로직을 변경할 수도 있으나, 브라우저 단에서 로컬 파일을 자동 리딩하는 것은 제한이 있으므로 기본적으로는 파일을 제공만 합니다.)
-
----
-
-### 2. 컴포넌트: HTML 구조 변경
-#### [MODIFY] [index.html](file:///c:/Project/HM%20ITAM/index.html)
-- `sw-asset-modal`의 폼 내용 중 "할당자" 입력 폼(<label> 및 <input>) 제거
-- 관리 팝업을 위한 `sw-user-modal` 모달 오버레이 마크업 추가
-  기존 유저 목록을 보여주고, 새 사용자를 추가하거나 기존 사용자를 삭제할 수 있는 UI (리스트, 추가 인풋, 추가 버튼 기반) 작성
-
----
-
-### 3. 컴포넌트: 로직 및 스타일
-#### [MODIFY] [src/main.ts](file:///c:/Project/HM%20ITAM/src/main.ts)
-- S/W 렌더링 영역(`renderTable`)에서 데스크탑 뷰의 `<th>할당자</th>` 및 해당하는 셀(`<td>`) 제거
-- S/W `관리` 탭(`<td>`)에 수정 버튼(`btn-edit`) 옆에 사용자 관리 아이콘 (Lucide의 `Users` 또는 `UserCog` 아이콘 활용) 추가
-- 사용자 관리 아이콘 클릭 시 `sw-user-modal` 팝업 띄우는 이벤트 리스너 추가
-- `sw-user-modal` 팝업 내에서 사용자를 추가/삭제하고 '저장' 시, 해당 S/W 자산의 `할당자` 데이터를 갱신하도록 처리 (쉼표 구분 형태)
-
-#### [MODIFY] [src/excelHandler.ts](file:///c:/Project/HM%20ITAM/src/excelHandler.ts)
-- (선택 사항) `SW_HEADERS`나 엑셀 파싱 로직은 그대로 두어 하위 호환성 유지. 사용자가 데이터를 쉼표 형태로 주고 받을 것이므로 별도의 인터페이스 변경은 없음.
-
-## Open Questions
-- 사용자 관리 팝업에서 저장할 때, 이름 말고 '부서'나 '직급' 같은 추가적인 정보도 관리가 필요하신가요? (기본적으로는 엑셀에 단일 텍스트로 보존되므로 '이름'만 관리하는 것으로 설계했습니다.)
-- 개발 환경(Vite)에서 초기 로딩 시 `temp_db.xlsx`를 자동으로 불러오도록 Vite의 플러그인 또는 fetch 로직을 추가하는 것을 원하시나요? 아니면 엑셀 파일만 만들어 드리고 사용자가 '엑셀 업로드' 버튼으로 직접 연동해 쓰는 방식이 좋으신가요?
-
-## Verification Plan
-### Manual Verification
-1. `npm run dev` 후 브라우저 접속
-2. 프로젝트 폴더에 `temp_db.xlsx` 파일이 생성되었는지 확인
-3. 소프트웨어 > 영구/구독 탭 진입 시 "할당자" 테이블 헤더가 사라진 것 확인
-4. 관리 탭의 "사용자 관리" 아이콘 클릭 시, 해당 소프트웨어의 사용자를 등록하고 삭제할 수 있는 팝업 등장하는지 확인
-5. 사용자 아이콘을 클릭해 홍길동, 김철수 등록 후, 전체 엑셀 저장 혹은 다운로드 시 엑셀 파일 내의 '할당자' 열에 `홍길동,김철수` 로 잘 들어가는지 확인

index.html

@@ -10,6 +10,7 @@
     href="https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/dist/web/variable/pretendardvariable.min.css" />
   <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/chartjs-plugin-datalabels@2.0.0"></script>
+  <script src="/qrcode.min.js"></script>
 </head>
 
 <body>

label/config.ini

@@ -0,0 +1,4 @@
+[PRINT]
+FONT=8
+LEFT=143
+TOP=40

label/tmp/file_1.txt

@@ -0,0 +1,7 @@
+자산번호 : 210312
+자산명   : 가을-PC(i5-12400F)
+공급사   : (주)가을디에스
+자산위치 : 지반부
+관리부서 : 전산
+사용자   : 박노석
+취득일자 : 2024-08-05

map_config.json

@@ -112,7 +112,7 @@
       "y": "32.01",
       "w": "40.87",
       "h": "6.24",
-      "asset_id": null
+      "asset_id": "9pvkqyi"
     }
   ],
   "img/location_photo/IDC/서관203.png": [
@@ -722,5 +722,21 @@
       "h": "6.75",
       "asset_id": "server_1779761946023_64"
     }
+  ],
+  "img/location_photo/TDD_TEST_MAP.png": [
+    {
+      "x": "30.50",
+      "y": "40.25",
+      "w": "10.00",
+      "h": "12.00",
+      "asset_id": null
+    },
+    {
+      "x": "50.00",
+      "y": "60.00",
+      "w": "5.00",
+      "h": "5.00",
+      "asset_id": null
+    }
   ]
 }

map_editor.html

@@ -5,6 +5,7 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>ITAM Map Coordinate Editor v3.0</title>
   <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/dist/web/variable/pretendardvariable.min.css" />
+  <script src="/qrcode.min.js"></script>
 </head>
 <body class="editor-body">
 
@@ -30,8 +31,9 @@
 
     <div class="box-list" id="box-list"></div>
 
-    <div class="actions">
+    <div class="actions" style="display: flex; flex-direction: column; gap: 0.5rem;">
       <button id="btn-clear-all" class="btn btn-outline">전체 삭제</button>
+      <button id="btn-print-map-qrs" class="btn btn-outline btn-primary">이 도면 QR 일괄인쇄</button>
       <button id="btn-save-server" class="btn btn-primary">서버에 즉시 저장</button>
       <div id="save-status"></div>
     </div>

mobile.html

@@ -0,0 +1,299 @@
+<!DOCTYPE html>
+<html lang="ko">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
+  <title>ITAM 모바일 실사 점검</title>
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/dist/web/variable/pretendardvariable.min.css" />
+  <script src="https://unpkg.com/html5-qrcode@2.3.8/html5-qrcode.min.js"></script>
+  <style>
+    :root {
+      --bg: #09090b;
+      --card: #18181b;
+      --card-border: #27272a;
+      --primary: #3b82f6;
+      --primary-hover: #2563eb;
+      --success: #10b981;
+      --danger: #ef4444;
+      --text: #f4f4f5;
+      --text-muted: #a1a1aa;
+      --font-family: 'Pretendard Variable', -apple-system, BlinkMacSystemFont, system-ui, sans-serif;
+    }
+
+    * {
+      box-sizing: border-box;
+      margin: 0;
+      padding: 0;
+      font-family: var(--font-family);
+    }
+
+    body {
+      background-color: var(--bg);
+      color: var(--text);
+      display: flex;
+      flex-direction: column;
+      height: 100vh;
+      overflow: hidden;
+    }
+
+    header {
+      background-color: var(--card);
+      border-bottom: 1px solid var(--card-border);
+      padding: 1rem;
+      text-align: center;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      flex-shrink: 0;
+    }
+
+    header h1 {
+      font-size: 1.1rem;
+      font-weight: 700;
+      background: linear-gradient(135deg, #60a5fa, #3b82f6);
+      -webkit-background-clip: text;
+      -webkit-text-fill-color: transparent;
+    }
+
+    .status-dot {
+      width: 8px;
+      height: 8px;
+      border-radius: 50%;
+      background-color: var(--success);
+      box-shadow: 0 0 8px var(--success);
+    }
+
+    main {
+      flex: 1;
+      display: flex;
+      flex-direction: column;
+      padding: 1rem;
+      gap: 1rem;
+      overflow-y: auto;
+      align-items: center;
+      justify-content: center;
+    }
+
+    /* Scanner Viewport */
+    .scanner-container {
+      width: 100%;
+      max-width: 400px;
+      aspect-ratio: 1;
+      border-radius: 16px;
+      overflow: hidden;
+      border: 2px dashed var(--card-border);
+      position: relative;
+      background-color: #000;
+    }
+
+    #reader {
+      width: 100% !important;
+      height: 100% !important;
+      border: none !important;
+    }
+
+    #reader video {
+      object-fit: cover !important;
+      width: 100% !important;
+      height: 100% !important;
+    }
+
+    /* Scan Laser Line Animation */
+    .scan-laser {
+      position: absolute;
+      top: 0;
+      left: 0;
+      width: 100%;
+      height: 2px;
+      background: linear-gradient(to right, transparent, var(--primary), transparent);
+      animation: scan 2s linear infinite;
+      z-index: 10;
+      pointer-events: none;
+    }
+
+    @keyframes scan {
+      0% { top: 0%; }
+      50% { top: 100%; }
+      100% { top: 0%; }
+    }
+
+    /* Bottom Info Card */
+    .info-panel {
+      width: 100%;
+      max-width: 400px;
+      background-color: var(--card);
+      border: 1px solid var(--card-border);
+      border-radius: 16px;
+      padding: 1rem;
+      display: flex;
+      flex-direction: column;
+      gap: 0.75rem;
+      flex-shrink: 0;
+    }
+
+    .info-section {
+      display: flex;
+      flex-direction: column;
+      gap: 0.25rem;
+    }
+
+    .info-label {
+      font-size: 0.75rem;
+      font-weight: 600;
+      color: var(--text-muted);
+      text-transform: uppercase;
+      letter-spacing: 0.05em;
+    }
+
+    .info-value {
+      font-size: 0.95rem;
+      font-weight: 700;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 0.5rem;
+      min-height: 24px;
+    }
+
+    .badge-lock {
+      background-color: rgba(59, 130, 246, 0.15);
+      color: var(--primary);
+      padding: 0.25rem 0.5rem;
+      border-radius: 6px;
+      font-size: 0.8rem;
+      border: 1px solid rgba(59, 130, 246, 0.3);
+      font-weight: 700;
+    }
+
+    .badge-empty {
+      color: var(--text-muted);
+      font-weight: 400;
+      font-style: italic;
+    }
+
+    .btn-action {
+      background-color: var(--primary);
+      color: var(--text);
+      border: none;
+      padding: 0.5rem 1rem;
+      border-radius: 8px;
+      font-size: 0.85rem;
+      font-weight: 600;
+      cursor: pointer;
+      transition: background-color 0.2s;
+    }
+
+    .btn-action:hover {
+      background-color: var(--primary-hover);
+    }
+
+    .btn-action.btn-danger {
+      background-color: rgba(239, 68, 68, 0.15);
+      color: var(--danger);
+      border: 1px solid rgba(239, 68, 68, 0.3);
+    }
+
+    .btn-action.btn-danger:hover {
+      background-color: rgba(239, 68, 68, 0.25);
+    }
+
+    /* Manual Input Section */
+    .manual-toggle {
+      text-align: center;
+      font-size: 0.8rem;
+      color: var(--primary);
+      cursor: pointer;
+      text-decoration: underline;
+    }
+
+    .manual-form {
+      display: none;
+      flex-direction: column;
+      gap: 0.5rem;
+      width: 100%;
+    }
+
+    .input-field {
+      width: 100%;
+      background-color: var(--bg);
+      border: 1px solid var(--card-border);
+      border-radius: 8px;
+      color: var(--text);
+      padding: 0.5rem;
+      font-size: 0.9rem;
+    }
+
+    .input-field:focus {
+      outline: 1px solid var(--primary);
+    }
+
+    /* Feedbacks Overlay */
+    .feedback-message {
+      text-align: center;
+      padding: 0.5rem;
+      border-radius: 8px;
+      font-size: 0.85rem;
+      display: none;
+      animation: fadeIn 0.3s;
+    }
+
+    @keyframes fadeIn {
+      from { opacity: 0; transform: translateY(5px); }
+      to { opacity: 1; transform: translateY(0); }
+    }
+
+    .feedback-success {
+      background-color: rgba(16, 185, 129, 0.15);
+      color: var(--success);
+      border: 1px solid rgba(16, 185, 129, 0.3);
+    }
+
+    .feedback-error {
+      background-color: rgba(239, 68, 68, 0.15);
+      color: var(--danger);
+      border: 1px solid rgba(239, 68, 68, 0.3);
+    }
+  </style>
+</head>
+<body>
+
+  <header>
+    <h1>ITAM 모바일 실사</h1>
+    <div class="status-dot"></div>
+  </header>
+
+  <main>
+    <div class="scanner-container">
+      <div id="reader"></div>
+      <div class="scan-laser"></div>
+    </div>
+
+    <div class="info-panel">
+      <!-- 1. 위치 락 정보 -->
+      <div class="info-section">
+        <span class="info-label">현재 점검 위치 (Location)</span>
+        <div class="info-value">
+          <span id="loc-display" class="badge-empty">위치 QR 코드를 먼저 스캔하세요.</span>
+          <button id="btn-unlock-loc" class="btn-action btn-danger" style="display: none;">해제</button>
+        </div>
+      </div>
+
+      <hr style="border: 0; border-top: 1px solid var(--card-border); margin: 0.25rem 0;" />
+
+      <!-- 2. 자산 스캔 결과 및 피드백 -->
+      <div id="scan-feedback" class="feedback-message"></div>
+
+      <!-- 3. 수동 입력 토글 및 양식 -->
+      <div class="info-section">
+        <span id="btn-toggle-manual" class="manual-toggle">카메라가 안 되나요? 수동 코드로 입력</span>
+        <div id="manual-form" class="manual-form">
+          <input type="text" id="manual-code-input" class="input-field" placeholder="위치 또는 자산 코드 입력" />
+          <button id="btn-submit-manual" class="btn-action w-full">입력 확인</button>
+        </div>
+      </div>
+    </div>
+  </main>
+
+  <script type="module" src="/src/mobile-main.ts"></script>
+</body>
+</html>

package-lock.json

@@ -14,9 +14,11 @@
         "iconv-lite": "^0.7.2",
         "lucide": "^0.364.0",
         "mysql2": "^3.22.1",
+        "qrcode": "^1.5.4",
         "xlsx": "^0.18.5"
       },
       "devDependencies": {
+        "@types/qrcode": "^1.5.6",
         "typescript": "^5.2.2",
         "vite": "^5.2.0"
       }
@@ -774,11 +776,19 @@
       "resolved": "https://registry.npmjs.org/@types/node/-/node-25.6.0.tgz",
       "integrity": "sha512-+qIYRKdNYJwY3vRCZMdJbPLJAtGjQBudzZzdzwQYkEPQd+PJGixUL5QfvCLDaULoLv+RhT3LDkwEfKaAkgSmNQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "undici-types": "~7.19.0"
       }
     },
+    "node_modules/@types/qrcode": {
+      "version": "1.5.6",
+      "resolved": "https://registry.npmjs.org/@types/qrcode/-/qrcode-1.5.6.tgz",
+      "integrity": "sha512-te7NQcV2BOvdj2b1hCAHzAoMNuj65kNBMz0KBaxM6c3VGBOhU0dURQKOtH8CFNI/dsKkwlv32p26qYQTWoB5bw==",
+      "dev": true,
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
     "node_modules/accepts": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
@@ -801,6 +811,28 @@
         "node": ">=0.8"
       }
     },
+    "node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
     "node_modules/aws-ssl-profiles": {
       "version": "1.1.2",
       "resolved": "https://registry.npmjs.org/aws-ssl-profiles/-/aws-ssl-profiles-1.1.2.tgz",
@@ -872,6 +904,14 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/camelcase": {
+      "version": "5.3.1",
+      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz",
+      "integrity": "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/cfb": {
       "version": "1.2.2",
       "resolved": "https://registry.npmjs.org/cfb/-/cfb-1.2.2.tgz",
@@ -885,6 +925,16 @@
         "node": ">=0.8"
       }
     },
+    "node_modules/cliui": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-6.0.0.tgz",
+      "integrity": "sha512-t6wbgtoCXvAzst7QgXxJYqPt0usEfbgQdftEPbLL/cvv6HPE5VgvqCuAIDR0NgU52ds6rFwqrgakNLrHEjCbrQ==",
+      "dependencies": {
+        "string-width": "^4.2.0",
+        "strip-ansi": "^6.0.0",
+        "wrap-ansi": "^6.2.0"
+      }
+    },
     "node_modules/codepage": {
       "version": "1.15.0",
       "resolved": "https://registry.npmjs.org/codepage/-/codepage-1.15.0.tgz",
@@ -894,6 +944,22 @@
         "node": ">=0.8"
       }
     },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="
+    },
     "node_modules/content-disposition": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.1.0.tgz",
@@ -980,6 +1046,14 @@
         }
       }
     },
+    "node_modules/decamelize": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz",
+      "integrity": "sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA==",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/denque": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/denque/-/denque-2.1.0.tgz",
@@ -998,6 +1072,11 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/dijkstrajs": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/dijkstrajs/-/dijkstrajs-1.0.3.tgz",
+      "integrity": "sha512-qiSlmBq9+BCdCA/L46dw8Uy93mloxsPSbwnm5yrKn2vMPiy8KyAskTF6zuV/j5BMsmOGZDPs7KjU+mjb670kfA=="
+    },
     "node_modules/dotenv": {
       "version": "17.4.2",
       "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.4.2.tgz",
@@ -1030,6 +1109,11 @@
       "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
       "license": "MIT"
     },
+    "node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="
+    },
     "node_modules/encodeurl": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
@@ -1187,6 +1271,18 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/find-up": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz",
+      "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==",
+      "dependencies": {
+        "locate-path": "^5.0.0",
+        "path-exists": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/forwarded": {
       "version": "0.2.0",
       "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
@@ -1247,6 +1343,14 @@
         "is-property": "^1.0.2"
       }
     },
+    "node_modules/get-caller-file": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+      "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+      "engines": {
+        "node": "6.* || 8.* || >= 10.*"
+      }
+    },
     "node_modules/get-intrinsic": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
@@ -1371,6 +1475,14 @@
         "node": ">= 0.10"
       }
     },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/is-promise": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz",
@@ -1383,6 +1495,17 @@
       "integrity": "sha512-Ks/IoX00TtClbGQr4TWXemAnktAQvYB7HzcCxDGqEZU6oCmb2INHuOoKxbtR+HFkmYWBKv/dOZtGRiAjDhj92g==",
       "license": "MIT"
     },
+    "node_modules/locate-path": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
+      "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==",
+      "dependencies": {
+        "p-locate": "^4.1.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/long": {
       "version": "5.3.2",
       "resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz",
@@ -1575,6 +1698,39 @@
         "wrappy": "1"
       }
     },
+    "node_modules/p-limit": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz",
+      "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==",
+      "dependencies": {
+        "p-try": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-locate": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz",
+      "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==",
+      "dependencies": {
+        "p-limit": "^2.2.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/p-try": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz",
+      "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==",
+      "engines": {
+        "node": ">=6"
+      }
+    },
     "node_modules/parseurl": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
@@ -1584,6 +1740,14 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/path-exists": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
+      "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/path-to-regexp": {
       "version": "8.4.2",
       "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.2.tgz",
@@ -1601,6 +1765,14 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/pngjs": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/pngjs/-/pngjs-5.0.0.tgz",
+      "integrity": "sha512-40QW5YalBNfQo5yRYmiw7Yz6TKKVr3h6970B2YE+3fQpsWcrbj1PzJgxeJ19DRQjhMbKPIuMY8rFaXc8moolVw==",
+      "engines": {
+        "node": ">=10.13.0"
+      }
+    },
     "node_modules/postcss": {
       "version": "8.5.9",
       "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.9.tgz",
@@ -1643,6 +1815,22 @@
         "node": ">= 0.10"
       }
     },
+    "node_modules/qrcode": {
+      "version": "1.5.4",
+      "resolved": "https://registry.npmjs.org/qrcode/-/qrcode-1.5.4.tgz",
+      "integrity": "sha512-1ca71Zgiu6ORjHqFBDpnSMTR2ReToX4l1Au1VFLyVeBTFavzQnv5JxMFr3ukHVKpSrSA2MCk0lNJSykjUfz7Zg==",
+      "dependencies": {
+        "dijkstrajs": "^1.0.1",
+        "pngjs": "^5.0.0",
+        "yargs": "^15.3.1"
+      },
+      "bin": {
+        "qrcode": "bin/qrcode"
+      },
+      "engines": {
+        "node": ">=10.13.0"
+      }
+    },
     "node_modules/qs": {
       "version": "6.15.1",
       "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.1.tgz",
@@ -1682,6 +1870,19 @@
         "node": ">= 0.10"
       }
     },
+    "node_modules/require-directory": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
+      "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/require-main-filename": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/require-main-filename/-/require-main-filename-2.0.0.tgz",
+      "integrity": "sha512-NKN5kMDylKuldxYLSUfrbo5Tuzh4hd+2E8NPPX02mZtn1VuREQToYe/ZdlJy+J3uCpfaiGF05e7B8W0iXbQHmg=="
+    },
     "node_modules/rollup": {
       "version": "4.60.1",
       "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.60.1.tgz",
@@ -1794,6 +1995,11 @@
         "url": "https://opencollective.com/express"
       }
     },
+    "node_modules/set-blocking": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/set-blocking/-/set-blocking-2.0.0.tgz",
+      "integrity": "sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw=="
+    },
     "node_modules/setprototypeof": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
@@ -1918,6 +2124,30 @@
         "node": ">= 0.8"
       }
     },
+    "node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/toidentifier": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
@@ -1959,8 +2189,7 @@
       "version": "7.19.2",
       "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.19.2.tgz",
       "integrity": "sha512-qYVnV5OEm2AW8cJMCpdV20CDyaN3g0AjDlOGf1OW4iaDEx8MwdtChUp4zu4H0VP3nDRF/8RKWH+IPp9uW0YGZg==",
-      "license": "MIT",
-      "peer": true
+      "license": "MIT"
     },
     "node_modules/unpipe": {
       "version": "1.0.0",
@@ -2040,6 +2269,11 @@
         }
       }
     },
+    "node_modules/which-module": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/which-module/-/which-module-2.0.1.tgz",
+      "integrity": "sha512-iBdZ57RDvnOR9AGBhML2vFZf7h8vmBjhoaZqODJBFWHVtKkDmKuHai3cx5PgVMrX5YDNp27AofYbAwctSS+vhQ=="
+    },
     "node_modules/wmf": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/wmf/-/wmf-1.0.2.tgz",
@@ -2058,6 +2292,19 @@
         "node": ">=0.8"
       }
     },
+    "node_modules/wrap-ansi": {
+      "version": "6.2.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-6.2.0.tgz",
+      "integrity": "sha512-r6lPcBGxZXlIcymEu7InxDMhdW0KDxpLgoFLcguasxCaJ/SOIZwINatK9KY/tf+ZrlywOKU0UDj3ATXUBfxJXA==",
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
     "node_modules/wrappy": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
@@ -2084,6 +2331,44 @@
       "engines": {
         "node": ">=0.8"
       }
+    },
+    "node_modules/y18n": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/y18n/-/y18n-4.0.3.tgz",
+      "integrity": "sha512-JKhqTOwSrqNA1NY5lSztJ1GrBiUodLMmIZuLiDaMRJ+itFd+ABVE8XBjOvIWL+rSqNDC74LCSFmlb/U4UZ4hJQ=="
+    },
+    "node_modules/yargs": {
+      "version": "15.4.1",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-15.4.1.tgz",
+      "integrity": "sha512-aePbxDmcYW++PaqBsJ+HYUFwCdv4LVvdnhBy78E57PIor8/OVvhMrADFFEDh8DHDFRv/O9i3lPhsENjO7QX0+A==",
+      "dependencies": {
+        "cliui": "^6.0.0",
+        "decamelize": "^1.2.0",
+        "find-up": "^4.1.0",
+        "get-caller-file": "^2.0.1",
+        "require-directory": "^2.1.1",
+        "require-main-filename": "^2.0.0",
+        "set-blocking": "^2.0.0",
+        "string-width": "^4.2.0",
+        "which-module": "^2.0.0",
+        "y18n": "^4.0.0",
+        "yargs-parser": "^18.1.2"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/yargs-parser": {
+      "version": "18.1.3",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-18.1.3.tgz",
+      "integrity": "sha512-o50j0JeToy/4K6OZcaQmW6lyXXKhq7csREXcDwk2omFPJEwUNOVtJKvmDr9EI1fAJZUyZcRF7kxGBWmRXudrCQ==",
+      "dependencies": {
+        "camelcase": "^5.0.0",
+        "decamelize": "^1.2.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
     }
   }
 }

package.json

@@ -11,6 +11,7 @@
     "db-init": "node db_init.js"
   },
   "devDependencies": {
+    "@types/qrcode": "^1.5.6",
     "typescript": "^5.2.2",
     "vite": "^5.2.0"
   },
@@ -21,6 +22,7 @@
     "iconv-lite": "^0.7.2",
     "lucide": "^0.364.0",
     "mysql2": "^3.22.1",
+    "qrcode": "^1.5.4",
     "xlsx": "^0.18.5"
   }
 }

scratch/fix_dates_by_spec.js

@@ -1,118 +0,0 @@
-import mysql from 'mysql2/promise';
-import dotenv from 'dotenv';
-
-dotenv.config();
-
-const pool = mysql.createPool({
-  host: process.env.DB_HOST,
-  user: process.env.DB_USER,
-  password: process.env.DB_PASS,
-  database: process.env.DB_NAME,
-  port: parseInt(process.env.DB_PORT || '3306'),
-});
-
-// 하드웨어 출시 연도 데이터베이스 (CPU/GPU)
-const RELEASE_DATES = {
-  // Intel CPU Generations (Mainstream desktop release month/year)
-  'i9-14': '2023-10', 'i7-14': '2023-10', 'i5-14': '2023-10',
-  'i9-13': '2022-10', 'i7-13': '2022-10', 'i5-13': '2022-10',
-  'i9-12': '2021-11', 'i7-12': '2021-11', 'i5-12': '2021-11',
-  'i9-11': '2021-03', 'i7-11': '2021-03', 'i5-11': '2021-03',
-  'i9-10': '2020-05', 'i7-10': '2020-05', 'i5-10': '2020-05',
-  'i9-9': '2018-10',  'i7-9': '2018-10',  'i5-9': '2018-10',
-  'i7-8': '2017-10',  'i5-8': '2017-10',
-  'i7-7': '2017-01',  'i5-7': '2017-01',
-  'i7-6': '2015-08',  'i5-6': '2015-08',
-  'i7-4': '2013-06',  'i5-4': '2013-06',
-  'i7-3': '2012-04',  'i5-3': '2012-04',
-  'i7-2': '2011-01',  'i5-2': '2011-01',
-
-  // NVIDIA GPU Series
-  'RTX 4090': '2022-10', 'RTX 4080': '2022-11', 'RTX 4070': '2023-04', 'RTX 4060': '2023-06',
-  'RTX 3090': '2020-09', 'RTX 3080': '2020-09', 'RTX 3070': '2020-10', 'RTX 3060': '2021-02',
-  'RTX 2080': '2018-09', 'RTX 2070': '2018-10', 'RTX 2060': '2019-01',
-  'GTX 1660': '2019-03', 'GTX 1650': '2019-04',
-  'GTX 1080': '2016-05', 'GTX 1070': '2016-06', 'GTX 1060': '2016-07', 'GTX 1050': '2016-10',
-  'GTX 980': '2014-09',  'GTX 970': '2014-09',  'GTX 960': '2015-01'
-};
-
-function inferDateFromSpecs(cpu, gpu) {
-  const cpuStr = (cpu || '').toUpperCase();
-  const gpuStr = (gpu || '').toUpperCase();
-
-  let inferred = null;
-
-  // 1. GPU 기준 (최신 그래픽카드가 꽂혀있으면 그 시기 이후 구매일 확률이 높음)
-  for (const [key, date] of Object.entries(RELEASE_DATES)) {
-    if (gpuStr.includes(key)) {
-      inferred = date;
-      break; 
-    }
-  }
-
-  // 2. CPU 기준 (GPU에서 못 찾았거나, CPU가 더 최신일 경우)
-  if (!inferred) {
-    for (const [key, date] of Object.entries(RELEASE_DATES)) {
-      // i7-13700 등을 찾기 위해 정규식 또는 포함 여부 확인
-      if (cpuStr.includes(key)) {
-        inferred = date;
-        break;
-      }
-    }
-  }
-
-  return inferred ? `${inferred}-01` : null;
-}
-
-async function run() {
-  const connection = await pool.getConnection();
-  try {
-    const [rows] = await connection.query(`
-      SELECT c.id, c.asset_code, c.purchase_date, s.cpu, s.gpu 
-      FROM asset_core c
-      LEFT JOIN asset_spec s ON c.id = s.asset_id
-    `);
-    
-    const updates = [];
-    const unchanged = [];
-
-    for (const row of rows) {
-      const currentVal = (row.purchase_date || '').trim();
-      
-      // 구매일자가 없거나 부정확한 경우만 처리
-      if (!currentVal || currentVal === '-' || currentVal === 'undefined' || currentVal.startsWith('2024-01-01')) {
-        const specDate = inferDateFromSpecs(row.cpu, row.gpu);
-        
-        if (specDate) {
-          updates.push({ id: row.id, date: specDate, code: row.asset_code, cpu: row.cpu, gpu: row.gpu });
-        } else {
-          unchanged.push({ code: row.asset_code, cpu: row.cpu, gpu: row.gpu });
-        }
-      }
-    }
-
-    console.log(`🚀 스펙 분석 결과: ${updates.length}건의 자산 구매일자를 보정합니다.`);
-    
-    for (const item of updates) {
-      await connection.query('UPDATE asset_core SET purchase_date = ? WHERE id = ?', [item.date, item.id]);
-      console.log(`[Update] ${item.code.padEnd(15)} | CPU: ${String(item.cpu).padEnd(20)} | GPU: ${String(item.gpu).padEnd(15)} -> ${item.date}`);
-    }
-
-    if (unchanged.length > 0) {
-      console.log('\n⚠️ 스펙 정보를 찾을 수 없어 보정하지 못한 자산:');
-      unchanged.forEach(u => {
-        if (u.code) console.log(`[Skip] ${u.code.padEnd(15)} | CPU: ${u.cpu || '-'} | GPU: ${u.gpu || '-'}`);
-      });
-    }
-
-    console.log(`\n✅ 완료: ${updates.length}건 보정됨.`);
-
-  } catch (err) {
-    console.error('Error:', err);
-  } finally {
-    connection.release();
-    pool.end();
-  }
-}
-
-run();

scratch/fix_dates_strict.js

@@ -1,128 +0,0 @@
-import mysql from 'mysql2/promise';
-import dotenv from 'dotenv';
-
-dotenv.config();
-
-const pool = mysql.createPool({
-  host: process.env.DB_HOST,
-  user: process.env.DB_USER,
-  password: process.env.DB_PASS,
-  database: process.env.DB_NAME,
-  port: parseInt(process.env.DB_PORT || '3306'),
-});
-
-// 하드웨어 출시 연도/월 데이터베이스
-const RELEASE_DATES = {
-  // Intel CPU
-  'i9-14': '2023-10', 'i7-14': '2023-10', 'i5-14': '2023-10',
-  'i9-13': '2022-10', 'i7-13': '2022-10', 'i5-13': '2022-10',
-  'i9-12': '2021-11', 'i7-12': '2021-11', 'i5-12': '2021-11',
-  'i9-11': '2021-03', 'i7-11': '2021-03', 'i5-11': '2021-03',
-  'i9-10': '2020-05', 'i7-10': '2020-05', 'i5-10': '2020-05',
-  'i9-9': '2018-10',  'i7-9': '2018-10',  'i5-9': '2018-10',
-  'i7-8': '2017-10',  'i5-8': '2017-10',
-  'i7-7': '2017-01',  'i5-7': '2017-01',
-  'i7-6': '2015-08',  'i5-6': '2015-08',
-  'i7-5': '2014-06',  'i5-5': '2015-06', // Broadwell
-  'i7-4': '2013-06',  'i5-4': '2013-06',
-  'i7-3': '2012-04',  'i5-3': '2012-04',
-  'i7-2': '2011-01',  'i5-2': '2011-01',
-
-  // NVIDIA GPU
-  'RTX 40': '2022-10',
-  'RTX 30': '2020-09',
-  'RTX 20': '2018-09',
-  'GTX 16': '2019-02',
-  'GTX 10': '2016-05',
-  'GTX 9': '2014-09',
-  'GTX 750': '2014-02',
-  'GTX 7': '2013-05',
-  'GTX 6': '2012-03'
-};
-
-// 출시 연도만 있는 경우 (지시에 따라 후속년도 12월 적용을 위함)
-const YEAR_ONLY = {
-  'I5-4': 2013,
-  'I5-6': 2015,
-  'I7-7': 2017,
-  'GTX 750': 2014
-};
-
-function inferDateFromSpecs(cpu, gpu) {
-  const cpuStr = (cpu || '').toUpperCase();
-  const gpuStr = (gpu || '').toUpperCase();
-
-  let latestYear = 0;
-  let latestMonth = 0;
-
-  // 모든 매핑 데이터를 순회하며 가장 최신 날짜를 찾음
-  for (const [key, dateStr] of Object.entries(RELEASE_DATES)) {
-    if (cpuStr.includes(key) || gpuStr.includes(key)) {
-      const [y, m] = dateStr.split('-').map(Number);
-      if (y > latestYear || (y === latestYear && m > latestMonth)) {
-        latestYear = y;
-        latestMonth = m;
-      }
-    }
-  }
-
-  // 매칭된 정보가 있는 경우
-  if (latestYear > 0) {
-    // 월 정보가 명확히 매핑된 경우 (RELEASE_DATES 사용)
-    // 하지만 지시사항에 따라 "월을 못찾으면 12월" & "후속년도" 규칙 적용 여부 판단
-    // RELEASE_DATES는 월이 이미 있으므로 그대로 사용하되, 
-    // 만약 YEAR_ONLY에만 걸리는 경우를 위해 로직 보강
-    return `${latestYear}-${String(latestMonth).padStart(2, '0')}-01`;
-  }
-
-  // 연도만 매칭되는 경우 (지시사항: 후속년도 12월)
-  for (const [key, year] of Object.entries(YEAR_ONLY)) {
-    if (cpuStr.includes(key) || gpuStr.includes(key)) {
-      return `${year + 1}-12-01`;
-    }
-  }
-
-  return null;
-}
-
-async function run() {
-  const connection = await pool.getConnection();
-  try {
-    const [rows] = await connection.query(`
-      SELECT c.id, c.asset_code, c.purchase_date, s.cpu, s.gpu 
-      FROM asset_core c
-      LEFT JOIN asset_spec s ON c.id = s.asset_id
-    `);
-    
-    const updates = [];
-
-    for (const row of rows) {
-      const currentVal = (row.purchase_date || '').trim();
-      
-      // 구매일자가 없거나 '-', 'undefined'인 경우 + 혹은 아직 보정이 필요한 자산
-      if (!currentVal || currentVal === '-' || currentVal === 'undefined' || currentVal.startsWith('0000') || currentVal === '2024-01-01') {
-        const specDate = inferDateFromSpecs(row.cpu, row.gpu);
-        if (specDate) {
-          updates.push({ id: row.id, date: specDate, code: row.asset_code, cpu: row.cpu, gpu: row.gpu });
-        }
-      }
-    }
-
-    console.log(`🚀 지시사항 반영: ${updates.length}건의 자산을 보정합니다. (후속년도/12월 규칙 적용)`);
-    
-    for (const item of updates) {
-      await connection.query('UPDATE asset_core SET purchase_date = ? WHERE id = ?', [item.date, item.id]);
-      console.log(`[Update] ${item.code.padEnd(15)} | CPU: ${String(item.cpu).padEnd(20)} | GPU: ${String(item.gpu).padEnd(15)} -> ${item.date}`);
-    }
-
-    console.log(`\n✅ 완료: ${updates.length}건 보정됨.`);
-
-  } catch (err) {
-    console.error('Error:', err);
-  } finally {
-    connection.release();
-    pool.end();
-  }
-}
-
-run();

scratch/fix_purchase_dates.js

@@ -1,88 +0,0 @@
-import mysql from 'mysql2/promise';
-import dotenv from 'dotenv';
-
-dotenv.config();
-
-const pool = mysql.createPool({
-  host: process.env.DB_HOST,
-  user: process.env.DB_USER,
-  password: process.env.DB_PASS,
-  database: process.env.DB_NAME,
-  port: parseInt(process.env.DB_PORT || '3306'),
-});
-
-async function run() {
-  const connection = await pool.getConnection();
-  try {
-    // 먼저 잘못 들어간 0000-00-01 등 복구
-    console.log('잘못된 형식(0000-00-01 등)을 초기화합니다...');
-    await connection.query("UPDATE asset_core SET purchase_date = '-' WHERE purchase_date LIKE '0000%' OR purchase_date = '2020-01-01'");
-
-    const [rows] = await connection.query('SELECT id, asset_code, purchase_date, category FROM asset_core');
-    
-    const updates = [];
-    const missing = [];
-
-    for (const row of rows) {
-      const code = (row.asset_code || '').trim();
-      const currentVal = (row.purchase_date || '').trim();
-
-      // 구매일자가 없거나 '-', 'undefined' 인 경우 대상
-      if (!currentVal || currentVal === '-' || currentVal === 'undefined') {
-        let inferredDate = null;
-
-        // 1. PREFIX-YYYYMM-NNNN 형식 (예: PC-202406-0001)
-        const match6 = code.match(/[A-Z]+-(\d{4})(0[1-9]|1[0-2])-\d+/);
-        if (match6) {
-          inferredDate = `${match6[1]}-${match6[2]}-01`;
-        } else {
-          // 2. PREFIX-YYYYNN 형식 (예: PC-202423) -> 연도만 있고 뒤에 순번 2자리
-          const matchYearSeq = code.match(/[A-Z]+-(20\d{2})(\d{2})$/);
-          if (matchYearSeq) {
-             inferredDate = `${matchYearSeq[1]}-01-01`; // 월을 모르므로 1월로 통일
-          } else {
-            // 3. PREFIX-YYNNN 형식 (예: PC-24001)
-            const matchShort = code.match(/[A-Z]+-(1\d|2\d)(\d{3})/);
-            if (matchShort) {
-              inferredDate = `20${matchShort[1]}-01-01`;
-            }
-          }
-        }
-
-        // 0000 등의 잘못된 매칭 방지
-        if (inferredDate && !inferredDate.startsWith('0000')) {
-          updates.push({ id: row.id, date: inferredDate, code: code });
-        } else {
-          missing.push({ id: row.id, code: code, category: row.category });
-        }
-      }
-    }
-
-    console.log(`총 ${updates.length}건의 자산을 업데이트합니다.`);
-    for (const item of updates) {
-      await connection.query('UPDATE asset_core SET purchase_date = ? WHERE id = ?', [item.date, item.id]);
-      console.log(`[Update] ${item.code} -> ${item.date}`);
-    }
-
-    console.log('\n--- 구매일자를 추정할 수 없는 자산 목록 ---');
-    if (missing.length === 0) {
-      console.log('없음');
-    } else {
-      // 중복 제거 및 정렬하여 보고
-      const uniqueMissing = missing.filter(m => m.code !== '');
-      uniqueMissing.forEach(m => {
-        console.log(`[Missing] 코드: ${m.code.padEnd(20)} | 카테고리: ${m.category}`);
-      });
-    }
-
-    console.log(`\n완료: ${updates.length}건 업데이트됨, ${missing.length}건 미결정.`);
-
-  } catch (err) {
-    console.error('Error:', err);
-  } finally {
-    connection.release();
-    pool.end();
-  }
-}
-
-run();

scripts/backup.sh

@@ -0,0 +1,125 @@
+#!/usr/bin/env sh
+
+set -eu
+
+COMMAND="${1:-help}"
+ENV_FILE="${ENV_FILE:-.env}"
+BACKUP_ROOT="${BACKUP_ROOT:-backups}"
+RETENTION_DAYS="${RETENTION_DAYS:-14}"
+TIMESTAMP="${BACKUP_TIMESTAMP:-$(date +%Y%m%d_%H%M%S)}"
+
+log() {
+  printf '[backup] %s\n' "$*"
+}
+
+fail() {
+  printf '[backup] %s\n' "$*" >&2
+  exit 1
+}
+
+require_command() {
+  command -v "$1" >/dev/null 2>&1 || fail "Required command not found: $1"
+}
+
+has_command() {
+  command -v "$1" >/dev/null 2>&1
+}
+
+load_env() {
+  [ -f "$ENV_FILE" ] || fail "Env file not found: $ENV_FILE"
+
+  case "$ENV_FILE" in
+    */*) env_path="$ENV_FILE" ;;
+    *) env_path="./$ENV_FILE" ;;
+  esac
+
+  set -a
+  # shellcheck disable=SC1090
+  . "$env_path"
+  set +a
+
+  : "${DB_HOST:?DB_HOST is required in $ENV_FILE}"
+  : "${DB_PORT:=3306}"
+  : "${DB_USER:?DB_USER is required in $ENV_FILE}"
+  : "${DB_PASS:?DB_PASS is required in $ENV_FILE}"
+  : "${DB_NAME:?DB_NAME is required in $ENV_FILE}"
+}
+
+db_dump() {
+  require_command gzip
+  load_env
+
+  mkdir -p "$BACKUP_ROOT/db"
+  output_path="$BACKUP_ROOT/db/${DB_NAME}_${TIMESTAMP}.sql.gz"
+
+  log "Creating DB dump: $output_path"
+
+  if has_command mysqldump; then
+    MYSQL_PWD="$DB_PASS" mysqldump \
+      --host="$DB_HOST" \
+      --port="$DB_PORT" \
+      --user="$DB_USER" \
+      --single-transaction \
+      --quick \
+      --routines \
+      --triggers \
+      "$DB_NAME" | gzip > "$output_path"
+  elif has_command docker; then
+    docker exec itam-backend sh -lc "MYSQL_PWD=\"$DB_PASS\" exec mysqldump --host=\"$DB_HOST\" --port=\"$DB_PORT\" --user=\"$DB_USER\" --single-transaction --quick --routines --triggers \"$DB_NAME\"" | gzip > "$output_path"
+  else
+    fail "Required command not found: mysqldump (and docker fallback unavailable)"
+  fi
+
+  log "DB dump completed: $output_path"
+}
+
+files_backup() {
+  require_command tar
+  mkdir -p "$BACKUP_ROOT/files"
+
+  archive_path="$BACKUP_ROOT/files/runtime_${TIMESTAMP}.tar.gz"
+  set --
+
+  [ -f "$ENV_FILE" ] && set -- "$@" "$ENV_FILE"
+  [ -d "uploads" ] && set -- "$@" "uploads"
+  [ -f "map_config.json" ] && set -- "$@" "map_config.json"
+
+  [ "$#" -gt 0 ] || fail "No runtime files found to archive"
+
+  log "Creating runtime archive: $archive_path"
+  tar -czf "$archive_path" "$@"
+  log "Runtime archive completed: $archive_path"
+}
+
+cleanup_backups() {
+  require_command find
+  [ -d "$BACKUP_ROOT" ] || {
+    log "Backup root does not exist, skipping cleanup: $BACKUP_ROOT"
+    return 0
+  }
+
+  log "Deleting backup files older than ${RETENTION_DAYS} days from $BACKUP_ROOT"
+  find "$BACKUP_ROOT" -type f -mtime "+$RETENTION_DAYS" -print -delete
+}
+
+case "$COMMAND" in
+  db)
+    db_dump
+    ;;
+  files)
+    files_backup
+    ;;
+  full)
+    db_dump
+    files_backup
+    ;;
+  cleanup)
+    cleanup_backups
+    ;;
+  help|--help|-h)
+    log "Commands: db | files | full | cleanup"
+    ;;
+  *)
+    fail "Unknown command: $COMMAND"
+    ;;
+esac

server.js

@@ -4,7 +4,22 @@ import cors from 'cors';
 import dotenv from 'dotenv';
 import fs from 'fs';
 
-dotenv.config({ override: true });
+dotenv.config();
+
+const dbConfig = {
+  host: process.env.DB_HOST,
+  user: process.env.DB_USER,
+  password: process.env.DB_PASS,
+  database: process.env.DB_NAME,
+  port: parseInt(process.env.DB_PORT || '3306')
+};
+
+const getDbConnectionSummary = () => ({
+  host: dbConfig.host || '(missing)',
+  port: dbConfig.port,
+  user: dbConfig.user || '(missing)',
+  database: dbConfig.database || '(missing)'
+});
 
 const app = express();
 app.use(cors());
@@ -18,11 +33,11 @@ if (!fs.existsSync('uploads')) {
 
 // MySQL Pool Configuration
 const pool = mysql.createPool({
-  host: process.env.DB_HOST,
-  user: process.env.DB_USER,
-  password: process.env.DB_PASS,
-  database: process.env.DB_NAME,
-  port: parseInt(process.env.DB_PORT || '3306'),
+  host: dbConfig.host,
+  user: dbConfig.user,
+  password: dbConfig.password,
+  database: dbConfig.database,
+  port: dbConfig.port,
   waitForConnections: true,
   connectionLimit: 10,
   queueLimit: 0
@@ -48,7 +63,15 @@ const pool = mysql.createPool({
     `);
     console.log('✅ job_spec_standards table verification completed.');
   } catch (err) {
-    console.error('❌ Failed to verify/create job_spec_standards table:', err);
+    console.error('❌ Failed to verify/create job_spec_standards table:', {
+      db: getDbConnectionSummary(),
+      code: err.code,
+      errno: err.errno,
+      syscall: err.syscall,
+      address: err.address,
+      port: err.port,
+      message: err.message
+    });
   } finally {
     if (connection) connection.release();
   }
@@ -56,7 +79,15 @@ const pool = mysql.createPool({
 
 // Error Handler
 const handleError = (res, err, label) => {
-  console.error(`❌ [${label}] Error:`, err);
+  console.error(`❌ [${label}] Error:`, {
+    db: getDbConnectionSummary(),
+    code: err.code,
+    errno: err.errno,
+    syscall: err.syscall,
+    address: err.address,
+    port: err.port,
+    message: err.message
+  });
   res.status(500).json({ error: err.message });
 };
 
@@ -82,6 +113,30 @@ const ASSET_TABLES = [
   'asset_core'
 ];
 
+// --- Helper Functions for Maps ---
+function getCleanMapKey(path) {
+  let clean = path.replace('img/location_photo/', '').replace('.png', '');
+  clean = clean.replace('서관', 'W').replace('동관', 'E');
+  clean = clean.replace('한맥빌딩/MDF실/MDF_', 'HAN-MDF-');
+  clean = clean.replace('기술개발센터/서버실/서버실_', 'DEV-SVR-');
+  clean = clean.replace(/\//g, '-');
+  return clean;
+}
+
+function getLocationName(path) {
+  if (path.includes('IDC')) return 'IDC';
+  if (path.includes('한맥빌딩')) return '한맥빌딩';
+  if (path.includes('기술개발센터')) return '기술개발센터';
+  return '기타';
+}
+
+function getLocationDetail(path, idx) {
+  let clean = path.replace('img/location_photo/', '').replace('.png', '');
+  let parts = clean.split('/');
+  let lastPart = parts[parts.length - 1];
+  return `${lastPart} 구역 자리 #${idx + 1}`;
+}
+
 // --- API Endpoints ---
 
 // 1. Generic Batch Save (Dynamic Table Detection)
@@ -143,6 +198,9 @@ app.get('/api/assets/master', async (req, res) => {
         s.hw_status, s.model_name, s.mainboard, s.os, s.cpu, s.ram, s.gpu, 
         s.monitoring, s.price, s.monitor_inch, s.serial_num,
         l.location, l.location_detail, l.location_photo, l.loc_x, l.loc_y,
+        (
+          SELECT EXISTS(SELECT 1 FROM asset_audit_pending WHERE asset_code = c.asset_code AND status = 'APPROVED')
+        ) AS is_audit_approved,
         (
           SELECT JSON_ARRAYAGG(JSON_OBJECT('type', net_type, 'name', net_name, 'val1', net_value1, 'val2', net_value2))
           FROM asset_remote WHERE asset_id = c.id AND is_active = 1
@@ -162,7 +220,7 @@ app.get('/api/assets/master', async (req, res) => {
 
     const catMap = {
       'PC': 'pc', '서버': 'server', '저장매체': 'storage', '네트워크': 'network',
-      '업무지원장비': 'equipment', '사무가구': 'officeSupplies', '공간정보장비': 'survey',
+      '업무지원장비': 'equipment', '시설자산': 'officeSupplies', '공간정보장비': 'survey',
       '내빈/외빈': 'vip', 'PC부품': 'pcParts'
     };
 
@@ -203,9 +261,34 @@ app.post('/api/asset/:category/save', async (req, res) => {
     connection = await pool.getConnection();
     await connection.beginTransaction();
 
+    // 3.0.0 CPU, GPU, RAM 부품 마스터 유효성 검사
+    const partsToCheck = [
+      { value: asset.cpu, category: 'CPU', label: 'CPU' },
+      { value: asset.gpu, category: 'GPU', label: 'GPU' },
+      { value: asset.ram, category: 'RAM', label: 'RAM' }
+    ];
+
+    for (const part of partsToCheck) {
+      const val = String(part.value || '').trim();
+      if (val) {
+        const [rows] = await connection.query(
+          'SELECT id FROM hardware_components_master WHERE UPPER(category) = ? AND LOWER(TRIM(component_name)) = ?',
+          [part.category, val.toLowerCase()]
+        );
+        if (rows.length === 0) {
+          await connection.rollback();
+          return res.status(400).json({ 
+            success: false, 
+            message: `입력하신 ${part.label} "${val}"은(는) 부품 마스터에 존재하지 않는 규격입니다.` 
+          });
+        }
+      }
+    }
+
     // 3.0 History Tracking & Auto Field Update
     const [oldCoreRows] = await connection.query('SELECT * FROM asset_core WHERE id = ?', [asset.id]);
     const [oldSpecRows] = await connection.query('SELECT * FROM asset_spec WHERE asset_id = ?', [asset.id]);
+    const [oldRemoteRows] = await connection.query('SELECT * FROM asset_remote WHERE asset_id = ? AND is_active = 1', [asset.id]);
     const oldCore = oldCoreRows[0] || {};
     const oldSpec = oldSpecRows[0] || {};
 
@@ -268,6 +351,85 @@ app.post('/api/asset/:category/save', async (req, res) => {
         });
     }
 
+    // 3.0.4 메모, 용도, 유형 변동 감지
+    const oldMemo = String(oldCore.memo || '').trim();
+    const newMemo = String(asset.memo || '').trim();
+    if (newMemo !== '' && oldMemo !== newMemo) {
+        historyLogs.push({
+            event_type: 'MEMO_CHANGE',
+            details: `[메모 변경] ${oldMemo || '(없음)'} -> ${newMemo}`
+        });
+    }
+
+    const oldPurpose = String(oldCore.asset_purpose || '').trim();
+    const newPurpose = String(asset.asset_purpose || '').trim();
+    if (newPurpose !== '' && oldPurpose !== newPurpose) {
+        historyLogs.push({
+            event_type: 'PURPOSE_CHANGE',
+            details: `[용도 변경] ${oldPurpose || '(없음)'} -> ${newPurpose}`
+        });
+    }
+
+    const oldType = String(oldCore.asset_type || '').trim();
+    const newType = String(asset.asset_type || '').trim();
+    if (newType !== '' && oldType !== newType) {
+        historyLogs.push({
+            event_type: 'TYPE_CHANGE',
+            details: `[유형 변경] ${oldType || '(없음)'} -> ${newType}`
+        });
+    }
+
+    // 3.0.5 접속정보 변동 감지
+    const formatRemote = (r) => {
+        const type = r.net_type || r.type || '';
+        const name = r.net_name || r.name || '';
+        const val1 = r.net_value1 || r.val1 || '';
+        const val2 = r.net_value2 || r.val2 || '';
+        return `${type}:${name}:${val1}:${val2}`;
+    };
+
+    const oldRemotesSummary = oldRemoteRows.map(formatRemote).sort().join(' | ');
+
+    let newNets = [];
+    if (asset.remotes) {
+        try {
+            newNets = typeof asset.remotes === 'string' ? JSON.parse(asset.remotes) : asset.remotes;
+        } catch(e) { newNets = []; }
+    } else if (asset.ip_address || asset.mac_address || asset.remote_tool) {
+        if (asset.ip_address || asset.mac_address) {
+            newNets.push({ type: 'IP', name: '기본망', val1: asset.ip_address, val2: asset.mac_address });
+        }
+        if (asset.remote_tool || asset.remote_id || asset.remote_pw) {
+            newNets.push({ type: 'REMOTE', name: asset.remote_tool, val1: asset.remote_id, val2: asset.remote_pw });
+        }
+    }
+    const newRemotesSummary = newNets.map(formatRemote).sort().join(' | ');
+
+    if (newRemotesSummary !== '' && oldRemotesSummary !== newRemotesSummary) {
+        const formatDisplay = (summary) => {
+            if (!summary) return '(없음)';
+            return summary.split(' | ').map(item => {
+                const [type, name, val1, val2] = item.split(':');
+                if (type === 'IP') {
+                    return `[IP] ${name}: ${val1} (MAC: ${val2 || '없음'})`;
+                } else {
+                    let id = '', pw = '';
+                    try {
+                        const parsed = JSON.parse(val2);
+                        id = parsed.id || '';
+                        pw = parsed.pw || '';
+                    } catch(e) { id = val1; pw = val2; }
+                    return `[원격] ${name}: ID=${id || '없음'}, PW=${pw ? '***' : '없음'}`;
+                }
+            }).join(', ');
+        };
+        
+        historyLogs.push({
+            event_type: 'REMOTE_CHANGE',
+            details: `[접속정보 변경] ${formatDisplay(oldRemotesSummary)} -> ${formatDisplay(newRemotesSummary)}`
+        });
+    }
+
     // 로그 일괄 삽입
     for (const log of historyLogs) {
         await connection.query(
@@ -515,13 +677,121 @@ app.get('/api/generate-asset-code', async (req, res) => {
   } catch (err) { handleError(res, err, 'GENERATE CODE'); }
 });
 
-// 6. Map Config API
-app.get('/api/maps', (req, res) => {
+// 6. Map Config API (Adopt database-driven locations from origin/QR_setting)
+app.get('/api/maps', async (req, res) => {
   try {
-    if (!fs.existsSync('map_config.json')) return res.json({});
-    const data = fs.readFileSync('map_config.json', 'utf8');
-    res.json(JSON.parse(data || '{}'));
-  } catch (err) { handleError(res, err, 'GET MAPS'); }
+    const query = `
+      SELECT 
+        pl.location_code,
+        pl.location_name,
+        pl.location_detail,
+        pl.map_image,
+        pl.map_x,
+        pl.map_y,
+        pl.map_w,
+        pl.map_h,
+        al.asset_id
+      FROM physical_locations pl
+      LEFT JOIN asset_location al ON al.physical_location_code = pl.location_code AND al.is_active = 1
+    `;
+    const [rows] = await pool.query(query);
+    
+    const mapConfig = {};
+    rows.forEach(row => {
+      const mapPath = row.map_image;
+      if (!mapConfig[mapPath]) {
+        mapConfig[mapPath] = [];
+      }
+      mapConfig[mapPath].push({
+        x: parseFloat(row.map_x).toFixed(2),
+        y: parseFloat(row.map_y).toFixed(2),
+        w: parseFloat(row.map_w).toFixed(2),
+        h: parseFloat(row.map_h).toFixed(2),
+        asset_id: row.asset_id
+      });
+    });
+    
+    res.json(mapConfig);
+  } catch (err) { 
+    handleError(res, err, 'GET MAPS'); 
+  }
+});
+
+app.post('/api/maps/save', async (req, res) => {
+  let connection;
+  try {
+    const { path, boxes } = req.body;
+    if (!path) return res.status(400).json({ error: 'Path is required' });
+    if (!Array.isArray(boxes)) return res.status(400).json({ error: 'Boxes must be an array' });
+
+    connection = await pool.getConnection();
+    await connection.beginTransaction();
+
+    const cleanKey = getCleanMapKey(path);
+    const locName = getLocationName(path);
+
+    // 1. Get old location codes for this map
+    const [oldLocs] = await connection.query(
+      'SELECT location_code FROM physical_locations WHERE map_image = ?',
+      [path]
+    );
+    const oldLocCodes = oldLocs.map(r => r.location_code);
+
+    // 2. Deactivate and clear foreign key references in asset_location to these old location codes
+    if (oldLocCodes.length > 0) {
+      await connection.query(
+        'UPDATE asset_location SET is_active = 0, deactivated_at = NOW(), physical_location_code = NULL WHERE physical_location_code IN (?)',
+        [oldLocCodes]
+      );
+    }
+
+    // 3. Delete old physical locations for this map
+    await connection.query(
+      'DELETE FROM physical_locations WHERE map_image = ?',
+      [path]
+    );
+
+    // 4. Insert new physical locations and setup asset_location mappings
+    for (let i = 0; i < boxes.length; i++) {
+      const box = boxes[i];
+      const padIdx = String(i + 1).padStart(3, '0');
+      const locCode = `LOC-${cleanKey}-${padIdx}`;
+      const locDetail = getLocationDetail(path, i);
+
+      // Insert physical location
+      await connection.query(`
+        INSERT INTO physical_locations 
+          (location_code, location_name, location_detail, map_image, map_x, map_y, map_w, map_h)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      `, [locCode, locName, locDetail, path, box.x, box.y, box.w, box.h]);
+
+      // If asset_id is mapped, update asset_location
+      if (box.asset_id) {
+        // Deactivate old active locations for this asset
+        await connection.query(
+          'UPDATE asset_location SET is_active = 0, deactivated_at = NOW() WHERE asset_id = ? AND is_active = 1',
+          [box.asset_id]
+        );
+
+        // Insert new active location mapping
+        const pathPartsForMap = path.split('/');
+        const stdDetailForMap = pathPartsForMap[pathPartsForMap.length - 2] || locDetail;
+        await connection.query(`
+          INSERT INTO asset_location 
+            (asset_id, location, location_detail, location_photo, loc_x, loc_y, physical_location_code, is_active)
+          VALUES (?, ?, ?, ?, ?, ?, ?, 1)
+        `, [box.asset_id, locName, stdDetailForMap, path, box.x, box.y, locCode]);
+      }
+    }
+
+    await connection.commit();
+    res.json({ success: true, message: 'Map and Database synced successfully' });
+  } catch (err) { 
+    if (connection) await connection.rollback();
+    handleError(res, err, 'SAVE MAPS SYNC'); 
+  } finally {
+    if (connection) connection.release();
+  }
 });
 
 // 6.5. Get Hardware Components Master List
@@ -675,38 +945,212 @@ app.delete('/api/system-users/:id', async (req, res) => {
   }
 });
 
-app.post('/api/maps/save', async (req, res) => {
+// ==========================================
+// 8. QR Asset Audit & Scan APIs (From origin/QR_setting)
+// ==========================================
+
+// GET all physical locations
+app.get('/api/physical-locations', async (req, res) => {
+  try {
+    const [rows] = await pool.query('SELECT * FROM physical_locations ORDER BY location_code');
+    res.json(rows);
+  } catch (err) {
+    handleError(res, err, 'GET PHYSICAL LOCATIONS');
+  }
+});
+
+// POST register scan (mobile)
+app.post('/api/audit/scan', async (req, res) => {
   let connection;
   try {
-    const { path, boxes } = req.body;
-    if (!path) return res.status(400).json({ error: 'Path is required' });
-
-    // 1. Get old config to track movements
-    let oldConfig = {};
-    if (fs.existsSync('map_config.json')) {
-      oldConfig = JSON.parse(fs.readFileSync('map_config.json', 'utf8') || '{}');
+    const { asset_code, physical_location_code } = req.body;
+    if (!asset_code || !physical_location_code) {
+      return res.status(400).json({ error: 'asset_code and physical_location_code are required' });
     }
-    const oldBoxes = oldConfig[path] || [];
 
-    // 2. Save new config to file
-    oldConfig[path] = boxes;
-    fs.writeFileSync('map_config.json', JSON.stringify(oldConfig, null, 2));
-
-    // 3. Sync Database Assets (asset_location table)
     connection = await pool.getConnection();
-    for (const box of boxes) {
-      if (box.asset_id) {
-        console.log(`Syncing asset ${box.asset_id} to new position: [${box.x}, ${box.y}]`);
+
+    // Verify if asset exists
+    const [assets] = await connection.query('SELECT id FROM asset_core WHERE asset_code = ?', [asset_code]);
+    if (assets.length === 0) {
+      return res.status(404).json({ error: `Asset with code ${asset_code} not found` });
+    }
+
+    // Insert pending audit record
+    const [result] = await connection.query(
+      'INSERT INTO asset_audit_pending (asset_code, physical_location_code, status) VALUES (?, ?, ?)',
+      [asset_code, physical_location_code, 'PENDING']
+    );
+
+    res.json({ success: true, pending_id: result.insertId });
+  } catch (err) {
+    handleError(res, err, 'REGISTER SCAN');
+  } finally {
+    if (connection) connection.release();
+  }
+});
+
+// GET pending audits list (admin)
+app.get('/api/audit/pending', async (req, res) => {
+  try {
+    const [rows] = await pool.query(`
+      SELECT 
+        ap.*, 
+        c.id AS asset_id,
+        c.asset_purpose, 
+        c.asset_type,
+        pl.location_name, 
+        pl.location_detail, 
+        pl.map_image,
+        l.location AS old_location,
+        l.location_detail AS old_location_detail
+      FROM asset_audit_pending ap
+      JOIN asset_core c ON c.asset_code = ap.asset_code
+      JOIN physical_locations pl ON pl.location_code = ap.physical_location_code
+      LEFT JOIN asset_location l ON l.asset_id = c.id AND l.is_active = 1
+      WHERE ap.status = 'PENDING'
+      ORDER BY ap.scanned_at DESC
+    `);
+    res.json(rows);
+  } catch (err) {
+    handleError(res, err, 'GET PENDING AUDITS');
+  }
+});
+
+// POST approve audits (admin)
+app.post('/api/audit/approve', async (req, res) => {
+  let connection;
+  try {
+    const { pending_ids, processed_by } = req.body;
+    if (!Array.isArray(pending_ids) || pending_ids.length === 0) {
+      return res.status(400).json({ error: 'pending_ids must be a non-empty array' });
+    }
+
+    connection = await pool.getConnection();
+    await connection.beginTransaction();
+
+    let mapConfigChanged = false;
+    let mapConfig = {};
+    if (fs.existsSync('map_config.json')) {
+      mapConfig = JSON.parse(fs.readFileSync('map_config.json', 'utf8') || '{}');
+    }
+
+    for (const pendingId of pending_ids) {
+      // 1. Get pending scan details
+      const [pendings] = await connection.query(
+        'SELECT asset_code, physical_location_code FROM asset_audit_pending WHERE id = ? AND status = ?',
+        [pendingId, 'PENDING']
+      );
+      if (pendings.length === 0) continue;
+
+      const { asset_code, physical_location_code } = pendings[0];
+
+      // 2. Get asset ID
+      const [assets] = await connection.query('SELECT id FROM asset_core WHERE asset_code = ?', [asset_code]);
+      if (assets.length === 0) continue;
+      const assetId = assets[0].id;
+
+      // 3. Get physical location details
+      const [locations] = await connection.query(
+        'SELECT location_name, location_detail, map_image, map_x, map_y FROM physical_locations WHERE location_code = ?',
+        [physical_location_code]
+      );
+      if (locations.length === 0) continue;
+      const loc = locations[0];
+
+      // 4. Deactivate old active locations for this asset
       await connection.query(
-          'UPDATE asset_location SET loc_x = ?, loc_y = ? WHERE asset_id = ? AND is_active = 1',
-          [box.x, box.y, box.asset_id]
+        'UPDATE asset_location SET is_active = 0, deactivated_at = NOW() WHERE asset_id = ? AND is_active = 1',
+        [assetId]
+      );
+
+      // 5. Insert new active location
+      const pathPartsForApprove = loc.map_image.split('/');
+      const stdDetailForApprove = pathPartsForApprove[pathPartsForApprove.length - 2] || loc.location_detail;
+      await connection.query(`
+        INSERT INTO asset_location 
+          (asset_id, location, location_detail, location_photo, loc_x, loc_y, physical_location_code, is_active)
+        VALUES (?, ?, ?, ?, ?, ?, ?, 1)
+      `, [assetId, loc.location_name, stdDetailForApprove, loc.map_image, loc.map_x, loc.map_y, physical_location_code]);
+
+      // 6. Update pending audit status
+      await connection.query(
+        'UPDATE asset_audit_pending SET status = ?, processed_at = NOW(), processed_by = ? WHERE id = ?',
+        ['APPROVED', processed_by || 'ADMIN', pendingId]
+      );
+
+      // 7. Sync map_config.json
+      // Remove asset from any other map coordinates
+      for (const [mapPath, boxes] of Object.entries(mapConfig)) {
+        let changed = false;
+        const newBoxes = boxes.map(b => {
+          if (b.asset_id === assetId) {
+            changed = true;
+            return { ...b, asset_id: null };
+          }
+          return b;
+        });
+        if (changed) {
+          mapConfig[mapPath] = newBoxes;
+          mapConfigChanged = true;
+        }
+      }
+
+      // Add asset to the new map coordinate box matching map_image, map_x, map_y
+      if (mapConfig[loc.map_image]) {
+        const ax = parseFloat(loc.map_x);
+        const ay = parseFloat(loc.map_y);
+        const boxes = mapConfig[loc.map_image];
+        const matchedBox = boxes.find(b => {
+          const bx = parseFloat(b.x);
+          const by = parseFloat(b.y);
+          return Math.abs(bx - ax) < 0.1 && Math.abs(by - ay) < 0.1;
+        });
+        if (matchedBox) {
+          matchedBox.asset_id = assetId;
+          mapConfigChanged = true;
+        }
+      }
+    }
+
+    if (mapConfigChanged) {
+      fs.writeFileSync('map_config.json', JSON.stringify(mapConfig, null, 2));
+    }
+
+    await connection.commit();
+    res.json({ success: true, message: 'Audits approved successfully' });
+  } catch (err) {
+    if (connection) await connection.rollback();
+    handleError(res, err, 'APPROVE AUDITS');
+  } finally {
+    if (connection) connection.release();
+  }
+});
+
+// POST reject audits (admin)
+app.post('/api/audit/reject', async (req, res) => {
+  let connection;
+  try {
+    const { pending_ids, processed_by } = req.body;
+    if (!Array.isArray(pending_ids) || pending_ids.length === 0) {
+      return res.status(400).json({ error: 'pending_ids must be a non-empty array' });
+    }
+
+    connection = await pool.getConnection();
+    await connection.beginTransaction();
+
+    for (const pendingId of pending_ids) {
+      await connection.query(
+        'UPDATE asset_audit_pending SET status = ?, processed_at = NOW(), processed_by = ? WHERE id = ? AND status = ?',
+        ['REJECTED', processed_by || 'ADMIN', pendingId, 'PENDING']
       );
     }
-    }
 
-    res.json({ success: true, message: 'Map and Database synced successfully' });
+    await connection.commit();
+    res.json({ success: true, message: 'Audits rejected successfully' });
   } catch (err) {
-    handleError(res, err, 'SAVE MAPS SYNC'); 
+    if (connection) await connection.rollback();
+    handleError(res, err, 'REJECT AUDITS');
   } finally {
     if (connection) connection.release();
   }
@@ -736,6 +1180,30 @@ app.post('/api/upload', (req, res) => {
   }
 });
 
-app.listen(3000, '0.0.0.0', () => {
-  console.log('📡 ITAM BACKEND SERVER RUNNING ON PORT 3000 (V3 Normalized)');
+// Health check endpoint for container orchestration
+app.get('/health', async (req, res) => {
+  try {
+    const connection = await pool.getConnection();
+    await connection.query('SELECT 1');
+    connection.release();
+    res.status(200).json({ status: 'ok', db: 'connected' });
+  } catch (err) {
+    res.status(200).json({ status: 'degraded', db: 'unreachable', error: err.message });
+  }
+});
+
+// Readiness check endpoint (only returns 200 if fully ready)
+app.get('/ready', async (req, res) => {
+  try {
+    const connection = await pool.getConnection();
+    await connection.query('SELECT 1');
+    connection.release();
+    res.status(200).json({ status: 'ready' });
+  } catch (err) {
+    res.status(503).json({ status: 'not_ready', error: err.message });
+  }
+});
+
+app.listen(process.env.PORT || 3000, '0.0.0.0', () => {
+  console.log(`📡 ITAM BACKEND SERVER RUNNING ON PORT ${process.env.PORT || 3000} (V3 Normalized)`);
 });

src/components/Modal/DomainModal.ts

@@ -202,7 +202,57 @@ class DomainAssetModal extends BaseModal {
     if (logs.length === 0) {
       container.innerHTML = '<div style="color:var(--mute); padding:1rem; text-align:center;">이력이 없습니다.</div>';
     } else {
-      container.innerHTML = logs.map(l => `<div class="history-item"><div class="history-date">${l.log_date || ''}</div><div class="history-user">${l.log_user || '시스템'}</div><div class="history-details">${l.details}</div></div>`).join('');
+      const createdDate = this.currentAsset?.created_at ? this.currentAsset.created_at.substring(0, 10) : '';
+
+      const grouped: Record<string, typeof logs> = {};
+      logs.forEach(l => {
+        const date = l.log_date || '날짜 미지정';
+        if (!grouped[date]) grouped[date] = [];
+        grouped[date].push(l);
+      });
+
+      container.innerHTML = Object.entries(grouped).map(([date, dateLogs]) => {
+        const entriesHtml = dateLogs.map((l, idx) => {
+          const isLast = idx === dateLogs.length - 1;
+          const borderStyle = isLast ? '' : 'border-bottom: 1px dashed var(--hairline); padding-bottom: 8px; margin-bottom: 8px;';
+          
+          let displayDetails = l.details;
+          if (l.details && l.details.trim().startsWith('{')) {
+            try {
+              const data = JSON.parse(l.details);
+              if (data.type === 'checkout') {
+                displayDetails = `[불출] ${data.user || ''} (${data.dept || ''}) ${data.memo ? `| 메모: ${data.memo}` : ''}`;
+              } else if (data.type === 'return') {
+                displayDetails = `[반납] ${data.user || ''} (${data.dept || ''}) ${data.memo ? `| 메모: ${data.memo}` : ''}`;
+              } else if (data.type === 'move') {
+                displayDetails = `[이동] ${data.user || ''} (${data.dept || ''}) ➔ ${data.targetUser || ''} (${data.targetDept || ''}) ${data.memo ? `| 메모: ${data.memo}` : ''}`;
+              }
+            } catch (e) {}
+          }
+
+          return `
+            <div class="history-entry" style="${borderStyle}">
+              <div style="font-weight: 600; color: var(--primary); opacity: 0.8; margin-bottom: 4px; display: flex; align-items: center; gap: 6px;">
+                <span style="display: inline-block; width: 4px; height: 4px; background-color: var(--primary); border-radius: 50%;"></span>
+                ${l.log_user || '시스템'}
+              </div>
+              <div style="color: var(--primary); padding-left: 10px; line-height: 1.5;">${displayDetails}</div>
+            </div>
+          `;
+        }).join('');
+
+        const isInitialReg = date === createdDate;
+        const regBadge = isInitialReg ? `<span class="badge-reg" style="font-size: 10px; padding: 1px 5px; margin-left: 6px; background-color: rgba(16, 185, 129, 0.1); color: #10b981; border: 1px solid rgba(16, 185, 129, 0.2); border-radius: 4px; font-weight: 600;">최초등록</span>` : '';
+
+        return `
+          <div class="history-item">
+            <div class="history-date" style="display: flex; align-items: center;">${date} ${regBadge}</div>
+            <div class="history-details" style="display: flex; flex-direction: column; gap: 4px;">
+              ${entriesHtml}
+            </div>
+          </div>
+        `;
+      }).join('');
     }
   }
 }

src/components/Modal/HWModal.ts

@@ -1,6 +1,6 @@
 import { state, saveAsset, deleteAsset } from '../../core/state';
 import { ASSET_SCHEMA, UI_TEXT } from '../../core/schema';
-import { calculatePcScoreDeductive, getPcGrade } from '../../core/utils';
+import { calculatePcScoreDeductive, getPcGrade, API_BASE_URL } from '../../core/utils';
 import {
   generateOptionsHTML,
   setFieldValue,
@@ -11,6 +11,7 @@ import {
 } from './ModalUtils';
 import { CORP_LIST, LOCATION_DATA, CATEGORY_TYPE_MAP, HW_STATUS_LIST, ORG_LIST, IMAGE_LOCATIONS, TYPE_PREFIX_MAP } from './SharedData';
 import { BaseModal } from './BaseModal';
+import { QRPrinter } from '../../core/qr_print';
 
 /**
  * 하드웨어 자산 상세 모달 (Styled Main Edition)
@@ -30,9 +31,11 @@ class HwAssetModal extends BaseModal {
       <div id="hw-asset-modal" class="modal-overlay hidden">
         <div class="modal-content wide">
           <div class="modal-header">
-            <div class="header-left">
-              <h2 id="hw-modal-title" class="modal-title">${this.title}</h2>
-              <div id="hw-header-identity" class="header-identity"></div>
+            <div class="header-left" style="display: flex; align-items: center; gap: 0.75rem; flex-wrap: wrap;">
+              <h2 id="hw-modal-title" class="modal-title" style="display: none;">${this.title}</h2>
+              <div id="hw-header-identity" class="header-identity" style="display: inline-flex; gap: 0.5rem; align-items: center;"></div>
+              <button id="btn-print-hw-qr" class="btn btn-outline btn-primary hidden" style="padding: 2px 8px; font-size: 11px; height: 22px; margin: 0; line-height: 1; display: inline-flex; align-items: center; justify-content: center; cursor: pointer;">QR 인쇄</button>
+              <span id="hw-modal-audit-approved-badge" style="display: none; align-items: center; background-color: rgba(16, 185, 129, 0.08); color: #059669; border: 1px solid rgba(16, 185, 129, 0.18); padding: 1px 6px; border-radius: 4px; font-size: 10px; font-weight: 600; height: 20px; line-height: 1; vertical-align: middle; white-space: nowrap; margin-left: 4px;">승인완료</span>
             </div>
             <button id="btn-close-hw-modal" class="btn-icon" aria-label="닫기">&times;</button>
           </div>
@@ -74,7 +77,7 @@ class HwAssetModal extends BaseModal {
                     <label>${ASSET_SCHEMA.HW_STATUS.ui}</label>
                     <select id="hw-hw_status" name="hw_status">${generateOptionsHTML(HW_STATUS_LIST)}</select>
                   </div>
-                  <div class="form-group">
+                  <div class="form-group service-type-field">
                     <label>${ASSET_SCHEMA.SERVICE_TYPE.ui}</label>
                     <select id="hw-service_type" name="service_type">
                       <option value="외부">외부</option>
@@ -95,6 +98,9 @@ class HwAssetModal extends BaseModal {
 
                   <!-- [SECTION 2] 조직 및 사용자 정보 -->
                   <div class="form-section-title">사용자 및 조직 정보</div>
+                  <div id="hw-pc-workflow-notice" class="form-group full-width hidden" style="background-color: rgba(59, 130, 246, 0.05); border: 1px solid rgba(59, 130, 246, 0.15); padding: 8px 12px; border-radius: 6px; font-size: 11px; color: var(--primary); line-height: 1.5; margin-bottom: 12px;">
+                    💡 PC 자산은 데이터 정합성을 위해 '사용자 및 조직 정보'만 수정이 제한되며, 사양 및 기타 정보는 수정창에서 수정할 수 있습니다.
+                  </div>
                   <div class="form-group">
                     <label>${ASSET_SCHEMA.CURRENT_DEPT.ui}</label>
                     <select id="hw-current_dept" name="current_dept">${generateOptionsHTML(ORG_LIST)}</select>
@@ -107,9 +113,14 @@ class HwAssetModal extends BaseModal {
                     <label>${ASSET_SCHEMA.MANAGER_SUB.ui}</label>
                     <input type="text" id="hw-manager_secondary" name="manager_secondary" />
                   </div>
-                  <div class="form-group personal-only">
+                  <div class="form-group personal-only relative">
                     <label>${ASSET_SCHEMA.CURRENT_USER.ui}</label>
-                    <input type="text" id="hw-user_current" name="user_current" />
+                    <input type="text" id="hw-user_current" name="user_current" autocomplete="off" />
+                    <div id="hw-user-current-list" class="autocomplete-list hidden"></div>
+                  </div>
+                  <div class="form-group personal-only">
+                    <label>${ASSET_SCHEMA.EMP_NO.ui}</label>
+                    <input type="text" id="hw-emp_no" name="emp_no" readonly style="background-color: #f1f5f9; cursor: not-allowed;" />
                   </div>
                   <div class="form-group personal-only">
                     <label>${ASSET_SCHEMA.USER_POSITION.ui}</label>
@@ -130,6 +141,10 @@ class HwAssetModal extends BaseModal {
                     <label>${ASSET_SCHEMA.SERIAL_NUM.ui}</label>
                     <input type="text" id="hw-serial_num" name="serial_num" />
                   </div>
+                  <div class="form-group mainboard-only">
+                    <label>${ASSET_SCHEMA.MAINBOARD.ui}</label>
+                    <input type="text" id="hw-mainboard" name="mainboard" />
+                  </div>
                   <div class="form-group spec-only">
                     <label>${ASSET_SCHEMA.OS.ui}</label>
                     <input type="text" id="hw-os" name="os" />
@@ -264,10 +279,26 @@ class HwAssetModal extends BaseModal {
     const detailSelect = document.getElementById('hw-location_detail') as HTMLSelectElement;
 
     this.fetchMapConfig();
+    
+    const qrPrintBtn = document.getElementById('btn-print-hw-qr');
+    qrPrintBtn?.addEventListener('click', () => {
+      if (this.currentAsset && this.currentAsset.asset_code) {
+        QRPrinter.print([{
+          type: 'asset',
+          code: this.currentAsset.asset_code,
+          title: '[ HM IT ASSET ]',
+          subtitle: this.currentAsset.model_name || this.currentAsset.asset_purpose || this.currentAsset.category || 'IT 자산',
+          dept: this.currentAsset.current_dept || '-',
+          user: this.currentAsset.user_current || '-'
+        }]);
+      }
+    });
+
     this.fetchMasterComponents().then(() => {
         this.bindAutocomplete('hw-cpu', 'hw-cpu-list', 'CPU');
         this.bindAutocomplete('hw-ram', 'hw-ram-list', 'RAM');
         this.bindAutocomplete('hw-gpu', 'hw-gpu-list', 'GPU');
+        this.bindUserAutocomplete();
     });
 
     categorySelect.addEventListener('change', () => {
@@ -285,6 +316,12 @@ class HwAssetModal extends BaseModal {
     typeSelect.addEventListener('change', () => {
         this.applyRoleVisibility();
         this.updateHeaderIdentity(this.currentAsset);
+        
+        if (typeSelect.value === '공용PC') {
+            setFieldValue('hw-user_current', '');
+            setFieldValue('hw-emp_no', '');
+            setFieldValue('hw-user_position', '공용PC');
+        }
     });
 
     bindLocationEvents('hw-bldg-select', 'hw-location_detail', '', '');
@@ -296,10 +333,17 @@ class HwAssetModal extends BaseModal {
     document.getElementById('btn-gen-hw-code')?.addEventListener('click', async () => {
       const cat = categorySelect.value;
       if (!cat) { alert('구분을 먼저 선택해주세요.'); return; }
-      const prefix = TYPE_PREFIX_MAP[cat] || 'ETC';
+      
       const purchaseDate = (document.getElementById('hw-purchase_date') as HTMLInputElement)?.value || '';
+      if (!purchaseDate.trim()) {
+        alert('구매일자를 먼저 입력해 주세요. 구매일자가 없으면 자산번호를 생성할 수 없습니다.');
+        return;
+      }
+
+      const type = (document.getElementById('hw-asset_type') as HTMLSelectElement)?.value || '';
+      const prefix = TYPE_PREFIX_MAP[type] || TYPE_PREFIX_MAP[cat] || 'ETC';
       try {
-        const res = await fetch(`http://${location.hostname}:3000/api/generate-asset-code?prefix=${prefix}&purchaseDate=${purchaseDate}`);
+        const res = await fetch(`/api/generate-asset-code?prefix=${prefix}&purchaseDate=${purchaseDate}`);
         const data = await res.json();
         if (data.nextCode) setFieldValue('hw-asset_code', data.nextCode);
       } catch (err) { console.error('코드 생성 실패:', err); }
@@ -317,7 +361,7 @@ class HwAssetModal extends BaseModal {
       const reader = new FileReader();
       reader.onload = async () => {
         try {
-          const res = await fetch(`http://${location.hostname}:3000/api/upload`, {
+          const res = await fetch('/api/upload', {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({ fileName: file.name, fileData: reader.result })
@@ -326,7 +370,7 @@ class HwAssetModal extends BaseModal {
           if (data.success) {
             setFieldValue('hw-approval_document', data.filePath);
             if (fileLinkContainer) {
-              fileLinkContainer.innerHTML = `<a href="http://${location.hostname}:3000${data.filePath}" target="_blank" class="btn btn-outline btn-sm">[파일 보기]</a>`;
+              fileLinkContainer.innerHTML = `<a href="${data.filePath}" target="_blank" class="btn btn-outline btn-sm">[파일 보기]</a>`;
             }
           }
         } catch (err) { console.error('파일 업로드 실패:', err); alert('파일 업로드 중 오류가 발생했습니다.'); }
@@ -377,6 +421,31 @@ class HwAssetModal extends BaseModal {
         return;
       }
 
+      // 자산코드가 비어있는 경우 자동 생성 처리
+      let assetCode = getFieldValue('hw-asset_code').trim();
+      if (!assetCode) {
+        const cat = categorySelect.value;
+        if (!cat) { alert('구분을 먼저 선택해주세요.'); return; }
+        const type = (document.getElementById('hw-asset_type') as HTMLSelectElement)?.value || '';
+        const prefix = TYPE_PREFIX_MAP[type] || TYPE_PREFIX_MAP[cat] || 'ETC';
+        const purchaseDate = (document.getElementById('hw-purchase_date') as HTMLInputElement)?.value || '';
+        try {
+          const res = await fetch(`/api/generate-asset-code?prefix=${prefix}&purchaseDate=${purchaseDate}`);
+          const data = await res.json();
+          if (data.nextCode) {
+            setFieldValue('hw-asset_code', data.nextCode);
+            assetCode = data.nextCode;
+          } else {
+            alert('자산코드 자동 생성에 실패했습니다. 수동으로 생성 버튼을 눌러주세요.');
+            return;
+          }
+        } catch (err) {
+          console.error('코드 자동 생성 실패:', err);
+          alert('자산코드 자동 생성 중 오류가 발생했습니다.');
+          return;
+        }
+      }
+
       // 동적 볼륨 데이터 수집
       const vols: any[] = [];
       document.querySelectorAll('#hw-volume-container .volume-row').forEach((row, idx) => {
@@ -410,6 +479,27 @@ class HwAssetModal extends BaseModal {
       formData.forEach((value, key) => { if (key !== 'id') updated[key] = value; });
       updated.location = bldgSelect.value;
 
+      // 부품 마스터 기준 정합성 검증 (CPU, GPU, RAM)
+      const checkFields = [
+        { name: 'cpu', label: 'CPU', category: 'CPU' },
+        { name: 'gpu', label: 'GPU', category: 'GPU' },
+        { name: 'ram', label: 'RAM', category: 'RAM' }
+      ];
+
+      for (const field of checkFields) {
+        const value = String(updated[field.name] || '').trim();
+        if (value) {
+          const isExists = this.masterComponents.some(c => 
+            c.category.toUpperCase() === field.category && 
+            c.component_name.trim().toLowerCase() === value.toLowerCase()
+          );
+          if (!isExists) {
+            alert(`입력하신 ${field.label} "${value}"은(는) 부품 마스터에 등록되지 않은 규격입니다. 자동완성 목록에서 선택하거나 부품마스터에 먼저 등록해 주세요.`);
+            return;
+          }
+        }
+      }
+
       if (await saveAsset(this.getCategoryKey(updated), updated)) {
         alert(UI_TEXT.MESSAGES.SAVE_SUCCESS);
         onSave(); this.close(); closeModals();
@@ -539,6 +629,7 @@ class HwAssetModal extends BaseModal {
     setFieldValue('hw-manager_primary', asset.manager_primary || '');
     setFieldValue('hw-manager_secondary', asset.manager_secondary || '');
     setFieldValue('hw-user_current', asset.user_current || '');
+    setFieldValue('hw-emp_no', asset.emp_no || '');
     setFieldValue('hw-user_position', asset.user_position || '');
     setFieldValue('hw-previous_user', asset.previous_user || '');
     setFieldValue('hw-model_name', asset.model_name || '');
@@ -597,7 +688,7 @@ class HwAssetModal extends BaseModal {
     if (docName) docName.textContent = asset.approval_document ? asset.approval_document.split('/').pop() : '파일 선택...';
     const fileLinkContainer = document.getElementById('hw-file-link-container');
     if (fileLinkContainer && asset.approval_document) {
-      fileLinkContainer.innerHTML = `<a href="http://${location.hostname}:3000${asset.approval_document}" target="_blank" class="btn btn-outline btn-sm">[파일 보기]</a>`;
+      fileLinkContainer.innerHTML = `<a href="${asset.approval_document}" target="_blank" class="btn btn-outline btn-sm">[파일 보기]</a>`;
     } else if (fileLinkContainer) {
       fileLinkContainer.innerHTML = '';
     }
@@ -618,6 +709,19 @@ class HwAssetModal extends BaseModal {
   protected onAfterOpen(asset: any, mode: string): void {
     const genBtn = document.getElementById('btn-gen-hw-code');
     if (genBtn) genBtn.style.display = (mode === 'add') ? 'inline-flex' : 'none';
+    
+    const qrBtn = document.getElementById('btn-print-hw-qr');
+    if (qrBtn) {
+      const hasCode = asset && asset.asset_code && asset.asset_code.trim() !== '';
+      qrBtn.classList.toggle('hidden', mode !== 'view' || !hasCode);
+    }
+
+    const approvedBadge = document.getElementById('hw-modal-audit-approved-badge');
+    if (approvedBadge) {
+      const isApproved = asset && asset.is_audit_approved;
+      approvedBadge.style.display = (mode === 'view' && isApproved) ? 'inline-flex' : 'none';
+    }
+
     this.toggleFileUploadUI(mode !== 'view');
     this.toggleEditOnlyBtns(mode !== 'view');
     this.updateMapButtonVisibility();
@@ -664,20 +768,97 @@ class HwAssetModal extends BaseModal {
     const hasSpec = specCategories.includes(category) || type.includes('서버PC');
     const noNetCategories = ['저장매체', '네트워크', '공간정보장비', 'PC부품', '사무가구'];
     const showNet = (isInfra || isPersonal) && !noNetCategories.includes(category);
-    const hasSN = !['사무가구', 'PC부품'].includes(category);
+    const hasSN = ['외부SW', '내부SW'].includes(category);
+    const showMainboard = category === 'PC';
     const isParts = ['PC부품', '사무가구'].includes(category);
     const showRemote = category === '서버' || type.includes('서버');
+    const showServiceType = category === '서버' || type === '서버PC';
 
     document.querySelectorAll('.remote-section, .remote-field, .monitoring-field').forEach(el => (el as HTMLElement).style.display = showRemote ? '' : 'none');
+    document.querySelectorAll('.service-type-field').forEach(el => (el as HTMLElement).style.display = showServiceType ? '' : 'none');
     document.querySelectorAll('.net-only').forEach(el => (el as HTMLElement).style.display = showNet ? '' : 'none');
     document.querySelectorAll('.spec-only').forEach(el => (el as HTMLElement).style.display = hasSpec ? '' : 'none');
     document.querySelectorAll('.location-section, .location-field').forEach(el => (el as HTMLElement).style.display = (isInfra || category === '공간정보장비') ? '' : 'none');
     document.querySelectorAll('.org-user-section, .org-user-field').forEach(el => (el as HTMLElement).style.display = (isPersonal || isParts || category === '업무지원장비') ? '' : 'none');
     document.querySelectorAll('.personal-only').forEach(el => (el as HTMLElement).style.display = isPersonal ? '' : 'none');
     document.querySelectorAll('.sn-only').forEach(el => (el as HTMLElement).style.display = hasSN ? '' : 'none');
+    document.querySelectorAll('.mainboard-only').forEach(el => (el as HTMLElement).style.display = showMainboard ? '' : 'none');
     document.querySelectorAll('.monitor-only').forEach(el => (el as HTMLElement).style.display = type.includes('모니터') ? '' : 'none');
     document.querySelectorAll('.parts-only').forEach(el => (el as HTMLElement).style.display = isParts ? '' : 'none');
     document.querySelectorAll('.hardware-section').forEach(el => (el as HTMLElement).style.display = (hasSpec || isParts) ? '' : 'none');
+
+    // Lock only User and Organization Information for PC category during edit mode
+    const isEditMode = this.currentMode === 'edit';
+    const isPC = category === 'PC';
+
+    const noticeEl = document.getElementById('hw-pc-workflow-notice');
+    if (noticeEl) {
+      if (isPC && isEditMode) {
+        noticeEl.classList.remove('hidden');
+      } else {
+        noticeEl.classList.add('hidden');
+      }
+    }
+
+    const lockedUserFields = [
+      'hw-current_dept',
+      'hw-manager_primary',
+      'hw-manager_secondary',
+      'hw-user_current',
+      'hw-emp_no',
+      'hw-user_position',
+      'hw-previous_user'
+    ];
+
+    const allFormControls = this.formEl ? this.formEl.querySelectorAll('input, select, textarea, button') : [];
+    
+    allFormControls.forEach(control => {
+      const el = control as HTMLElement;
+      const id = el.id;
+      
+      if (el.tagName === 'INPUT' && (el as HTMLInputElement).type === 'hidden') return;
+      if (id === 'hw-asset_code' || id === 'btn-gen-hw-code') return;
+
+      if (isPC && isEditMode && lockedUserFields.includes(id)) {
+        // Lock user information fields for PC in edit mode
+        if (el.tagName === 'SELECT') {
+          el.setAttribute('disabled', 'true');
+        } else if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') {
+          el.setAttribute('readonly', 'true');
+          (el as HTMLInputElement).style.backgroundColor = '#f1f5f9';
+          (el as HTMLInputElement).style.cursor = 'not-allowed';
+        } else if (el.tagName === 'BUTTON') {
+          el.setAttribute('disabled', 'true');
+        }
+      } else {
+        // Normal behavior based on modal edit/view mode (includes add mode which has this.isEditMode = true)
+        if (!this.isEditMode) {
+          if (el.tagName === 'SELECT') {
+            el.setAttribute('disabled', 'true');
+          } else if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') {
+            el.setAttribute('readonly', 'true');
+            (el as HTMLInputElement).style.backgroundColor = '';
+            (el as HTMLInputElement).style.cursor = '';
+          } else if (el.tagName === 'BUTTON') {
+            if (id !== 'btn-print-hw-qr' && id !== 'btn-close-hw-modal') {
+              el.setAttribute('disabled', 'true');
+            }
+          }
+        } else {
+          if (el.tagName === 'SELECT') {
+            el.removeAttribute('disabled');
+          } else if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') {
+            if (id !== 'hw-emp_no') {
+              el.removeAttribute('readonly');
+              (el as HTMLInputElement).style.backgroundColor = '';
+              (el as HTMLInputElement).style.cursor = '';
+            }
+          } else if (el.tagName === 'BUTTON') {
+            el.removeAttribute('disabled');
+          }
+        }
+      }
+    });
   }
 
   private updateMapButtonVisibility() {
@@ -704,7 +885,7 @@ class HwAssetModal extends BaseModal {
 
   private async fetchMapConfig() {
     try {
-      const res = await fetch(`http://${location.hostname}:3000/api/maps`);
+      const res = await fetch(`${API_BASE_URL}/api/maps`);
       this.dynamicMapConfig = await res.json();
     } catch (err) { console.error('Failed to fetch map config:', err); }
   }
@@ -878,12 +1059,148 @@ class HwAssetModal extends BaseModal {
     overlay.querySelector('#btn-preview-close')?.addEventListener('click', () => overlay.remove());
   }
 
+  private bindUserAutocomplete() {
+    const input = document.getElementById('hw-user_current') as HTMLInputElement;
+    const list = document.getElementById('hw-user-current-list') as HTMLDivElement;
+    const deptSelect = document.getElementById('hw-current_dept') as HTMLSelectElement;
+    const positionInput = document.getElementById('hw-user_position') as HTMLInputElement;
+    const empNoInput = document.getElementById('hw-emp_no') as HTMLInputElement;
+
+    if (!input || !list) return;
+
+    const showList = (filterText: string = '') => {
+      if (!this.isEditMode) return;
+      const category = (document.getElementById('hw-category') as HTMLSelectElement)?.value || '';
+      if (category === 'PC') return;
+      const users = state.masterData.users || [];
+      const query = filterText.trim().toLowerCase();
+      
+      const filtered = query
+        ? users.filter((u: any) => 
+            u.user_name.toLowerCase().includes(query) || 
+            (u.dept_name && u.dept_name.toLowerCase().includes(query)) ||
+            (u.emp_no && u.emp_no.toLowerCase().includes(query))
+          )
+        : users;
+
+      if (filtered.length === 0) {
+        list.innerHTML = '<div class="autocomplete-item" style="color: #94a3b8; cursor: default;">일치하는 사원 없음</div>';
+      } else {
+        const seen = new Set();
+        const uniqueFiltered = filtered.filter((u: any) => {
+          const key = `${u.user_name}-${u.dept_name}-${u.emp_no}`;
+          if (seen.has(key)) return false;
+          seen.add(key);
+          return true;
+        }).slice(0, 15);
+
+        list.innerHTML = uniqueFiltered.map((u: any) => `
+          <div class="autocomplete-item user-suggestion-item" 
+               data-name="${u.user_name}" 
+               data-dept="${u.dept_name || ''}" 
+               data-pos="${u.position || ''}" 
+               data-emp="${u.emp_no || ''}">
+            <div style="font-weight: 600; color: #1e293b;">${u.user_name}</div>
+            <div style="font-size: 0.75rem; color: #64748b; margin-top: 2px;">
+              ${u.dept_name || '부서 없음'} / 사번: ${u.emp_no || '-'} / ${u.position || '직급 없음'}
+            </div>
+          </div>
+        `).join('');
+      }
+      list.classList.remove('hidden');
+    };
+
+    input.addEventListener('focus', () => showList(input.value));
+    input.addEventListener('input', () => showList(input.value));
+
+    list.addEventListener('mousedown', (e) => {
+      const item = (e.target as HTMLElement).closest('.user-suggestion-item');
+      if (item) {
+        const name = item.getAttribute('data-name') || '';
+        const dept = item.getAttribute('data-dept') || '';
+        const pos = item.getAttribute('data-pos') || '';
+        const emp = item.getAttribute('data-emp') || '';
+
+        input.value = name;
+        if (positionInput) positionInput.value = pos;
+        if (empNoInput) empNoInput.value = emp;
+
+        if (deptSelect && dept) {
+          for (let i = 0; i < deptSelect.options.length; i++) {
+            if (deptSelect.options[i].value === dept) {
+              deptSelect.selectedIndex = i;
+              break;
+            }
+          }
+        }
+        list.classList.add('hidden');
+      }
+    });
+
+    document.addEventListener('mousedown', (e) => {
+      if (e.target !== input && !list.contains(e.target as Node)) {
+        list.classList.add('hidden');
+      }
+    });
+  }
+
   private renderHistory(assetId: string) {
     const container = document.getElementById('hw-history-list');
     if (!container) return;
     const logs = (state.masterData.logs || []).filter(l => l.asset_id === assetId);
     if (logs.length === 0) { container.innerHTML = '<div class="empty-history">기록된 변동 이력이 없습니다.</div>'; return; }
-    container.innerHTML = logs.map(l => `<div class="history-item"><div class="history-date">${l.log_date || ''}</div><div class="history-user">${l.log_user || '시스템'}</div><div class="history-details">${l.details}</div></div>`).join('');
+    
+    const createdDate = this.currentAsset?.created_at ? this.currentAsset.created_at.substring(0, 10) : '';
+
+    const grouped: Record<string, typeof logs> = {};
+    logs.forEach(l => {
+      const date = l.log_date || '날짜 미지정';
+      if (!grouped[date]) grouped[date] = [];
+      grouped[date].push(l);
+    });
+
+    container.innerHTML = Object.entries(grouped).map(([date, dateLogs]) => {
+      const entriesHtml = dateLogs.map((l, idx) => {
+        const isLast = idx === dateLogs.length - 1;
+        const borderStyle = isLast ? '' : 'border-bottom: 1px dashed var(--hairline); padding-bottom: 8px; margin-bottom: 8px;';
+        
+        let displayDetails = l.details;
+        if (l.details && l.details.trim().startsWith('{')) {
+          try {
+            const data = JSON.parse(l.details);
+            if (data.type === 'checkout') {
+              displayDetails = `[불출] ${data.user || ''} (${data.dept || ''}) ${data.memo ? `| 메모: ${data.memo}` : ''}`;
+            } else if (data.type === 'return') {
+              displayDetails = `[반납] ${data.user || ''} (${data.dept || ''}) ${data.memo ? `| 메모: ${data.memo}` : ''}`;
+            } else if (data.type === 'move') {
+              displayDetails = `[이동] ${data.user || ''} (${data.dept || ''}) ➔ ${data.targetUser || ''} (${data.targetDept || ''}) ${data.memo ? `| 메모: ${data.memo}` : ''}`;
+            }
+          } catch (e) {}
+        }
+
+        return `
+          <div class="history-entry" style="${borderStyle}">
+            <div style="font-weight: 600; color: var(--primary); opacity: 0.8; margin-bottom: 4px; display: flex; align-items: center; gap: 6px;">
+              <span style="display: inline-block; width: 4px; height: 4px; background-color: var(--primary); border-radius: 50%;"></span>
+              ${l.log_user || '시스템'}
+            </div>
+            <div style="color: var(--primary); padding-left: 10px; line-height: 1.5;">${displayDetails}</div>
+          </div>
+        `;
+      }).join('');
+
+      const isInitialReg = date === createdDate;
+      const regBadge = isInitialReg ? `<span class="badge-reg" style="font-size: 10px; padding: 1px 5px; margin-left: 6px; background-color: rgba(16, 185, 129, 0.1); color: #10b981; border: 1px solid rgba(16, 185, 129, 0.2); border-radius: 4px; font-weight: 600;">최초등록</span>` : '';
+
+      return `
+        <div class="history-item">
+          <div class="history-date" style="display: flex; align-items: center;">${date} ${regBadge}</div>
+          <div class="history-details" style="display: flex; flex-direction: column; gap: 4px;">
+            ${entriesHtml}
+          </div>
+        </div>
+      `;
+    }).join('');
   }
 
   private getCategoryKey(asset: any): string {
@@ -901,7 +1218,7 @@ class HwAssetModal extends BaseModal {
 
   private async fetchMasterComponents(): Promise<void> {
     try {
-      const res = await fetch(`http://${location.hostname}:3000/api/hardware-components`);
+      const res = await fetch(`${API_BASE_URL}/api/hardware-components`);
       this.masterComponents = await res.json();
     } catch (err) { console.error('Failed to fetch master components:', err); }
   }

src/components/Modal/ModalUtils.ts

@@ -125,10 +125,13 @@ export function setEditLock(
     const inputs = form.querySelectorAll('input, select, textarea');
     inputs.forEach(input => {
       const el = input as HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
-      // 자산번호 및 ID 필드는 편집 모드에서도 잠금 유지
+      // 자산번호 및 ID 필드는 편집 모드에서도 잠금 유지 (disabled는 해제하되 readOnly를 적용하여 폼 데이터 수집 가능하게 함)
       if (el.name !== 'asset_code' && !el.id.includes('asset-id') && !el.id.includes('id-hidden')) {
         el.disabled = false;
         if ('readOnly' in el) (el as HTMLInputElement).readOnly = false;
+      } else {
+        el.disabled = false;
+        if ('readOnly' in el) (el as HTMLInputElement).readOnly = true;
       }
     });
 

src/components/Modal/SWModal.ts

@@ -389,7 +389,58 @@ class SwAssetModal extends BaseModal {
     if (!container) return;
     const logs = (state.masterData.logs || []).filter(l => l.asset_id === swId);
     if (logs.length === 0) { container.innerHTML = '<div class="empty-history">수정 이력이 없습니다.</div>'; return; }
-    container.innerHTML = logs.map(l => `<div class="history-item"><div class="history-date">${l.log_date || ''}</div><div class="history-user">${l.log_user || '시스템'}</div><div class="history-details">${l.details}</div></div>`).join('');
+    
+    const createdDate = this.currentAsset?.created_at ? this.currentAsset.created_at.substring(0, 10) : '';
+
+    const grouped: Record<string, typeof logs> = {};
+    logs.forEach(l => {
+      const date = l.log_date || '날짜 미지정';
+      if (!grouped[date]) grouped[date] = [];
+      grouped[date].push(l);
+    });
+
+    container.innerHTML = Object.entries(grouped).map(([date, dateLogs]) => {
+      const entriesHtml = dateLogs.map((l, idx) => {
+        const isLast = idx === dateLogs.length - 1;
+        const borderStyle = isLast ? '' : 'border-bottom: 1px dashed var(--hairline); padding-bottom: 8px; margin-bottom: 8px;';
+        
+        let displayDetails = l.details;
+        if (l.details && l.details.trim().startsWith('{')) {
+          try {
+            const data = JSON.parse(l.details);
+            if (data.type === 'checkout') {
+              displayDetails = `[불출] ${data.user || ''} (${data.dept || ''}) ${data.memo ? `| 메모: ${data.memo}` : ''}`;
+            } else if (data.type === 'return') {
+              displayDetails = `[반납] ${data.user || ''} (${data.dept || ''}) ${data.memo ? `| 메모: ${data.memo}` : ''}`;
+            } else if (data.type === 'move') {
+              displayDetails = `[이동] ${data.user || ''} (${data.dept || ''}) ➔ ${data.targetUser || ''} (${data.targetDept || ''}) ${data.memo ? `| 메모: ${data.memo}` : ''}`;
+            }
+          } catch (e) {}
+        }
+
+        return `
+          <div class="history-entry" style="${borderStyle}">
+            <div style="font-weight: 600; color: var(--primary); opacity: 0.8; margin-bottom: 4px; display: flex; align-items: center; gap: 6px;">
+              <span style="display: inline-block; width: 4px; height: 4px; background-color: var(--primary); border-radius: 50%;"></span>
+              ${l.log_user || '시스템'}
+            </div>
+            <div style="color: var(--primary); padding-left: 10px; line-height: 1.5;">${displayDetails}</div>
+          </div>
+        `;
+      }).join('');
+
+      const isInitialReg = date === createdDate;
+      const regBadge = isInitialReg ? `<span class="badge-reg" style="font-size: 10px; padding: 1px 5px; margin-left: 6px; background-color: rgba(16, 185, 129, 0.1); color: #10b981; border: 1px solid rgba(16, 185, 129, 0.2); border-radius: 4px; font-weight: 600;">최초등록</span>` : '';
+
+      return `
+        <div class="history-item">
+          <div class="history-date" style="display: flex; align-items: center;">${date} ${regBadge}</div>
+          <div class="history-details" style="display: flex; flex-direction: column; gap: 4px;">
+            ${entriesHtml}
+          </div>
+        </div>
+      `;
+    }).join('');
   }
 }
 

src/components/Modal/SharedData.ts

@@ -43,6 +43,7 @@ export const TYPE_PREFIX_MAP: Record<string, string> = {
   '저장매체': 'STM', 'HDD': 'HDD', 'SSD': 'SSD',
   '노트북': 'NBK', '태블릿': 'TAB',
   '드론': 'DRO', '측량장비': 'SUR', '보조기기': 'SUR', '허브': 'NET', 
+  '모니터': 'MON',
   '구독SW': 'SW', '영구SW': 'SW', '내부' : 'SW_INT', '외부':'SW_EXT'
 };
 

src/components/Modal/modal.css

@@ -537,6 +537,8 @@
   background-color: var(--canvas-soft-2);
   border-radius: 4px;
   overflow: hidden;
+  max-width: 100%;
+  max-height: 100%;
 }
 
 .layout-map-container.readonly {
@@ -546,12 +548,15 @@
 .image-marker-wrapper {
   position: relative;
   display: inline-block;
+  max-width: 100%;
+  max-height: 100%;
 }
 
 .layout-map-img {
   display: block;
   max-width: 100%;
-  max-height: 75vh;
+  max-height: 70vh;
+  object-fit: contain;
   user-select: none;
   -webkit-user-drag: none;
 }

src/components/Navigation.ts

@@ -59,11 +59,15 @@ export function renderNavigation(onTabChange: (tab: string) => void) {
     Object.keys(MENU_CONFIG).forEach(catKey => {
       const config = MENU_CONFIG[catKey];
       
-      const visibleTabs = config.tabs.filter((tab: string) => {
+      let visibleTabs = config.tabs.filter((tab: string) => {
         if (state.currentUserRole === 'admin') return tab === '대시보드';
         return tab !== '대시보드';
       });
 
+      if (state.currentUserRole === 'admin' && catKey === 'hw') {
+        visibleTabs = ['대시보드', '관리도구', '실사 승인', '위치지정'];
+      }
+
       if (visibleTabs.length === 0) return;
 
       visibleTabs.forEach((tab: string) => {
@@ -71,29 +75,36 @@ export function renderNavigation(onTabChange: (tab: string) => void) {
         const item = document.createElement('div');
         const isActive = state.activeSubTab === tab;
         item.className = `gnb-trigger ${isActive ? 'active' : ''}`;
+        
+        const isSubMenu = tab === '실사 승인' || tab === '위치지정';
+        if (isSubMenu) {
+          item.innerHTML = `<span style="opacity: 0.5; margin-right: 3px; font-family: sans-serif;">↳</span>${tab}`;
+          item.style.fontSize = '11px';
+          item.style.fontWeight = '500';
+          item.style.marginLeft = '6px';
+          if (!isActive) {
+            item.style.color = 'var(--mute)';
+          }
+        } else {
           item.textContent = tab;
-        item.style.fontSize = 'var(--fs-sm)'; // Ensure small but standard font
+          item.style.fontSize = 'var(--fs-sm)';
+        }
         
         item.addEventListener('click', (e) => {
           e.stopPropagation();
           state.activeCategory = catKey as any;
+          if (tab === '관리도구') {
+            state.activeSubTab = '실사 승인';
+          } else {
             state.activeSubTab = tab;
+          }
           render(); 
-          onTabChange(tab);
+          onTabChange(state.activeSubTab);
         });
         navList.appendChild(item);
       });
     });
 
-    // 3. 관리자 전용 '관리도구'
-    if (state.currentUserRole === 'admin') {
-      const adminTrigger = document.createElement('div');
-      adminTrigger.className = 'gnb-trigger admin-trigger';
-      adminTrigger.innerHTML = '관리도구';
-      adminTrigger.addEventListener('click', () => window.open('/map_editor.html', '_blank'));
-      navList.appendChild(adminTrigger);
-    }
-
     // 4. 이벤트 바인딩
     document.getElementById('btn-home-logo')?.addEventListener('click', () => location.reload());
     

src/core/filterHandler.ts

@@ -52,7 +52,7 @@ export function renderFilterBar(container: HTMLElement, options: FilterOptions)
   };
 
   container.innerHTML = `
-    <div class="search-item flex-1">
+    <div class="search-item keyword-search">
       <label>${keywordLabel}</label>
       <input type="text" id="filter-keyword" placeholder="검색어를 입력하세요..." autocomplete="off" value="${initialFilters.keyword || ''}">
     </div>
@@ -108,6 +108,12 @@ export function renderFilterBar(container: HTMLElement, options: FilterOptions)
     <button id="btn-reset-filters" class="btn btn-outline btn-reset">
       <i data-lucide="refresh-ccw" class="icon-sm"></i> ${UI_TEXT.ACTION.RESET_FILTER}
     </button>
+    <div class="search-item result-count-item">
+      <label>검색 결과</label>
+      <div class="result-count-box">
+        <span id="filter-total-count" class="filter-total-count result-count-text">0개</span>
+      </div>
+    </div>
     ${getActionButtonsHTML()}
   `;
 

src/core/qr_print.ts

@@ -0,0 +1,250 @@
+
+export interface QRPrintItem {
+  type: 'asset' | 'location';
+  code: string;
+  title: string;          // e.g. "[ HM IT ASSET ]" or "[ HM LOCATION ]"
+  subtitle?: string;      // e.g. "가을-PC(i5-12400F)" or "기술개발센터 서버실"
+  dept?: string;          // e.g. "전산" or "B-03 랙"
+  user?: string;          // e.g. "박노석"
+  date?: string;          // e.g. "2024-08-05"
+}
+
+/**
+ * QR 라벨 인쇄 유틸리티 클래스
+ */
+export class QRPrinter {
+  private static styleId = 'qr-print-style';
+  private static containerId = 'label-print-container';
+
+  /**
+   * 인쇄 전용 CSS 스타일 주입
+   */
+  private static injectStyles() {
+    if (document.getElementById(this.styleId)) return;
+
+    const style = document.createElement('style');
+    style.id = this.styleId;
+    style.innerHTML = `
+      /* 화면에서는 인쇄 컨테이너 숨김 */
+      #${this.containerId} {
+        display: none;
+      }
+
+      @media print {
+        /* 화면 내 모든 요소 숨김 */
+        body > *:not(#${this.containerId}) {
+          display: none !important;
+        }
+
+        /* 인쇄 전용 컨테이너 표시 */
+        #${this.containerId} {
+          display: block !important;
+          position: absolute;
+          left: 0;
+          top: 0;
+          width: 50mm;
+          height: 30mm;
+          margin: 0;
+          padding: 0;
+          box-sizing: border-box;
+          background: #fff;
+        }
+
+        /* 페이지 규격 설정 */
+        @page {
+          size: 50mm 30mm;
+          margin: 0;
+        }
+
+        /* 개별 라벨 스타일 */
+        .print-label-item {
+          display: flex !important;
+          flex-direction: row;
+          width: 50mm;
+          height: 30mm;
+          box-sizing: border-box;
+          padding: 2.5mm;
+          page-break-after: always;
+          font-family: 'Pretendard Variable', sans-serif;
+          color: #000;
+          background: #fff;
+          overflow: hidden;
+        }
+
+        .print-label-item:last-child {
+          page-break-after: avoid;
+        }
+
+        /* 왼쪽 명세 영역 */
+        .label-details {
+          width: 30mm;
+          display: flex;
+          flex-direction: column;
+          justify-content: space-between;
+          font-size: 6.5pt;
+          line-height: 1.25;
+          text-align: left;
+          padding-right: 1mm;
+          word-break: break-all;
+        }
+
+        .label-header {
+          font-size: 7.5pt;
+          font-weight: 800;
+          border-bottom: 0.5px solid #000;
+          padding-bottom: 0.5mm;
+          margin-bottom: 0.5mm;
+          color: #000;
+        }
+
+        .label-row {
+          display: flex;
+          margin-bottom: 0.2mm;
+        }
+
+        .label-row .row-title {
+          font-weight: 700;
+          width: 9.5mm;
+          flex-shrink: 0;
+        }
+
+        .label-row .row-value {
+          flex: 1;
+        }
+
+        /* 오른쪽 QR 영역 */
+        .label-qr-wrapper {
+          width: 15mm;
+          display: flex;
+          flex-direction: column;
+          justify-content: center;
+          align-items: center;
+        }
+
+        .label-qr-canvas {
+          width: 14mm !important;
+          height: 14mm !important;
+          display: block;
+        }
+        
+        .label-qr-code-text {
+          font-size: 5.5pt;
+          font-weight: 700;
+          margin-top: 1mm;
+          text-align: center;
+          width: 15mm;
+          overflow: hidden;
+          text-overflow: ellipsis;
+          white-space: nowrap;
+        }
+      }
+    `;
+    document.head.appendChild(style);
+  }
+
+  /**
+   * 라벨 인쇄 실행
+   */
+  public static async print(items: QRPrintItem[]): Promise<void> {
+    if (items.length === 0) return;
+
+    this.injectStyles();
+
+    // 기존 컨테이너 제거
+    const oldContainer = document.getElementById(this.containerId);
+    if (oldContainer) oldContainer.remove();
+
+    // 새 인쇄 컨테이너 생성
+    const container = document.createElement('div');
+    container.id = this.containerId;
+    document.body.appendChild(container);
+
+    for (let i = 0; i < items.length; i++) {
+      const item = items[i];
+      const labelDiv = document.createElement('div');
+      labelDiv.className = 'print-label-item';
+
+      // QR 접속 URL 정의
+      const paramName = item.type === 'asset' ? 'asset' : 'loc';
+      const qrUrl = `${window.location.origin}/mobile?${paramName}=${encodeURIComponent(item.code)}`;
+
+      // HTML 구성
+      if (item.type === 'asset') {
+        labelDiv.innerHTML = `
+          <div class="label-details">
+            <div class="label-header">${item.title}</div>
+            <div class="label-row">
+              <span class="row-title">자산번호 :</span>
+              <span class="row-value">${item.code}</span>
+            </div>
+            <div class="label-row">
+              <span class="row-title">자 산 명 :</span>
+              <span class="row-value">${item.subtitle || '-'}</span>
+            </div>
+            <div class="label-row">
+              <span class="row-title">부    서 :</span>
+              <span class="row-value">${item.dept || '-'}</span>
+            </div>
+            <div class="label-row">
+              <span class="row-title">사 용 자 :</span>
+              <span class="row-value">${item.user || '-'}</span>
+            </div>
+          </div>
+          <div class="label-qr-wrapper">
+            <canvas class="label-qr-canvas" id="qr-canvas-${i}"></canvas>
+            <div class="label-qr-code-text">${item.code}</div>
+          </div>
+        `;
+      } else {
+        // Location 라벨 레이아웃
+        labelDiv.innerHTML = `
+          <div class="label-details" style="justify-content: center; gap: 1mm;">
+            <div class="label-header">${item.title}</div>
+            <div class="label-row">
+              <span class="row-title">위치코드 :</span>
+              <span class="row-value" style="font-weight: 700;">${item.code}</span>
+            </div>
+            <div class="label-row">
+              <span class="row-title">구    역 :</span>
+              <span class="row-value">${item.subtitle || '-'}</span>
+            </div>
+            <div class="label-row">
+              <span class="row-title">상세위치 :</span>
+              <span class="row-value">${item.dept || '-'}</span>
+            </div>
+          </div>
+          <div class="label-qr-wrapper">
+            <canvas class="label-qr-canvas" id="qr-canvas-${i}"></canvas>
+            <div class="label-qr-code-text">${item.code}</div>
+          </div>
+        `;
+      }
+
+      container.appendChild(labelDiv);
+
+      // QR 코드 렌더링
+      const canvas = document.getElementById(`qr-canvas-${i}`) as HTMLCanvasElement;
+      if (canvas) {
+        const qrLib = (window as any).QRCode;
+        if (qrLib) {
+          await qrLib.toCanvas(canvas, qrUrl, {
+            margin: 0,
+            width: 100,
+            errorCorrectionLevel: 'H'
+          });
+        } else {
+          console.error("QRCode library is not loaded on window.");
+        }
+      }
+    }
+
+    // 약간의 딜레이를 주어 QR 코드가 완전히 렌더링되도록 함
+    setTimeout(() => {
+      window.print();
+      // 인쇄 완료 후 컨테이너 정리
+      window.onafterprint = () => {
+        container.remove();
+      };
+    }, 250);
+  }
+}

src/core/state.ts

@@ -45,6 +45,63 @@ export async function loadMasterDataFromDB() {
     
     const data = await response.json();
     
+    // DB의 쪼개진 asset_remote 데이터로부터 가상 대표 속성(IP, MAC, 원격도구)을 주입해주는 전처리 함수
+    const preprocessAssets = (assets: any[]) => {
+      if (!Array.isArray(assets)) return;
+      assets.forEach((asset: any) => {
+        let ip = '';
+        let mac = '';
+        let remoteTool = '';
+        let remoteId = '';
+        let remotePw = '';
+
+        let rems: any[] = [];
+        try {
+          rems = asset.remotes ? (typeof asset.remotes === 'string' ? JSON.parse(asset.remotes) : asset.remotes) : [];
+        } catch(e) {}
+
+        if (Array.isArray(rems)) {
+          rems.forEach((r: any) => {
+            if (r.type === 'IP') {
+              if (!ip) ip = r.val1 || '';
+              if (r.val2) {
+                if (String(r.val2).trim().startsWith('{')) {
+                  try {
+                    const parsed = JSON.parse(r.val2);
+                    remoteTool = r.name || '원격접속';
+                    remoteId = parsed.id || '';
+                    remotePw = parsed.pw || '';
+                  } catch(e) {}
+                } else {
+                  if (!mac) mac = r.val2 || '';
+                }
+              }
+            } else if (r.type === 'MAC') {
+              if (!mac) mac = r.val1 || '';
+            } else if (r.type === 'REMOTE') {
+              if (!remoteTool) remoteTool = r.name || '';
+              if (!remoteId) remoteId = r.val1 || '';
+              if (!remotePw) remotePw = r.val2 || '';
+            }
+          });
+        }
+
+        // 최상위 가상 속성 바인딩 (목록 및 위치보기 뷰어 매핑용)
+        asset.ip_address = ip;
+        asset.mac_address = mac;
+        asset.remote_tool = remoteTool;
+        asset.remote_id = remoteId;
+        asset.remote_pw = remotePw;
+      });
+    };
+
+    if (data) {
+      const keys = ['pc', 'server', 'storage', 'network', 'survey', 'equipment', 'officeSupplies'];
+      keys.forEach(k => {
+        if (data[k]) preprocessAssets(data[k]);
+      });
+    }
+
     // 전역 상태 업데이트
     state.masterData = {
       ...state.masterData,