docs: codify isolated 8081 worktree workflow

scripts/prepare_dev_worktree.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+DEV_DIR="${DEV_DIR:-/tmp/mh-dashboard-organization-dev-worktree}"
+TARGET_REF="${1:-HEAD}"
+
+copy_optional_path() {
+  local rel_path="$1"
+  local src="${ROOT_DIR}/${rel_path}"
+  local dst="${DEV_DIR}/${rel_path}"
+  if [[ ! -e "${src}" ]]; then
+    return 0
+  fi
+  mkdir -p "$(dirname "${dst}")"
+  cp -a "${src}" "${dst}"
+}
+
+if [[ "${DEV_DIR}" == "${ROOT_DIR}" ]]; then
+  echo "DEV_DIR must not be the same as the production workspace." >&2
+  exit 1
+fi
+
+echo "[1/6] Removing previous dev workspace at ${DEV_DIR}"
+rm -rf "${DEV_DIR}"
+
+echo "[2/6] Cloning production workspace into isolated dev workspace"
+git clone --no-hardlinks "${ROOT_DIR}" "${DEV_DIR}" >/dev/null
+
+echo "[3/6] Checking out detached ref ${TARGET_REF}"
+git -C "${DEV_DIR}" checkout --detach "${TARGET_REF}" >/dev/null
+
+echo "[4/6] Copying local runtime env when available"
+copy_optional_path ".env"
+
+echo "[5/6] Copying local-only incoming design assets when available"
+copy_optional_path "incoming-files/1.png"
+copy_optional_path "incoming-files/260320.html"
+copy_optional_path "incoming-files/sample style.css"
+copy_optional_path "incoming-files/seat/center_chair_people_map(2).html"
+copy_optional_path "incoming-files/사업관리대장"
+
+echo "[6/6] Dev worktree ready"
+echo "Path: ${DEV_DIR}"
+echo "Use this to start 8081 from the isolated workspace:"
+echo "  cd ${DEV_DIR} && docker compose -p mh-dashboard-organization-dev --env-file .env -f docker-compose.8081.yml up -d --build"

scripts/sync_prod_db_to_dev.sh

@@ -4,9 +4,9 @@ set -euo pipefail
 
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 PROD_DIR="${ROOT_DIR}"
-DEV_DIR="${DEV_DIR:-${ROOT_DIR}}"
+DEV_DIR="${DEV_DIR:-/tmp/mh-dashboard-organization-dev-worktree}"
 DEV_PROJECT_NAME="${DEV_PROJECT_NAME:-mh-dashboard-organization-dev}"
-DEV_COMPOSE_FILE="${DEV_COMPOSE_FILE:-${ROOT_DIR}/docker-compose.8081.yml}"
+DEV_COMPOSE_FILE="${DEV_COMPOSE_FILE:-${DEV_DIR}/docker-compose.8081.yml}"
 SCOPE="${1:-minimal}"
 
 if [[ ! -f "${PROD_DIR}/docker-compose.yml" ]]; then