commit 54707c99a3879b2f371f4d33eb8cfce3cb7609eb
Author: king <king@local>
Date:   Sun May 24 03:07:53 2026 +0900

    초기 커밋: Docker/PostgreSQL 이관, 구글 OAuth 제거, Gitea 푸시 스크립트 추가

diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..bbe49b7
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,11 @@
+venv*
+__pycache__
+*.pyc
+.env
+.git
+.gitignore
+*.db
+*.sqlite*
+node_modules
+.idea
+.vscode
diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..8d24d78
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,28 @@
+# ===== Database (PostgreSQL) =====
+# 앱 컨테이너는 같은 Docker network 안의 postgres-db 컨테이너에 접속합니다.
+DB_HOST=postgres-db
+DB_PORT=5432
+DB_USER=king
+DB_PASSWORD=change-me-strong-password
+
+# 프로젝트별 DB 이름
+ORDER_DB_NAME=orderlist_db
+ITEM_DB_NAME=itemcode_db
+RETURN_DB_NAME=return_db
+CHECKLIST_DB_NAME=checklist_db
+
+# (선택) DATABASE_URL을 직접 지정하면 위 DB_* 값보다 우선 사용됩니다.
+# DATABASE_URL=postgresql+psycopg2://king:password@postgres-db:5432/orderlist_db
+
+# ===== App =====
+APP_ROOT_PATH=
+SESSION_SECRET_KEY=please-change-this-to-a-long-random-string
+
+# ===== Default admin (구글 로그인 제거 후, /login 시 자동 생성/로그인되는 계정) =====
+DEFAULT_ADMIN_EMAIL=king@dbxcorp.co.kr
+DEFAULT_ADMIN_NAME=Administrator
+
+# ===== Docker network =====
+# 이미 운영 중인 postgres-db가 속한 외부 네트워크 이름.
+# `docker inspect postgres-db --format '{{range $k,$v := .NetworkSettings.Networks}}{{$k}}{{end}}'` 로 확인.
+POSTGRES_NETWORK=postgres-net
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..67ec5a6
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,47 @@
+# ===== Secrets / Env =====
+.env
+*.env
+!.env.example
+
+# ===== Python =====
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# ===== Virtual envs =====
+.venv/
+venv/
+venv*/
+env/
+
+# ===== Node =====
+node_modules/
+
+# ===== Logs / runtime =====
+*.log
+logs/
+*.pid
+
+# ===== Local DB / backups =====
+*.db
+*.sqlite
+*.sqlite3
+*.db-journal
+app.db.pre-restore-*.db
+
+# ===== OS junk =====
+.DS_Store
+Thumbs.db
+
+# ===== Editor / IDE =====
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# ===== Docker runtime =====
+*.pid
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..a0f6a81
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,26 @@
+FROM python:3.11-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1
+
+WORKDIR /app
+
+# psycopg2-binary는 빌드툴 없이도 설치 가능하지만, 일부 환경에서 libpq가
+# 필요할 수 있어 런타임 의존성만 가볍게 설치합니다.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends curl ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt ./
+RUN pip install --upgrade pip && pip install -r requirements.txt
+
+COPY app ./app
+COPY static ./static
+
+EXPOSE 8000
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=20s --retries=3 \
+    CMD curl -fsS http://localhost:8000/health/db || exit 1
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--proxy-headers"]
diff --git a/app/__init__.py b/app/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/app/auth.py b/app/auth.py
new file mode 100644
index 0000000..a8324b5
--- /dev/null
+++ b/app/auth.py
@@ -0,0 +1,76 @@
+import os
+
+from fastapi import APIRouter, Depends, HTTPException, Request, status
+from fastapi.responses import RedirectResponse
+from sqlalchemy.orm import Session
+
+from app.database import get_db
+from app.models import User
+
+router = APIRouter(tags=["auth"])
+
+
+DEFAULT_ADMIN_EMAIL = os.getenv("DEFAULT_ADMIN_EMAIL", "king@dbxcorp.co.kr")
+DEFAULT_ADMIN_NAME = os.getenv("DEFAULT_ADMIN_NAME", "Administrator")
+
+
+def app_path(path: str = "/") -> str:
+    root_path = os.getenv("APP_ROOT_PATH", "").rstrip("/")
+    if path == "/":
+        return root_path or "/"
+    return f"{root_path}{path}"
+
+
+def get_current_user(request: Request, db: Session = Depends(get_db)):
+    user_email = request.session.get("user_email")
+    if not user_email:
+        raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="Not authenticated")
+
+    user = db.query(User).filter(User.email == user_email).first()
+    if not user:
+        raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="User not found")
+
+    if not user.is_approved and not user.is_admin:
+        raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail="User is not approved by administrator")
+
+    return user
+
+
+def get_admin_user(current_user: User = Depends(get_current_user)):
+    if not current_user.is_admin:
+        raise HTTPException(status_code=status.HTTP_403_FORBIDDEN, detail="Admin access required")
+    return current_user
+
+
+def _login_as_default_admin(request: Request, db: Session) -> RedirectResponse:
+    email = DEFAULT_ADMIN_EMAIL
+    user = db.query(User).filter(User.email == email).first()
+    if not user:
+        user = User(email=email, name=DEFAULT_ADMIN_NAME, is_admin=True, is_approved=True)
+        db.add(user)
+        db.commit()
+        db.refresh(user)
+
+    request.session["user_email"] = email
+    return RedirectResponse(url=app_path("/"))
+
+
+@router.get("/login")
+async def login(request: Request, db: Session = Depends(get_db)):
+    return _login_as_default_admin(request, db)
+
+
+@router.get("/login/test")
+async def login_test(request: Request, db: Session = Depends(get_db)):
+    return _login_as_default_admin(request, db)
+
+
+@router.get("/logout")
+async def logout(request: Request):
+    request.session.pop("user_email", None)
+    return RedirectResponse(url=app_path("/"))
+
+
+@router.get("/api/users/me")
+async def read_users_me(current_user: User = Depends(get_current_user)):
+    return {"email": current_user.email, "name": current_user.name, "is_admin": current_user.is_admin}
diff --git a/app/database.py b/app/database.py
new file mode 100644
index 0000000..362e7dd
--- /dev/null
+++ b/app/database.py
@@ -0,0 +1,113 @@
+import logging
+import os
+from urllib.parse import quote_plus
+
+from sqlalchemy import create_engine, text
+from sqlalchemy.orm import declarative_base, sessionmaker
+
+logger = logging.getLogger(__name__)
+
+
+def load_env_file(path: str = ".env"):
+    if not os.path.exists(path):
+        return
+
+    with open(path, "r", encoding="utf-8") as env_file:
+        for raw_line in env_file:
+            line = raw_line.strip()
+            if not line or line.startswith("#") or "=" not in line:
+                continue
+
+            key, value = line.split("=", 1)
+            key = key.strip()
+            value = value.strip().strip('"').strip("'")
+            if key and key not in os.environ:
+                os.environ[key] = value
+
+
+load_env_file()
+
+
+def _build_pg_url(db_name: str) -> str:
+    user = os.getenv("DB_USER", "")
+    password = os.getenv("DB_PASSWORD", "")
+    host = os.getenv("DB_HOST", "localhost")
+    port = os.getenv("DB_PORT", "5432")
+    return (
+        f"postgresql+psycopg2://{quote_plus(user)}:{quote_plus(password)}"
+        f"@{host}:{port}/{db_name}"
+    )
+
+
+def _resolve_database_url() -> str:
+    explicit_url = os.getenv("DATABASE_URL")
+    if explicit_url:
+        return explicit_url
+
+    order_db = os.getenv("ORDER_DB_NAME")
+    if order_db and os.getenv("DB_HOST"):
+        return _build_pg_url(order_db)
+
+    return "sqlite:///./app.db"
+
+
+DATABASE_URL = _resolve_database_url()
+
+connect_args = {}
+engine_kwargs = {}
+if DATABASE_URL.startswith("sqlite"):
+    connect_args = {"check_same_thread": False, "timeout": 30}
+else:
+    engine_kwargs.update(pool_pre_ping=True, pool_recycle=1800)
+
+engine = create_engine(DATABASE_URL, connect_args=connect_args, **engine_kwargs)
+
+SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
+
+Base = declarative_base()
+
+
+# --- Secondary engines for the other PostgreSQL databases ----------------
+# These are exposed for code that needs to query item / return / checklist
+# databases. They are created lazily and only when PostgreSQL is configured.
+_secondary_engines: dict[str, object] = {}
+
+
+def get_secondary_engine(env_var: str):
+    """Get (or create) an engine for ITEM_DB_NAME / RETURN_DB_NAME / CHECKLIST_DB_NAME."""
+    db_name = os.getenv(env_var)
+    if not db_name or not os.getenv("DB_HOST"):
+        return None
+    if env_var in _secondary_engines:
+        return _secondary_engines[env_var]
+    eng = create_engine(_build_pg_url(db_name), pool_pre_ping=True, pool_recycle=1800)
+    _secondary_engines[env_var] = eng
+    return eng
+
+
+# Dependency for FastAPI to get DB session
+def get_db():
+    db = SessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()
+
+
+def check_db_connection() -> tuple[bool, str]:
+    """Ping the primary database. Returns (ok, message)."""
+    try:
+        with engine.connect() as conn:
+            conn.execute(text("SELECT 1"))
+        return True, "ok"
+    except Exception as exc:  # noqa: BLE001
+        return False, str(exc)
+
+
+def log_db_startup_status() -> None:
+    safe_url = engine.url.render_as_string(hide_password=True)
+    ok, msg = check_db_connection()
+    if ok:
+        logger.warning("[DB] Connected: %s", safe_url)
+    else:
+        logger.error("[DB] Connection FAILED: %s -> %s", safe_url, msg)
diff --git a/app/database_maintenance.py b/app/database_maintenance.py
new file mode 100644
index 0000000..ff07ca5
--- /dev/null
+++ b/app/database_maintenance.py
@@ -0,0 +1,278 @@
+from sqlalchemy import inspect, text
+
+
+SEARCH_OPTIMIZATION_VERSION = "2026-04-24-search-v1"
+PHONE_FTS_VERSION = "2026-04-24-phone-fts-v1"
+ADDRESS_NORMALIZATION_VERSION = "2026-04-29-address-normalized-v1"
+
+
+def _supports_trigram_fts(conn) -> bool:
+    try:
+        conn.execute(
+            text(
+                "CREATE VIRTUAL TABLE IF NOT EXISTS temp_fts_trigram_check "
+                "USING fts5(value, tokenize='trigram')"
+            )
+        )
+        conn.execute(text("DROP TABLE IF EXISTS temp_fts_trigram_check"))
+        return True
+    except Exception:
+        return False
+
+
+def _setting_value(conn, key: str) -> str | None:
+    row = conn.execute(
+        text("SELECT value FROM settings WHERE key = :key"), {"key": key}
+    ).fetchone()
+    return row[0] if row else None
+
+
+def _set_setting(conn, key: str, value: str) -> None:
+    conn.execute(
+        text(
+            "INSERT INTO settings(key, value) VALUES (:key, :value) "
+            "ON CONFLICT(key) DO UPDATE SET value = excluded.value"
+        ),
+        {"key": key, "value": value},
+    )
+
+
+def ensure_search_optimizations(engine) -> None:
+    if engine.dialect.name != "sqlite":
+        ensure_standard_indexes(engine)
+        return
+
+    inspector = inspect(engine)
+    existing_columns = {column["name"] for column in inspector.get_columns("orders")}
+
+    with engine.begin() as conn:
+        needs_rebuild = _setting_value(conn, "search_optimization_version") != SEARCH_OPTIMIZATION_VERSION
+        if needs_rebuild:
+            conn.execute(text("DROP TRIGGER IF EXISTS orders_fts_ai"))
+            conn.execute(text("DROP TRIGGER IF EXISTS orders_fts_ad"))
+            conn.execute(text("DROP TRIGGER IF EXISTS orders_fts_au"))
+            conn.execute(text("DROP TABLE IF EXISTS orders_name_address_fts"))
+
+        if "recipient_phone_normalized" not in existing_columns:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN recipient_phone_normalized TEXT"))
+        if "recipient_mobile_normalized" not in existing_columns:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN recipient_mobile_normalized TEXT"))
+        if "tracking_number_normalized" not in existing_columns:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN tracking_number_normalized TEXT"))
+        if "address_normalized" not in existing_columns:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN address_normalized TEXT"))
+        added_customer_note = "customer_note" not in existing_columns
+        if added_customer_note:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN customer_note TEXT"))
+        if "order_note" not in existing_columns:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN order_note TEXT"))
+
+        conn.execute(
+            text(
+                "CREATE INDEX IF NOT EXISTS ix_orders_phone_normalized "
+                "ON orders(recipient_phone_normalized)"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE INDEX IF NOT EXISTS ix_orders_mobile_normalized "
+                "ON orders(recipient_mobile_normalized)"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE INDEX IF NOT EXISTS ix_orders_tracking_normalized "
+                "ON orders(tracking_number_normalized)"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE INDEX IF NOT EXISTS ix_orders_address_normalized "
+                "ON orders(address_normalized)"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE INDEX IF NOT EXISTS ix_orders_customer_note "
+                "ON orders(customer_note)"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE INDEX IF NOT EXISTS ix_orders_order_note "
+                "ON orders(order_note)"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE INDEX IF NOT EXISTS ix_orders_tracking_number_id "
+                "ON orders(tracking_number, id DESC)"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE INDEX IF NOT EXISTS ix_orders_upload_date_id "
+                "ON orders(upload_date, id DESC)"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE INDEX IF NOT EXISTS ix_orders_order_date_id "
+                "ON orders(order_date, id DESC)"
+            )
+        )
+
+        if needs_rebuild:
+            conn.execute(
+                text(
+                    "UPDATE orders SET "
+                    "recipient_phone_normalized = replace(replace(replace(replace(replace(coalesce(recipient_phone, ''), '-', ''), ' ', ''), '.', ''), ')', ''), '(', ''), "
+                    "recipient_mobile_normalized = replace(replace(replace(replace(replace(coalesce(recipient_mobile, ''), '-', ''), ' ', ''), '.', ''), ')', ''), '(', ''), "
+                    "tracking_number_normalized = upper(replace(replace(replace(replace(coalesce(tracking_number, ''), '-', ''), ' ', ''), '/', ''), '.', ''))"
+                )
+            )
+        if added_customer_note:
+            conn.execute(
+                text(
+                    "UPDATE orders SET customer_note = note "
+                    "WHERE note IS NOT NULL AND note != ''"
+                )
+            )
+
+        address_normalization_rebuild = (
+            _setting_value(conn, "address_normalization_version") != ADDRESS_NORMALIZATION_VERSION
+        )
+        if address_normalization_rebuild:
+            conn.execute(
+                text(
+                    "UPDATE orders SET address_normalized = "
+                    "trim(coalesce(address, ''), "
+                    "' ' || char(9) || char(10) || char(13) || char(160) || "
+                    "char(8203) || char(8204) || char(8205) || char(65279))"
+                )
+            )
+            _set_setting(conn, "address_normalization_version", ADDRESS_NORMALIZATION_VERSION)
+
+        tokenizer = "trigram" if _supports_trigram_fts(conn) else "unicode61"
+        conn.execute(
+            text(
+                "CREATE VIRTUAL TABLE IF NOT EXISTS orders_name_address_fts "
+                "USING fts5("
+                "recipient_name, address, "
+                "content='orders', content_rowid='id', "
+                f"tokenize='{tokenizer}'"
+                ")"
+            )
+        )
+
+        if needs_rebuild:
+            conn.execute(text("INSERT INTO orders_name_address_fts(orders_name_address_fts) VALUES('rebuild')"))
+            _set_setting(conn, "search_optimization_version", SEARCH_OPTIMIZATION_VERSION)
+
+        conn.execute(
+            text(
+                "CREATE TRIGGER IF NOT EXISTS orders_fts_ai AFTER INSERT ON orders BEGIN "
+                "INSERT INTO orders_name_address_fts(rowid, recipient_name, address) "
+                "VALUES (new.id, new.recipient_name, new.address); "
+                "END"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE TRIGGER IF NOT EXISTS orders_fts_ad AFTER DELETE ON orders BEGIN "
+                "INSERT INTO orders_name_address_fts(orders_name_address_fts, rowid, recipient_name, address) "
+                "VALUES('delete', old.id, old.recipient_name, old.address); "
+                "END"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE TRIGGER IF NOT EXISTS orders_fts_au AFTER UPDATE ON orders BEGIN "
+                "INSERT INTO orders_name_address_fts(orders_name_address_fts, rowid, recipient_name, address) "
+                "VALUES('delete', old.id, old.recipient_name, old.address); "
+                "INSERT INTO orders_name_address_fts(rowid, recipient_name, address) "
+                "VALUES (new.id, new.recipient_name, new.address); "
+                "END"
+            )
+        )
+
+        phone_fts_rebuild = _setting_value(conn, "phone_fts_version") != PHONE_FTS_VERSION
+        if phone_fts_rebuild:
+            conn.execute(text("DROP TRIGGER IF EXISTS orders_phone_fts_ai"))
+            conn.execute(text("DROP TRIGGER IF EXISTS orders_phone_fts_ad"))
+            conn.execute(text("DROP TRIGGER IF EXISTS orders_phone_fts_au"))
+            conn.execute(text("DROP TABLE IF EXISTS orders_phone_fts"))
+        conn.execute(
+            text(
+                "CREATE VIRTUAL TABLE IF NOT EXISTS orders_phone_fts "
+                "USING fts5("
+                "recipient_phone_normalized, recipient_mobile_normalized, "
+                "content='orders', content_rowid='id', tokenize='trigram'"
+                ")"
+            )
+        )
+        if phone_fts_rebuild:
+            conn.execute(text("INSERT INTO orders_phone_fts(orders_phone_fts) VALUES('rebuild')"))
+            _set_setting(conn, "phone_fts_version", PHONE_FTS_VERSION)
+        conn.execute(
+            text(
+                "CREATE TRIGGER IF NOT EXISTS orders_phone_fts_ai AFTER INSERT ON orders BEGIN "
+                "INSERT INTO orders_phone_fts(rowid, recipient_phone_normalized, recipient_mobile_normalized) "
+                "VALUES (new.id, new.recipient_phone_normalized, new.recipient_mobile_normalized); "
+                "END"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE TRIGGER IF NOT EXISTS orders_phone_fts_ad AFTER DELETE ON orders BEGIN "
+                "INSERT INTO orders_phone_fts(orders_phone_fts, rowid, recipient_phone_normalized, recipient_mobile_normalized) "
+                "VALUES('delete', old.id, old.recipient_phone_normalized, old.recipient_mobile_normalized); "
+                "END"
+            )
+        )
+        conn.execute(
+            text(
+                "CREATE TRIGGER IF NOT EXISTS orders_phone_fts_au AFTER UPDATE ON orders BEGIN "
+                "INSERT INTO orders_phone_fts(orders_phone_fts, rowid, recipient_phone_normalized, recipient_mobile_normalized) "
+                "VALUES('delete', old.id, old.recipient_phone_normalized, old.recipient_mobile_normalized); "
+                "INSERT INTO orders_phone_fts(rowid, recipient_phone_normalized, recipient_mobile_normalized) "
+                "VALUES (new.id, new.recipient_phone_normalized, new.recipient_mobile_normalized); "
+                "END"
+            )
+        )
+
+
+def ensure_standard_indexes(engine) -> None:
+    inspector = inspect(engine)
+    existing_columns = {column["name"] for column in inspector.get_columns("orders")}
+
+    with engine.begin() as conn:
+        if "recipient_phone_normalized" not in existing_columns:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN recipient_phone_normalized VARCHAR"))
+        if "recipient_mobile_normalized" not in existing_columns:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN recipient_mobile_normalized VARCHAR"))
+        if "tracking_number_normalized" not in existing_columns:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN tracking_number_normalized VARCHAR"))
+        if "address_normalized" not in existing_columns:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN address_normalized VARCHAR"))
+        added_customer_note = "customer_note" not in existing_columns
+        if added_customer_note:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN customer_note VARCHAR"))
+        if "order_note" not in existing_columns:
+            conn.execute(text("ALTER TABLE orders ADD COLUMN order_note VARCHAR"))
+
+        conn.execute(text("CREATE INDEX IF NOT EXISTS ix_orders_phone_normalized ON orders(recipient_phone_normalized)"))
+        conn.execute(text("CREATE INDEX IF NOT EXISTS ix_orders_mobile_normalized ON orders(recipient_mobile_normalized)"))
+        conn.execute(text("CREATE INDEX IF NOT EXISTS ix_orders_tracking_normalized ON orders(tracking_number_normalized)"))
+        conn.execute(text("CREATE INDEX IF NOT EXISTS ix_orders_address_normalized ON orders(address_normalized)"))
+        conn.execute(text("CREATE INDEX IF NOT EXISTS ix_orders_customer_note ON orders(customer_note)"))
+        conn.execute(text("CREATE INDEX IF NOT EXISTS ix_orders_order_note ON orders(order_note)"))
+        conn.execute(text("CREATE INDEX IF NOT EXISTS ix_orders_order_date_id ON orders(order_date, id DESC)"))
+        conn.execute(text("CREATE INDEX IF NOT EXISTS ix_orders_upload_date_id ON orders(upload_date, id DESC)"))
+        if added_customer_note:
+            conn.execute(
+                text(
+                    "UPDATE orders SET customer_note = note "
+                    "WHERE note IS NOT NULL AND note != ''"
+                )
+            )
diff --git a/app/event_logger.py b/app/event_logger.py
new file mode 100644
index 0000000..54fbafa
--- /dev/null
+++ b/app/event_logger.py
@@ -0,0 +1,43 @@
+import csv
+import json
+import os
+from datetime import datetime
+from zoneinfo import ZoneInfo
+
+
+LOG_DIR = "logs"
+EVENT_LOG_PATH = os.path.join(LOG_DIR, "event_log.csv")
+LOG_COLUMNS = ["date", "time", "user", "action", "status", "details"]
+KST = ZoneInfo("Asia/Seoul")
+
+
+def user_label(user) -> str:
+    if not user:
+        return ""
+    return getattr(user, "email", None) or getattr(user, "name", None) or str(getattr(user, "id", ""))
+
+
+def log_event(user, action: str, status: str = "success", details: dict | str | None = None):
+    os.makedirs(LOG_DIR, exist_ok=True)
+    now = datetime.now(KST)
+    file_exists = os.path.exists(EVENT_LOG_PATH)
+    details_text = ""
+    if isinstance(details, dict):
+        details_text = json.dumps(details, ensure_ascii=False)
+    elif details is not None:
+        details_text = str(details)
+
+    with open(EVENT_LOG_PATH, "a", encoding="utf-8-sig", newline="") as f:
+        writer = csv.DictWriter(f, fieldnames=LOG_COLUMNS)
+        if not file_exists or os.path.getsize(EVENT_LOG_PATH) == 0:
+            writer.writeheader()
+        writer.writerow(
+            {
+                "date": now.strftime("%Y-%m-%d"),
+                "time": now.strftime("%H:%M:%S"),
+                "user": user_label(user),
+                "action": action,
+                "status": status,
+                "details": details_text,
+            }
+        )
diff --git a/app/main.py b/app/main.py
new file mode 100644
index 0000000..6c4257a
--- /dev/null
+++ b/app/main.py
@@ -0,0 +1,61 @@
+from fastapi import FastAPI, Depends, Request
+from fastapi.staticfiles import StaticFiles
+from fastapi.responses import HTMLResponse, JSONResponse
+from starlette.middleware.sessions import SessionMiddleware
+import logging
+import os
+
+from app.database import engine, Base, check_db_connection, log_db_startup_status
+from app.database_maintenance import ensure_search_optimizations
+from app.routers import orders, settings
+from app.auth import router as auth_router
+
+logging.basicConfig(level=logging.INFO)
+
+APP_ROOT_PATH = os.getenv("APP_ROOT_PATH", "").rstrip("/")
+
+# Verify DB connectivity at startup (log only — do not crash so the
+# container can stay up and report status via /health/db).
+log_db_startup_status()
+
+# Create all DB tables
+Base.metadata.create_all(bind=engine)
+ensure_search_optimizations(engine)
+
+app = FastAPI(title="Order Management System", root_path=APP_ROOT_PATH)
+
+
+@app.get("/health/db")
+async def health_db():
+    ok, msg = check_db_connection()
+    status_code = 200 if ok else 503
+    return JSONResponse({"ok": ok, "detail": msg}, status_code=status_code)
+
+# Session middleware for OAuth
+# In production, use a secure secret key from environment variables
+app.add_middleware(SessionMiddleware, secret_key=os.getenv("SESSION_SECRET_KEY", "super-secret-key"))
+
+# Include routers
+app.include_router(auth_router)
+app.include_router(orders.router, prefix="/api/orders", tags=["orders"])
+app.include_router(settings.router, prefix="/api/settings", tags=["settings"])
+
+# Mount static files for frontend
+os.makedirs("static", exist_ok=True)
+app.mount("/static", StaticFiles(directory="static"), name="static")
+
+@app.get("/", response_class=HTMLResponse)
+async def read_root():
+    # Return the main index.html file
+    if os.path.exists("static/index.html"):
+        with open("static/index.html", "r", encoding="utf-8") as f:
+            content = f.read()
+            content = content.replace("__APP_BASE_PATH__", APP_ROOT_PATH)
+            content = content.replace('src="/static/', f'src="{APP_ROOT_PATH}/static/' if APP_ROOT_PATH else 'src="/static/')
+            content = content.replace('href="/static/', f'href="{APP_ROOT_PATH}/static/' if APP_ROOT_PATH else 'href="/static/')
+            content = content.replace("window.location.href='/login", f"window.location.href='{APP_ROOT_PATH}/login")
+            content = content.replace('window.location.href="/login', f'window.location.href="{APP_ROOT_PATH}/login')
+            content = content.replace("window.location.href='/logout", f"window.location.href='{APP_ROOT_PATH}/logout")
+            content = content.replace('window.location.href="/logout', f'window.location.href="{APP_ROOT_PATH}/logout')
+            return HTMLResponse(content=content)
+    return HTMLResponse(content="<h1>Welcome. static/index.html is missing.</h1>")
diff --git a/app/models.py b/app/models.py
new file mode 100644
index 0000000..146251e
--- /dev/null
+++ b/app/models.py
@@ -0,0 +1,54 @@
+from sqlalchemy import Column, Integer, String, Boolean
+from .database import Base
+
+class Order(Base):
+    __tablename__ = "orders"
+
+    id = Column(Integer, primary_key=True, index=True)
+    order_date = Column(String, nullable=True)     # 주문날짜
+    sequence_num = Column(String, nullable=True)   # 번호
+    order_no = Column(String, nullable=True)       # 주문번호
+    order_no_mall = Column(String, nullable=True)  # 주문번호(쇼핑몰)
+    recipient_name = Column(String, index=True, nullable=True)  # 수령인명
+    product_code = Column(String, nullable=True)   # 상품코드
+    product_name = Column(String, nullable=True)   # 상품명
+    order_quantity = Column(String, nullable=True) # 주문수량
+    address = Column(String, index=True, nullable=True) # 주소
+    address_normalized = Column(String, index=True, nullable=True)
+    postal_code = Column(String, nullable=True)    # 우편번호
+    recipient_phone = Column(String, nullable=True) # 수령인 전화번호 (일반전화)
+    recipient_mobile = Column(String, index=True, nullable=True) # 수령인 휴대폰
+    recipient_phone_normalized = Column(String, index=True, nullable=True)
+    recipient_mobile_normalized = Column(String, index=True, nullable=True)
+    delivery_memo = Column(String, nullable=True)  # 배송시 요구사항
+    tracking_number = Column(String, index=True, nullable=True) # 송장번호
+    tracking_number_normalized = Column(String, index=True, nullable=True)
+    vendor = Column(String, nullable=True)         # 발주처
+    order_list_1 = Column(String, nullable=True)   # 주문목록
+    order_list_2 = Column(String, nullable=True)   # 주문목록2
+    note = Column(String, index=True)           # 비고 (옵션)
+    customer_note = Column(String, index=True, nullable=True)  # 고객 메모
+    order_note = Column(String, index=True, nullable=True)     # 주문 메모
+    upload_date = Column(String, nullable=True)     # 추가된 날짜 및 시간 (yyyy-MM-dd HH:mm:ss)
+
+class User(Base):
+    """
+    Users table for Google Workspace authentication.
+    Only approved users can access the system.
+    """
+    __tablename__ = "users"
+
+    id = Column(Integer, primary_key=True, index=True)
+    email = Column(String, unique=True, index=True, nullable=False)
+    name = Column(String, nullable=True)
+    is_admin = Column(Boolean, default=False)
+    is_approved = Column(Boolean, default=False)
+
+class Setting(Base):
+    """
+    Application settings (e.g., Excel export path)
+    """
+    __tablename__ = "settings"
+
+    key = Column(String, primary_key=True, index=True)
+    value = Column(String, nullable=True)
diff --git a/app/routers/__init__.py b/app/routers/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/app/routers/orders.py b/app/routers/orders.py
new file mode 100644
index 0000000..3ab659a
--- /dev/null
+++ b/app/routers/orders.py
@@ -0,0 +1,1059 @@
+import io
+import json
+import math
+import os
+import threading
+from types import SimpleNamespace
+from typing import Optional
+from datetime import date, datetime
+import asyncio
+import httpx
+import pandas as pd
+from fastapi import APIRouter, Depends, HTTPException, File, Form, UploadFile
+from fastapi.responses import Response, StreamingResponse
+from pydantic import BaseModel
+from sqlalchemy.orm import Session
+from sqlalchemy import String, and_, cast, func, or_, text
+from urllib.parse import quote
+
+from app.database import SessionLocal, get_db
+from app.models import Order
+from app.auth import get_current_user
+from app.event_logger import log_event
+from app.search_utils import (
+    can_use_trigram_fts,
+    fts_phrase,
+    normalize_phone,
+    normalize_tracking,
+    prefix_upper_bound,
+)
+
+router = APIRouter()
+CS_RETURN_REQUEST_URL = os.getenv(
+    "CS_RETURN_REQUEST_URL",
+    "http://127.0.0.1:8001/api/return/request",
+)
+
+# Global dict to hold upload progress. In a real world scenario this should be in Redis or DB.
+upload_progress_state = {}
+
+TEMPLATE_COLUMN_ALIASES = {
+    "order_date": ["주문날짜"],
+    "sequence_num": ["번호"],
+    "order_no": ["주문번호"],
+    "recipient_name": ["수령인명"],
+    "product_code": ["상품코드"],
+    "product_name": ["상품명"],
+    "order_quantity": ["수량"],
+    "address": ["주소"],
+    "postal_code": ["우편번호"],
+    "recipient_phone": ["수령인전화번호", "수령인전화"],
+    "recipient_mobile": ["수령인휴대폰"],
+    "delivery_memo": ["배송시요구사항", "배송시요구"],
+    "tracking_number": ["송장번호"],
+    "vendor": ["쇼핑몰명"],
+    "order_note": ["비고"],
+    "order_no_mall": ["주문번호(쇼핑몰)"],
+    "order_list_1": ["주문목록"],
+}
+
+TEMPLATE_COLUMN_FALLBACK_INDEXES = {
+    "order_no_mall": 15,  # Excel P column
+    "order_list_1": 16,   # Excel Q column
+}
+
+REQUIRED_TEMPLATE_FIELDS = [
+    "order_date",
+    "order_no",
+    "recipient_name",
+    "product_code",
+    "product_name",
+    "order_quantity",
+    "address",
+    "recipient_mobile",
+    "tracking_number",
+    "vendor",
+]
+
+
+def normalize_template_column(value) -> str:
+    return str(value).replace("\n", "").replace(" ", "").strip()
+
+
+def clean_excel_value(value) -> str | None:
+    if value is None or pd.isna(value):
+        return None
+    if isinstance(value, datetime):
+        return value.strftime("%Y-%m-%d %H:%M:%S")
+    if isinstance(value, date):
+        return datetime.combine(value, datetime.min.time()).strftime("%Y-%m-%d %H:%M:%S")
+    text = str(value).strip()
+    return text or None
+
+
+def find_template_columns(raw_columns) -> dict[str, int]:
+    normalized_columns = [normalize_template_column(column) for column in raw_columns]
+    column_map = {}
+
+    for field, aliases in TEMPLATE_COLUMN_ALIASES.items():
+        normalized_aliases = [normalize_template_column(alias) for alias in aliases]
+        for alias in normalized_aliases:
+            if alias in normalized_columns:
+                column_map[field] = normalized_columns.index(alias)
+                break
+
+    for field, column_index in TEMPLATE_COLUMN_FALLBACK_INDEXES.items():
+        if field not in column_map and column_index < len(normalized_columns):
+            column_map[field] = column_index
+
+    missing_required = [
+        TEMPLATE_COLUMN_ALIASES[field][0]
+        for field in REQUIRED_TEMPLATE_FIELDS
+        if field not in column_map
+    ]
+    if missing_required:
+        raise ValueError("템플릿 필수 컬럼이 없습니다: " + ", ".join(missing_required))
+
+    return column_map
+
+
+def row_value(row_values, column_map: dict[str, int], field: str) -> str | None:
+    index = column_map.get(field)
+    if index is None or index >= len(row_values):
+        return None
+    return clean_excel_value(row_values[index])
+
+
+def normalize_address_key(value) -> str:
+    if not value:
+        return ""
+    return str(value).strip(" \t\r\n\u00a0\u200b\u200c\u200d\ufeff")
+
+
+def is_manual_vendor(value) -> bool:
+    return str(value or "").replace(" ", "") == "수동발주"
+
+
+def set_upload_state(
+    user_id: str,
+    *,
+    status: str,
+    message: str,
+    upload_progress: int = 0,
+    index_progress: int = 0,
+    total_rows: int = 0,
+    processed_rows: int = 0,
+    indexed_rows: int = 0,
+):
+    upload_progress_state[user_id] = {
+        "status": status,
+        "message": message,
+        "upload_progress": max(0, min(100, int(upload_progress))),
+        "index_progress": max(0, min(100, int(index_progress))),
+        "total_rows": int(total_rows or 0),
+        "processed_rows": int(processed_rows or 0),
+        "indexed_rows": int(indexed_rows or 0),
+    }
+
+
+def set_upload_error(user_id: str, message: str):
+    previous = upload_progress_state.get(user_id, {})
+    set_upload_state(
+        user_id,
+        status="error",
+        message=message,
+        upload_progress=previous.get("upload_progress", 0),
+        index_progress=previous.get("index_progress", 0),
+        total_rows=previous.get("total_rows", 0),
+        processed_rows=previous.get("processed_rows", 0),
+        indexed_rows=previous.get("indexed_rows", 0),
+    )
+
+
+def build_order_search_query(
+    db: Session,
+    *,
+    name: Optional[str] = None,
+    tracking: Optional[str] = None,
+    phone: Optional[str] = None,
+    address: Optional[str] = None,
+    order_start_date: Optional[str] = None,
+    order_end_date: Optional[str] = None,
+):
+    query = db.query(Order)
+    params = {}
+    is_sqlite = db.get_bind().dialect.name == "sqlite"
+
+    if name:
+        if is_sqlite and can_use_trigram_fts(name):
+            params["name_fts"] = f"recipient_name:{fts_phrase(name)}"
+            query = query.filter(
+                text(
+                    "orders.id IN ("
+                    "SELECT rowid FROM orders_name_address_fts "
+                    "WHERE orders_name_address_fts MATCH :name_fts"
+                    ")"
+                )
+            )
+        else:
+            query = query.filter(Order.recipient_name.ilike(f"%{name}%"))
+    if tracking:
+        clean_tracking = normalize_tracking(tracking)
+        if clean_tracking:
+            tracking_upper = prefix_upper_bound(clean_tracking)
+            if tracking_upper:
+                query = query.filter(
+                    Order.tracking_number_normalized >= clean_tracking,
+                    Order.tracking_number_normalized < tracking_upper,
+                )
+            else:
+                query = query.filter(Order.tracking_number_normalized == clean_tracking)
+    if phone:
+        clean_phone = normalize_phone(phone)
+        if clean_phone:
+            if is_sqlite and can_use_trigram_fts(clean_phone):
+                params["phone_fts"] = (
+                    f"recipient_phone_normalized:{fts_phrase(clean_phone)} OR "
+                    f"recipient_mobile_normalized:{fts_phrase(clean_phone)}"
+                )
+                query = query.filter(
+                    text(
+                        "orders.id IN ("
+                        "SELECT rowid FROM orders_phone_fts "
+                        "WHERE orders_phone_fts MATCH :phone_fts"
+                        ")"
+                    )
+                )
+            else:
+                query = query.filter(
+                    or_(
+                        Order.recipient_phone_normalized.like(f"%{clean_phone}%"),
+                        Order.recipient_mobile_normalized.like(f"%{clean_phone}%"),
+                    )
+                )
+    if address:
+        if is_sqlite and can_use_trigram_fts(address):
+            params["address_fts"] = f"address:{fts_phrase(address)}"
+            query = query.filter(
+                text(
+                    "orders.id IN ("
+                    "SELECT rowid FROM orders_name_address_fts "
+                    "WHERE orders_name_address_fts MATCH :address_fts"
+                    ")"
+                )
+            )
+        else:
+            query = query.filter(Order.address.ilike(f"%{address}%"))
+
+    if order_start_date:
+        query = query.filter(Order.order_date >= f"{order_start_date} 00:00:00")
+    if order_end_date:
+        query = query.filter(Order.order_date <= f"{order_end_date} 23:59:59")
+
+    if params:
+        query = query.params(**params)
+
+    has_filters = any([name, tracking, phone, address, order_start_date, order_end_date])
+    return query, has_filters
+
+
+def customer_key(name: str | None, phone: str | None):
+    normalized_name = (name or "").strip()
+    normalized_phone = normalize_phone(phone)
+    if not normalized_name or not normalized_phone:
+        return None
+    return normalized_name, normalized_phone
+
+
+def order_note_key(order: Order) -> str:
+    return (order.order_no_mall or order.order_no or "").strip()
+
+
+def apply_customer_notes(db: Session, orders: list[Order]):
+    keys = {
+        key
+        for order in orders
+        if (key := customer_key(order.recipient_name, order.recipient_mobile or order.recipient_phone))
+    }
+    if not keys:
+        for order in orders:
+            order.customer_note = ""
+        return
+
+    names = sorted({name for name, _phone in keys})
+    phones = sorted({phone for _name, phone in keys})
+    note_rows = (
+        db.query(
+            Order.recipient_name,
+            Order.recipient_mobile_normalized,
+            Order.recipient_phone_normalized,
+            Order.customer_note,
+            Order.note,
+        )
+        .filter(
+            or_(
+                and_(Order.customer_note.isnot(None), Order.customer_note != ""),
+                and_(Order.note.isnot(None), Order.note != ""),
+            )
+        )
+        .filter(func.trim(Order.recipient_name).in_(names))
+        .filter(
+            or_(
+                Order.recipient_mobile_normalized.in_(phones),
+                Order.recipient_phone_normalized.in_(phones),
+            )
+        )
+        .order_by(Order.id.desc())
+        .all()
+    )
+
+    notes_by_customer = {}
+    for name, mobile_normalized, phone_normalized, customer_note, legacy_note in note_rows:
+        note = customer_note or legacy_note or ""
+        for phone_value in (mobile_normalized, phone_normalized):
+            key = customer_key(name, phone_value)
+            if key in keys and key not in notes_by_customer:
+                notes_by_customer[key] = note
+
+    for order in orders:
+        key = customer_key(order.recipient_name, order.recipient_mobile or order.recipient_phone)
+        order.customer_note = notes_by_customer.get(key, "") if key else ""
+
+
+def apply_order_notes(db: Session, orders: list[Order]):
+    keys = sorted({key for order in orders if (key := order_note_key(order))})
+    if not keys:
+        for order in orders:
+            order.order_note = ""
+        return
+
+    note_rows = (
+        db.query(
+            Order.order_no_mall,
+            Order.order_no,
+            Order.order_note,
+        )
+        .filter(Order.order_note.isnot(None), Order.order_note != "")
+        .filter(
+            or_(
+                Order.order_no_mall.in_(keys),
+                Order.order_no.in_(keys),
+            )
+        )
+        .order_by(Order.id.desc())
+        .all()
+    )
+
+    notes_by_order = {}
+    for order_no_mall, order_no, note in note_rows:
+        for key in ((order_no_mall or "").strip(), (order_no or "").strip()):
+            if key in keys and key not in notes_by_order:
+                notes_by_order[key] = note or ""
+
+    for order in orders:
+        key = order_note_key(order)
+        order.order_note = notes_by_order.get(key, "") if key else ""
+
+
+def order_to_search_item(order: Order):
+    return {
+        "id": order.id,
+        "order_date": order.order_date,
+        "sequence_num": order.sequence_num,
+        "order_no": order.order_no,
+        "order_no_mall": order.order_no_mall,
+        "recipient_name": order.recipient_name,
+        "product_code": order.product_code,
+        "product_name": order.product_name,
+        "order_quantity": order.order_quantity,
+        "address": order.address,
+        "postal_code": order.postal_code,
+        "recipient_phone": order.recipient_phone,
+        "recipient_mobile": order.recipient_mobile,
+        "delivery_memo": order.delivery_memo,
+        "tracking_number": order.tracking_number,
+        "vendor": order.vendor,
+        "order_list_1": order.order_list_1,
+        "order_list_2": order.order_list_2,
+        "note": order.note,
+        "upload_date": order.upload_date,
+        "address_order_count": getattr(order, "address_order_count", 0),
+        "phone_order_count": getattr(order, "phone_order_count", 0),
+        "customer_note": getattr(order, "customer_note", "") or "",
+        "order_note": getattr(order, "order_note", "") or "",
+    }
+
+
+def orders_to_excel_response(orders, filename: str, sheet_name: str = "Orders"):
+    data = []
+    for o in orders:
+        data.append({
+            "주문날짜": o.order_date,
+            "수령인명": o.recipient_name,
+            "상품코드": o.product_code,
+            "상품명": o.product_name,
+            "수량": o.order_quantity,
+            "주소": o.address,
+            "수령인 전화번호": o.recipient_phone,
+            "휴대폰": o.recipient_mobile,
+            "송장번호": o.tracking_number,
+            "발주처": o.vendor,
+            "주문번호": o.order_no,
+            "주문번호(쇼핑몰)": o.order_no_mall,
+            "주문목록": o.order_list_1,
+            "추가날짜": o.upload_date,
+        })
+
+    df = pd.DataFrame(data)
+    output = io.BytesIO()
+    with pd.ExcelWriter(output, engine="openpyxl") as writer:
+        df.to_excel(writer, index=False, sheet_name=sheet_name)
+    output.seek(0)
+    encoded_filename = quote(filename)
+    return Response(
+        content=output.getvalue(),
+        media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        headers={"Content-Disposition": f"attachment; filename*=UTF-8''{encoded_filename}"},
+    )
+
+
+def run_upload_job(contents: bytes, filename: str, user_id: str, user_data: dict):
+    current_user = SimpleNamespace(**user_data)
+    db = SessionLocal()
+
+    try:
+        set_upload_state(
+            user_id,
+            status="reading",
+            message="엑셀 파일을 읽는 중입니다...",
+        )
+
+        # read_excel requires xlrd for .xls and openpyxl for .xlsx
+        df = pd.read_excel(io.BytesIO(contents))
+
+        # Replace NaN with None for SQLAlchemy
+        df = df.where(pd.notnull(df), None)
+
+        column_map = find_template_columns(list(df.columns))
+
+        total_rows = len(df)
+        set_upload_state(
+            user_id,
+            status="processing",
+            message=f"총 {total_rows}건의 엑셀 데이터를 정리하는 중입니다...",
+            total_rows=total_rows,
+        )
+
+        db_records = []
+        batch_size = 1000
+
+        for index, row in df.iterrows():
+            rlist = list(row)
+            recipient_phone = row_value(rlist, column_map, "recipient_phone")
+            recipient_mobile = row_value(rlist, column_map, "recipient_mobile")
+            tracking_number = row_value(rlist, column_map, "tracking_number")
+            address = row_value(rlist, column_map, "address")
+
+            order = Order(
+                order_date=row_value(rlist, column_map, "order_date"),
+                sequence_num=row_value(rlist, column_map, "sequence_num"),
+                order_no=row_value(rlist, column_map, "order_no"),
+                order_no_mall=row_value(rlist, column_map, "order_no_mall"),
+                recipient_name=row_value(rlist, column_map, "recipient_name"),
+                product_code=row_value(rlist, column_map, "product_code"),
+                product_name=row_value(rlist, column_map, "product_name"),
+                order_quantity=row_value(rlist, column_map, "order_quantity"),
+                address=address,
+                address_normalized=normalize_address_key(address),
+                postal_code=row_value(rlist, column_map, "postal_code"),
+                recipient_phone=recipient_phone,
+                recipient_mobile=recipient_mobile,
+                recipient_phone_normalized=normalize_phone(recipient_phone),
+                recipient_mobile_normalized=normalize_phone(recipient_mobile),
+                delivery_memo=row_value(rlist, column_map, "delivery_memo"),
+                tracking_number=tracking_number,
+                tracking_number_normalized=normalize_tracking(tracking_number),
+                vendor=row_value(rlist, column_map, "vendor"),
+                order_list_1=row_value(rlist, column_map, "order_list_1"),
+                order_note=row_value(rlist, column_map, "order_note"),
+                upload_date=datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+            )
+            db_records.append(order)
+
+            # Update progress periodically
+            if index % 1000 == 0 and index > 0:
+                calc_progress = float(index) / total_rows if total_rows else 1
+
+                set_upload_state(
+                    user_id,
+                    status="processing",
+                    message=f"{index}/{total_rows}건 엑셀 데이터 정리 중...",
+                    upload_progress=calc_progress * 100,
+                    total_rows=total_rows,
+                    processed_rows=index,
+                )
+
+        set_upload_state(
+            user_id,
+            status="indexing",
+            message="DB 저장과 검색 인덱스 반영을 시작합니다...",
+            upload_progress=100,
+            index_progress=0,
+            total_rows=total_rows,
+            processed_rows=total_rows,
+        )
+
+        for i in range(0, len(db_records), batch_size):
+            chunk = db_records[i:i + batch_size]
+            db.bulk_save_objects(chunk)
+            indexed_rows = min(i + len(chunk), total_rows)
+            index_progress = (indexed_rows / total_rows * 100) if total_rows else 100
+            set_upload_state(
+                user_id,
+                status="indexing",
+                message=f"{indexed_rows}/{total_rows}건 DB 저장 및 검색 인덱스 반영 중...",
+                upload_progress=100,
+                index_progress=index_progress,
+                total_rows=total_rows,
+                processed_rows=total_rows,
+                indexed_rows=indexed_rows,
+            )
+
+        db.commit()
+
+        set_upload_state(
+            user_id,
+            status="completed",
+            message=f"완료: {len(db_records)}건 저장 및 검색 인덱스 반영",
+            upload_progress=100,
+            index_progress=100,
+            total_rows=total_rows,
+            processed_rows=total_rows,
+            indexed_rows=total_rows,
+        )
+        log_event(
+            current_user,
+            "파일 업로드 완료",
+            "success",
+            {"filename": filename, "uploaded_count": len(db_records)},
+        )
+    except ValueError as e:
+        db.rollback()
+        set_upload_error(user_id, str(e))
+        log_event(current_user, "파일 업로드 실패", "error", {"filename": filename, "error": str(e)})
+    except Exception as e:
+        db.rollback()
+        set_upload_error(user_id, f"에러 발생: {str(e)}")
+        log_event(current_user, "파일 업로드 실패", "error", {"filename": filename, "error": str(e)})
+    finally:
+        db.close()
+
+
+@router.post("/upload")
+def upload_file(
+    file: UploadFile = File(...),
+    upload_token: str = Form(...),
+    current_user = Depends(get_current_user)
+):
+    filename = file.filename or ""
+    if not filename.endswith(".xls") and not filename.endswith(".xlsx"):
+        raise HTTPException(status_code=400, detail="Only XLS or XLSX files are allowed.")
+
+    user_id = f"{current_user.id}:{upload_token}"
+    contents = file.file.read()
+    user_data = {
+        "id": getattr(current_user, "id", ""),
+        "email": getattr(current_user, "email", None),
+        "name": getattr(current_user, "name", None),
+    }
+
+    log_event(current_user, "파일 업로드 시작", "started", {"filename": filename})
+    set_upload_state(
+        user_id,
+        status="queued",
+        message="업로드 작업이 등록되었습니다.",
+    )
+    threading.Thread(
+        target=run_upload_job,
+        args=(contents, filename, user_id, user_data),
+        daemon=True,
+    ).start()
+
+    return {
+        "status": "queued",
+        "upload_token": upload_token,
+        "message": "업로드 작업이 시작되었습니다. 진행률 창에서 완료 상태를 확인해주세요.",
+    }
+
+@router.get("/progress")
+async def upload_progress(
+    upload_token: str,
+    current_user = Depends(get_current_user)
+):
+    user_id = f"{current_user.id}:{upload_token}"
+    
+    async def event_generator():
+        while True:
+            if user_id in upload_progress_state:
+                state = upload_progress_state[user_id]
+                yield f"data: {json.dumps(state, ensure_ascii=False)}\n\n"
+                
+                # Stop streaming connection if done or error
+                if state["status"] in ["completed", "error"]:
+                    upload_progress_state.pop(user_id, None)
+                    break
+            else:
+                yield f"data: {json.dumps({'status': 'idle'}, ensure_ascii=False)}\n\n"
+            
+            await asyncio.sleep(0.5)
+
+    return StreamingResponse(event_generator(), media_type="text/event-stream")
+
+@router.get("/search")
+async def search_orders(
+    name: Optional[str] = None,
+    tracking: Optional[str] = None,
+    phone: Optional[str] = None,
+    address: Optional[str] = None,
+    order_start_date: Optional[str] = None,
+    order_end_date: Optional[str] = None,
+    page: int = 1,
+    size: int = 27,
+    db: Session = Depends(get_db),
+    current_user = Depends(get_current_user)
+):
+    query, has_filters = build_order_search_query(
+        db,
+        name=name,
+        tracking=tracking,
+        phone=phone,
+        address=address,
+        order_start_date=order_start_date,
+        order_end_date=order_end_date,
+    )
+
+    # If no parameters are provided, return empty
+    if not has_filters:
+        return {"items": [], "total": 0, "page": page, "size": size}
+
+    total = query.count()
+    offset = (page - 1) * size
+    
+    orders = query.order_by(Order.order_date.desc(), Order.id.desc()).offset(offset).limit(size).all()
+    page_address_keys = sorted({normalize_address_key(order.address) for order in orders if normalize_address_key(order.address)})
+    page_phones = sorted(
+        {
+            normalize_phone(order.recipient_mobile or order.recipient_phone)
+            for order in orders
+            if normalize_phone(order.recipient_mobile or order.recipient_phone)
+        }
+    )
+    address_date_counts = {}
+    phone_date_counts = {}
+    order_date_key = func.substr(Order.order_date, 1, 10)
+    if page_address_keys:
+        address_date_counts = dict(
+            db.query(
+                Order.address_normalized,
+                func.count(func.distinct(order_date_key)),
+            )
+            .filter(Order.address_normalized.in_(page_address_keys))
+            .group_by(Order.address_normalized)
+            .all()
+        )
+    if page_phones:
+        phone_date_sets = {phone_value: set() for phone_value in page_phones}
+        phone_rows = (
+            db.query(
+                Order.recipient_mobile_normalized,
+                Order.recipient_phone_normalized,
+                order_date_key,
+            )
+            .filter(
+                or_(
+                    Order.recipient_mobile_normalized.in_(page_phones),
+                    Order.recipient_phone_normalized.in_(page_phones),
+                )
+            )
+            .all()
+        )
+        for mobile_normalized, phone_normalized, date_key in phone_rows:
+            if mobile_normalized in phone_date_sets:
+                if date_key:
+                    phone_date_sets[mobile_normalized].add(date_key)
+            if phone_normalized in phone_date_sets:
+                if date_key:
+                    phone_date_sets[phone_normalized].add(date_key)
+        phone_date_counts = {
+            phone_value: len(date_keys)
+            for phone_value, date_keys in phone_date_sets.items()
+        }
+
+    for order in orders:
+        address_key = normalize_address_key(order.address)
+        order.address_order_count = address_date_counts.get(address_key, 0) if address_key else 0
+        display_phone_normalized = normalize_phone(order.recipient_mobile or order.recipient_phone)
+        order.phone_order_count = phone_date_counts.get(display_phone_normalized, 0) if display_phone_normalized else 0
+    apply_customer_notes(db, orders)
+    apply_order_notes(db, orders)
+    
+    return {
+        "items": [order_to_search_item(order) for order in orders],
+        "total": total,
+        "page": page,
+        "size": size,
+        "total_pages": math.ceil(total / size) if size > 0 else 0
+    }
+
+
+@router.get("/export-search")
+async def export_search_orders(
+    name: Optional[str] = None,
+    tracking: Optional[str] = None,
+    phone: Optional[str] = None,
+    address: Optional[str] = None,
+    order_start_date: Optional[str] = None,
+    order_end_date: Optional[str] = None,
+    db: Session = Depends(get_db),
+    current_user = Depends(get_current_user)
+):
+    query, has_filters = build_order_search_query(
+        db,
+        name=name,
+        tracking=tracking,
+        phone=phone,
+        address=address,
+        order_start_date=order_start_date,
+        order_end_date=order_end_date,
+    )
+    if not has_filters:
+        raise HTTPException(status_code=400, detail="검색 조건이 없습니다.")
+
+    orders = query.order_by(Order.order_date.desc(), Order.id.desc()).all()
+    if not orders:
+        raise HTTPException(status_code=404, detail="다운로드할 검색 결과가 없습니다.")
+
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    log_event(
+        current_user,
+        "검색 결과 엑셀 다운로드",
+        "success",
+        {
+            "download_count": len(orders),
+            "name": name,
+            "phone": phone,
+            "address": address,
+            "tracking": tracking,
+            "start_date": order_start_date,
+            "end_date": order_end_date,
+        },
+    )
+    return orders_to_excel_response(orders, f"검색결과_{timestamp}.xlsx", "Search_Results")
+
+class DeleteOrdersRequest(BaseModel):
+    order_ids: list[int]
+
+
+class UpdateOrderContactRequest(BaseModel):
+    recipient_name: str
+    address: str
+    recipient_mobile: str
+    customer_note: Optional[str] = None
+    order_note: Optional[str] = None
+    note: str = ""
+
+
+class DeleteSingleOrderRequest(BaseModel):
+    password: str
+
+
+class ReturnRequestPayload(BaseModel):
+    request_date: str
+    request_type: str
+    remarks: str = ""
+    tracking_no: Optional[str] = None
+    receiver_name: Optional[str] = None
+    address: Optional[str] = None
+    phone: Optional[str] = None
+
+
+@router.put("/{order_id}/contact")
+async def update_order_contact(
+    order_id: int,
+    req: UpdateOrderContactRequest,
+    db: Session = Depends(get_db),
+    current_user = Depends(get_current_user)
+):
+    order = db.query(Order).filter(Order.id == order_id).first()
+    if not order:
+        log_event(current_user, "주문 정보 수정", "error", {"order_id": order_id, "error": "not_found"})
+        raise HTTPException(status_code=404, detail="주문 데이터를 찾을 수 없습니다.")
+
+    before = {
+        "recipient_name": order.recipient_name,
+        "address": order.address,
+        "recipient_mobile": order.recipient_mobile,
+        "customer_note": order.customer_note,
+        "order_note": order.order_note,
+        "note": order.note,
+    }
+    new_name = req.recipient_name.strip() or None
+    new_phone = req.recipient_mobile.strip() or None
+    new_phone_normalized = normalize_phone(new_phone)
+    new_customer_note = (
+        req.customer_note if req.customer_note is not None else req.note
+    ).strip() or None
+    new_order_note = (req.order_note or "").strip() or None
+
+    order.recipient_name = new_name
+    order.address = req.address.strip() or None
+    order.address_normalized = normalize_address_key(order.address)
+    order.recipient_mobile = new_phone
+    order.recipient_mobile_normalized = new_phone_normalized
+
+    customer_note_updated_count = 1
+    customer_phone_normalized = new_phone_normalized or normalize_phone(order.recipient_phone)
+    if new_name and customer_phone_normalized:
+        customer_note_targets = (
+            db.query(Order)
+            .filter(func.trim(Order.recipient_name) == new_name)
+            .filter(
+                or_(
+                    Order.recipient_mobile_normalized == customer_phone_normalized,
+                    Order.recipient_phone_normalized == customer_phone_normalized,
+                )
+            )
+            .all()
+        )
+        for target_order in customer_note_targets:
+            target_order.customer_note = new_customer_note
+        customer_note_updated_count = len(customer_note_targets)
+
+    order_note_updated_count = 1
+    current_order_note_key = order_note_key(order)
+    if current_order_note_key:
+        order_note_targets = (
+            db.query(Order)
+            .filter(
+                or_(
+                    Order.order_no_mall == current_order_note_key,
+                    Order.order_no == current_order_note_key,
+                )
+            )
+            .all()
+        )
+        for target_order in order_note_targets:
+            target_order.order_note = new_order_note
+        order_note_updated_count = len(order_note_targets)
+    order.customer_note = new_customer_note
+    order.order_note = new_order_note
+    db.commit()
+    db.refresh(order)
+    log_event(
+        current_user,
+        "주문 정보 수정",
+        "success",
+        {
+            "order_id": order.id,
+            "order_no": order.order_no,
+            "order_no_mall": order.order_no_mall,
+            "before": before,
+            "after": {
+                "recipient_name": order.recipient_name,
+                "address": order.address,
+                "recipient_mobile": order.recipient_mobile,
+                "customer_note": order.customer_note,
+                "order_note": order.order_note,
+                "note": order.note,
+            },
+            "customer_note_updated_count": customer_note_updated_count,
+            "order_note_updated_count": order_note_updated_count,
+            "submitted_customer_note_length": len(
+                req.customer_note if req.customer_note is not None else req.note or ""
+            ),
+            "submitted_order_note_length": len(req.order_note or ""),
+        },
+    )
+
+    return {
+        "message": "주문 정보가 수정되었습니다.",
+        "order_id": order.id,
+        "customer_note": order.customer_note,
+        "order_note": order.order_note,
+        "note": order.note,
+        "customer_note_updated_count": customer_note_updated_count,
+        "order_note_updated_count": order_note_updated_count,
+    }
+
+
+@router.post("/{order_id}/return-request")
+async def send_return_request(
+    order_id: int,
+    req: ReturnRequestPayload,
+    db: Session = Depends(get_db),
+    current_user = Depends(get_current_user),
+):
+    order = db.query(Order).filter(Order.id == order_id).first()
+    if not order:
+        log_event(current_user, "반품 신청 전송", "error", {"order_id": order_id, "error": "not_found"})
+        raise HTTPException(status_code=404, detail="주문 데이터를 찾을 수 없습니다.")
+
+    payload = {
+        "request_date": (req.request_date or "").strip(),
+        "request_type": (req.request_type or "").strip(),
+        "receiver_name": (req.receiver_name or order.recipient_name or "").strip(),
+        "address": (req.address or order.address or "").strip(),
+        "phone": (req.phone or order.recipient_mobile or order.recipient_phone or "").strip(),
+        "tracking_no": (req.tracking_no or order.tracking_number or "").strip(),
+        "mall": (order.vendor or "").strip(),
+        "remarks": (req.remarks or "").strip(),
+    }
+
+    missing_fields = [
+        key for key in ("request_date", "request_type")
+        if payload[key] == ""
+    ]
+    if missing_fields:
+        log_event(
+            current_user,
+            "반품 신청 전송",
+            "error",
+            {
+                "order_id": order_id,
+                "missing_fields": missing_fields,
+                "payload": payload,
+            },
+        )
+        raise HTTPException(
+            status_code=400,
+            detail=f"반품 신청 필수값이 비어 있습니다: {', '.join(missing_fields)}",
+        )
+
+    log_event(
+        current_user,
+        "반품 신청 전송 요청",
+        "info",
+        {
+            "order_id": order_id,
+            "endpoint": CS_RETURN_REQUEST_URL,
+            "payload": payload,
+        },
+    )
+
+    try:
+        timeout = httpx.Timeout(connect=2.0, read=5.0, write=3.0, pool=2.0)
+        async with httpx.AsyncClient(timeout=timeout, trust_env=False) as client:
+            response = await client.post(CS_RETURN_REQUEST_URL, json=payload)
+            response.raise_for_status()
+    except httpx.HTTPStatusError as exc:
+        response_text = exc.response.text[:1000] if exc.response is not None else ""
+        log_event(
+            current_user,
+            "반품 신청 전송",
+            "error",
+            {
+                "order_id": order_id,
+                "status_code": exc.response.status_code if exc.response is not None else None,
+                "response": response_text,
+                "payload": payload,
+            },
+        )
+        raise HTTPException(
+            status_code=502,
+            detail=f"CS 관리 프로그램 반품 신청 오류: HTTP {exc.response.status_code}",
+        )
+    except httpx.RequestError as exc:
+        log_event(
+            current_user,
+            "반품 신청 전송",
+            "error",
+            {
+                "order_id": order_id,
+                "endpoint": CS_RETURN_REQUEST_URL,
+                "error": str(exc),
+                "payload": payload,
+            },
+        )
+        raise HTTPException(status_code=502, detail=f"CS 관리 프로그램 연결 오류: {str(exc)}")
+
+    log_event(
+        current_user,
+        "반품 신청 전송",
+        "success",
+        {
+            "order_id": order_id,
+            "endpoint": CS_RETURN_REQUEST_URL,
+            "payload": payload,
+            "status_code": response.status_code,
+        },
+    )
+    return {
+        "message": "반품 신청 데이터가 CS 관리 프로그램으로 전송되었습니다.",
+        "status_code": response.status_code,
+        "payload": payload,
+    }
+
+
+@router.post("/{order_id}/delete")
+@router.delete("/{order_id}")
+async def delete_single_order(
+    order_id: int,
+    req: DeleteSingleOrderRequest,
+    db: Session = Depends(get_db),
+    current_user = Depends(get_current_user)
+):
+    log_event(current_user, "주문 단건 삭제 요청", "info", {"order_id": order_id})
+    if req.password != "1225":
+        log_event(current_user, "주문 단건 삭제", "error", {"order_id": order_id, "error": "invalid_password"})
+        raise HTTPException(status_code=403, detail="비밀번호가 올바르지 않습니다.")
+
+    order = db.query(Order).filter(Order.id == order_id).first()
+    if not order:
+        log_event(current_user, "주문 단건 삭제", "error", {"order_id": order_id, "error": "not_found"})
+        raise HTTPException(status_code=404, detail="주문 데이터를 찾을 수 없습니다.")
+
+    deleted_order = {
+        "order_id": order.id,
+        "order_date": order.order_date,
+        "order_no": order.order_no,
+        "order_no_mall": order.order_no_mall,
+        "recipient_name": order.recipient_name,
+        "recipient_mobile": order.recipient_mobile,
+        "recipient_phone": order.recipient_phone,
+        "product_code": order.product_code,
+        "product_name": order.product_name,
+        "order_quantity": order.order_quantity,
+        "vendor": order.vendor,
+        "note": order.note,
+    }
+
+    try:
+        db.delete(order)
+        db.commit()
+        log_event(current_user, "주문 단건 삭제", "success", deleted_order)
+        return {"message": "주문이 삭제되었습니다.", "deleted_count": 1, "order_id": order_id}
+    except Exception as e:
+        db.rollback()
+        log_event(current_user, "주문 단건 삭제", "error", {**deleted_order, "error": str(e)})
+        raise HTTPException(status_code=500, detail=f"주문 삭제 오류: {str(e)}")
+
+
+@router.post("/delete")
+async def delete_orders(
+    req: DeleteOrdersRequest,
+    db: Session = Depends(get_db),
+    current_user = Depends(get_current_user)
+):
+    if not current_user.is_admin:
+        raise HTTPException(status_code=403, detail="Not authorized to delete data.")
+        
+    if not req.order_ids:
+        return {"message": "No orders selected for deletion.", "deleted_count": 0}
+        
+    try:
+        deleted_count = db.query(Order).filter(Order.id.in_(req.order_ids)).delete(synchronize_session=False)
+        db.commit()
+        return {"message": f"성공적으로 {deleted_count}건의 데이터를 삭제했습니다.", "deleted_count": deleted_count}
+    except Exception as e:
+        db.rollback()
+        raise HTTPException(status_code=500, detail=str(e))
diff --git a/app/routers/settings.py b/app/routers/settings.py
new file mode 100644
index 0000000..e64ac76
--- /dev/null
+++ b/app/routers/settings.py
@@ -0,0 +1,1063 @@
+import os
+import asyncio
+import datetime
+import json
+import locale
+import sqlite3
+import tempfile
+import threading
+import traceback
+import uuid
+from fastapi import APIRouter, Depends, File, HTTPException, Request, UploadFile
+from sqlalchemy.orm import Session
+from sqlalchemy import func, text
+from pydantic import BaseModel
+from typing import Optional
+import io
+from openpyxl import Workbook
+from fastapi.responses import FileResponse, Response, StreamingResponse
+from starlette.background import BackgroundTask
+from urllib.parse import quote
+from types import SimpleNamespace
+
+from app.database import SessionLocal, engine, get_db
+from app.database_maintenance import ensure_search_optimizations
+from app.models import Order
+from app.auth import get_admin_user, get_current_user
+from app.event_logger import EVENT_LOG_PATH, log_event
+
+router = APIRouter()
+delete_progress_state = {}
+export_progress_state = {}
+export_progress_lock = threading.Lock()
+DELETE_BATCH_SIZE = 50000
+DELETE_COMMIT_EVERY_ROWS = 200000
+
+# Setup correct locale for Korean day of week (e.g., 월요일)
+try:
+    locale.setlocale(locale.LC_TIME, 'ko_KR.UTF-8')
+except locale.Error:
+    pass
+
+class DeleteAllOrdersRequest(BaseModel):
+    password: str
+
+class DeleteOrdersByDateRangeRequest(BaseModel):
+    password: str
+    start_date: str
+    end_date: str
+    delete_token: Optional[str] = None
+
+
+class UiEventRequest(BaseModel):
+    action: str
+    details: Optional[dict] = None
+
+
+def format_file_size(size_bytes: int) -> str:
+    value = float(size_bytes or 0)
+    for unit in ("B", "KB", "MB", "GB", "TB"):
+        if value < 1024 or unit == "TB":
+            if unit == "B":
+                return f"{int(value)} {unit}"
+            return f"{value:.1f} {unit}"
+        value /= 1024
+
+
+def set_delete_progress(
+    user_id: str,
+    *,
+    status: str,
+    message: str,
+    progress: int = 0,
+    cleanup_progress: int = 0,
+    total_rows: int = 0,
+    deleted_rows: int = 0,
+    cleanup_step: str = "",
+):
+    delete_progress_state[user_id] = {
+        "status": status,
+        "message": message,
+        "progress": max(0, min(100, int(progress))),
+        "cleanup_progress": max(0, min(100, int(cleanup_progress))),
+        "total_rows": int(total_rows or 0),
+        "deleted_rows": int(deleted_rows or 0),
+        "cleanup_step": cleanup_step,
+    }
+
+def require_admin_session(request: Request) -> str:
+    user_email = request.session.get("user_email")
+    if not user_email:
+        raise HTTPException(status_code=401, detail="Not authenticated")
+
+    db = SessionLocal()
+    try:
+        row = db.execute(
+            text("SELECT is_admin FROM users WHERE email = :email"),
+            {"email": user_email},
+        ).fetchone()
+    finally:
+        db.close()
+
+    if not row or not row[0]:
+        raise HTTPException(status_code=403, detail="Admin access required")
+    return user_email
+
+
+def excel_response_from_rows(rows, filename: str, sheet_name: str):
+    output = io.BytesIO()
+    workbook = Workbook(write_only=True)
+    worksheet = workbook.create_sheet(title=sheet_name[:31] or "Sheet1")
+
+    row_iter = iter(rows)
+    first_row = next(row_iter, None)
+    if first_row is None:
+        raise HTTPException(status_code=404, detail="다운로드할 데이터가 없습니다.")
+
+    headers = list(first_row.keys())
+    worksheet.append(headers)
+    worksheet.append([first_row.get(header) for header in headers])
+    for row in row_iter:
+        worksheet.append([row.get(header) for header in headers])
+
+    workbook.save(output)
+    output.seek(0)
+    encoded_filename = quote(filename)
+    return Response(
+        content=output.getvalue(),
+        media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        headers={"Content-Disposition": f"attachment; filename*=UTF-8''{encoded_filename}"},
+    )
+
+
+def write_excel_file_from_rows(rows, output_path: str, sheet_name: str):
+    workbook = Workbook(write_only=True)
+    worksheet = workbook.create_sheet(title=sheet_name[:31] or "Sheet1")
+
+    row_iter = iter(rows)
+    first_row = next(row_iter, None)
+    if first_row is None:
+        raise ValueError("다운로드할 데이터가 없습니다.")
+
+    headers = list(first_row.keys())
+    worksheet.append(headers)
+    worksheet.append([first_row.get(header) for header in headers])
+    for row in row_iter:
+        worksheet.append([row.get(header) for header in headers])
+
+    workbook.save(output_path)
+
+
+def validate_date_range(start_date: str, end_date: str):
+    try:
+        start = datetime.datetime.strptime(start_date, "%Y-%m-%d").date()
+        end = datetime.datetime.strptime(end_date, "%Y-%m-%d").date()
+    except ValueError:
+        raise HTTPException(status_code=400, detail="날짜 형식이 올바르지 않습니다.")
+
+    if start > end:
+        raise HTTPException(status_code=400, detail="시작일이 종료일보다 늦을 수 없습니다.")
+    return start, end
+
+
+def log_operation_error(user, action: str, exc: Exception, details: dict | None = None):
+    error_details = {
+        **(details or {}),
+        "error_type": type(exc).__name__,
+        "error": str(exc),
+        "traceback": traceback.format_exc(),
+    }
+    try:
+        log_event(user, action, "error", error_details)
+    except Exception:
+        os.makedirs("logs", exist_ok=True)
+        timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+        with open(os.path.join("logs", "operation_errors.log"), "a", encoding="utf-8") as f:
+            f.write(f"[{timestamp}] {action}\n")
+            f.write(json.dumps(error_details, ensure_ascii=False, indent=2))
+            f.write("\n\n")
+
+
+def set_export_progress(export_token: str, **updates):
+    with export_progress_lock:
+        current = export_progress_state.get(export_token, {})
+        current.update(updates)
+        export_progress_state[export_token] = current
+
+
+def get_export_progress(export_token: str):
+    with export_progress_lock:
+        job = export_progress_state.get(export_token)
+        return dict(job) if job else None
+
+
+def build_export_rows(db: Session, start_date: Optional[str], end_date: Optional[str]):
+    query = db.query(
+        Order.order_date,
+        Order.recipient_name,
+        Order.product_code,
+        Order.product_name,
+        Order.order_quantity,
+        Order.address,
+        Order.recipient_phone,
+        Order.recipient_mobile,
+        Order.tracking_number,
+        Order.vendor,
+        Order.upload_date,
+        Order.order_no_mall,
+        Order.order_list_1,
+    )
+
+    if start_date and end_date:
+        start_datetime = start_date
+        end_datetime = f"{end_date} 23:59:59"
+        query = query.filter(Order.order_date >= start_datetime, Order.order_date <= end_datetime)
+
+    for o in query.order_by(Order.order_date.desc(), Order.id.desc()).yield_per(5000):
+        yield {
+            "주문날짜": o.order_date,
+            "수령인명": o.recipient_name,
+            "상품코드": o.product_code,
+            "상품명": o.product_name,
+            "수량": o.order_quantity,
+            "주소": o.address,
+            "수령인 전화번호": o.recipient_phone,
+            "휴대폰": o.recipient_mobile,
+            "송장번호": o.tracking_number,
+            "발주처": o.vendor,
+            "추가날짜": o.upload_date,
+            "주문번호(쇼핑몰)": o.order_no_mall,
+            "주문목록": o.order_list_1,
+        }
+
+
+def count_export_rows(db: Session, start_date: Optional[str], end_date: Optional[str]) -> int:
+    query = db.query(func.count(Order.id))
+    if start_date and end_date:
+        start_datetime = start_date
+        end_datetime = f"{end_date} 23:59:59"
+        query = query.filter(Order.order_date >= start_datetime, Order.order_date <= end_datetime)
+    return int(query.scalar() or 0)
+
+
+def run_export_job(export_token: str, start_date: Optional[str], end_date: Optional[str], user_label_data):
+    db = SessionLocal()
+    started_at = datetime.datetime.now()
+    export_details = {"start_date": start_date, "end_date": end_date, "export_token": export_token}
+    current_user = SimpleNamespace(**user_label_data)
+    output_path = ""
+    row_count = 0
+
+    try:
+        set_export_progress(
+            export_token,
+            status="running",
+            message="대상 데이터 건수를 확인 중입니다.",
+            processed_rows=0,
+            total_rows=0,
+            progress=0,
+        )
+        log_event(current_user, "DB 데이터 엑셀 다운로드 파일 생성 시작", "info", export_details)
+
+        total_rows = count_export_rows(db, start_date, end_date)
+        if total_rows == 0:
+            raise ValueError("해당 기간의 데이터가 없습니다.")
+        set_export_progress(
+            export_token,
+            message=f"총 {total_rows:,}건 엑셀 파일 생성 중입니다.",
+            processed_rows=0,
+            total_rows=total_rows,
+            progress=0,
+        )
+
+        filename = "OMS_DB_전체데이터.xlsx"
+        if start_date and end_date:
+            filename = f"OMS_DB_{start_date}_to_{end_date}.xlsx"
+
+        temp_file = tempfile.NamedTemporaryFile(prefix="order_export_", suffix=".xlsx", delete=False)
+        output_path = temp_file.name
+        temp_file.close()
+
+        workbook = Workbook(write_only=True)
+        worksheet = workbook.create_sheet(title="DB_Export")
+        headers = [
+            "주문날짜",
+            "수령인명",
+            "상품코드",
+            "상품명",
+            "수량",
+            "주소",
+            "수령인 전화번호",
+            "휴대폰",
+            "송장번호",
+            "발주처",
+            "추가날짜",
+            "주문번호(쇼핑몰)",
+            "주문목록",
+        ]
+        worksheet.append(headers)
+
+        for row in build_export_rows(db, start_date, end_date):
+            row_count += 1
+            worksheet.append([row.get(header) for header in headers])
+            if row_count % 5000 == 0:
+                progress = round((row_count / total_rows) * 100, 1) if total_rows else 0
+                set_export_progress(
+                    export_token,
+                    message=f"{row_count:,}건 처리 중입니다.",
+                    processed_rows=row_count,
+                    total_rows=total_rows,
+                    progress=min(progress, 99),
+                )
+
+        set_export_progress(
+            export_token,
+            message=f"{row_count:,}건 엑셀 파일 저장 중입니다.",
+            processed_rows=row_count,
+            total_rows=total_rows,
+            progress=99,
+        )
+        workbook.save(output_path)
+
+        elapsed_seconds = round((datetime.datetime.now() - started_at).total_seconds(), 3)
+        set_export_progress(
+            export_token,
+            status="completed",
+            message="엑셀 파일 생성이 완료되었습니다.",
+            processed_rows=row_count,
+            total_rows=total_rows,
+            progress=100,
+            file_path=output_path,
+            filename=filename,
+            elapsed_seconds=elapsed_seconds,
+        )
+        log_event(
+            current_user,
+            "DB 데이터 엑셀 다운로드 파일 생성 완료",
+            "success",
+            {
+                **export_details,
+                "download_count": row_count,
+                "elapsed_seconds": elapsed_seconds,
+                "file_path": output_path,
+            },
+        )
+    except Exception as e:
+        if output_path and os.path.exists(output_path):
+            try:
+                os.remove(output_path)
+            except OSError:
+                pass
+        elapsed_seconds = round((datetime.datetime.now() - started_at).total_seconds(), 3)
+        set_export_progress(
+            export_token,
+            status="error",
+            message=f"엑셀 파일 생성 오류: {type(e).__name__}: {str(e)}",
+            processed_rows=row_count,
+            total_rows=get_export_progress(export_token).get("total_rows", 0) if get_export_progress(export_token) else 0,
+            progress=0,
+            elapsed_seconds=elapsed_seconds,
+        )
+        log_operation_error(
+            current_user,
+            "DB 데이터 엑셀 다운로드 파일 생성",
+            e,
+            {
+                **export_details,
+                "processed_rows": row_count,
+                "elapsed_seconds": elapsed_seconds,
+            },
+        )
+    finally:
+        db.close()
+
+
+@router.post("/log-ui-event")
+async def log_ui_event(data: UiEventRequest, current_user = Depends(get_current_user)):
+    log_event(current_user, data.action, "info", data.details or {})
+    return {"message": "logged"}
+
+@router.get("/database-size")
+async def get_database_size(db: Session = Depends(get_db), current_user = Depends(get_current_user)):
+    try:
+        dialect = db.get_bind().dialect.name
+        if dialect == "postgresql":
+            size_bytes = int(db.execute(text("SELECT pg_database_size(current_database())")).scalar() or 0)
+        elif dialect == "sqlite":
+            database_path = db.get_bind().url.database or "app.db"
+            if not os.path.isabs(database_path):
+                database_path = os.path.abspath(database_path)
+            size_bytes = os.path.getsize(database_path) if os.path.exists(database_path) else 0
+        else:
+            raise HTTPException(status_code=400, detail=f"지원하지 않는 DB 종류입니다: {dialect}")
+
+        return {
+            "bytes": size_bytes,
+            "formatted": format_file_size(size_bytes),
+            "database": dialect,
+        }
+    except HTTPException:
+        raise
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"DB 용량 조회 오류: {str(e)}")
+
+
+@router.post("/optimize")
+async def optimize_database(db: Session = Depends(get_db), current_user = Depends(get_current_user)):
+    try:
+        if db.get_bind().dialect.name == "sqlite":
+            with db.get_bind().connect() as conn:
+                conn.execution_options(isolation_level="AUTOCOMMIT").execute(text("VACUUM"))
+        else:
+            with db.get_bind().connect() as conn:
+                conn.execution_options(isolation_level="AUTOCOMMIT").execute(text("VACUUM ANALYZE orders"))
+        log_event(current_user, "데이터베이스 최적화", "success")
+        return {"message": "데이터베이스 최적화가 성공적으로 완료되었습니다."}
+    except Exception as e:
+        log_event(current_user, "데이터베이스 최적화", "error", str(e))
+        raise HTTPException(status_code=500, detail=f"최적화 오류: {str(e)}")
+
+@router.get("/backup-db")
+async def backup_database(current_user = Depends(get_admin_user)):
+    if engine.dialect.name != "sqlite":
+        raise HTTPException(
+            status_code=400,
+            detail="이 백업 기능은 SQLite 전용입니다. PostgreSQL은 서버 측 pg_dump를 사용하세요.",
+        )
+    backup_file = tempfile.NamedTemporaryFile(prefix="oms-backup-", suffix=".db", delete=False)
+    backup_path = backup_file.name
+    backup_file.close()
+
+    try:
+        source = sqlite3.connect("app.db")
+        target = sqlite3.connect(backup_path)
+        with target:
+            source.backup(target)
+        target.close()
+        source.close()
+
+        timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
+        filename = f"OMS_DB_backup_{timestamp}.db"
+        log_event(current_user, "DB 백업 다운로드", "success", {"filename": filename})
+        return FileResponse(
+            backup_path,
+            media_type="application/octet-stream",
+            filename=filename,
+            background=BackgroundTask(lambda: os.path.exists(backup_path) and os.remove(backup_path)),
+        )
+    except Exception as e:
+        if os.path.exists(backup_path):
+            os.remove(backup_path)
+        log_event(current_user, "DB 백업 다운로드", "error", str(e))
+        raise HTTPException(status_code=500, detail=f"백업 오류: {str(e)}")
+
+@router.post("/restore-db")
+async def restore_database(
+    request: Request,
+    file: UploadFile = File(...),
+    current_user = Depends(get_admin_user)
+):
+    if engine.dialect.name != "sqlite":
+        raise HTTPException(
+            status_code=400,
+            detail="이 복구 기능은 SQLite 전용입니다. PostgreSQL은 서버 측 pg_restore를 사용하세요.",
+        )
+    filename = (file.filename or "").lower()
+    if not filename.endswith((".db", ".sqlite", ".sqlite3")):
+        raise HTTPException(status_code=400, detail="SQLite DB 백업 파일만 업로드할 수 있습니다.")
+
+    upload_file = tempfile.NamedTemporaryFile(prefix="oms-restore-upload-", suffix=".db", delete=False)
+    upload_path = upload_file.name
+    upload_file.close()
+
+    try:
+        contents = await file.read()
+        with open(upload_path, "wb") as f:
+            f.write(contents)
+
+        uploaded = sqlite3.connect(upload_path)
+        try:
+            try:
+                check_result = uploaded.execute("PRAGMA quick_check").fetchone()[0]
+                if check_result != "ok":
+                    raise HTTPException(status_code=400, detail=f"DB 파일 무결성 오류: {check_result}")
+
+                required_tables = {"orders", "users"}
+                found_tables = {
+                    row[0]
+                    for row in uploaded.execute(
+                        "SELECT name FROM sqlite_master WHERE type = 'table'"
+                    ).fetchall()
+                }
+                missing_tables = sorted(required_tables - found_tables)
+                if missing_tables:
+                    raise HTTPException(
+                        status_code=400,
+                        detail=f"필수 테이블이 없는 DB 파일입니다: {', '.join(missing_tables)}",
+                    )
+                restored_count = uploaded.execute("SELECT count(*) FROM orders").fetchone()[0]
+            except sqlite3.DatabaseError as e:
+                raise HTTPException(status_code=400, detail=f"올바른 SQLite DB 파일이 아닙니다: {str(e)}")
+        finally:
+            uploaded.close()
+
+        timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
+        safety_backup_path = f"app.db.pre-restore-{timestamp}.db"
+
+        current_source = sqlite3.connect("app.db")
+        safety_target = sqlite3.connect(safety_backup_path)
+        try:
+            with safety_target:
+                current_source.backup(safety_target)
+        finally:
+            safety_target.close()
+            current_source.close()
+
+        engine.dispose()
+        source = sqlite3.connect(upload_path)
+        target = sqlite3.connect("app.db")
+        try:
+            with target:
+                source.backup(target)
+        finally:
+            target.close()
+            source.close()
+
+        ensure_search_optimizations(engine)
+        log_event(
+            current_user,
+            "DB 복구",
+            "success",
+            {
+                "filename": file.filename,
+                "restored_count": restored_count,
+                "safety_backup": safety_backup_path,
+            },
+        )
+        return {
+            "message": "DB 복구가 완료되었습니다.",
+            "restored_count": restored_count,
+            "safety_backup": safety_backup_path,
+        }
+    except HTTPException:
+        log_event(current_user, "DB 복구", "error", {"filename": file.filename, "error": "invalid db file"})
+        raise
+    except Exception as e:
+        log_event(current_user, "DB 복구", "error", {"filename": file.filename, "error": str(e)})
+        raise HTTPException(status_code=500, detail=f"DB 복구 오류: {str(e)}")
+    finally:
+        if os.path.exists(upload_path):
+            os.remove(upload_path)
+
+@router.post("/delete-all-orders")
+async def delete_all_orders(
+    data: DeleteAllOrdersRequest,
+    db: Session = Depends(get_db),
+    current_user = Depends(get_admin_user)
+):
+    if data.password != "1225":
+        raise HTTPException(status_code=403, detail="비밀번호가 올바르지 않습니다.")
+
+    try:
+        is_sqlite = db.get_bind().dialect.name == "sqlite"
+        if is_sqlite:
+            db.execute(text("DROP TRIGGER IF EXISTS orders_fts_ai"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_fts_ad"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_fts_au"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_phone_fts_ai"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_phone_fts_ad"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_phone_fts_au"))
+        result = db.execute(text("DELETE FROM orders"))
+        if is_sqlite:
+            db.execute(text("INSERT INTO orders_name_address_fts(orders_name_address_fts) VALUES('rebuild')"))
+            db.execute(text("INSERT INTO orders_phone_fts(orders_phone_fts) VALUES('rebuild')"))
+        db.commit()
+        ensure_search_optimizations(engine)
+        log_event(current_user, "전체 주문 데이터 삭제", "success", {"deleted_count": result.rowcount})
+        return {"message": "전체 주문 데이터가 삭제되었습니다.", "deleted_count": result.rowcount}
+    except Exception as e:
+        db.rollback()
+        ensure_search_optimizations(engine)
+        log_event(current_user, "전체 주문 데이터 삭제", "error", str(e))
+        raise HTTPException(status_code=500, detail=f"전체 삭제 오류: {str(e)}")
+
+@router.get("/delete-progress")
+async def delete_progress(
+    delete_token: str,
+    current_user = Depends(get_admin_user)
+):
+    user_id = f"{current_user.id}:{delete_token}"
+
+    async def event_generator():
+        while True:
+            state = delete_progress_state.get(user_id)
+            if state:
+                yield f"data: {json.dumps(state, ensure_ascii=False)}\n\n"
+                if state["status"] in ["completed", "error"]:
+                    delete_progress_state.pop(user_id, None)
+                    break
+            else:
+                yield f"data: {json.dumps({'status': 'idle'}, ensure_ascii=False)}\n\n"
+
+            await asyncio.sleep(0.5)
+
+    return StreamingResponse(event_generator(), media_type="text/event-stream")
+
+@router.post("/delete-orders-by-date-range")
+def delete_orders_by_date_range(
+    data: DeleteOrdersByDateRangeRequest,
+    db: Session = Depends(get_db),
+    current_user = Depends(get_admin_user)
+):
+    if data.password != "1225":
+        raise HTTPException(status_code=403, detail="비밀번호가 올바르지 않습니다.")
+
+    start_date, end_date = validate_date_range(data.start_date, data.end_date)
+
+    start_datetime = start_date.strftime("%Y-%m-%d")
+    end_datetime = f"{end_date.strftime('%Y-%m-%d')} 23:59:59"
+
+    progress_key = f"{current_user.id}:{data.delete_token}" if data.delete_token else None
+    params = {
+        "start_datetime": start_datetime,
+        "end_datetime": end_datetime,
+    }
+
+    try:
+        total_rows = db.execute(
+            text(
+                "SELECT COUNT(*) FROM orders "
+                "WHERE order_date >= :start_datetime "
+                "AND order_date <= :end_datetime"
+            ),
+            params,
+        ).scalar() or 0
+
+        if progress_key:
+            set_delete_progress(
+                progress_key,
+                status="processing",
+                message="삭제 대상을 확인했습니다.",
+                progress=0 if total_rows else 100,
+                cleanup_progress=0,
+                total_rows=total_rows,
+                deleted_rows=0,
+            )
+
+        if total_rows == 0:
+            if progress_key:
+                set_delete_progress(
+                    progress_key,
+                    status="completed",
+                    message="삭제할 데이터가 없습니다.",
+                    progress=100,
+                    cleanup_progress=100,
+                    total_rows=0,
+                    deleted_rows=0,
+                )
+            log_event(
+                current_user,
+                "날짜 범위 주문 데이터 삭제",
+                "success",
+                {"start_date": data.start_date, "end_date": data.end_date, "deleted_count": 0},
+            )
+            return {
+                "message": "삭제할 주문 데이터가 없습니다.",
+                "deleted_count": 0,
+                "start_date": data.start_date,
+                "end_date": data.end_date,
+            }
+
+        if progress_key:
+            set_delete_progress(
+                progress_key,
+                status="processing",
+                message="삭제 준비 중입니다.",
+                progress=0,
+                cleanup_progress=0,
+                total_rows=total_rows,
+                deleted_rows=0,
+                cleanup_step="검색 인덱스 트리거 중지",
+            )
+
+        is_sqlite = db.get_bind().dialect.name == "sqlite"
+        if is_sqlite:
+            db.execute(text("PRAGMA temp_store = MEMORY"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_fts_ai"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_fts_ad"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_fts_au"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_phone_fts_ai"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_phone_fts_ad"))
+            db.execute(text("DROP TRIGGER IF EXISTS orders_phone_fts_au"))
+        db.commit()
+
+        deleted_count = 0
+        uncommitted_rows = 0
+        while deleted_count < total_rows:
+            result = db.execute(
+                text(
+                    "DELETE FROM orders "
+                    "WHERE id IN ("
+                    "SELECT id FROM orders "
+                    "WHERE order_date >= :start_datetime "
+                    "AND order_date <= :end_datetime "
+                    "LIMIT :batch_size"
+                    ")"
+                ),
+                {
+                    **params,
+                    "batch_size": DELETE_BATCH_SIZE,
+                },
+            )
+
+            batch_deleted = max(0, result.rowcount or 0)
+            if batch_deleted == 0:
+                break
+
+            deleted_count += batch_deleted
+            uncommitted_rows += batch_deleted
+            if uncommitted_rows >= DELETE_COMMIT_EVERY_ROWS:
+                db.commit()
+                uncommitted_rows = 0
+
+            if progress_key:
+                set_delete_progress(
+                    progress_key,
+                    status="processing",
+                    message="주문 데이터를 삭제하는 중입니다.",
+                    progress=min(100, round((deleted_count / total_rows) * 100)),
+                    cleanup_progress=0,
+                    total_rows=total_rows,
+                    deleted_rows=deleted_count,
+                )
+
+        db.commit()
+
+        if progress_key:
+            set_delete_progress(
+                progress_key,
+                status="processing",
+                message="정리 작업을 시작합니다.",
+                progress=100,
+                cleanup_progress=5,
+                total_rows=total_rows,
+                deleted_rows=deleted_count,
+                cleanup_step="검색 인덱스 정리 준비",
+            )
+
+        if progress_key:
+            set_delete_progress(
+                progress_key,
+                status="processing",
+                message="이름/주소 검색 인덱스를 정리하는 중입니다.",
+                progress=100,
+                cleanup_progress=25,
+                total_rows=total_rows,
+                deleted_rows=deleted_count,
+                cleanup_step="이름/주소 인덱스 정리",
+            )
+        if is_sqlite:
+            db.execute(text("INSERT INTO orders_name_address_fts(orders_name_address_fts) VALUES('rebuild')"))
+
+        if progress_key:
+            set_delete_progress(
+                progress_key,
+                status="processing",
+                message="전화번호 검색 인덱스를 정리하는 중입니다.",
+                progress=100,
+                cleanup_progress=60,
+                total_rows=total_rows,
+                deleted_rows=deleted_count,
+                cleanup_step="전화번호 인덱스 정리",
+            )
+        if is_sqlite:
+            db.execute(text("INSERT INTO orders_phone_fts(orders_phone_fts) VALUES('rebuild')"))
+        db.commit()
+
+        if progress_key:
+            set_delete_progress(
+                progress_key,
+                status="processing",
+                message="검색 기능을 다시 연결하는 중입니다.",
+                progress=100,
+                cleanup_progress=90,
+                total_rows=total_rows,
+                deleted_rows=deleted_count,
+                cleanup_step="검색 트리거 복구",
+            )
+        ensure_search_optimizations(engine)
+        if progress_key:
+            set_delete_progress(
+                progress_key,
+                status="completed",
+                message="삭제가 완료되었습니다.",
+                progress=100,
+                cleanup_progress=100,
+                total_rows=total_rows,
+                deleted_rows=deleted_count,
+                cleanup_step="정리 완료",
+            )
+        log_event(
+            current_user,
+            "날짜 범위 주문 데이터 삭제",
+            "success",
+            {"start_date": data.start_date, "end_date": data.end_date, "deleted_count": deleted_count},
+        )
+        return {
+            "message": "지정한 날짜 범위의 주문 데이터가 삭제되었습니다.",
+            "deleted_count": deleted_count,
+            "start_date": data.start_date,
+            "end_date": data.end_date,
+        }
+    except Exception as e:
+        db.rollback()
+        ensure_search_optimizations(engine)
+        if progress_key:
+            set_delete_progress(
+                progress_key,
+                status="error",
+                message=f"삭제 오류: {str(e)}",
+                progress=0,
+                cleanup_progress=0,
+            )
+        log_event(
+            current_user,
+            "날짜 범위 주문 데이터 삭제",
+            "error",
+            {"start_date": data.start_date, "end_date": data.end_date, "error": str(e)},
+        )
+        raise HTTPException(status_code=500, detail=f"날짜 범위 삭제 오류: {str(e)}")
+
+@router.post("/export-db/start")
+def start_export_db(
+    start_date: Optional[str] = None,
+    end_date: Optional[str] = None,
+    current_user = Depends(get_current_user)
+):
+    if (start_date and not end_date) or (end_date and not start_date):
+        raise HTTPException(status_code=400, detail="시작일과 종료일을 모두 선택해주세요.")
+    if start_date and end_date:
+        validate_date_range(start_date, end_date)
+
+    export_token = str(uuid.uuid4())
+    user_label_data = {
+        "email": getattr(current_user, "email", None),
+        "name": getattr(current_user, "name", None),
+        "id": getattr(current_user, "id", ""),
+    }
+    set_export_progress(
+        export_token,
+        status="queued",
+        message="엑셀 파일 생성 대기 중입니다.",
+        processed_rows=0,
+        start_date=start_date,
+        end_date=end_date,
+    )
+    threading.Thread(
+        target=run_export_job,
+        args=(export_token, start_date, end_date, user_label_data),
+        daemon=True,
+    ).start()
+    log_event(
+        current_user,
+        "DB 데이터 엑셀 다운로드 작업 등록",
+        "info",
+        {"start_date": start_date, "end_date": end_date, "export_token": export_token},
+    )
+    return {"export_token": export_token, "status": "queued"}
+
+
+@router.get("/export-db/status")
+def get_export_db_status(export_token: str, current_user = Depends(get_current_user)):
+    job = get_export_progress(export_token)
+    if not job:
+        raise HTTPException(status_code=404, detail="다운로드 작업을 찾을 수 없습니다.")
+    public_job = {k: v for k, v in job.items() if k != "file_path"}
+    return public_job
+
+
+@router.get("/export-db/download")
+def download_export_db_file(export_token: str, current_user = Depends(get_current_user)):
+    job = get_export_progress(export_token)
+    if not job:
+        raise HTTPException(status_code=404, detail="다운로드 작업을 찾을 수 없습니다.")
+    if job.get("status") != "completed":
+        raise HTTPException(status_code=409, detail=job.get("message") or "엑셀 파일 생성이 아직 완료되지 않았습니다.")
+
+    file_path = job.get("file_path")
+    if not file_path or not os.path.exists(file_path):
+        raise HTTPException(status_code=404, detail="생성된 엑셀 파일을 찾을 수 없습니다.")
+
+    log_event(
+        current_user,
+        "DB 데이터 엑셀 파일 다운로드",
+        "success",
+        {
+            "export_token": export_token,
+            "processed_rows": job.get("processed_rows", 0),
+            "filename": job.get("filename"),
+        },
+    )
+    return FileResponse(
+        file_path,
+        media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        filename=job.get("filename") or "DB_Export.xlsx",
+    )
+
+
+@router.get("/export-db")
+def export_entire_db_legacy(current_user = Depends(get_current_user)):
+    raise HTTPException(
+        status_code=409,
+        detail="엑셀 파일 생성 시간이 길어 백그라운드 다운로드 방식으로 변경되었습니다. 페이지를 새로고침한 뒤 다시 시도해주세요.",
+    )
+
+
+@router.get("/download-log")
+def download_event_log(current_user = Depends(get_admin_user)):
+    try:
+        log_event(current_user, "로그 파일 다운로드 요청", "info")
+        timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
+        filename = quote(f"OMS_event_log_{timestamp}.csv")
+        with open(EVENT_LOG_PATH, "rb") as f:
+            content = f.read()
+        log_event(
+            current_user,
+            "로그 파일 다운로드",
+            "success",
+            {"event_log_path": os.path.abspath(EVENT_LOG_PATH), "bytes": len(content)},
+        )
+        return Response(
+            content=content,
+            media_type="text/csv; charset=utf-8",
+            headers={"Content-Disposition": f"attachment; filename*=UTF-8''{filename}"},
+        )
+    except Exception as e:
+        log_operation_error(
+            current_user,
+            "로그 파일 다운로드",
+            e,
+            {"event_log_path": os.path.abspath(EVENT_LOG_PATH)},
+        )
+        raise HTTPException(status_code=500, detail=f"로그 다운로드 오류: {type(e).__name__}: {str(e)}")
+
+
+@router.get("/repeat-purchase-export")
+async def export_repeat_purchase_orders(
+    start_date: str,
+    end_date: str,
+    min_count: int = 3,
+    db: Session = Depends(get_db),
+    current_user = Depends(get_admin_user),
+):
+    validate_date_range(start_date, end_date)
+    if min_count < 1:
+        raise HTTPException(status_code=400, detail="구매 회수는 1 이상이어야 합니다.")
+
+    params = {
+        "start_datetime": start_date,
+        "end_datetime": f"{end_date} 23:59:59",
+        "min_count": min_count,
+    }
+
+    try:
+        rows = db.execute(
+            text(
+                """
+                WITH qualified AS (
+                    SELECT
+                        trim(coalesce(recipient_name, '')) AS name_key,
+                        coalesce(
+                            nullif(recipient_mobile_normalized, ''),
+                            nullif(recipient_phone_normalized, '')
+                        ) AS phone_key,
+                        count(DISTINCT substr(order_date, 1, 10)) AS purchase_count
+                    FROM orders
+                    WHERE order_date >= :start_datetime
+                      AND order_date <= :end_datetime
+                      AND trim(coalesce(recipient_name, '')) != ''
+                      AND coalesce(
+                            nullif(recipient_mobile_normalized, ''),
+                            nullif(recipient_phone_normalized, '')
+                          ) IS NOT NULL
+                    GROUP BY name_key, phone_key
+                    HAVING count(DISTINCT substr(order_date, 1, 10)) >= :min_count
+                )
+                SELECT
+                    q.purchase_count AS purchase_count,
+                    o.order_date AS order_date,
+                    o.recipient_name AS recipient_name,
+                    coalesce(nullif(o.recipient_mobile, ''), o.recipient_phone) AS display_phone,
+                    o.product_code AS product_code,
+                    o.product_name AS product_name,
+                    o.order_quantity AS order_quantity,
+                    o.address AS address,
+                    o.tracking_number AS tracking_number,
+                    o.vendor AS vendor,
+                    o.order_no AS order_no,
+                    o.order_no_mall AS order_no_mall,
+                    o.order_list_1 AS order_list_1
+                FROM orders o
+                JOIN qualified q
+                  ON trim(coalesce(o.recipient_name, '')) = q.name_key
+                 AND coalesce(
+                        nullif(o.recipient_mobile_normalized, ''),
+                        nullif(o.recipient_phone_normalized, '')
+                     ) = q.phone_key
+                WHERE o.order_date >= :start_datetime
+                  AND o.order_date <= :end_datetime
+                ORDER BY q.purchase_count DESC, q.name_key ASC, q.phone_key ASC, o.order_date DESC, o.id DESC
+                """
+            ),
+            params,
+        ).mappings().all()
+
+        if not rows:
+            raise HTTPException(status_code=404, detail="해당 조건의 반복 구매 주문이 없습니다.")
+
+        excel_rows = []
+        for row in rows:
+            excel_rows.append({
+                "구매회수": row["purchase_count"],
+                "주문날짜": row["order_date"],
+                "수령인명": row["recipient_name"],
+                "전화번호": row["display_phone"],
+                "상품코드": row["product_code"],
+                "상품명": row["product_name"],
+                "수량": row["order_quantity"],
+                "주소": row["address"],
+                "송장번호": row["tracking_number"],
+                "발주처": row["vendor"],
+                "주문번호": row["order_no"],
+                "주문번호(쇼핑몰)": row["order_no_mall"],
+                "주문목록": row["order_list_1"],
+            })
+
+        filename = f"반복구매_{start_date}_to_{end_date}_{min_count}회이상.xlsx"
+        log_event(
+            current_user,
+            "반복 구매 주문 리스트 다운로드",
+            "success",
+            {
+                "start_date": start_date,
+                "end_date": end_date,
+                "min_count": min_count,
+                "download_count": len(excel_rows),
+            },
+        )
+        return excel_response_from_rows(excel_rows, filename, "Repeat_Purchases")
+    except HTTPException:
+        raise
+    except Exception as e:
+        log_event(
+            current_user,
+            "반복 구매 주문 리스트 다운로드",
+            "error",
+            {
+                "start_date": start_date,
+                "end_date": end_date,
+                "min_count": min_count,
+                "error": str(e),
+            },
+        )
+        raise HTTPException(status_code=500, detail=f"반복 구매 리스트 다운로드 오류: {str(e)}")
diff --git a/app/search_utils.py b/app/search_utils.py
new file mode 100644
index 0000000..12a8532
--- /dev/null
+++ b/app/search_utils.py
@@ -0,0 +1,39 @@
+import re
+
+
+_NON_DIGIT_RE = re.compile(r"\D+")
+_NON_ALNUM_RE = re.compile(r"[^0-9A-Za-z]+")
+
+
+def normalize_phone(value: str | None) -> str | None:
+    if not value:
+        return None
+    normalized = _NON_DIGIT_RE.sub("", str(value))
+    return normalized or None
+
+
+def normalize_tracking(value: str | None) -> str | None:
+    if not value:
+        return None
+    normalized = _NON_ALNUM_RE.sub("", str(value)).upper()
+    return normalized or None
+
+
+def fts_phrase(value: str) -> str:
+    escaped = str(value).strip().replace('"', '""')
+    return f'"{escaped}"'
+
+
+def can_use_trigram_fts(value: str | None) -> bool:
+    if not value:
+        return False
+    return len(str(value).strip()) >= 3
+
+
+def prefix_upper_bound(value: str) -> str | None:
+    if not value:
+        return None
+    last = value[-1]
+    if last == "\uffff":
+        return None
+    return value[:-1] + chr(ord(last) + 1)
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..81a83dc
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,32 @@
+services:
+  app:
+    build: .
+    image: orderlist-app:latest
+    container_name: orderlist-app
+    restart: unless-stopped
+    env_file:
+      - .env
+    environment:
+      # .env에 적힌 값이 컨테이너에서 그대로 보입니다.
+      # 컨테이너 내부에서 DB_HOST는 반드시 postgres-db 여야 합니다.
+      DB_HOST: ${DB_HOST:-postgres-db}
+    ports:
+      - "8000:8000"
+    networks:
+      - postgres_net
+      - default
+    healthcheck:
+      test: ["CMD", "curl", "-fsS", "http://localhost:8000/health/db"]
+      interval: 30s
+      timeout: 5s
+      retries: 5
+      start_period: 20s
+
+networks:
+  # 이미 운영 중인 postgres-db 컨테이너가 속해 있는 외부 네트워크에
+  # 그대로 attach 합니다. (compose가 새로 만들지 않음)
+  postgres_net:
+    external: true
+    name: ${POSTGRES_NETWORK:-postgres-net}
+  default:
+    driver: bridge
diff --git a/push_to_gitea.bat b/push_to_gitea.bat
new file mode 100644
index 0000000..74a75ee
--- /dev/null
+++ b/push_to_gitea.bat
@@ -0,0 +1,110 @@
+@echo off
+setlocal EnableExtensions EnableDelayedExpansion
+chcp 65001 >nul
+
+REM ===============================================================
+REM  Push project to Gitea (Windows)
+REM  Usage:
+REM    push_to_gitea.bat
+REM    push_to_gitea.bat "commit message"
+REM  비밀번호/토큰은 이 파일에 절대 저장하지 않습니다.
+REM  인증은 Git Credential Manager 또는 푸시 시 직접 입력으로 처리됩니다.
+REM ===============================================================
+
+set "REMOTE_URL=https://gitea.no1king.freeddns.org/king/dbx-orderlist.git"
+set "BRANCH=main"
+
+cd /d "%~dp0"
+
+where git >nul 2>nul
+if errorlevel 1 (
+    echo [ERROR] git 가 PATH 에 없습니다. Git for Windows 를 설치하세요.
+    exit /b 1
+)
+
+REM ---- 1) 저장소 초기화 (이미 있으면 그대로 사용) ----
+if not exist ".git" (
+    echo [INFO] Git 저장소를 초기화합니다.
+    git init -b %BRANCH%
+    if errorlevel 1 (
+        git init
+        git symbolic-ref HEAD refs/heads/%BRANCH%
+    )
+) else (
+    echo [INFO] 이미 Git 저장소가 초기화되어 있습니다.
+)
+
+REM ---- 2) 현재 브랜치를 main 으로 맞춤 ----
+for /f "delims=" %%b in ('git rev-parse --abbrev-ref HEAD 2^>nul') do set "CURRENT_BRANCH=%%b"
+if not defined CURRENT_BRANCH set "CURRENT_BRANCH=HEAD"
+if /I not "%CURRENT_BRANCH%"=="%BRANCH%" (
+    if "%CURRENT_BRANCH%"=="HEAD" (
+        git checkout -b %BRANCH% 2>nul
+    ) else (
+        echo [INFO] 현재 브랜치 %CURRENT_BRANCH% -> %BRANCH% 로 이름 변경합니다.
+        git branch -M %BRANCH%
+    )
+)
+
+REM ---- 3) origin 설정 / 확인 ----
+git remote get-url origin >nul 2>nul
+if errorlevel 1 (
+    echo [INFO] origin 을 추가합니다: %REMOTE_URL%
+    git remote add origin "%REMOTE_URL%"
+) else (
+    for /f "delims=" %%u in ('git remote get-url origin') do set "EXIST_URL=%%u"
+    if /I not "!EXIST_URL!"=="%REMOTE_URL%" (
+        echo [INFO] origin URL 이 다릅니다.
+        echo        기존: !EXIST_URL!
+        echo        변경: %REMOTE_URL%
+        git remote set-url origin "%REMOTE_URL%"
+    ) else (
+        echo [INFO] origin 이 이미 올바르게 설정되어 있습니다.
+    )
+)
+
+REM ---- 4) 변경 사항 add ----
+git add -A
+
+REM ---- 5) status 보여주고 사용자 확인 ----
+echo.
+echo =============== git status ===============
+git status
+echo ==========================================
+echo.
+set /p CONFIRM="이 내용을 커밋 & push 하시겠습니까? (Y/N): "
+if /I not "%CONFIRM%"=="Y" (
+    echo [INFO] 사용자가 취소했습니다.
+    exit /b 0
+)
+
+REM ---- 6) 커밋 메시지 결정 ----
+set "MSG=%~1"
+if "%MSG%"=="" (
+    set /p MSG="커밋 메시지를 입력하세요 (빈 값이면 'update project'): "
+)
+if "%MSG%"=="" set "MSG=update project"
+
+REM ---- 7) 커밋 (변경 없으면 건너뜀) ----
+git diff --cached --quiet
+if errorlevel 1 (
+    git commit -m "%MSG%"
+    if errorlevel 1 (
+        echo [ERROR] 커밋 실패.
+        exit /b 1
+    )
+) else (
+    echo [INFO] 스테이징된 변경이 없습니다. 커밋을 건너뜁니다.
+)
+
+REM ---- 8) push ----
+echo [INFO] origin/%BRANCH% 로 push 합니다. 인증창이 뜨면 Gitea ID/비밀번호 또는 토큰을 입력하세요.
+git push -u origin %BRANCH%
+if errorlevel 1 (
+    echo [ERROR] push 실패. 인증 또는 네트워크 상태를 확인하세요.
+    exit /b 1
+)
+
+echo.
+echo [OK] 완료되었습니다.
+endlocal
diff --git a/push_to_gitea.sh b/push_to_gitea.sh
new file mode 100644
index 0000000..ef827cd
--- /dev/null
+++ b/push_to_gitea.sh
@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+# =================================================================
+#  Push project to Gitea (Ubuntu / Linux / macOS)
+#  Usage:
+#    ./push_to_gitea.sh
+#    ./push_to_gitea.sh "commit message"
+#  비밀번호/토큰은 이 파일에 절대 저장하지 않습니다.
+#  HTTPS 인증은 Git Credential Manager / git-credential-store /
+#  또는 push 시 직접 입력으로 처리됩니다.
+# =================================================================
+set -euo pipefail
+
+REMOTE_URL="https://gitea.no1king.freeddns.org/king/dbx-orderlist.git"
+BRANCH="main"
+
+cd "$(dirname "$0")"
+
+if ! command -v git >/dev/null 2>&1; then
+    echo "[ERROR] git 가 설치되어 있지 않습니다." >&2
+    exit 1
+fi
+
+# ---- 1) 저장소 초기화 (이미 있으면 그대로 사용) ----
+if [ ! -d ".git" ]; then
+    echo "[INFO] Git 저장소를 초기화합니다."
+    if ! git init -b "$BRANCH" 2>/dev/null; then
+        git init
+        git symbolic-ref HEAD "refs/heads/$BRANCH"
+    fi
+else
+    echo "[INFO] 이미 Git 저장소가 초기화되어 있습니다."
+fi
+
+# ---- 2) 현재 브랜치를 main 으로 맞춤 ----
+current_branch="$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo HEAD)"
+if [ "$current_branch" != "$BRANCH" ]; then
+    if [ "$current_branch" = "HEAD" ]; then
+        git checkout -b "$BRANCH" 2>/dev/null || true
+    else
+        echo "[INFO] 현재 브랜치 $current_branch -> $BRANCH 로 이름 변경합니다."
+        git branch -M "$BRANCH"
+    fi
+fi
+
+# ---- 3) origin 설정 / 확인 ----
+if ! git remote get-url origin >/dev/null 2>&1; then
+    echo "[INFO] origin 을 추가합니다: $REMOTE_URL"
+    git remote add origin "$REMOTE_URL"
+else
+    existing="$(git remote get-url origin)"
+    if [ "$existing" != "$REMOTE_URL" ]; then
+        echo "[INFO] origin URL 이 다릅니다."
+        echo "       기존: $existing"
+        echo "       변경: $REMOTE_URL"
+        git remote set-url origin "$REMOTE_URL"
+    else
+        echo "[INFO] origin 이 이미 올바르게 설정되어 있습니다."
+    fi
+fi
+
+# ---- 4) 변경 사항 add ----
+git add -A
+
+# ---- 5) status 보여주고 사용자 확인 ----
+echo
+echo "=============== git status ==============="
+git status
+echo "=========================================="
+echo
+read -r -p "이 내용을 커밋 & push 하시겠습니까? (Y/N): " CONFIRM
+case "${CONFIRM:-N}" in
+    [yY]|[yY][eE][sS]) ;;
+    *) echo "[INFO] 사용자가 취소했습니다."; exit 0;;
+esac
+
+# ---- 6) 커밋 메시지 결정 ----
+MSG="${1:-}"
+if [ -z "$MSG" ]; then
+    read -r -p "커밋 메시지를 입력하세요 (빈 값이면 'update project'): " MSG
+fi
+MSG="${MSG:-update project}"
+
+# ---- 7) 커밋 (변경 없으면 건너뜀) ----
+if ! git diff --cached --quiet; then
+    git commit -m "$MSG"
+else
+    echo "[INFO] 스테이징된 변경이 없습니다. 커밋을 건너뜁니다."
+fi
+
+# ---- 8) push ----
+echo "[INFO] origin/$BRANCH 로 push 합니다. 인증창이 뜨면 Gitea ID/비밀번호 또는 토큰을 입력하세요."
+git push -u origin "$BRANCH"
+
+echo
+echo "[OK] 완료되었습니다."
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..9e0999f
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,9 @@
+fastapi>=0.110
+uvicorn[standard]>=0.27
+sqlalchemy>=2.0
+psycopg2-binary>=2.9
+python-multipart>=0.0.9
+itsdangerous>=2.1
+httpx>=0.27
+openpyxl>=3.1
+pydantic>=2.6
diff --git a/static/css/style.css b/static/css/style.css
new file mode 100644
index 0000000..ba1347a
--- /dev/null
+++ b/static/css/style.css
@@ -0,0 +1,1772 @@
+/* Base Variables & Reset */
+:root {
+    --primary-color: #4f46e5;
+    --primary-hover: #4338ca;
+    --success-color: #10b981;
+    --success-hover: #059669;
+    --text-main: #1f2937;
+    --text-muted: #6b7280;
+    --bg-color: #f3f4f6;
+    --glass-bg: rgba(255, 255, 255, 0.7);
+    --glass-border: rgba(255, 255, 255, 0.5);
+    --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+    --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+    --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+    --border-radius: 12px;
+    --transition-fast: 0.2s ease;
+}
+
+* {
+    box-sizing: border-box;
+    margin: 0;
+    padding: 0;
+}
+
+body {
+    font-family: 'Inter', sans-serif;
+    background-color: var(--bg-color);
+    color: var(--text-main);
+    line-height: 1.6;
+    overflow-x: hidden;
+    position: relative;
+    min-height: 100vh;
+}
+
+/* Background Animated Shapes for Glassmorphism */
+.bg-shape {
+    position: fixed;
+    border-radius: 50%;
+    filter: blur(80px);
+    z-index: -1;
+    opacity: 0.6;
+    animation: float 15s infinite ease-in-out alternate;
+}
+
+.shape-1 {
+    width: 600px;
+    height: 600px;
+    background: linear-gradient(135deg, #a78bfa, #c084fc);
+    top: -200px;
+    left: -200px;
+}
+
+.shape-2 {
+    width: 500px;
+    height: 500px;
+    background: linear-gradient(135deg, #60a5fa, #3b82f6);
+    bottom: -100px;
+    right: -150px;
+    animation-delay: -5s;
+}
+
+.shape-3 {
+    width: 400px;
+    height: 400px;
+    background: linear-gradient(135deg, #34d399, #10b981);
+    top: 40%;
+    left: 40%;
+    animation-delay: -10s;
+    opacity: 0.4;
+}
+
+@keyframes float {
+    0% {
+        transform: translate(0, 0) scale(1);
+    }
+
+    100% {
+        transform: translate(50px, 50px) scale(1.1);
+    }
+}
+
+/* Glassmorphism Panel */
+.glass-panel {
+    background: var(--glass-bg);
+    backdrop-filter: blur(16px);
+    -webkit-backdrop-filter: blur(16px);
+    border: 1px solid var(--glass-border);
+    border-radius: var(--border-radius);
+    box-shadow: var(--shadow-lg);
+}
+
+/* Screens */
+.screen {
+    display: none;
+    height: 100vh;
+    width: 100%;
+    flex-direction: column;
+    overflow: hidden;
+}
+
+.screen.active {
+    display: flex;
+}
+
+#login-screen {
+    justify-content: center;
+    align-items: center;
+    background: transparent;
+}
+
+.hidden {
+    display: none !important;
+}
+
+/* Login Box */
+.login-box {
+    padding: 3rem;
+    text-align: center;
+    max-width: 450px;
+    width: 90%;
+}
+
+.logo {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    margin-bottom: 1.5rem;
+}
+
+.logo-icon {
+    font-size: 3rem;
+    color: var(--primary-color);
+    margin-bottom: 1rem;
+}
+
+.logo h2 {
+    font-weight: 700;
+    font-size: 1.8rem;
+    letter-spacing: -0.5px;
+}
+
+.subtitle {
+    color: var(--text-muted);
+    margin-bottom: 2.5rem;
+}
+
+.auth-hint {
+    margin-top: 1.5rem;
+    font-size: 0.85rem;
+    color: var(--text-muted);
+}
+
+/* Buttons */
+.btn {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: 0.75rem 1.5rem;
+    border: none;
+    border-radius: 8px;
+    font-weight: 600;
+    font-size: 1rem;
+    cursor: pointer;
+    transition: var(--transition-fast);
+    gap: 0.5rem;
+}
+
+.btn:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+}
+
+.btn-google {
+    background-color: white;
+    color: #3f3f3f;
+    box-shadow: var(--shadow-sm);
+    width: 100%;
+}
+
+.btn-google img {
+    width: 20px;
+    height: 20px;
+}
+
+.btn-google:hover {
+    box-shadow: var(--shadow-md);
+    transform: translateY(-2px);
+}
+
+.btn-primary {
+    background-color: var(--primary-color);
+    color: white;
+}
+
+.btn-primary:hover:not(:disabled) {
+    background-color: var(--primary-hover);
+    transform: translateY(-2px);
+}
+
+.btn-success {
+    background-color: var(--success-color);
+    color: white;
+}
+
+.btn-success:hover:not(:disabled) {
+    background-color: var(--success-hover);
+    transform: translateY(-2px);
+}
+
+.btn-danger {
+    background-color: #ef4444;
+    color: white;
+}
+
+.btn-danger:hover:not(:disabled) {
+    background-color: #dc2626;
+    transform: translateY(-2px);
+}
+
+.btn-secondary {
+    background-color: #e5e7eb;
+    color: var(--text-main);
+}
+
+.btn-secondary:hover:not(:disabled) {
+    background-color: #d1d5db;
+    transform: translateY(-2px);
+}
+
+.btn-warning {
+    background-color: #f59e0b;
+    color: #ffffff;
+}
+
+.btn-warning:hover:not(:disabled) {
+    background-color: #d97706;
+    transform: translateY(-2px);
+}
+
+.icon-btn {
+    background: transparent;
+    border: none;
+    font-size: 1.2rem;
+    color: var(--text-muted);
+    cursor: pointer;
+    padding: 0.5rem;
+    border-radius: 50%;
+    transition: var(--transition-fast);
+}
+
+.icon-btn:hover {
+    color: var(--primary-color);
+    background-color: rgba(79, 70, 229, 0.1);
+}
+
+/* Unified Header (Top Bar) */
+.unified-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 4px 0.75rem;
+    gap: 0.45rem;
+    background: var(--primary-color);
+    backdrop-filter: none;
+    border-bottom: 1px solid var(--border-color);
+    box-shadow: 0 4px 6px rgba(0, 0, 0, 0.05);
+    margin-bottom: 0px;
+    border-top-left-radius: 12px;
+    border-top-right-radius: 12px;
+    border-bottom-left-radius: 0;
+    border-bottom-right-radius: 0;
+    z-index: 10;
+}
+
+/* 1. Logo */
+.nav-brand {
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    color: #ffffff;
+    flex: 0 0 48px;
+    width: 48px;
+    height: 48px;
+}
+
+.brand-logo-img {
+    width: 48px;
+    height: 48px;
+    object-fit: contain;
+    display: block;
+    background: transparent;
+}
+
+/* 2. Search & Action Area */
+.nav-center-area {
+    display: flex;
+    align-items: center;
+    gap: 0.45rem;
+    flex: 1;
+    min-width: 0;
+    flex-wrap: nowrap;
+}
+
+.nav-center-area>button,
+.nav-center-area>.upload-section-mini {
+    display: flex;
+    flex-direction: row;
+    justify-content: center;
+}
+
+.upload-section-mini .btn-upload-tall {
+    height: 34px;
+}
+
+.nav-cent.search-actions {
+    display: flex;
+    gap: 1rem;
+    align-items: stretch;
+    min-width: max-content;
+}
+
+.search-grid-2x2 {
+    display: flex;
+    align-items: center;
+    flex-wrap: nowrap;
+    gap: 0.45rem;
+    flex: 1 1 auto;
+    max-width: none;
+    min-width: 0;
+}
+
+.input-group-original {
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+    gap: 0.35rem;
+    min-width: 0;
+    flex: 0 0 auto;
+}
+
+.input-group-original label {
+    font-size: 1.05rem;
+    font-weight: 700;
+    color: #ffffff;
+    white-space: nowrap;
+    min-width: auto;
+    text-align: right;
+    margin: 0;
+}
+
+.input-group-original.compact-field .input-wrapper {
+    flex: 0 0 140px;
+    width: 140px;
+}
+
+.input-group-original.address-field .input-wrapper {
+    flex: 0 0 166px;
+    width: 166px;
+}
+
+.date-range-filter {
+    flex: 0 0 auto;
+}
+
+.date-range-inputs,
+.modal-date-range {
+    display: flex;
+    align-items: center;
+    gap: 0.35rem;
+}
+
+.date-range-inputs .input-wrapper {
+    flex: 0 0 160px;
+    width: 160px;
+    min-width: 160px;
+}
+
+.date-range-separator,
+.modal-date-range span {
+    color: #ffffff;
+    font-weight: 700;
+}
+
+/* Table Header and Resizer styles */
+#results-table th {
+    background-color: var(--table-header-bg);
+    color: var(--primary-color);
+    font-weight: 600;
+    text-transform: uppercase;
+    font-size: 0.85rem;
+    letter-spacing: 0.5px;
+    position: sticky;
+    top: 0;
+    z-index: 10;
+    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.05);
+    white-space: nowrap;
+    position: relative;
+    /* For resizer */
+}
+
+/* Resizer styles */
+.resizer {
+    position: absolute;
+    top: 0;
+    right: 0;
+    width: 5px;
+    cursor: col-resize;
+    user-select: none;
+    height: 100%;
+}
+
+.resizer:hover,
+.resizing {
+    background-color: var(--primary-color);
+    opacity: 0.5;
+}
+
+.col-address {
+    white-space: nowrap;
+}
+
+.col-order-no {
+    white-space: nowrap;
+}
+
+.col-ext {
+    white-space: nowrap;
+}
+
+/* --- THE ORIGINAL INPUT DESIGN/* Input Icon styles */
+.input-wrapper {
+    position: relative;
+    display: flex;
+    align-items: center;
+}
+
+.input-icon {
+    position: absolute;
+    left: 0.8rem;
+    color: #94a3b8;
+    pointer-events: none;
+    font-size: 0.85rem;
+}
+
+/* Inputs styling */
+.form-control,
+.input-wrapper input {
+    width: 100%;
+    padding: 0.3rem 0.55rem;
+    padding-left: 1.75rem;
+    border: 1px solid var(--border-color);
+    border-radius: 8px;
+    font-size: 0.9rem;
+    transition: all 0.2s ease;
+    background-color: #ffffff;
+    /* Explicit white background requested */
+    height: 30px;
+}
+
+.input-wrapper i {
+    position: absolute;
+    left: 0.65rem;
+    color: var(--text-main);
+    /* Darker icon color like image */
+    pointer-events: none;
+    font-size: 0.85rem;
+    z-index: 2;
+}
+
+.input-wrapper input:focus {
+    outline: none;
+    border-color: var(--primary-color);
+    box-shadow: 0 0 0 3px rgba(79, 70, 229, 0.1);
+}
+
+/* Buttons */
+.btn-search-tall {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 1rem;
+    font-weight: 600;
+    padding: 0 1rem;
+    /* Wider padding like image */
+    border-radius: 6px;
+    white-space: nowrap;
+    flex-direction: row;
+    gap: 0.35rem;
+    flex-wrap: nowrap;
+    line-height: 1;
+    width: 96px !important;
+    height: 48px !important;
+    box-sizing: border-box !important;
+    background-color: #111827;
+    color: white;
+    box-shadow: 0 2px 4px rgba(79, 70, 229, 0.2);
+    border: none;
+    transition: all 0.2s ease;
+}
+
+.btn-search-tall i {
+    position: static;
+    color: inherit;
+    pointer-events: auto;
+    font-size: 1rem;
+}
+
+.btn-search-tall:hover:not(:disabled) {
+    background-color: #0f172a;
+}
+
+.btn-reset-search {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex-direction: row;
+    flex-wrap: nowrap;
+    gap: 0.35rem;
+    width: 90px;
+    height: 48px;
+    border-radius: 6px;
+    border: none;
+    background-color: #ef4444;
+    color: #ffffff;
+    font-size: 1.08rem;
+    font-weight: 800;
+    line-height: 1;
+    white-space: nowrap;
+}
+
+.btn-reset-search:hover:not(:disabled) {
+    background-color: #dc2626;
+}
+
+.btn-upload-tall {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 0.32rem;
+    font-size: 0.88rem;
+    font-weight: 800;
+    padding: 0 0.28rem;
+    border-radius: 6px;
+    white-space: normal;
+    width: 110px !important;
+    height: 48px !important;
+    box-sizing: border-box !important;
+    transition: all 0.2s ease;
+    /* Removed flex: 1 so it doesn't stretch and change proportions */
+}
+
+.btn-upload-tall-narrow {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 1.1rem;
+    font-weight: 600;
+    padding: 0 1rem;
+    border-radius: 6px;
+    white-space: nowrap;
+    width: 130px !important;
+    /* Narrower width requested */
+    height: 75px !important;
+    /* Exact height requested */
+    box-sizing: border-box !important;
+    transition: all 0.2s ease;
+}
+
+/* Upload Custom Styles */
+input[type="file"] {
+    display: none;
+}
+
+.custom-file-upload {
+    display: inline-flex;
+    align-items: center;
+    cursor: pointer;
+    background-color: white;
+    border: 1px solid #d1d5db;
+    border-radius: 8px;
+    font-weight: 600;
+    transition: var(--transition-fast);
+    color: var(--text-main);
+}
+
+.custom-file-upload:hover {
+    border-color: var(--primary-color);
+    color: var(--primary-color);
+}
+
+.custom-file-upload.btn-excel {
+    background-color: #107c41;
+    /* Excel green */
+    color: white;
+    border: none;
+    /* Removed border to look cleaner like image */
+    box-shadow: 0 2px 4px rgba(16, 124, 65, 0.2);
+}
+
+.custom-file-upload.btn-excel:hover {
+    background-color: #0c5e31;
+    border-color: #0c5e31;
+    color: white;
+    transform: translateY(-1px);
+}
+
+.upload-section-mini {
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+    justify-content: center;
+    position: relative;
+}
+
+.custom-file-upload.btn-upload-tall {
+    height: 48px !important;
+    width: 110px !important;
+    padding: 0 0.28rem;
+    font-size: 0.88rem;
+    line-height: 1.05;
+}
+
+.custom-file-upload.btn-upload-tall i {
+    font-size: 1.25rem;
+    flex: 0 0 auto;
+}
+
+.upload-label-text {
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+    justify-content: center;
+    gap: 0.08rem;
+    line-height: 1.05;
+    white-space: nowrap;
+}
+
+/* 3. Profile */
+.nav-profile-area {
+    display: flex;
+    align-items: center;
+    gap: 0.35rem;
+    flex: 0 0 auto;
+}
+
+.user-profile.mini-profile {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    font-weight: 500;
+    font-size: 1rem;
+    color: #ffffff;
+}
+
+.avatar.mini-avatar {
+    width: 32px;
+    height: 32px;
+    border-radius: 50%;
+    background-color: var(--primary-color);
+    color: white;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+}
+
+.icon-btn.mini-icon-btn {
+    padding: 0.4rem;
+    font-size: 1.1rem;
+    color: var(--text-muted);
+}
+
+.nav-profile-area>.icon-btn.mini-icon-btn:not(.nav-tool-btn) {
+    color: #ffffff;
+}
+
+.icon-btn.mini-icon-btn.nav-tool-btn {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 32px;
+    height: 32px;
+    padding: 0;
+    font-size: 1.45rem;
+    color: #ffffff;
+    border-radius: 50%;
+    line-height: 1;
+}
+
+.icon-btn.mini-icon-btn.nav-tool-btn:hover {
+    color: #ffffff;
+    background-color: rgba(255, 255, 255, 0.16);
+}
+
+.icon-btn.mini-icon-btn.nav-tool-btn i {
+    line-height: 1;
+}
+
+.icon-btn.mini-icon-btn:hover {
+    color: var(--primary-color);
+}
+
+.nav-profile-area>.icon-btn.mini-icon-btn:not(.nav-tool-btn):hover {
+    color: #ffffff;
+    background-color: rgba(255, 255, 255, 0.16);
+}
+
+/* Main Content Wrapper */
+.main-content {
+    padding: 0;
+    display: flex;
+    flex-direction: column;
+    flex: 1;
+    min-height: 0;
+}
+
+.search-panel {
+    background: var(--surface-color);
+    padding: 1rem 1.5rem;
+    /* Reverted padding */
+    border-top-left-radius: 12px;
+    border-top-right-radius: 12px;
+    border-bottom-left-radius: 0;
+    border-bottom-right-radius: 0;
+    box-shadow: 0 0 6px rgba(0, 0, 0, 0.05);
+    /* reduced shadow underneath */
+    margin-bottom: 0 !important;
+    display: flex;
+    flex-wrap: wrap;
+    gap: 1rem;
+    align-items: center;
+    border-bottom: 1px solid var(--border-color);
+    /* Separator line between panels */
+}
+
+.search-group {
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+    /* Reverted gap */
+    flex: 1;
+    min-width: 200px;
+}
+
+/* Results Panel & Table */
+.results-panel {
+    padding: 1rem 1.5rem;
+    flex: 1;
+    display: flex;
+    flex-direction: column;
+    min-height: 0;
+    margin-top: 0 !important;
+    border-top-left-radius: 0;
+    border-top-right-radius: 0;
+    border-bottom-left-radius: 12px;
+    border-bottom-right-radius: 12px;
+}
+
+.results-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 0.5rem;
+}
+
+.results-header h3 {
+    font-size: 1.1rem;
+    font-weight: 600;
+}
+
+.btn-search-download {
+    min-height: 30px;
+    padding: 0.35rem 0.7rem;
+    border-radius: 6px;
+    font-size: 0.8rem;
+    white-space: nowrap;
+}
+
+.badge {
+    background-color: var(--primary-color);
+    color: white;
+    padding: 0.2rem 0.6rem;
+    border-radius: 9999px;
+    font-size: 0.8rem;
+    margin-left: 0.5rem;
+}
+
+.pagination {
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    padding: 1rem 0;
+    gap: 0.5rem;
+    flex-wrap: wrap;
+}
+
+.btn-page {
+    width: 20px;
+    /* Reduced to ~60% of 32px */
+    height: 20px;
+    border-radius: 50%;
+    border: none;
+    background-color: var(--primary-color);
+    color: white;
+    font-weight: 600;
+    font-size: 0.6rem;
+    /* Scaled down */
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: all 0.2s ease;
+    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+}
+
+.btn-page-nav {
+    width: auto;
+    min-width: 78px;
+    padding: 0 0.55rem;
+    border-radius: 999px;
+    font-size: 0.68rem;
+}
+
+#btn-search,
+#btn-show-upload {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 0.5rem;
+    font-weight: 600;
+}
+
+.btn-page:hover {
+    transform: scale(1.1);
+    background-color: #4338ca;
+}
+
+.btn-page.active {
+    background-color: #ef4444;
+    /* Red color as requested */
+    color: white;
+    box-shadow: 0 4px 6px rgba(239, 68, 68, 0.4);
+}
+
+.table-container {
+    overflow-x: auto;
+    overflow-y: auto;
+    flex: 1;
+    min-height: 0;
+    max-height: none;
+    background: white;
+    border-radius: 8px;
+    border: 1px solid #e5e7eb;
+}
+
+table {
+    width: 100%;
+    border-collapse: collapse;
+    font-size: 0.8rem;
+    white-space: nowrap;
+}
+
+th {
+    background-color: #fca5a5;
+    /* Example distinct styling based on image header (greenish/yellow/etc.) Actually, let's use a green header like image */
+    background-color: #a7f3d0 !important;
+    position: sticky;
+    top: 0;
+    z-index: 10;
+    padding: 0.4rem;
+    text-align: center;
+    /* Center align header text as requested */
+    font-weight: 700;
+    color: var(--text-main);
+    border-bottom: 1px solid #e5e7eb;
+}
+
+/* Address column auto-sizes */
+
+td {
+    padding: 0.2rem 0.4rem;
+    border-bottom: 1px solid #e5e7eb;
+    color: #374151;
+    text-overflow: ellipsis;
+    overflow: hidden;
+}
+
+/* Address TD specific setting to allow full address to be seen */
+td.cell-address,
+td.cell-phone {
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+td.cell-address {
+    min-width: 350px;
+    max-width: 600px;
+}
+
+.address-cell-inner,
+.phone-cell-inner {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 0.25rem;
+    width: 100%;
+    min-width: 0;
+}
+
+.address-text,
+.phone-text {
+    flex: 1 1 auto;
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.count-badge {
+    flex: 0 0 auto;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 1.05rem;
+    height: 0.95rem;
+    padding: 0 0.25rem;
+    border-radius: 3px;
+    color: #ffffff;
+    font-size: 0.62rem;
+    font-weight: 800;
+    line-height: 1;
+}
+
+.count-badge-neutral {
+    background: #9ca3af;
+}
+
+.count-badge-warning {
+    background: #f97316;
+}
+
+.count-badge-danger {
+    background: #dc2626;
+}
+
+.customer-name-cell {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.35rem;
+    min-width: 0;
+}
+
+.customer-note-icon {
+    flex: 0 0 auto;
+    color: #d97706;
+    font-size: 0.9rem;
+}
+
+.order-no-cell {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.32rem;
+    min-width: 0;
+}
+
+.order-note-icon {
+    flex: 0 0 auto;
+    color: #2563eb;
+    font-size: 0.9rem;
+}
+
+.vendor-badge {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 3.5rem;
+    padding: 0.15rem 0.45rem;
+    border-radius: 4px;
+    font-size: 0.72rem;
+    font-weight: 800;
+    white-space: nowrap;
+}
+
+.vendor-badge-own {
+    background: #dbeafe;
+    color: #1d4ed8;
+}
+
+.vendor-badge-smartstore {
+    background: #dcfce7;
+    color: #15803d;
+}
+
+tr {
+    transition: background-color var(--transition-fast);
+}
+
+tbody tr.date-group-alt {
+    background-color: rgba(15, 23, 42, 0.15);
+}
+
+tbody tr:hover {
+    background-color: #e5e7eb;
+}
+
+tr.selected {
+    background-color: rgba(79, 70, 229, 0.05);
+}
+
+input[type="checkbox"] {
+    width: 16px;
+    height: 16px;
+    accent-color: var(--primary-color);
+    cursor: pointer;
+}
+
+.empty-state {
+    text-align: center;
+    padding: 3rem !important;
+    color: var(--text-muted);
+    font-style: italic;
+}
+
+/* Modal */
+.modal {
+    display: none;
+    position: fixed;
+    z-index: 100;
+    left: 0;
+    top: 0;
+    width: 100%;
+    height: 100%;
+    background-color: rgba(0, 0, 0, 0.4);
+    backdrop-filter: blur(4px);
+    justify-content: center;
+    align-items: center;
+}
+
+.modal.show {
+    display: flex;
+}
+
+#order-edit-modal,
+#return-request-modal {
+    backdrop-filter: none;
+    -webkit-backdrop-filter: none;
+}
+
+.modal-content {
+    background-color: white;
+    padding: 2.5rem;
+    width: 100%;
+    max-width: 500px;
+    position: relative;
+    border-radius: 16px;
+    animation: modalSlideIn 0.3s ease;
+}
+
+.data-management-modal {
+    width: calc(100vw - 32px);
+    max-width: 1040px;
+    max-height: calc(100vh - 28px);
+    overflow: hidden;
+    padding: 1.45rem;
+    border-radius: 12px;
+}
+
+.modal .data-management-modal h2 {
+    margin-bottom: 1rem;
+    font-size: 1.4rem;
+}
+
+.data-management-title {
+    display: flex;
+    align-items: center;
+    gap: 0.6rem;
+    flex-wrap: wrap;
+}
+
+.data-management-title .title-main {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.45rem;
+}
+
+.db-size-badge {
+    display: inline-flex;
+    align-items: center;
+    min-height: 1.45rem;
+    padding: 0.12rem 0.55rem;
+    border: 1px solid #d8dee8;
+    border-radius: 6px;
+    background: #f3f6fa;
+    color: #475569;
+    font-size: 0.76rem;
+    font-weight: 700;
+    line-height: 1;
+}
+
+.management-grid {
+    display: grid;
+    grid-template-columns: repeat(4, minmax(0, 1fr));
+    gap: 0.6rem;
+}
+
+.management-grid-compact {
+    margin-top: 0.35rem;
+}
+
+.management-card,
+.data-management-modal > .form-group {
+    display: flex;
+    flex-direction: column;
+    min-height: 150px;
+    background: #ffffff;
+    border: 1px solid var(--border-color);
+    border-radius: 8px;
+    padding: 0.75rem;
+    box-shadow: 0 8px 18px rgba(15, 23, 42, 0.06);
+}
+
+.management-card h3 {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    margin: 0 0 0.55rem;
+    font-size: 0.84rem;
+    color: var(--text-main);
+}
+
+.management-card small,
+.data-management-modal small {
+    display: block;
+    margin-top: 0.45rem;
+    color: var(--text-muted);
+    font-size: 0.76rem;
+    line-height: 1.35;
+}
+
+.management-card small {
+    margin-top: auto;
+}
+
+.inline-check {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+    margin: 0 0 0.55rem;
+    font-weight: 600;
+    cursor: pointer;
+}
+
+.inline-check input {
+    accent-color: var(--primary-color);
+}
+
+.full-width-btn {
+    width: 100%;
+    justify-content: center;
+    border-radius: 8px;
+    min-height: 36px;
+    padding: 0.45rem 0.6rem;
+    font-weight: 700;
+    font-size: 0.82rem;
+}
+
+.action-stack {
+    display: grid;
+    gap: 0.42rem;
+}
+
+.modal-date-range {
+    margin-bottom: 0.55rem;
+}
+
+.modal-date-range span {
+    color: var(--text-muted);
+}
+
+.modal-date-range input {
+    flex: 1;
+    min-width: 0;
+    padding: 0.42rem;
+    border: 1px solid var(--border-color);
+    border-radius: 6px;
+    font-size: 0.82rem;
+}
+
+.repeat-purchase-row {
+    display: flex;
+    align-items: center;
+    gap: 0.45rem;
+    margin-bottom: 0.55rem;
+    color: var(--text-muted);
+    font-size: 0.82rem;
+    font-weight: 700;
+}
+
+.repeat-purchase-row input {
+    width: 72px;
+    padding: 0.42rem;
+    border: 1px solid var(--border-color);
+    border-radius: 6px;
+    font-size: 0.82rem;
+}
+
+.danger-zone {
+    background: #fff7f7;
+    border-color: rgba(239, 68, 68, 0.35);
+}
+
+.danger-zone h3 {
+    color: #991b1b;
+}
+
+.export-progress-container,
+.optimize-progress-container,
+.delete-progress-container {
+    display: none;
+    margin-top: 0.65rem;
+}
+
+.progress-label-row {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 0.35rem;
+    font-size: 0.78rem;
+    color: var(--text-secondary);
+}
+
+.progress-label-row span:last-child {
+    font-weight: 700;
+    color: var(--text-main);
+}
+
+.progress-bar-wrapper {
+    height: 7px;
+    background: #e5e7eb;
+    border-radius: 999px;
+    overflow: hidden;
+    width: 100%;
+}
+
+#optimize-progress-fill,
+#export-progress-fill,
+#delete-date-progress-fill,
+#delete-cleanup-progress-fill {
+    width: 0%;
+    height: 100%;
+    background: var(--primary-color);
+    transition: width 0.3s ease;
+}
+
+#delete-date-progress-fill {
+    background: #dc2626;
+}
+
+#delete-cleanup-progress-fill {
+    background: #2563eb;
+}
+
+#delete-date-progress-count {
+    margin-top: 0.3rem;
+}
+
+#export-progress-fill {
+    background: var(--success-color);
+}
+
+#export-progress-count {
+    margin-top: 0.3rem;
+}
+
+.delete-cleanup-row {
+    margin-top: 0.55rem;
+}
+
+@media (max-height: 760px) and (min-width: 900px) {
+    .data-management-modal {
+        padding: 1rem;
+        max-height: calc(100vh - 16px);
+    }
+
+    .data-management-modal h2 {
+        margin-bottom: 0.8rem;
+        font-size: 1.35rem;
+    }
+
+    .management-grid {
+        gap: 0.55rem;
+    }
+
+    .management-card,
+    .data-management-modal > .form-group {
+        min-height: 142px;
+        padding: 0.72rem;
+    }
+
+    .management-card h3 {
+        margin-bottom: 0.5rem;
+        font-size: 0.84rem;
+    }
+
+    .full-width-btn {
+        min-height: 36px;
+        padding: 0.45rem 0.6rem;
+        font-size: 0.84rem;
+    }
+
+    .modal-date-range {
+        margin-bottom: 0.55rem;
+    }
+
+    .management-card small,
+    .data-management-modal small {
+        font-size: 0.72rem;
+        line-height: 1.25;
+    }
+}
+
+@media (max-width: 820px) {
+    .data-management-modal {
+        max-width: calc(100vw - 24px);
+    }
+
+    .management-grid {
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
+}
+
+@media (max-width: 760px) {
+    .management-grid {
+        grid-template-columns: 1fr;
+    }
+
+    .date-range-filter {
+        grid-column: span 1;
+    }
+}
+
+@keyframes modalSlideIn {
+    from {
+        opacity: 0;
+        transform: translateY(-20px) scale(0.95);
+    }
+
+    to {
+        opacity: 1;
+        transform: translateY(0) scale(1);
+    }
+}
+
+.close-btn {
+    position: absolute;
+    top: 1rem;
+    right: 1.5rem;
+    font-size: 1.8rem;
+    font-weight: 500;
+    color: var(--text-muted);
+    cursor: pointer;
+}
+
+.close-btn:hover {
+    color: var(--text-main);
+}
+
+.modal h2 {
+    margin-bottom: 1.5rem;
+    font-size: 1.5rem;
+}
+
+.order-edit-modal-content,
+.return-request-modal-content {
+    width: min(calc(100vw - 32px), 520px);
+    max-width: 520px;
+    padding: 0;
+    overflow: hidden;
+    border-radius: 10px;
+    background: #ffffff;
+    backdrop-filter: none;
+    -webkit-backdrop-filter: none;
+    box-shadow: 0 12px 28px rgba(15, 23, 42, 0.2);
+    animation-duration: 0.14s;
+}
+
+.order-edit-modal-content .close-btn,
+.return-request-modal-content .close-btn {
+    top: 0.55rem;
+    right: 0.7rem;
+    width: 30px;
+    height: 30px;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    color: rgba(255, 255, 255, 0.82);
+    font-size: 1.55rem;
+    line-height: 1;
+    border-radius: 6px;
+}
+
+.order-edit-modal-content .close-btn:hover,
+.return-request-modal-content .close-btn:hover {
+    color: #ffffff;
+    background: rgba(255, 255, 255, 0.13);
+}
+
+.modal .order-edit-modal-content h2,
+.modal .return-request-modal-content h2 {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    margin: 0;
+    padding: 0.78rem 3rem 0.78rem 1rem;
+    background: var(--primary-color);
+    color: #ffffff;
+    font-size: 1.03rem;
+    line-height: 1.25;
+    border-bottom: 1px solid rgba(255, 255, 255, 0.16);
+}
+
+.modal .return-request-modal-content h2 {
+    background: #f59e0b;
+}
+
+.order-edit-modal-content h2 i,
+.return-request-modal-content h2 i {
+    font-size: 0.98rem;
+}
+
+.order-edit-modal-content .form-group,
+.return-request-modal-content .form-group {
+    display: grid;
+    grid-template-columns: 92px minmax(0, 1fr);
+    align-items: start;
+    gap: 0.55rem;
+    margin: 0;
+    padding: 0.62rem 1rem;
+    border-bottom: 1px solid #eef2f7;
+}
+
+.order-edit-modal-content .form-group label,
+.return-request-modal-content .form-group label {
+    margin: 0;
+    padding-top: 0.44rem;
+    color: #374151;
+    font-size: 0.86rem;
+    font-weight: 700;
+    line-height: 1.25;
+}
+
+.order-edit-modal-content .form-group input,
+.order-edit-modal-content .form-group textarea,
+.return-request-modal-content .form-group input,
+.return-request-modal-content .form-group select,
+.return-request-modal-content .form-group textarea {
+    width: 100%;
+    min-height: 34px;
+    padding: 0.47rem 0.62rem;
+    border: 1px solid #d9e0ea;
+    border-radius: 6px;
+    border-color: #d9e0ea;
+    background: #ffffff;
+    font: inherit;
+    color: var(--text-main);
+    font-size: 0.9rem;
+    line-height: 1.35;
+}
+
+.return-request-modal-content .form-group select {
+    appearance: auto;
+}
+
+.order-edit-modal-content .form-group textarea,
+.return-request-modal-content .form-group textarea {
+    min-height: 56px;
+    max-height: 112px;
+    resize: vertical;
+}
+
+.order-edit-modal-content #edit-address {
+    min-height: 66px;
+}
+
+.order-edit-modal-content #edit-customer-note {
+    min-height: 58px;
+}
+
+.order-edit-modal-content #edit-order-note {
+    min-height: 58px;
+}
+
+.return-request-modal-content #return-request-remarks {
+    min-height: 78px;
+}
+
+.return-request-modal-content label[for="return-request-remarks"] {
+    white-space: nowrap;
+    font-size: 0.82rem;
+}
+
+.order-edit-modal-content .form-group input:focus,
+.order-edit-modal-content .form-group textarea:focus,
+.return-request-modal-content .form-group input:focus,
+.return-request-modal-content .form-group select:focus,
+.return-request-modal-content .form-group textarea:focus {
+    border-color: var(--primary-color);
+    box-shadow: 0 0 0 2px rgba(79, 70, 229, 0.14);
+}
+
+.form-group {
+    margin-bottom: 1.5rem;
+}
+
+.form-group label {
+    display: block;
+    margin-bottom: 0.5rem;
+    font-weight: 600;
+}
+
+.form-group small {
+    display: block;
+    margin-top: 0.5rem;
+    color: var(--text-muted);
+}
+
+.form-group input,
+.form-group textarea {
+    width: 100%;
+    border: 1px solid var(--border-color);
+    border-radius: 8px;
+    padding: 0.75rem 0.9rem;
+    font: inherit;
+    color: var(--text-main);
+    background: #ffffff;
+}
+
+.form-group textarea {
+    resize: vertical;
+    min-height: 88px;
+}
+
+.form-group input:focus,
+.form-group textarea:focus {
+    outline: none;
+    border-color: var(--primary-color);
+    box-shadow: 0 0 0 3px rgba(79, 70, 229, 0.12);
+}
+
+.modal-actions {
+    display: flex;
+    justify-content: flex-end;
+    gap: 0.6rem;
+}
+
+.order-edit-actions,
+.return-request-actions {
+    justify-content: space-between;
+    align-items: center;
+    padding: 0.72rem 1rem;
+    background: #f8fafc;
+    border-top: 1px solid #e5eaf2;
+}
+
+.return-request-actions {
+    justify-content: flex-end;
+}
+
+.order-edit-action-group {
+    display: flex;
+    gap: 0.45rem;
+}
+
+.order-edit-actions .btn,
+.return-request-actions .btn {
+    min-height: 34px;
+    padding: 0.45rem 0.8rem;
+    border-radius: 6px;
+    font-size: 0.86rem;
+    line-height: 1.1;
+}
+
+@media (max-width: 560px) {
+    .order-edit-modal-content,
+    .return-request-modal-content {
+        width: calc(100vw - 20px);
+    }
+
+    .order-edit-modal-content .form-group,
+    .return-request-modal-content .form-group {
+        grid-template-columns: 1fr;
+        gap: 0.35rem;
+        padding: 0.58rem 0.85rem;
+    }
+
+    .order-edit-modal-content .form-group label,
+    .return-request-modal-content .form-group label {
+        padding-top: 0;
+    }
+
+    .order-edit-actions {
+        align-items: stretch;
+        gap: 0.5rem;
+    }
+
+    .order-edit-action-group {
+        flex: 1;
+    }
+
+    .order-edit-action-group .btn {
+        flex: 1;
+    }
+}
+
+.upload-progress-modal-content {
+    max-width: 560px;
+}
+
+.upload-progress-message {
+    min-height: 1.5rem;
+    margin-bottom: 1.5rem;
+    color: var(--text-muted);
+    font-size: 0.95rem;
+}
+
+.upload-progress-message.success {
+    color: var(--success-color);
+    font-weight: 700;
+}
+
+.upload-progress-message.error {
+    color: #ef4444;
+    font-weight: 700;
+}
+
+.upload-progress-block {
+    padding: 1rem;
+    margin-bottom: 1rem;
+    border: 1px solid var(--border-color);
+    border-radius: 8px;
+    background: rgba(255, 255, 255, 0.65);
+}
+
+.upload-progress-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 1rem;
+    margin-bottom: 0.7rem;
+    font-size: 0.95rem;
+    font-weight: 700;
+}
+
+.upload-progress-header span {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.45rem;
+}
+
+.upload-progress-track {
+    width: 100%;
+    height: 12px;
+    overflow: hidden;
+    border-radius: 999px;
+    background: #e5e7eb;
+}
+
+.upload-progress-fill {
+    width: 0%;
+    height: 100%;
+    border-radius: inherit;
+    transition: width 0.25s ease;
+}
+
+.upload-data-fill {
+    background: var(--success-color);
+}
+
+.upload-index-fill {
+    background: var(--primary-color);
+}
+
+.upload-progress-count {
+    margin-top: 0.55rem;
+    color: var(--text-muted);
+    font-size: 0.85rem;
+    text-align: right;
+}
+
+.upload-progress-actions {
+    margin-top: 1.5rem;
+}
+
+/* Layout base */
+.container {
+    height: 100vh;
+    display: flex;
+    flex-direction: column;
+    padding: 0;
+    gap: 0;
+    max-width: 100%;
+    margin: 0 auto;
+}
+
+/* Toast */
+#toast-container {
+    position: fixed;
+    bottom: 20px;
+    right: 20px;
+    z-index: 1000;
+    display: flex;
+    flex-direction: column;
+    gap: 10px;
+}
+
+.toast {
+    padding: 1rem 1.5rem;
+    background-color: white;
+    border-left: 4px solid var(--primary-color);
+    border-radius: 4px;
+    box-shadow: var(--shadow-md);
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    animation: slideInRight 0.3s ease forwards;
+}
+
+.toast.success {
+    border-left-color: var(--success-color);
+}
+
+.toast.error {
+    border-left-color: #ef4444;
+}
+
+@keyframes slideInRight {
+    from {
+        transform: translateX(100%);
+        opacity: 0;
+    }
+
+    to {
+        transform: translateX(0);
+        opacity: 1;
+    }
+}
+
+/* Animations */
+.fade-in {
+    opacity: 0;
+    animation: fadeIn 0.6s ease forwards;
+}
+
+.delay-1 {
+    animation-delay: 0.1s;
+}
+
+.delay-2 {
+    animation-delay: 0.2s;
+}
+
+.delay-3 {
+    animation-delay: 0.3s;
+}
+
+@keyframes fadeIn {
+    to {
+        opacity: 1;
+        transform: translateY(0);
+    }
+}
+
+/* Force UI Update */
diff --git a/static/img/king_logo.png b/static/img/king_logo.png
new file mode 100644
index 0000000..76c2aa2
Binary files /dev/null and b/static/img/king_logo.png differ
diff --git a/static/index.html b/static/index.html
new file mode 100644
index 0000000..0805591
--- /dev/null
+++ b/static/index.html
@@ -0,0 +1,433 @@
+<!DOCTYPE None>
+<html lang="ko">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Order Management System</title>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
+    <link rel="stylesheet" href="/static/css/style.css?v=27">
+    <!-- FontAwesome for Icons -->
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
+</head>
+
+<body>
+    <!-- Background Elements for Glassmorphism Context -->
+    <div class="bg-shape shape-1"></div>
+    <div class="bg-shape shape-2"></div>
+    <div class="bg-shape shape-3"></div>
+
+    <!-- MAIN APP CONTAINER -->
+    <div class="app-container" id="app">
+
+        <!-- LOGIN SCREEN (Visible when unauthenticated) -->
+        <div id="login-screen" class="screen active glass-panel">
+            <div class="login-box">
+                <div class="logo">
+                    <i class="fa-solid fa-boxes-packing logo-icon"></i>
+                    <h2>OMS system</h2>
+                </div>
+                <p class="subtitle">Enter the corporate order management center.</p>
+                <div class="oauth-buttons">
+                    <button class="btn btn-primary" style="width: 100%;"
+                        onclick="window.location.href='/login'">
+                        <i class="fa-solid fa-right-to-bracket"></i> 로그인
+                    </button>
+                </div>
+                <p class="auth-hint">Access restricted to approved users.</p>
+            </div>
+        </div>
+
+        <!-- DASHBOARD SCREEN (Visible when authenticated) -->
+        <div id="dashboard-screen" class="screen hidden">
+            <!-- Unified Top Header Bar -->
+            <header class="unified-header glass-panel fade-in">
+                <!-- 1. Logo Section -->
+                <div class="nav-brand">
+                    <img src="/static/img/king_logo.png" alt="King" class="brand-logo-img">
+                </div>
+
+                <!-- 2. Search Section -->
+                <div class="nav-center-area">
+                    <button id="btn-reset-search" class="btn btn-reset-search"><i
+                            class="fa-solid fa-rotate-left"></i> 초기화</button>
+                    <div class="search-grid-2x2">
+                        <div class="input-group-original compact-field">
+                            <label>이름</label>
+                            <div class="input-wrapper mini-input">
+                                <i class="fa-solid fa-user"></i>
+                                <input type="text" id="search-name" placeholder="이름 입력...">
+                            </div>
+                        </div>
+                        <div class="input-group-original compact-field">
+                            <label>전화</label>
+                            <div class="input-wrapper mini-input">
+                                <i class="fa-solid fa-mobile-screen-button"></i>
+                                <input type="text" id="search-phone" placeholder="전화 입력...">
+                            </div>
+                        </div>
+                        <div class="input-group-original compact-field">
+                            <label>송장</label>
+                            <div class="input-wrapper mini-input">
+                                <i class="fa-solid fa-barcode"></i>
+                                <input type="text" id="search-tracking" placeholder="송장 입력...">
+                            </div>
+                        </div>
+                        <div class="input-group-original address-field">
+                            <label>주소</label>
+                            <div class="input-wrapper mini-input">
+                                <i class="fa-solid fa-map-location-dot"></i>
+                                <input type="text" id="search-address" placeholder="주소 입력...">
+                            </div>
+                        </div>
+                        <div class="input-group-original date-range-filter">
+                            <label>날짜</label>
+                            <div class="date-range-inputs">
+                                <div class="input-wrapper mini-input">
+                                    <i class="fa-regular fa-calendar-days"></i>
+                                    <input type="date" id="search-start-date">
+                                </div>
+                                <span class="date-range-separator">~</span>
+                                <div class="input-wrapper mini-input">
+                                    <i class="fa-regular fa-calendar-days"></i>
+                                    <input type="date" id="search-end-date">
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    <button id="btn-search" class="btn btn-primary btn-search-tall"><i
+                            class="fa-solid fa-magnifying-glass"></i> 검색</button>
+
+                    <div class="upload-section-mini"
+                        style="display: flex; flex-direction: row; gap: 0.5rem; align-items: center;">
+                        <label for="file-upload" class="custom-file-upload btn-upload-tall btn-excel">
+                            <i class="fa-solid fa-file-excel"></i>
+                            <span class="upload-label-text">
+                                <span>데이터 추가</span>
+                                <span>(.xls, .xlsx)</span>
+                            </span>
+                        </label>
+                        <input id="file-upload" type="file" accept=".xls, .xlsx" />
+                    </div>
+                </div>
+
+                <!-- 3. Profile Section -->
+                <div class="nav-profile-area">
+                    <button id="btn-data-management" class="icon-btn mini-icon-btn nav-tool-btn" title="데이터 관리"><i
+                            class="fa-solid fa-database"></i></button>
+                    <div class="user-profile mini-profile">
+                        <span id="user-name">Loading...</span>
+                        <div class="avatar mini-avatar"><i class="fa-solid fa-user"></i></div>
+                    </div>
+                    <button class="icon-btn mini-icon-btn" onclick="window.location.href='/logout'" title="Logout"><i
+                            class="fa-solid fa-right-from-bracket"></i></button>
+                </div>
+            </header>
+
+            <!-- Main Content Area -->
+            <main class="main-content">
+
+                <!-- Results Panel -->
+                <div class="results-panel glass-panel fade-in delay-3">
+                    <div class="results-header" style="flex-wrap: wrap; gap: 0.5rem;">
+                        <h3 style="white-space: nowrap;">검색 결과 <span id="result-count" class="badge">0</span></h3>
+                        <!-- Pagination Container -->
+                        <div id="pagination-container" class="pagination"
+                            style="flex: 1; padding: 0; justify-content: center; margin: 0;"></div>
+                        <button id="btn-download-search-results" class="btn btn-success btn-search-download" disabled>
+                            <i class="fa-solid fa-download"></i> 다운로드
+                        </button>
+                    </div>
+                    <div class="table-container">
+                        <table id="results-table">
+                            <thead>
+                                <tr>
+                                    <th>주문날짜<div class="resizer"></div>
+                                    </th>
+                                    <th>수령인명<div class="resizer"></div>
+                                    </th>
+                                    <th>상품코드<div class="resizer"></div>
+                                    </th>
+                                    <th>상품명<div class="resizer"></div>
+                                    </th>
+                                    <th>수량<div class="resizer"></div>
+                                    </th>
+                                    <th class="col-address">주소<div class="resizer"></div>
+                                    </th>
+                                    <th>휴대폰<div class="resizer"></div>
+                                    </th>
+                                    <th>송장번호<div class="resizer"></div>
+                                    </th>
+                                    <th>발주처<div class="resizer"></div>
+                                    </th>
+                                    <th class="col-order-no">주문번호(쇼핑몰)<div class="resizer"></div>
+                                    </th>
+                                    <th class="col-ext">주문목록<div class="resizer"></div>
+                                    </th>
+                                </tr>
+                            </thead>
+                            <tbody id="results-body">
+                                <tr>
+                                    <td colspan="11" class="empty-state">검색어를 입력하고 검색 버튼을 눌러주세요.</td>
+                                </tr>
+                            </tbody>
+                        </table>
+                    </div>
+                </div>
+            </main>
+        </div>
+
+    </div>
+
+    <!-- Order Contact Edit Modal -->
+    <div id="order-edit-modal" class="modal">
+        <div class="modal-content glass-panel order-edit-modal-content">
+            <span class="close-btn" id="order-edit-close">&times;</span>
+            <h2><i class="fa-solid fa-pen-to-square"></i> 주문 정보 수정</h2>
+            <div class="form-group">
+                <label for="edit-recipient-name">이름</label>
+                <input type="text" id="edit-recipient-name">
+            </div>
+            <div class="form-group">
+                <label for="edit-address">주소</label>
+                <textarea id="edit-address" rows="3"></textarea>
+            </div>
+            <div class="form-group">
+                <label for="edit-recipient-mobile">휴대폰 번호</label>
+                <input type="text" id="edit-recipient-mobile">
+            </div>
+            <div class="form-group">
+                <label for="edit-customer-note">고객 메모</label>
+                <textarea id="edit-customer-note" rows="3" placeholder="이름과 전화번호가 같은 고객 주문에 함께 표시됩니다."></textarea>
+            </div>
+            <div class="form-group">
+                <label for="edit-order-note">주문 메모</label>
+                <textarea id="edit-order-note" rows="3" placeholder="주문번호가 같은 주문에 함께 표시됩니다."></textarea>
+            </div>
+            <div class="modal-actions order-edit-actions">
+                <button id="btn-delete-order-edit" class="btn btn-danger">
+                    <i class="fa-solid fa-trash-can"></i> 삭제
+                </button>
+                <div class="order-edit-action-group">
+                    <button id="btn-open-return-request" class="btn btn-warning">
+                        <i class="fa-solid fa-rotate-left"></i> 반품 입력
+                    </button>
+                    <button id="btn-cancel-order-edit" class="btn btn-secondary">취소</button>
+                    <button id="btn-save-order-edit" class="btn btn-primary">
+                        <i class="fa-solid fa-floppy-disk"></i> 저장
+                    </button>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- Return Request Modal -->
+    <div id="return-request-modal" class="modal">
+        <div class="modal-content glass-panel return-request-modal-content">
+            <span class="close-btn" id="return-request-close">&times;</span>
+            <h2><i class="fa-solid fa-rotate-left"></i> 반품 신청</h2>
+            <div class="form-group">
+                <label for="return-request-date">반품 신청일</label>
+                <input type="date" id="return-request-date">
+            </div>
+            <div class="form-group">
+                <label for="return-request-type">반품 사유/유형</label>
+                <select id="return-request-type">
+                    <option value="단순변심">단순변심</option>
+                    <option value="상품불량">상품불량</option>
+                    <option value="오배송">오배송</option>
+                    <option value="파손">파손</option>
+                    <option value="맞교환">맞교환</option>
+                    <option value="기타">기타</option>
+                </select>
+            </div>
+            <div class="form-group">
+                <label for="return-request-tracking">송장번호</label>
+                <select id="return-request-tracking"></select>
+            </div>
+            <div class="form-group">
+                <label for="return-request-remarks">비고 및 참고사항</label>
+                <textarea id="return-request-remarks" rows="4"></textarea>
+            </div>
+            <div class="modal-actions return-request-actions">
+                <button id="btn-cancel-return-request" class="btn btn-secondary">취소</button>
+                <button id="btn-send-return-request" class="btn btn-primary">
+                    <i class="fa-solid fa-paper-plane"></i> 전송
+                </button>
+            </div>
+        </div>
+    </div>
+
+    <!-- Upload Progress Modal -->
+    <div id="upload-progress-modal" class="modal">
+        <div class="modal-content glass-panel upload-progress-modal-content">
+            <h2><i class="fa-solid fa-file-arrow-up"></i> 엑셀 데이터 업로드</h2>
+            <p id="upload-modal-message" class="upload-progress-message">업로드를 준비하는 중입니다...</p>
+
+            <div class="upload-progress-block">
+                <div class="upload-progress-header">
+                    <span><i class="fa-solid fa-table"></i> 엑셀 데이터 처리</span>
+                    <strong id="upload-data-progress-text">0%</strong>
+                </div>
+                <div class="upload-progress-track">
+                    <div id="upload-data-progress-fill" class="upload-progress-fill upload-data-fill"></div>
+                </div>
+                <div id="upload-data-progress-count" class="upload-progress-count">0 / 0건</div>
+            </div>
+
+            <div class="upload-progress-block">
+                <div class="upload-progress-header">
+                    <span><i class="fa-solid fa-magnifying-glass-chart"></i> DB 저장 및 검색 인덱스 반영</span>
+                    <strong id="upload-index-progress-text">0%</strong>
+                </div>
+                <div class="upload-progress-track">
+                    <div id="upload-index-progress-fill" class="upload-progress-fill upload-index-fill"></div>
+                </div>
+                <div id="upload-index-progress-count" class="upload-progress-count">0 / 0건</div>
+            </div>
+
+            <div class="modal-actions upload-progress-actions">
+                <button id="btn-close-upload-progress" class="btn btn-primary" disabled>닫기</button>
+            </div>
+        </div>
+    </div>
+
+    <!-- Data Management Modal -->
+    <div id="data-management-modal" class="modal">
+        <div class="modal-content glass-panel data-management-modal">
+            <span class="close-btn" id="data-management-close">&times;</span>
+            <h2 class="data-management-title">
+                <span class="title-main"><i class="fa-solid fa-database"></i> 데이터 관리</span>
+                <span id="db-size-badge" class="db-size-badge">용량 확인 중</span>
+            </h2>
+
+            <div class="management-grid management-grid-compact">
+                <section class="management-card">
+                    <h3><i class="fa-solid fa-file-excel"></i> DB 데이터 엑셀 다운로드</h3>
+                    <label class="inline-check">
+                        <input type="checkbox" id="export-all-dates-chk">
+                        전체 날짜 다운로드
+                    </label>
+                    <div id="export-date-range-container" class="modal-date-range">
+                        <input type="date" id="export-start-date" class="mini-input">
+                        <span>~</span>
+                        <input type="date" id="export-end-date" class="mini-input">
+                    </div>
+                    <button id="btn-export-db" class="btn btn-success full-width-btn">
+                        <i class="fa-solid fa-download"></i> 지정된 범위 데이터 다운로드
+                    </button>
+                    <div id="export-progress-container" class="export-progress-container">
+                        <div class="progress-label-row">
+                            <span id="export-progress-message">파일 생성 준비 중...</span>
+                            <span id="export-progress-text">0%</span>
+                        </div>
+                        <div class="progress-bar-wrapper">
+                            <div id="export-progress-fill"></div>
+                        </div>
+                        <small id="export-progress-count">0 / 0건</small>
+                    </div>
+                    <small>브라우저 다운로드 폴더로 엑셀 파일을 저장합니다.</small>
+                </section>
+
+                <section class="management-card">
+                    <h3><i class="fa-solid fa-hard-drive"></i> DB 백업 및 복구</h3>
+                    <div class="action-stack">
+                        <button id="btn-backup-db" class="btn btn-success full-width-btn">
+                            <i class="fa-solid fa-download"></i> 현재 DB 백업 다운로드
+                        </button>
+                        <button id="btn-download-event-log" class="btn btn-secondary full-width-btn">
+                            <i class="fa-solid fa-file-lines"></i> 이벤트 로그 다운로드
+                        </button>
+                        <input id="restore-db-file" type="file" accept=".db,.sqlite,.sqlite3">
+                        <label for="restore-db-file" class="btn btn-primary full-width-btn">
+                            <i class="fa-solid fa-upload"></i> 백업 DB 파일로 복구
+                        </label>
+                    </div>
+                    <small>복구 시 현재 DB는 자동으로 안전백업 후 교체됩니다.</small>
+                </section>
+
+                <section class="management-card">
+                    <h3><i class="fa-solid fa-broom"></i> 데이터베이스 최적화</h3>
+                    <button id="btn-optimize-db" class="btn btn-primary full-width-btn">
+                        <i class="fa-solid fa-broom"></i> 데이터베이스 최적화
+                    </button>
+                    <div id="optimize-progress-container" class="optimize-progress-container">
+                        <div class="progress-label-row">
+                            <span>최적화 진행 중...</span>
+                            <span id="optimize-progress-text">0%</span>
+                        </div>
+                        <div class="progress-bar-wrapper">
+                            <div id="optimize-progress-fill"></div>
+                        </div>
+                    </div>
+                    <small>DB 파일 용량을 줄이고 내부 저장 공간을 정리합니다.</small>
+                </section>
+
+                <section class="management-card">
+                    <h3><i class="fa-solid fa-repeat"></i> 반복 구매 리스트</h3>
+                    <div class="modal-date-range">
+                        <input type="date" id="repeat-start-date" class="mini-input">
+                        <span>~</span>
+                        <input type="date" id="repeat-end-date" class="mini-input">
+                    </div>
+                    <div class="repeat-purchase-row">
+                        <input type="number" id="repeat-min-count" class="mini-input" min="1" value="3">
+                        <span>회 이상 구매</span>
+                    </div>
+                    <button id="btn-download-repeat-purchase" class="btn btn-success full-width-btn">
+                        <i class="fa-solid fa-download"></i> 반복 구매 주문 다운로드
+                    </button>
+                    <small>선택 기간에서 이름+전화번호 기준으로 구매일수가 지정 회수 이상인 주문을 저장합니다.</small>
+                </section>
+
+                <section class="management-card danger-zone">
+                    <h3><i class="fa-solid fa-calendar-xmark"></i> 날짜 범위 데이터 삭제</h3>
+                    <div class="modal-date-range">
+                        <input type="date" id="delete-start-date" class="mini-input">
+                        <span>~</span>
+                        <input type="date" id="delete-end-date" class="mini-input">
+                    </div>
+                    <button id="btn-delete-date-range-orders" class="btn btn-danger full-width-btn">
+                        <i class="fa-solid fa-calendar-xmark"></i> 지정된 범위 주문 데이터 삭제
+                    </button>
+                    <div id="delete-date-progress-container" class="delete-progress-container">
+                        <div class="progress-label-row">
+                            <span id="delete-date-progress-message">삭제 진행</span>
+                            <span id="delete-date-progress-text">0%</span>
+                        </div>
+                        <div class="progress-bar-wrapper">
+                            <div id="delete-date-progress-fill"></div>
+                        </div>
+                        <small id="delete-date-progress-count">0 / 0건</small>
+                        <div class="progress-label-row delete-cleanup-row">
+                            <span id="delete-cleanup-progress-message">정리 대기</span>
+                            <span id="delete-cleanup-progress-text">0%</span>
+                        </div>
+                        <div class="progress-bar-wrapper">
+                            <div id="delete-cleanup-progress-fill"></div>
+                        </div>
+                    </div>
+                    <small>주문날짜 기준으로 선택한 기간의 데이터만 삭제합니다. 삭제 전 DB 백업을 권장합니다.</small>
+                </section>
+
+                <section class="management-card danger-zone">
+                    <h3><i class="fa-solid fa-trash-can"></i> 전체 데이터 삭제</h3>
+                    <button id="btn-delete-all-orders" class="btn btn-danger full-width-btn">
+                        <i class="fa-solid fa-trash-can"></i> 전체 주문 데이터 삭제
+                    </button>
+                    <small>삭제 전 DB 백업을 먼저 다운로드하는 것을 권장합니다.</small>
+                </section>
+            </div>
+        </div>
+    </div>
+
+    <!-- Toast Notifications -->
+    <div id="toast-container"></div>
+
+    <script>
+        window.APP_BASE_PATH = "__APP_BASE_PATH__";
+    </script>
+    <script src="/static/js/app.js?v=32"></script>
+</body>
+
+</html>
diff --git a/static/js/app.js b/static/js/app.js
new file mode 100644
index 0000000..cc208ad
--- /dev/null
+++ b/static/js/app.js
@@ -0,0 +1,1584 @@
+document.addEventListener('DOMContentLoaded', () => {
+    const APP_BASE_PATH = (window.APP_BASE_PATH || '').replace(/\/$/, '');
+    const appUrl = (path) => `${APP_BASE_PATH}${path.startsWith('/') ? path : `/${path}`}`;
+
+    // --- Elements ---
+    const loginScreen = document.getElementById('login-screen');
+    const dashboardScreen = document.getElementById('dashboard-screen');
+    const userNameEl = document.getElementById('user-name');
+
+    const searchInputs = {
+        name: document.getElementById('search-name'),
+        address: document.getElementById('search-address'),
+        phone: document.getElementById('search-phone'),
+        tracking: document.getElementById('search-tracking')
+    };
+    const searchStartDate = document.getElementById('search-start-date');
+    const searchEndDate = document.getElementById('search-end-date');
+    const btnSearch = document.getElementById('btn-search');
+    const btnResetSearch = document.getElementById('btn-reset-search');
+    const btnDownloadSearchResults = document.getElementById('btn-download-search-results');
+    const btnDataManagement = document.getElementById('btn-data-management');
+    const fileUpload = document.getElementById('file-upload');
+    const resultsBody = document.getElementById('results-body');
+    const resultCount = document.getElementById('result-count');
+
+    const dataManagementModal = document.getElementById('data-management-modal');
+    const dbSizeBadge = document.getElementById('db-size-badge');
+    const orderEditModal = document.getElementById('order-edit-modal');
+    const returnRequestModal = document.getElementById('return-request-modal');
+    const uploadProgressModal = document.getElementById('upload-progress-modal');
+    const btnCloseDataManagement = document.getElementById('data-management-close');
+    const btnCloseOrderEdit = document.getElementById('order-edit-close');
+    const btnCancelOrderEdit = document.getElementById('btn-cancel-order-edit');
+    const btnSaveOrderEdit = document.getElementById('btn-save-order-edit');
+    const btnDeleteOrderEdit = document.getElementById('btn-delete-order-edit');
+    const btnOpenReturnRequest = document.getElementById('btn-open-return-request');
+    const btnCloseReturnRequest = document.getElementById('return-request-close');
+    const btnCancelReturnRequest = document.getElementById('btn-cancel-return-request');
+    const btnSendReturnRequest = document.getElementById('btn-send-return-request');
+    const btnCloseUploadProgress = document.getElementById('btn-close-upload-progress');
+
+    const editRecipientName = document.getElementById('edit-recipient-name');
+    const editAddress = document.getElementById('edit-address');
+    const editRecipientMobile = document.getElementById('edit-recipient-mobile');
+    const editCustomerNote = document.getElementById('edit-customer-note');
+    const editOrderNote = document.getElementById('edit-order-note');
+    const returnRequestDate = document.getElementById('return-request-date');
+    const returnRequestType = document.getElementById('return-request-type');
+    const returnRequestTracking = document.getElementById('return-request-tracking');
+    const returnRequestRemarks = document.getElementById('return-request-remarks');
+
+    const uploadModalMessage = document.getElementById('upload-modal-message');
+    const uploadDataProgressText = document.getElementById('upload-data-progress-text');
+    const uploadDataProgressFill = document.getElementById('upload-data-progress-fill');
+    const uploadDataProgressCount = document.getElementById('upload-data-progress-count');
+    const uploadIndexProgressText = document.getElementById('upload-index-progress-text');
+    const uploadIndexProgressFill = document.getElementById('upload-index-progress-fill');
+    const uploadIndexProgressCount = document.getElementById('upload-index-progress-count');
+
+    const btnOptimizeDb = document.getElementById('btn-optimize-db');
+    const dbProgressContainer = document.getElementById('optimize-progress-container');
+    const dbProgressText = document.getElementById('optimize-progress-text');
+    const dbProgressFill = document.getElementById('optimize-progress-fill');
+
+    // DB Export Elements
+    const btnExportDb = document.getElementById('btn-export-db');
+    const exportStartDate = document.getElementById('export-start-date');
+    const exportEndDate = document.getElementById('export-end-date');
+    const exportAllDatesChk = document.getElementById('export-all-dates-chk');
+    const exportDateRangeContainer = document.getElementById('export-date-range-container');
+    const exportProgressContainer = document.getElementById('export-progress-container');
+    const exportProgressMessage = document.getElementById('export-progress-message');
+    const exportProgressText = document.getElementById('export-progress-text');
+    const exportProgressFill = document.getElementById('export-progress-fill');
+    const exportProgressCount = document.getElementById('export-progress-count');
+    const btnBackupDb = document.getElementById('btn-backup-db');
+    const btnDownloadEventLog = document.getElementById('btn-download-event-log');
+    const restoreDbFile = document.getElementById('restore-db-file');
+    const repeatStartDate = document.getElementById('repeat-start-date');
+    const repeatEndDate = document.getElementById('repeat-end-date');
+    const repeatMinCount = document.getElementById('repeat-min-count');
+    const btnDownloadRepeatPurchase = document.getElementById('btn-download-repeat-purchase');
+    const deleteStartDate = document.getElementById('delete-start-date');
+    const deleteEndDate = document.getElementById('delete-end-date');
+    const btnDeleteDateRangeOrders = document.getElementById('btn-delete-date-range-orders');
+    const deleteDateProgressContainer = document.getElementById('delete-date-progress-container');
+    const deleteDateProgressMessage = document.getElementById('delete-date-progress-message');
+    const deleteDateProgressText = document.getElementById('delete-date-progress-text');
+    const deleteDateProgressFill = document.getElementById('delete-date-progress-fill');
+    const deleteDateProgressCount = document.getElementById('delete-date-progress-count');
+    const deleteCleanupProgressMessage = document.getElementById('delete-cleanup-progress-message');
+    const deleteCleanupProgressText = document.getElementById('delete-cleanup-progress-text');
+    const deleteCleanupProgressFill = document.getElementById('delete-cleanup-progress-fill');
+    const btnDeleteAllOrders = document.getElementById('btn-delete-all-orders');
+
+    // State
+    let currentUser = null;
+    let latestUploadProgress = null;
+    let currentSearchPage = 1;
+    let editingOrderId = null;
+    let editingOrderData = null;
+    let highlightDateGroups = false;
+    let latestSearchParams = null;
+    let latestSearchTotal = 0;
+
+    // --- Initialization ---
+    checkAuth();
+
+    function logUiEvent(action, details = {}) {
+        fetch(appUrl('/api/settings/log-ui-event'), {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ action, details })
+        }).catch(() => {});
+    }
+
+    async function loadDatabaseSize() {
+        if (!dbSizeBadge) return;
+
+        dbSizeBadge.textContent = '용량 확인 중';
+        try {
+            const response = await fetch(appUrl('/api/settings/database-size'));
+            if (!response.ok) {
+                throw new Error('DB 용량 조회 실패');
+            }
+            const data = await response.json();
+            dbSizeBadge.textContent = `DB ${data.formatted || '-'}`;
+            dbSizeBadge.title = data.database ? `DB 종류: ${data.database}` : 'DB 용량';
+        } catch (error) {
+            dbSizeBadge.textContent = '용량 확인 실패';
+            dbSizeBadge.title = error.message || 'DB 용량 조회 실패';
+        }
+    }
+
+    function escapeHtml(value) {
+        return String(value ?? '')
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&#39;');
+    }
+
+    function todayKstDateString() {
+        try {
+            return new Intl.DateTimeFormat('sv-SE', {
+                timeZone: 'Asia/Seoul',
+                year: 'numeric',
+                month: '2-digit',
+                day: '2-digit',
+            }).format(new Date());
+        } catch (error) {
+            const now = new Date();
+            const localDate = new Date(now.getTime() - now.getTimezoneOffset() * 60000);
+            return localDate.toISOString().slice(0, 10);
+        }
+    }
+
+    function trackingNumberOptions(value) {
+        const trackingText = String(value || '').trim();
+        if (!trackingText) return [];
+        const parts = trackingText
+            .split(/[\/,\n\r]+/)
+            .map((item) => item.trim())
+            .filter(Boolean);
+        return [...new Set(parts)];
+    }
+
+    async function copyTextToClipboard(text) {
+        if (navigator.clipboard && window.isSecureContext) {
+            await navigator.clipboard.writeText(text);
+            return;
+        }
+
+        const textarea = document.createElement('textarea');
+        textarea.value = text;
+        textarea.setAttribute('readonly', '');
+        textarea.style.position = 'fixed';
+        textarea.style.left = '-9999px';
+        textarea.style.top = '0';
+        document.body.appendChild(textarea);
+        textarea.select();
+        document.execCommand('copy');
+        document.body.removeChild(textarea);
+    }
+
+    // --- Authentication ---
+    async function checkAuth() {
+        try {
+            const res = await fetch(appUrl('/api/users/me'));
+            if (res.ok) {
+                currentUser = await res.json();
+                userNameEl.textContent = currentUser.name;
+
+                loginScreen.classList.remove('active');
+                loginScreen.classList.add('hidden');
+                dashboardScreen.classList.remove('hidden');
+                dashboardScreen.classList.add('active');
+
+                if (btnDataManagement) {
+                    btnDataManagement.style.display = currentUser.is_admin ? 'inline-flex' : 'none';
+                }
+            } else {
+                loginScreen.classList.remove('hidden');
+                loginScreen.classList.add('active');
+                dashboardScreen.classList.add('hidden');
+                dashboardScreen.classList.remove('active');
+            }
+        } catch (error) {
+            console.error('Auth check error', error);
+        }
+    }
+
+    // --- Upload Data ---
+    function resetUploadProgressModal() {
+        latestUploadProgress = null;
+        uploadModalMessage.textContent = '업로드를 준비하는 중입니다...';
+        uploadModalMessage.classList.remove('error', 'success');
+        uploadDataProgressFill.style.width = '0%';
+        uploadIndexProgressFill.style.width = '0%';
+        uploadDataProgressText.textContent = '0%';
+        uploadIndexProgressText.textContent = '0%';
+        uploadDataProgressCount.textContent = '0 / 0건';
+        uploadIndexProgressCount.textContent = '0 / 0건';
+        btnCloseUploadProgress.disabled = true;
+    }
+
+    function setUploadProgress(data) {
+        latestUploadProgress = {
+            ...(latestUploadProgress || {}),
+            ...data
+        };
+        data = latestUploadProgress;
+
+        const uploadPercent = Math.max(0, Math.min(100, Number(data.upload_progress || 0)));
+        const indexPercent = Math.max(0, Math.min(100, Number(data.index_progress || 0)));
+        const totalRows = Number(data.total_rows || 0);
+        const processedRows = Number(data.processed_rows || 0);
+        const indexedRows = Number(data.indexed_rows || 0);
+
+        uploadDataProgressFill.style.width = `${uploadPercent}%`;
+        uploadIndexProgressFill.style.width = `${indexPercent}%`;
+        uploadDataProgressText.textContent = `${Math.round(uploadPercent)}%`;
+        uploadIndexProgressText.textContent = `${Math.round(indexPercent)}%`;
+        uploadDataProgressCount.textContent = `${processedRows.toLocaleString()} / ${totalRows.toLocaleString()}건`;
+        uploadIndexProgressCount.textContent = `${indexedRows.toLocaleString()} / ${totalRows.toLocaleString()}건`;
+        uploadModalMessage.textContent = data.message || '처리 중입니다...';
+
+        if (data.status === 'completed') {
+            uploadModalMessage.classList.add('success');
+            uploadModalMessage.classList.remove('error');
+            btnCloseUploadProgress.disabled = false;
+        } else if (data.status === 'error') {
+            uploadModalMessage.classList.add('error');
+            uploadModalMessage.classList.remove('success');
+            btnCloseUploadProgress.disabled = false;
+        } else {
+            uploadModalMessage.classList.remove('error', 'success');
+        }
+    }
+
+    btnCloseUploadProgress.addEventListener('click', () => {
+        logUiEvent('업로드 진행 창 닫기', {
+            status: latestUploadProgress?.status || '',
+            total_rows: latestUploadProgress?.total_rows || 0
+        });
+        uploadProgressModal.style.display = 'none';
+    });
+
+    fileUpload.addEventListener('change', async (e) => {
+        const file = e.target.files[0];
+        if (!file) return;
+        logUiEvent('파일 업로드 파일 선택', {
+            filename: file.name,
+            size: file.size,
+            type: file.type
+        });
+
+        const uploadToken = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        const formData = new FormData();
+        formData.append('file', file);
+        formData.append('upload_token', uploadToken);
+
+        resetUploadProgressModal();
+        uploadProgressModal.style.display = 'flex';
+        fileUpload.disabled = true;
+
+        const eventSource = new EventSource(appUrl(`/api/orders/progress?upload_token=${encodeURIComponent(uploadToken)}`));
+
+        eventSource.onmessage = (event) => {
+            try {
+                const data = JSON.parse(event.data);
+                if (data.status !== 'idle') {
+                    setUploadProgress(data);
+                }
+                if (data.status === 'completed' || data.status === 'error') {
+                    eventSource.close();
+                    fileUpload.disabled = false;
+                    fileUpload.value = '';
+                    if (data.status === 'completed') {
+                        showToast(data.message || '업로드와 검색 인덱스 반영이 완료되었습니다.', 'success');
+                    } else {
+                        showToast(data.message || '업로드 실패', 'error');
+                    }
+                }
+            } catch (err) {
+                console.error('Upload progress parse error', err);
+            }
+        };
+
+        try {
+            const res = await fetch(appUrl('/api/orders/upload'), {
+                method: 'POST',
+                body: formData
+            });
+
+            const data = await res.json();
+            if (res.ok) {
+                if (!['completed', 'error'].includes(latestUploadProgress?.status)) {
+                    setUploadProgress({
+                        ...(latestUploadProgress || {}),
+                        status: data.status || 'queued',
+                        message: data.message || '업로드 작업이 시작되었습니다.'
+                    });
+                }
+            } else {
+                showToast(data.detail || 'Upload failed', 'error');
+                setUploadProgress({
+                    status: 'error',
+                    message: data.detail || '업로드 실패'
+                });
+                eventSource.close();
+                fileUpload.disabled = false;
+                fileUpload.value = '';
+            }
+        } catch (error) {
+            showToast('네트워크 오류가 발생했습니다.', 'error');
+            setUploadProgress({
+                status: 'error',
+                message: '네트워크 오류가 발생했습니다.'
+            });
+            eventSource.close();
+            fileUpload.disabled = false;
+            fileUpload.value = '';
+        }
+    });
+
+    // --- Search ---
+    btnSearch.addEventListener('click', () => {
+        highlightDateGroups = false;
+        performSearch(1);
+    });
+    btnResetSearch.addEventListener('click', () => {
+        highlightDateGroups = false;
+        Object.values(searchInputs).forEach(input => {
+            input.value = '';
+        });
+        if (searchStartDate) searchStartDate.value = '';
+        if (searchEndDate) searchEndDate.value = '';
+        latestSearchParams = null;
+        latestSearchTotal = 0;
+        if (btnDownloadSearchResults) {
+            btnDownloadSearchResults.disabled = true;
+        }
+    });
+
+    // Allow enter key to search
+    Object.values(searchInputs).forEach(input => {
+        input.addEventListener('keypress', (e) => {
+            if (e.key === 'Enter') {
+                highlightDateGroups = false;
+                performSearch();
+            }
+        });
+    });
+
+    function getCurrentSearchParams() {
+        const params = new URLSearchParams();
+        const nameVal = searchInputs.name.value.trim();
+        const addressVal = searchInputs.address.value.trim();
+        const phoneVal = searchInputs.phone.value.trim();
+        const trackingVal = searchInputs.tracking.value.trim();
+        const startVal = searchStartDate ? searchStartDate.value : "";
+        const endVal = searchEndDate ? searchEndDate.value : "";
+
+        if (nameVal) params.append('name', nameVal);
+        if (addressVal) params.append('address', addressVal);
+        if (phoneVal) params.append('phone', phoneVal);
+        if (trackingVal) params.append('tracking', trackingVal);
+        if (startVal) params.append('order_start_date', startVal);
+        if (endVal) params.append('order_end_date', endVal);
+
+        return {
+            params,
+            hasFilters: Boolean(nameVal || addressVal || phoneVal || trackingVal || startVal || endVal)
+        };
+    }
+
+    async function performSearch(page = 1) {
+        currentSearchPage = page;
+        const searchState = getCurrentSearchParams();
+
+        if (!searchState.hasFilters) {
+            showToast('검색 조건을 하나 이상 입력해주세요.', 'error');
+            return;
+        }
+
+        try {
+            btnSearch.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 검색중';
+            btnSearch.disabled = true;
+
+            const params = new URLSearchParams(searchState.params);
+            params.set('page', page);
+            params.set('size', 27);
+            const queryUrl = appUrl(`/api/orders/search?${params.toString()}`);
+
+            const res = await fetch(queryUrl);
+            if (res.ok) {
+                const data = await res.json();
+                latestSearchParams = new URLSearchParams(searchState.params);
+                latestSearchTotal = Number(data.total || 0);
+                if (btnDownloadSearchResults) {
+                    btnDownloadSearchResults.disabled = latestSearchTotal === 0;
+                }
+                renderTable(data.items, data.total);
+                renderPagination(data.page, data.total_pages);
+                if (page === 1) {
+                    showToast(`${data.total} 건이 검색되었습니다.`, 'success');
+                }
+            } else {
+                showToast('검색 실패', 'error');
+            }
+        } catch (error) {
+            showToast('검색 중 오류 발생', 'error');
+        } finally {
+            btnSearch.innerHTML = '<i class="fa-solid fa-magnifying-glass"></i> 검색';
+            btnSearch.disabled = false;
+        }
+    }
+
+    if (btnDownloadSearchResults) {
+        btnDownloadSearchResults.addEventListener('click', async () => {
+            if (!latestSearchParams || latestSearchTotal <= 0) {
+                showToast('다운로드할 검색 결과가 없습니다.', 'error');
+                return;
+            }
+
+            const originalText = btnDownloadSearchResults.innerHTML;
+            btnDownloadSearchResults.disabled = true;
+            btnDownloadSearchResults.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 생성 중';
+
+            try {
+                const res = await fetch(appUrl(`/api/orders/export-search?${latestSearchParams.toString()}`));
+                if (res.ok) {
+                    await downloadFileFromResponse(res, '검색결과.xlsx');
+                    showToast('검색 결과 다운로드가 완료되었습니다.', 'success');
+                } else {
+                    const data = await res.json();
+                    showToast(data.detail || '검색 결과 다운로드 실패', 'error');
+                }
+            } catch (error) {
+                showToast('검색 결과 다운로드 중 네트워크 오류가 발생했습니다.', 'error');
+            } finally {
+                btnDownloadSearchResults.disabled = latestSearchTotal === 0;
+                btnDownloadSearchResults.innerHTML = originalText;
+            }
+        });
+    }
+
+    function renderTable(orders, totalCount) {
+        resultCount.textContent = totalCount || orders.length;
+
+        if (orders.length === 0) {
+            resultsBody.innerHTML = `<tr><td colspan="11" class="empty-state">검색 결과가 없습니다.</td></tr>`;
+            return;
+        }
+
+        resultsBody.innerHTML = '';
+        let previousDateKey = null;
+        let useAlternateDateShade = false;
+        orders.forEach(order => {
+            const tr = document.createElement('tr');
+
+            const pCode = order.product_code || '';
+            const pName = order.product_name || '';
+
+            // Date formatting logic "yy년 mm월 dd일"
+            let formattedDate = order.order_date || '';
+            if (formattedDate) {
+                // Try parsing YYYY-MM-DD
+                const parts = formattedDate.split('-');
+                if (parts.length >= 3) {
+                    const year = parts[0].substring(2); // yy
+                    const month = parts[1];
+                    const day = parts[2].substring(0, 2); // in case there's time component
+                    formattedDate = `${year}년 ${month}월 ${day}일`;
+                }
+            }
+            const dateKey = (order.order_date || '').slice(0, 10);
+            if (highlightDateGroups && dateKey !== previousDateKey) {
+                useAlternateDateShade = previousDateKey === null ? false : !useAlternateDateShade;
+                previousDateKey = dateKey;
+            }
+            if (highlightDateGroups && useAlternateDateShade) {
+                tr.classList.add('date-group-alt');
+            }
+
+            // Create a clickable tracking link if tracking number exists
+            let trackingCell = `<td></td>`;
+            if (order.tracking_number) {
+                // Handle multiple tracking numbers separated by '/'
+                const trackingNumbers = order.tracking_number.split('/').map(t => t.trim()).filter(t => t);
+                const links = trackingNumbers.map(num => {
+                    const trackingUrl = `https://www.cjlogistics.com/ko/tool/parcel/tracking?gnbInvcNo=${encodeURIComponent(num)}`;
+                    return `<a href="${trackingUrl}" target="_blank" class="tracking-link" style="color: var(--primary-color); text-decoration: underline; cursor: pointer;">${escapeHtml(num)}</a>`;
+                });
+
+                // Join multiple links with a visual separator, e.g. ' / ' or '<br>'
+                trackingCell = `<td>${links.join(' / ')}</td>`;
+            }
+
+            const orderNote = order.order_note || '';
+            const orderNoteIcon = orderNote
+                ? `<span class="order-note-icon" title="${escapeHtml(orderNote)}" aria-label="주문 메모 있음">📝</span>`
+                : '';
+            const orderNoLabel = `<span class="order-no-cell">${orderNoteIcon}<span>${escapeHtml(order.order_no_mall || '')}</span></span>`;
+            let orderNoCell = `<td>${orderNoLabel}</td>`;
+            if (order.vendor === '자사몰' && order.order_no_mall) {
+                const url = `https://miraskitchen.cafe24.com/admin/php/shop1/s_new/order_detail.php?order_id=${encodeURIComponent(order.order_no_mall)}`;
+                orderNoCell = `<td><span class="order-no-cell">${orderNoteIcon}<a href="${url}" target="_blank" style="color: var(--primary-color); text-decoration: underline; cursor: pointer;">${escapeHtml(order.order_no_mall)}</a></span></td>`;
+            } else if (order.vendor === '스마트스토어' && order.order_no_mall) {
+                const url = `https://sell.smartstore.naver.com/#/naverpay/manage/order?detailSearch.type=ORDER_NO&detailSearch.keyword=${encodeURIComponent(order.order_no_mall)}`;
+                orderNoCell = `<td><span class="order-no-cell">${orderNoteIcon}<a href="${url}" target="_blank" style="color: var(--primary-color); text-decoration: underline; cursor: pointer;">${escapeHtml(order.order_no_mall)}</a></span></td>`;
+            }
+            const vendorText = order.vendor || '';
+            const normalizedVendor = vendorText.replace(/\s/g, '');
+            let vendorCell = `<td>${escapeHtml(vendorText)}</td>`;
+            if (normalizedVendor === '자사몰' || normalizedVendor === '가사몰') {
+                vendorCell = '<td><span class="vendor-badge vendor-badge-own">자사몰</span></td>';
+            } else if (normalizedVendor === '스마트스토어') {
+                vendorCell = '<td><span class="vendor-badge vendor-badge-smartstore">스마트스토어</span></td>';
+            }
+            const countBadge = (count, title, searchType) => {
+                const numericCount = Number(count || 0);
+                if (numericCount <= 1) return '';
+                let levelClass = 'count-badge-neutral';
+                if (numericCount >= 10) {
+                    levelClass = 'count-badge-danger';
+                } else if (numericCount >= 5) {
+                    levelClass = 'count-badge-warning';
+                }
+                return `<span class="count-badge ${levelClass}" data-search-type="${searchType}" title="${title} ${numericCount}건">${numericCount}</span>`;
+            };
+            const addressToCopy = order.address || '';
+            const addressToSearch = addressToCopy.trim();
+            const phoneToCopy = order.recipient_mobile || order.recipient_phone || '';
+            const phoneToSearch = phoneToCopy.trim();
+            const addressCountBadge = countBadge(
+                order.address_order_count,
+                '전체 데이터에서 같은 주소의 주문날짜',
+                'address'
+            );
+            const phoneCountBadge = countBadge(
+                order.phone_order_count,
+                '전체 데이터에서 같은 전화번호의 주문날짜',
+                'phone'
+            );
+            const customerNote = order.customer_note || '';
+            const noteIcon = customerNote
+                ? `<span class="customer-note-icon" title="${escapeHtml(customerNote)}" aria-label="고객 메모 있음">📝</span>`
+                : '';
+
+            tr.innerHTML = `
+                <td>${escapeHtml(formattedDate)}</td>
+                <td class="copyable editable-contact" data-edit-field="name" title="클릭하여 복사 / 더블클릭하여 수정" style="cursor: pointer;"><span class="customer-name-cell">${noteIcon}<strong>${escapeHtml(order.recipient_name || '')}</strong></span></td>
+                <td>${escapeHtml(pCode)}</td>
+                <td title="${escapeHtml(pName)}">${escapeHtml(pName)}</td>
+                <td>${escapeHtml(order.order_quantity || '')}</td>
+                <td class="cell-address copyable editable-contact" data-edit-field="address" title="클릭하여 복사 / 더블클릭하여 수정" style="cursor: pointer;"><span class="address-cell-inner"><span class="address-text">${escapeHtml(addressToCopy)}</span>${addressCountBadge}</span></td>
+                <td class="cell-phone copyable editable-contact" data-edit-field="phone" title="클릭하여 복사 / 더블클릭하여 수정" style="cursor: pointer;"><span class="phone-cell-inner"><span class="phone-text">${escapeHtml(phoneToCopy)}</span>${phoneCountBadge}</span></td>
+                ${trackingCell}
+                ${vendorCell}
+                ${orderNoCell}
+                <td title="${escapeHtml(order.order_list_1 || '')}">${escapeHtml(order.order_list_1 || '')}</td>
+            `;
+            tr.querySelector('[data-edit-field="name"]').dataset.copy = order.recipient_name || '';
+            tr.querySelector('[data-edit-field="address"]').dataset.copy = addressToCopy;
+            tr.querySelector('[data-edit-field="phone"]').dataset.copy = phoneToCopy;
+
+            let copyTimer = null;
+
+            tr.addEventListener('dblclick', (e) => {
+                const editableCell = e.target.closest('.editable-contact');
+                if (!editableCell) return;
+                if (copyTimer) {
+                    clearTimeout(copyTimer);
+                    copyTimer = null;
+                }
+                e.preventDefault();
+                e.stopPropagation();
+                openOrderEditModal(order, editableCell.dataset.editField);
+            });
+
+            tr.addEventListener('click', (e) => {
+                if (e.target.tagName === 'A') return;
+                const countBadgeEl = e.target.closest('.count-badge');
+                if (countBadgeEl) {
+                    e.preventDefault();
+                    e.stopPropagation();
+
+                    searchInputs.tracking.value = '';
+                    if (searchStartDate) searchStartDate.value = '';
+                    if (searchEndDate) searchEndDate.value = '';
+
+                    if (countBadgeEl.dataset.searchType === 'address') {
+                        searchInputs.name.value = order.recipient_name || '';
+                        searchInputs.address.value = addressToSearch;
+                        searchInputs.phone.value = '';
+                    } else if (countBadgeEl.dataset.searchType === 'phone') {
+                        searchInputs.name.value = '';
+                        searchInputs.phone.value = phoneToSearch;
+                        searchInputs.address.value = '';
+                    }
+
+                    highlightDateGroups = true;
+                    performSearch(1);
+                    return;
+                }
+                const copyableCell = e.target.closest('.copyable');
+                if (copyableCell) {
+                    const textToCopy = copyableCell.getAttribute('data-copy');
+                    if (textToCopy) {
+                        if (copyTimer) clearTimeout(copyTimer);
+                        copyTimer = setTimeout(() => {
+                            copyTextToClipboard(textToCopy).then(() => {
+                                showToast('클립보드에 복사되었습니다.', 'success');
+                            }).catch(err => {
+                                console.error('복사 실패:', err);
+                                showToast('클립보드 복사에 실패했습니다.', 'error');
+                            });
+                            copyTimer = null;
+                        }, 220);
+                    }
+                }
+            });
+
+            resultsBody.appendChild(tr);
+        });
+    }
+
+    function closeOrderEditModal() {
+        if (!orderEditModal) return;
+        orderEditModal.classList.remove('show');
+        if (returnRequestModal) returnRequestModal.classList.remove('show');
+        editingOrderId = null;
+        editingOrderData = null;
+    }
+
+    function closeReturnRequestModal() {
+        if (!returnRequestModal) return;
+        returnRequestModal.classList.remove('show');
+    }
+
+    function openOrderEditModal(order, focusField) {
+        if (!orderEditModal) return;
+        editingOrderId = order.id;
+        editingOrderData = order;
+        editRecipientName.value = order.recipient_name || '';
+        editAddress.value = order.address || '';
+        editRecipientMobile.value = order.recipient_mobile || order.recipient_phone || '';
+        if (editCustomerNote) {
+            editCustomerNote.value = order.customer_note || '';
+        }
+        if (editOrderNote) {
+            editOrderNote.value = order.order_note || '';
+        }
+        orderEditModal.classList.add('show');
+
+        const focusTarget = {
+            name: editRecipientName,
+            address: editAddress,
+            phone: editRecipientMobile,
+        }[focusField] || editRecipientName;
+        setTimeout(() => {
+            focusTarget.focus();
+            focusTarget.select();
+        }, 0);
+    }
+
+    function openReturnRequestModal() {
+        if (!returnRequestModal || !editingOrderId) return;
+        if (returnRequestDate) returnRequestDate.value = todayKstDateString();
+        if (returnRequestType) returnRequestType.value = '단순변심';
+        if (returnRequestTracking) {
+            const trackingOptions = trackingNumberOptions(editingOrderData ? editingOrderData.tracking_number : '');
+            returnRequestTracking.innerHTML = '';
+            if (trackingOptions.length) {
+                trackingOptions.forEach((trackingNo) => {
+                    const option = document.createElement('option');
+                    option.value = trackingNo;
+                    option.textContent = trackingNo;
+                    returnRequestTracking.appendChild(option);
+                });
+                returnRequestTracking.disabled = trackingOptions.length <= 1;
+            } else {
+                const option = document.createElement('option');
+                option.value = '';
+                option.textContent = '송장번호 없음';
+                returnRequestTracking.appendChild(option);
+                returnRequestTracking.disabled = true;
+            }
+        }
+        if (returnRequestRemarks) returnRequestRemarks.value = '';
+        returnRequestModal.classList.add('show');
+        setTimeout(() => {
+            if (returnRequestRemarks) returnRequestRemarks.focus();
+        }, 0);
+        logUiEvent('반품 신청 팝업 열기', { order_id: editingOrderId });
+    }
+
+    async function sendReturnRequest() {
+        if (!editingOrderId || !btnSendReturnRequest) return;
+
+        const originalText = btnSendReturnRequest.innerHTML;
+        btnSendReturnRequest.disabled = true;
+        btnSendReturnRequest.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 전송 중...';
+
+        const payload = {
+            request_date: returnRequestDate ? returnRequestDate.value : '',
+            request_type: returnRequestType ? returnRequestType.value : '단순변심',
+            receiver_name: editRecipientName ? editRecipientName.value : '',
+            address: editAddress ? editAddress.value : '',
+            phone: editRecipientMobile ? editRecipientMobile.value : '',
+            tracking_no: returnRequestTracking ? returnRequestTracking.value : '',
+            remarks: returnRequestRemarks ? returnRequestRemarks.value : '',
+        };
+
+        logUiEvent('반품 신청 전송 버튼 클릭', {
+            order_id: editingOrderId,
+            request_date: payload.request_date,
+            request_type: payload.request_type,
+            has_remarks: !!payload.remarks,
+        });
+
+        try {
+            const res = await fetch(appUrl(`/api/orders/${editingOrderId}/return-request`), {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(payload),
+            });
+            const data = await res.json();
+            if (res.ok) {
+                showToast(data.message || '반품 신청 데이터가 전송되었습니다.', 'success');
+                closeOrderEditModal();
+            } else {
+                showToast(data.detail || '반품 신청 전송 실패', 'error');
+            }
+        } catch (error) {
+            showToast('반품 신청 전송 중 네트워크 오류가 발생했습니다.', 'error');
+        } finally {
+            btnSendReturnRequest.disabled = false;
+            btnSendReturnRequest.innerHTML = originalText;
+        }
+    }
+
+    async function saveOrderEdit() {
+        if (!editingOrderId) return;
+
+        const originalText = btnSaveOrderEdit.innerHTML;
+        btnSaveOrderEdit.disabled = true;
+        btnSaveOrderEdit.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 저장 중...';
+
+        try {
+            const res = await fetch(appUrl(`/api/orders/${editingOrderId}/contact`), {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    recipient_name: editRecipientName.value,
+                    address: editAddress.value,
+                    recipient_mobile: editRecipientMobile.value,
+                    customer_note: editCustomerNote ? editCustomerNote.value : '',
+                    order_note: editOrderNote ? editOrderNote.value : ''
+                })
+            });
+            const data = await res.json();
+            if (res.ok) {
+                showToast(data.message || '주문 정보가 수정되었습니다.', 'success');
+                closeOrderEditModal();
+                await performSearch(currentSearchPage);
+            } else {
+                showToast(data.detail || '주문 정보 수정 실패', 'error');
+            }
+        } catch (error) {
+            showToast('주문 정보 수정 중 네트워크 오류가 발생했습니다.', 'error');
+        } finally {
+            btnSaveOrderEdit.disabled = false;
+            btnSaveOrderEdit.innerHTML = originalText;
+        }
+    }
+
+    async function deleteCurrentOrder() {
+        if (!editingOrderId || !btnDeleteOrderEdit) return;
+
+        const deletePassword = prompt('이 주문을 삭제하려면 비밀번호를 입력하세요.');
+        if (deletePassword === null) {
+            logUiEvent('주문 단건 삭제 취소', { order_id: editingOrderId, step: 'password_prompt' });
+            return;
+        }
+        if (deletePassword !== '1225') {
+            logUiEvent('주문 단건 삭제 암호 오류', { order_id: editingOrderId });
+            showToast('비밀번호가 올바르지 않습니다.', 'error');
+            return;
+        }
+        if (!confirm('이 주문을 삭제하시겠습니까? 삭제 후 되돌릴 수 없습니다.')) {
+            logUiEvent('주문 단건 삭제 취소', { order_id: editingOrderId, step: 'confirm' });
+            return;
+        }
+
+        const orderIdToDelete = editingOrderId;
+        const originalText = btnDeleteOrderEdit.innerHTML;
+        btnDeleteOrderEdit.disabled = true;
+        btnDeleteOrderEdit.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 삭제 중...';
+        logUiEvent('주문 단건 삭제 요청', { order_id: orderIdToDelete });
+
+        try {
+            const res = await fetch(appUrl(`/api/orders/${orderIdToDelete}/delete`), {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ password: deletePassword })
+            });
+            const data = await res.json();
+            if (res.ok) {
+                showToast(data.message || '주문이 삭제되었습니다.', 'success');
+                closeOrderEditModal();
+                await performSearch(currentSearchPage);
+            } else {
+                showToast(data.detail || '주문 삭제 실패', 'error');
+            }
+        } catch (error) {
+            showToast('주문 삭제 중 네트워크 오류가 발생했습니다.', 'error');
+        } finally {
+            btnDeleteOrderEdit.disabled = false;
+            btnDeleteOrderEdit.innerHTML = originalText;
+        }
+    }
+
+    function renderPagination(currentPage, totalPages) {
+        const container = document.getElementById('pagination-container');
+        if (!container) return;
+
+        container.innerHTML = '';
+        if (totalPages <= 1) return;
+
+        const pageGroupSize = 50;
+        const groupStart = Math.floor((currentPage - 1) / pageGroupSize) * pageGroupSize + 1;
+        const groupEnd = Math.min(groupStart + pageGroupSize - 1, totalPages);
+
+        if (groupStart > 1) {
+            const prevBtn = document.createElement('button');
+            prevBtn.className = 'btn-page btn-page-nav';
+            prevBtn.textContent = '<<이전 페이지';
+            prevBtn.addEventListener('click', () => {
+                performSearch(groupStart - pageGroupSize);
+            });
+            container.appendChild(prevBtn);
+        }
+
+        for (let i = groupStart; i <= groupEnd; i++) {
+            const btn = document.createElement('button');
+            btn.className = `btn-page ${i === currentPage ? 'active' : ''}`;
+            btn.textContent = i;
+            btn.addEventListener('click', () => {
+                performSearch(i);
+            });
+            container.appendChild(btn);
+        }
+
+        if (groupEnd < totalPages) {
+            const nextBtn = document.createElement('button');
+            nextBtn.className = 'btn-page btn-page-nav';
+            nextBtn.textContent = '다음 페이지>>';
+            nextBtn.addEventListener('click', () => {
+                performSearch(groupEnd + 1);
+            });
+            container.appendChild(nextBtn);
+        }
+    }
+
+    if (btnDataManagement) {
+        btnDataManagement.addEventListener('click', () => {
+            dataManagementModal.classList.add('show');
+            loadDatabaseSize();
+            logUiEvent('데이터 관리 탭 열기');
+        });
+    }
+
+    if (btnCloseDataManagement) {
+        btnCloseDataManagement.addEventListener('click', () => {
+            dataManagementModal.classList.remove('show');
+            logUiEvent('데이터 관리 탭 닫기', { close_type: 'button' });
+        });
+    }
+
+    if (btnCloseOrderEdit) {
+        btnCloseOrderEdit.addEventListener('click', closeOrderEditModal);
+    }
+
+    if (btnCancelOrderEdit) {
+        btnCancelOrderEdit.addEventListener('click', closeOrderEditModal);
+    }
+
+    if (btnSaveOrderEdit) {
+        btnSaveOrderEdit.addEventListener('click', saveOrderEdit);
+    }
+
+    if (btnDeleteOrderEdit) {
+        btnDeleteOrderEdit.addEventListener('click', deleteCurrentOrder);
+    }
+
+    if (btnOpenReturnRequest) {
+        btnOpenReturnRequest.addEventListener('click', openReturnRequestModal);
+    }
+
+    if (btnCloseReturnRequest) {
+        btnCloseReturnRequest.addEventListener('click', closeReturnRequestModal);
+    }
+
+    if (btnCancelReturnRequest) {
+        btnCancelReturnRequest.addEventListener('click', closeReturnRequestModal);
+    }
+
+    if (btnSendReturnRequest) {
+        btnSendReturnRequest.addEventListener('click', sendReturnRequest);
+    }
+
+    window.addEventListener('click', (e) => {
+        if (e.target === dataManagementModal) {
+            dataManagementModal.classList.remove('show');
+            logUiEvent('데이터 관리 탭 닫기', { close_type: 'backdrop' });
+        }
+        if (e.target === orderEditModal) {
+            closeOrderEditModal();
+        }
+        if (e.target === returnRequestModal) {
+            closeReturnRequestModal();
+        }
+    });
+
+    if (btnOptimizeDb) {
+        btnOptimizeDb.addEventListener('click', async () => {
+            if (!confirm('데이터베이스 최적화를 시작하시겠습니까?\n이 작업은 데이터 용량에 따라 몇 초에서 수십 초가 소요될 수 있습니다.')) return;
+            logUiEvent('데이터베이스 최적화 요청');
+
+            btnOptimizeDb.disabled = true;
+            btnOptimizeDb.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 최적화 중...';
+            dbProgressContainer.style.display = 'block';
+            dbProgressFill.style.width = '0%';
+            dbProgressText.textContent = '0%';
+
+            let progress = 0;
+            // Fake progress that approaches 95%
+            const progressInterval = setInterval(() => {
+                progress += (95 - progress) * 0.15;
+                dbProgressFill.style.width = `${progress}%`;
+                dbProgressText.textContent = `${Math.round(progress)}%`;
+            }, 500);
+
+            try {
+                const res = await fetch(appUrl('/api/settings/optimize'), {
+                    method: 'POST'
+                });
+                const data = await res.json();
+
+                clearInterval(progressInterval);
+
+                if (res.ok) {
+                    dbProgressFill.style.width = '100%';
+                    dbProgressText.textContent = '100%';
+                    showToast(data.message || '최적화가 완료되었습니다.', 'success');
+                    loadDatabaseSize();
+                } else {
+                    showToast(data.detail || '최적화 실패', 'error');
+                }
+            } catch (error) {
+                clearInterval(progressInterval);
+                showToast('네트워크 오류', 'error');
+            } finally {
+                btnOptimizeDb.disabled = false;
+                btnOptimizeDb.innerHTML = '<i class="fa-solid fa-broom"></i> 데이터베이스 최적화 (용량 줄이기)';
+                setTimeout(() => {
+                    dbProgressContainer.style.display = 'none';
+                    dbProgressFill.style.width = '0%';
+                    dbProgressText.textContent = '0%';
+                }, 3000);
+            }
+        });
+    }
+
+    async function downloadFileFromResponse(res, fallbackFilename) {
+        let filename = fallbackFilename;
+        const disposition = res.headers.get('Content-Disposition');
+        if (disposition && disposition.indexOf('attachment') !== -1) {
+            const utf8Match = disposition.match(/filename\*=UTF-8''([^;]+)/);
+            const plainMatch = disposition.match(/filename="?([^";]+)"?/);
+            if (utf8Match && utf8Match[1]) {
+                filename = decodeURIComponent(utf8Match[1]);
+            } else if (plainMatch && plainMatch[1]) {
+                filename = plainMatch[1];
+            }
+        }
+
+        const blob = await res.blob();
+        const url = window.URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.style.display = 'none';
+        a.href = url;
+        a.download = filename;
+        document.body.appendChild(a);
+        a.click();
+        setTimeout(() => {
+            window.URL.revokeObjectURL(url);
+            document.body.removeChild(a);
+        }, 1000);
+    }
+
+    async function getErrorMessageFromResponse(res, fallbackMessage) {
+        try {
+            const contentType = res.headers.get('Content-Type') || '';
+            if (contentType.includes('application/json')) {
+                const data = await res.json();
+                return data.detail || data.message || fallbackMessage;
+            }
+            const text = await res.text();
+            return text || fallbackMessage;
+        } catch (error) {
+            return fallbackMessage;
+        }
+    }
+
+    if (btnBackupDb) {
+        btnBackupDb.addEventListener('click', async () => {
+            logUiEvent('DB 백업 다운로드 요청');
+            const originalText = btnBackupDb.innerHTML;
+            btnBackupDb.disabled = true;
+            btnBackupDb.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 백업 생성 중...';
+
+            try {
+                const res = await fetch(appUrl('/api/settings/backup-db'));
+                if (res.ok) {
+                    await downloadFileFromResponse(res, 'OMS_DB_backup.db');
+                    showToast('DB 백업 다운로드가 완료되었습니다.', 'success');
+                } else {
+                    const data = await res.json();
+                    showToast(data.detail || 'DB 백업 실패', 'error');
+                }
+            } catch (error) {
+                showToast('DB 백업 중 네트워크 오류가 발생했습니다.', 'error');
+            } finally {
+                btnBackupDb.disabled = false;
+                btnBackupDb.innerHTML = originalText;
+            }
+        });
+    }
+
+    if (btnDownloadEventLog) {
+        btnDownloadEventLog.addEventListener('click', async () => {
+            logUiEvent('이벤트 로그 다운로드 요청');
+            const originalText = btnDownloadEventLog.innerHTML;
+            btnDownloadEventLog.disabled = true;
+            btnDownloadEventLog.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 로그 생성 중...';
+
+            try {
+                const res = await fetch(appUrl('/api/settings/download-log'));
+                if (res.ok) {
+                    await downloadFileFromResponse(res, 'OMS_event_log.csv');
+                    showToast('이벤트 로그 다운로드가 완료되었습니다.', 'success');
+                } else {
+                    const message = await getErrorMessageFromResponse(res, '로그 다운로드 실패');
+                    showToast(message, 'error');
+                }
+            } catch (error) {
+                showToast(`로그 다운로드 오류: ${error.message || '응답 처리 실패'}`, 'error');
+            } finally {
+                btnDownloadEventLog.disabled = false;
+                btnDownloadEventLog.innerHTML = originalText;
+            }
+        });
+    }
+
+    if (btnDownloadRepeatPurchase) {
+        btnDownloadRepeatPurchase.addEventListener('click', async () => {
+            const startDate = repeatStartDate ? repeatStartDate.value : '';
+            const endDate = repeatEndDate ? repeatEndDate.value : '';
+            const minCount = Number(repeatMinCount ? repeatMinCount.value : 3);
+
+            if (!startDate || !endDate) {
+                showToast('반복 구매 조회 시작일과 종료일을 모두 선택해 주세요.', 'error');
+                return;
+            }
+            if (startDate > endDate) {
+                showToast('시작일이 종료일보다 늦을 수 없습니다.', 'error');
+                return;
+            }
+            if (!Number.isInteger(minCount) || minCount < 1) {
+                showToast('구매 회수는 1 이상의 숫자로 입력해 주세요.', 'error');
+                return;
+            }
+            logUiEvent('반복 구매 리스트 다운로드 요청', {
+                start_date: startDate,
+                end_date: endDate,
+                min_count: minCount
+            });
+
+            const originalText = btnDownloadRepeatPurchase.innerHTML;
+            btnDownloadRepeatPurchase.disabled = true;
+            btnDownloadRepeatPurchase.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 파일 생성 중...';
+
+            try {
+                const params = new URLSearchParams({
+                    start_date: startDate,
+                    end_date: endDate,
+                    min_count: String(minCount)
+                });
+                const res = await fetch(appUrl(`/api/settings/repeat-purchase-export?${params.toString()}`));
+                if (res.ok) {
+                    await downloadFileFromResponse(res, '반복구매.xlsx');
+                    showToast('반복 구매 리스트 다운로드가 완료되었습니다.', 'success');
+                } else {
+                    const data = await res.json();
+                    showToast(data.detail || '반복 구매 리스트 다운로드 실패', 'error');
+                }
+            } catch (error) {
+                showToast('반복 구매 리스트 다운로드 중 네트워크 오류가 발생했습니다.', 'error');
+            } finally {
+                btnDownloadRepeatPurchase.disabled = false;
+                btnDownloadRepeatPurchase.innerHTML = originalText;
+            }
+        });
+    }
+
+    if (restoreDbFile) {
+        restoreDbFile.addEventListener('change', async (e) => {
+            const file = e.target.files[0];
+            if (!file) return;
+            logUiEvent('DB 복구 파일 선택', {
+                filename: file.name,
+                size: file.size
+            });
+
+            if (!confirm(`백업 파일 "${file.name}"로 DB를 복구하시겠습니까?\n현재 DB는 자동 안전백업 후 교체됩니다.`)) {
+                logUiEvent('DB 복구 취소', { filename: file.name, step: 'first_confirm' });
+                restoreDbFile.value = '';
+                return;
+            }
+            if (!confirm('복구가 완료되면 현재 검색 결과는 초기화됩니다. 계속하시겠습니까?')) {
+                logUiEvent('DB 복구 취소', { filename: file.name, step: 'second_confirm' });
+                restoreDbFile.value = '';
+                return;
+            }
+            logUiEvent('DB 복구 요청', { filename: file.name });
+
+            const formData = new FormData();
+            formData.append('file', file);
+
+            const restoreLabel = document.querySelector('label[for="restore-db-file"]');
+            const originalText = restoreLabel ? restoreLabel.innerHTML : '';
+            restoreDbFile.disabled = true;
+            if (restoreLabel) {
+                restoreLabel.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 복구 중...';
+            }
+
+            try {
+                const res = await fetch(appUrl('/api/settings/restore-db'), {
+                    method: 'POST',
+                    body: formData
+                });
+                const data = await res.json();
+                if (res.ok) {
+                    showToast(`${data.restored_count}건의 주문 데이터가 복구되었습니다.`, 'success');
+                    resultsBody.innerHTML = `<tr><td colspan="11" class="empty-state">DB가 복구되었습니다. 다시 검색해주세요.</td></tr>`;
+                    resultCount.textContent = '0';
+                    dataManagementModal.classList.remove('show');
+                } else {
+                    showToast(data.detail || 'DB 복구 실패', 'error');
+                }
+            } catch (error) {
+                showToast('DB 복구 중 네트워크 오류가 발생했습니다.', 'error');
+            } finally {
+                restoreDbFile.disabled = false;
+                restoreDbFile.value = '';
+                if (restoreLabel) {
+                    restoreLabel.innerHTML = originalText;
+                }
+            }
+        });
+    }
+
+    function resetDeleteDateProgress() {
+        if (!deleteDateProgressContainer) return;
+        deleteDateProgressContainer.style.display = 'block';
+        deleteDateProgressMessage.textContent = '삭제 준비 중...';
+        deleteDateProgressText.textContent = '0%';
+        deleteDateProgressFill.style.width = '0%';
+        deleteDateProgressCount.textContent = '0 / 0건';
+        if (deleteCleanupProgressMessage) deleteCleanupProgressMessage.textContent = '정리 대기';
+        if (deleteCleanupProgressText) deleteCleanupProgressText.textContent = '0%';
+        if (deleteCleanupProgressFill) deleteCleanupProgressFill.style.width = '0%';
+    }
+
+    function setDeleteDateProgress(data) {
+        if (!deleteDateProgressContainer) return;
+        const progress = Math.max(0, Math.min(100, Number(data.progress || 0)));
+        const cleanupProgress = Math.max(0, Math.min(100, Number(data.cleanup_progress || 0)));
+        const totalRows = Number(data.total_rows || 0);
+        const deletedRows = Number(data.deleted_rows || 0);
+
+        deleteDateProgressContainer.style.display = 'block';
+        deleteDateProgressMessage.textContent = progress < 100 ? (data.message || '삭제 중입니다...') : '삭제 완료';
+        deleteDateProgressText.textContent = `${Math.round(progress)}%`;
+        deleteDateProgressFill.style.width = `${progress}%`;
+        deleteDateProgressCount.textContent = `${deletedRows.toLocaleString()} / ${totalRows.toLocaleString()}건`;
+        if (deleteCleanupProgressMessage) {
+            deleteCleanupProgressMessage.textContent = data.cleanup_step || (cleanupProgress > 0 ? data.message : '정리 대기');
+        }
+        if (deleteCleanupProgressText) {
+            deleteCleanupProgressText.textContent = `${Math.round(cleanupProgress)}%`;
+        }
+        if (deleteCleanupProgressFill) {
+            deleteCleanupProgressFill.style.width = `${cleanupProgress}%`;
+        }
+    }
+
+    if (btnDeleteDateRangeOrders) {
+        btnDeleteDateRangeOrders.addEventListener('click', async () => {
+            const startDate = deleteStartDate ? deleteStartDate.value : '';
+            const endDate = deleteEndDate ? deleteEndDate.value : '';
+
+            if (!startDate || !endDate) {
+                showToast('삭제할 시작일과 종료일을 모두 선택해 주세요.', 'error');
+                return;
+            }
+            if (startDate > endDate) {
+                showToast('시작일이 종료일보다 늦을 수 없습니다.', 'error');
+                return;
+            }
+
+            const deletePassword = prompt('지정한 날짜 범위의 주문 데이터를 삭제하려면 비밀번호를 입력하세요.');
+            if (deletePassword === null) return;
+            if (deletePassword !== '1225') {
+                showToast('비밀번호가 올바르지 않습니다.', 'error');
+                logUiEvent('날짜 범위 주문 데이터 삭제 비밀번호 오류', {
+                    start_date: startDate,
+                    end_date: endDate
+                });
+                return;
+            }
+            if (!confirm(`비밀번호가 확인되었습니다.\n${startDate} ~ ${endDate} 주문 데이터를 삭제하시겠습니까?\n이 작업은 되돌릴 수 없습니다.`)) {
+                logUiEvent('날짜 범위 주문 데이터 삭제 취소', {
+                    start_date: startDate,
+                    end_date: endDate
+                });
+                return;
+            }
+            logUiEvent('날짜 범위 주문 데이터 삭제 요청', {
+                start_date: startDate,
+                end_date: endDate
+            });
+
+            const originalText = btnDeleteDateRangeOrders.innerHTML;
+            const deleteToken = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+            let deleteEventSource = null;
+
+            resetDeleteDateProgress();
+            btnDeleteDateRangeOrders.disabled = true;
+            btnDeleteDateRangeOrders.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 범위 삭제 중...';
+
+            try {
+                deleteEventSource = new EventSource(appUrl(`/api/settings/delete-progress?delete_token=${encodeURIComponent(deleteToken)}`));
+                deleteEventSource.onmessage = (event) => {
+                    try {
+                        const progressData = JSON.parse(event.data);
+                        if (progressData.status !== 'idle') {
+                            setDeleteDateProgress(progressData);
+                        }
+                        if (['completed', 'error'].includes(progressData.status)) {
+                            deleteEventSource.close();
+                        }
+                    } catch (err) {
+                        console.error('Delete progress parse error', err);
+                    }
+                };
+                deleteEventSource.onerror = () => {
+                    if (deleteEventSource) deleteEventSource.close();
+                };
+
+                const res = await fetch(appUrl('/api/settings/delete-orders-by-date-range'), {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        password: deletePassword,
+                        start_date: startDate,
+                        end_date: endDate,
+                        delete_token: deleteToken
+                    })
+                });
+                const data = await res.json();
+                if (res.ok) {
+                    setDeleteDateProgress({
+                        status: 'completed',
+                        message: '삭제가 완료되었습니다.',
+                        progress: 100,
+                        cleanup_progress: 100,
+                        total_rows: data.deleted_count,
+                        deleted_rows: data.deleted_count,
+                        cleanup_step: '정리 완료'
+                    });
+                    showToast(`${data.deleted_count}건의 주문 데이터가 삭제되었습니다.`, 'success');
+                    resultsBody.innerHTML = `<tr><td colspan="11" class="empty-state">${startDate} ~ ${endDate} 주문 데이터가 삭제되었습니다. 다시 검색해 주세요.</td></tr>`;
+                    resultCount.textContent = '0';
+                    dataManagementModal.classList.remove('show');
+                } else {
+                    showToast(data.detail || '날짜 범위 삭제 실패', 'error');
+                }
+            } catch (error) {
+                showToast('날짜 범위 삭제 중 네트워크 오류가 발생했습니다.', 'error');
+            } finally {
+                if (deleteEventSource) deleteEventSource.close();
+                btnDeleteDateRangeOrders.disabled = false;
+                btnDeleteDateRangeOrders.innerHTML = originalText;
+            }
+        });
+    }
+
+    if (btnDeleteAllOrders) {
+        btnDeleteAllOrders.addEventListener('click', async () => {
+            const deletePassword = prompt('전체 주문 데이터를 삭제하려면 비밀번호를 입력하세요.');
+            if (deletePassword === null) return;
+            if (deletePassword !== '1225') {
+                showToast('비밀번호가 올바르지 않습니다.', 'error');
+                logUiEvent('전체 주문 데이터 삭제 비밀번호 오류');
+                return;
+            }
+            if (!confirm('비밀번호가 확인되었습니다.\n전체 주문 데이터를 삭제하시겠습니까?\n이 작업은 되돌릴 수 없습니다.')) {
+                logUiEvent('전체 주문 데이터 삭제 취소');
+                return;
+            }
+            logUiEvent('전체 주문 데이터 삭제 요청');
+
+            const originalText = btnDeleteAllOrders.innerHTML;
+            btnDeleteAllOrders.disabled = true;
+            btnDeleteAllOrders.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 전체 삭제 중...';
+
+            try {
+                const res = await fetch(appUrl('/api/settings/delete-all-orders'), {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ password: deletePassword })
+                });
+                const data = await res.json();
+                if (res.ok) {
+                    showToast(`${data.deleted_count}건의 전체 주문 데이터가 삭제되었습니다.`, 'success');
+                    resultsBody.innerHTML = `<tr><td colspan="11" class="empty-state">전체 주문 데이터가 삭제되었습니다.</td></tr>`;
+                    resultCount.textContent = '0';
+                    dataManagementModal.classList.remove('show');
+                } else {
+                    showToast(data.detail || '전체 삭제 실패', 'error');
+                }
+            } catch (error) {
+                showToast('전체 삭제 중 네트워크 오류가 발생했습니다.', 'error');
+            } finally {
+                btnDeleteAllOrders.disabled = false;
+                btnDeleteAllOrders.innerHTML = originalText;
+            }
+        });
+    }
+
+    if (exportAllDatesChk) {
+        exportAllDatesChk.addEventListener('change', (e) => {
+            logUiEvent('DB 데이터 엑셀 다운로드 전체 날짜 옵션 변경', {
+                checked: e.target.checked
+            });
+            if (e.target.checked) {
+                exportDateRangeContainer.style.opacity = '0.4';
+                exportStartDate.disabled = true;
+                exportEndDate.disabled = true;
+            } else {
+                exportDateRangeContainer.style.opacity = '1';
+                exportStartDate.disabled = false;
+                exportEndDate.disabled = false;
+            }
+        });
+    }
+
+    function resetExportProgress() {
+        if (!exportProgressContainer) return;
+        exportProgressContainer.style.display = 'block';
+        exportProgressMessage.textContent = '파일 생성 준비 중...';
+        exportProgressText.textContent = '0%';
+        exportProgressFill.style.width = '0%';
+        exportProgressCount.textContent = '0 / 0건';
+    }
+
+    function setExportProgress(data) {
+        if (!exportProgressContainer) return;
+        const processedRows = Number(data.processed_rows || 0);
+        const totalRows = Number(data.total_rows || 0);
+        const progress = Math.max(0, Math.min(100, Number(data.progress || 0)));
+
+        exportProgressContainer.style.display = 'block';
+        exportProgressMessage.textContent = data.message || '파일 생성 중...';
+        exportProgressText.textContent = `${Math.round(progress)}%`;
+        exportProgressFill.style.width = `${progress}%`;
+        exportProgressCount.textContent = `${processedRows.toLocaleString()} / ${totalRows.toLocaleString()}건`;
+    }
+
+    if (btnExportDb) {
+        btnExportDb.addEventListener('click', async () => {
+            const isAllDates = exportAllDatesChk.checked;
+            const startDate = exportStartDate.value;
+            const endDate = exportEndDate.value;
+
+            if (!isAllDates && (!startDate || !endDate)) {
+                showToast('시작일과 종료일을 모두 선택해주세요.', 'error');
+                return;
+            }
+            if (!isAllDates && startDate > endDate) {
+                showToast('시작일이 종료일보다 클 수 없습니다.', 'error');
+                return;
+            }
+            logUiEvent('DB 데이터 엑셀 다운로드 요청', {
+                all_dates: isAllDates,
+                start_date: isAllDates ? '' : startDate,
+                end_date: isAllDates ? '' : endDate
+            });
+
+            btnExportDb.disabled = true;
+            const originalText = btnExportDb.innerHTML;
+            btnExportDb.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i> 파일 생성 및 다운로드 중...';
+            resetExportProgress();
+
+            try {
+                // Determine query parameters
+                const params = new URLSearchParams();
+                if (!isAllDates) {
+                    params.append('start_date', startDate);
+                    params.append('end_date', endDate);
+                }
+
+                const startRes = await fetch(appUrl(`/api/settings/export-db/start?${params.toString()}`), {
+                    method: 'POST'
+                });
+                if (!startRes.ok) {
+                    const message = await getErrorMessageFromResponse(startRes, '엑셀 다운로드 작업 시작 실패');
+                    showToast(message, 'error');
+                    return;
+                }
+
+                const startData = await startRes.json();
+                const exportToken = startData.export_token;
+                if (!exportToken) {
+                    throw new Error('다운로드 작업 번호를 받지 못했습니다.');
+                }
+
+                let statusData = startData;
+                for (;;) {
+                    await new Promise(resolve => setTimeout(resolve, 2000));
+                    const statusRes = await fetch(appUrl(`/api/settings/export-db/status?export_token=${encodeURIComponent(exportToken)}`));
+                    if (!statusRes.ok) {
+                        const message = await getErrorMessageFromResponse(statusRes, '엑셀 다운로드 상태 확인 실패');
+                        showToast(message, 'error');
+                        return;
+                    }
+
+                    statusData = await statusRes.json();
+                    setExportProgress(statusData);
+                    const processedRows = Number(statusData.processed_rows || 0);
+                    const processedText = processedRows > 0 ? ` (${processedRows.toLocaleString()}건)` : '';
+                    btnExportDb.innerHTML = `<i class="fa-solid fa-spinner fa-spin"></i> ${statusData.message || '파일 생성 중...'}${processedText}`;
+
+                    if (statusData.status === 'completed') {
+                        break;
+                    }
+                    if (statusData.status === 'error') {
+                        showToast(statusData.message || '엑셀 파일 생성 실패', 'error');
+                        return;
+                    }
+                }
+
+                const downloadRes = await fetch(appUrl(`/api/settings/export-db/download?export_token=${encodeURIComponent(exportToken)}`));
+                if (downloadRes.ok) {
+                    await downloadFileFromResponse(downloadRes, 'DB_Export.xlsx');
+                    setExportProgress({
+                        ...statusData,
+                        status: 'completed',
+                        message: '다운로드가 완료되었습니다.',
+                        progress: 100
+                    });
+                    showToast('데이터베이스 다운로드가 완료되었습니다.', 'success');
+                } else {
+                    const message = await getErrorMessageFromResponse(downloadRes, '엑셀 파일 다운로드 실패');
+                    showToast(message, 'error');
+                }
+            } catch (error) {
+                console.error(error);
+                showToast(`엑셀 다운로드 오류: ${error.message || '응답 처리 실패'}`, 'error');
+            } finally {
+                btnExportDb.disabled = false;
+                btnExportDb.innerHTML = originalText;
+            }
+        });
+    }
+
+    // --- Toast Notifications ---
+    function showToast(message, type = 'success') {
+        const container = document.getElementById('toast-container');
+        const toast = document.createElement('div');
+        toast.className = `toast ${type}`;
+
+        let icon = type === 'success' ? '<i class="fa-solid fa-circle-check" style="color:var(--success-color)"></i>' : '<i class="fa-solid fa-circle-exclamation" style="color:#ef4444"></i>';
+
+        toast.innerHTML = `${icon} <span>${message}</span>`;
+        container.appendChild(toast);
+
+        setTimeout(() => {
+            toast.style.opacity = '0';
+            toast.style.transform = 'translateX(100%)';
+            setTimeout(() => toast.remove(), 300);
+        }, 3000);
+    }
+
+    // --- Column Resizing ---
+    function initResizers() {
+        const table = document.getElementById('results-table');
+        const cols = table.querySelectorAll('th');
+        [].forEach.call(cols, function (th) {
+            const resizer = th.querySelector('.resizer');
+            if (!resizer) return;
+
+            // Make the th position sticky if needed, and relative for its children
+            // The CSS already handles position: sticky and position: relative
+
+            let x = 0;
+            let w = 0;
+
+            const mouseDownHandler = function (e) {
+                // Get the current mouse position
+                x = e.clientX;
+
+                // Calculate the current width of column
+                const styles = window.getComputedStyle(th);
+                w = parseInt(styles.width, 10);
+
+                // Attach listeners for document's events
+                document.addEventListener('mousemove', mouseMoveHandler);
+                document.addEventListener('mouseup', mouseUpHandler);
+
+                resizer.classList.add('resizing');
+            };
+
+            const mouseMoveHandler = function (e) {
+                // Determine how far the mouse has been moved
+                const dx = e.clientX - x;
+
+                // Update the width of column
+                th.style.width = `${w + dx}px`;
+                th.style.minWidth = `${w + dx}px`;
+                th.style.maxWidth = `${w + dx}px`;
+            };
+
+            const mouseUpHandler = function () {
+                // Remove the handlers of `mousemove` and `mouseup`
+                document.removeEventListener('mousemove', mouseMoveHandler);
+                document.removeEventListener('mouseup', mouseUpHandler);
+
+                resizer.classList.remove('resizing');
+            };
+
+            resizer.addEventListener('mousedown', mouseDownHandler);
+        });
+    }
+
+    // Initialize resizers once when DOM is loaded
+    initResizers();
+});