@dazhicheng/common 1.0.45 → 1.0.47

package/.env.test

@@ -1,16 +1,16 @@
-# 【测试】环境变量
-
-# 应用部署基础路径（如部署在子目录 /admin，则设置为 /admin/）
-VITE_BASE_URL = /
-
-# API 地址前缀
-VITE_API_URL = test-api
-
-# Delete console
-VITE_DROP_CONSOLE = true
-
-# 飞书扫码登录回调地址
-VITE_FEISHU_REDIRECT_URI = http://fulfillment-qd.tiantai-jp.com:23006/feishuOAuth
-
-# webSocket地址
-VITE_WEBSOCKET_URL = ws://fulfillment-test.tiantai-jp.com:11000
+# 【测试】环境变量
+
+# 应用部署基础路径（如部署在子目录 /admin，则设置为 /admin/）
+VITE_BASE_URL = /
+
+# API 地址前缀
+VITE_API_URL = test-api
+
+# Delete console
+VITE_DROP_CONSOLE = true
+
+# 飞书扫码登录回调地址
+VITE_FEISHU_REDIRECT_URI = http://fulfillment-qd.tiantai-jp.com:23006/feishuOAuth
+
+# webSocket地址
+VITE_WEBSOCKET_URL = ws://fulfillment-test.tiantai-jp.com:11000

package/.gitignore

@@ -1,8 +1,8 @@
-node_modules
-.DS_Store
-dist
-dist-ssr
-*.local
-.cursorrules
-.vite
-.claude
+node_modules
+.DS_Store
+dist
+dist-ssr
+*.local
+.cursorrules
+.vite
+.claude

package/.gitlab-ci.yml

@@ -38,6 +38,7 @@ variables:
       - dist/
       - nginx_*.conf
       - docker-entrypoint.sh
+      - deploy-docker.sh
       - Dockerfile
     expire_in: 1 day
 
@@ -57,29 +58,20 @@ variables:
       - dist-test/
       - nginx_*.conf
       - docker-entrypoint.sh
+      - deploy-docker.sh
       - Dockerfile
     expire_in: 1 day
 
 # 部署锚点（通用脚本直接写在这里，不需要项目覆盖） -------------------------
 # 使用 named volume 持久化静态资源：发版时合并新构建并保留旧 hashed 文件，
 # 使已打开的旧页面仍能懒加载到旧入口资源。
-# 若存在 dist-${NODE_ENV}（develop 双构建产物），先还原为 dist/ 再 docker build。
+# 热更新逻辑见 deploy-docker.sh（sync-common 同步到各 *-web）。
 .deploy_template: &deploy_template
   stage: deploy
   image: docker:26.1.4
   script:
-    - |
-      if [ -d "dist-${NODE_ENV}" ]; then
-        rm -rf dist
-        mv "dist-${NODE_ENV}" dist
-      fi
-    - docker volume create ${IMAGE_NAME}-assets || true
-    - docker build --build-arg NODE_ENV=$NODE_ENV -t $IMAGE_NAME:latest .
-    - docker stop $IMAGE_NAME || true
-    - docker rm $IMAGE_NAME || true
-    - >
-      docker run -d --name $IMAGE_NAME --restart always -p $HOST_PORT:$CONTAINER_PORT -v ${IMAGE_NAME}-assets:/usr/share/nginx/html -e ASSET_RETENTION_DAYS=14 $IMAGE_NAME:latest
-
+    - chmod +x deploy-docker.sh
+    - ./deploy-docker.sh
     - docker image prune -f || true
 
 # MR 验证 -----------------------------------------------------------------
@@ -136,27 +128,41 @@ MR 构建验证:
 #     <<<开发环境发版_107_NO>>>
 #   only: [develop]
 
-测试环境发版:
+# develop：双构建产物 dist-test；构建失败则不发版（needs 非 optional）
+测试环境发版_develop:
+  <<: *deploy_template
+  needs: [构建_develop]
+  tags: [test]
+  resource_group: deploy-test
+  variables:
+    NODE_ENV: test
+    <<<测试环境发版>>>
+  only: [develop]
+
+# test：单构建产物 dist/；构建失败则不发版
+测试环境发版_test:
   <<: *deploy_template
-  needs:
-    - job: 构建_develop
-      optional: true
-    - job: 构建_test
-      optional: true
+  needs: [构建_test]
   tags: [test]
   resource_group: deploy-test
   variables:
     NODE_ENV: test
     <<<测试环境发版>>>
-  only: [test, develop]
+  only: [test]
+
+# 测试环境发版_107_develop:
+#   <<: *deploy_template
+#   needs: [构建_develop]
+#   tags: [test_107]
+#   resource_group: deploy-test_107
+#   variables:
+#     NODE_ENV: test
+#     <<<测试环境发版_107_NO>>>
+#   only: [develop]
 
-# 测试环境发版_107:
+# 测试环境发版_107_test:
 #   <<: *deploy_template
-#   needs:
-#     - job: 构建_develop
-#       optional: true
-#     - job: 构建_test
-#       optional: true
+#   needs: [构建_test]
 #   tags: [test_107]
 #   resource_group: deploy-test_107
 #   variables:

package/.husky/commit-msg

@@ -1,2 +1,2 @@
-#!/usr/bin/env sh
+#!/usr/bin/env sh
 pnpm exec commitlint < "$1"

package/.husky/pre-commit

@@ -1,3 +1,3 @@
-#!/usr/bin/env sh
-pnpm run typecheck
-pnpm run lint:lint-staged
+#!/usr/bin/env sh
+pnpm run typecheck
+pnpm run lint:lint-staged

package/.prettierrc.txt

@@ -1,21 +1,21 @@
-{
-  "printWidth": 100,
-  "tabWidth": 2,
-  "useTabs": false,
-  "semi": true,
-  "vueIndentScriptAndStyle": true,
-  "singleQuote": true,
-  "quoteProps": "as-needed",
-  "bracketSpacing": true,
-  "trailingComma": "all",
-  "bracketSameLine": false,
-  "jsxSingleQuote": false,
-  "arrowParens": "always",
-  "insertPragma": false,
-  "requirePragma": false,
-  "proseWrap": "never",
-  "htmlWhitespaceSensitivity": "strict",
-  "endOfLine": "auto",
-  "rangeStart": 0,
-  <<<自定义>>>
-}
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "vueIndentScriptAndStyle": true,
+  "singleQuote": true,
+  "quoteProps": "as-needed",
+  "bracketSpacing": true,
+  "trailingComma": "all",
+  "bracketSameLine": false,
+  "jsxSingleQuote": false,
+  "arrowParens": "always",
+  "insertPragma": false,
+  "requirePragma": false,
+  "proseWrap": "never",
+  "htmlWhitespaceSensitivity": "strict",
+  "endOfLine": "auto",
+  "rangeStart": 0,
+  <<<自定义>>>
+}

package/.stylelintignore

@@ -1,8 +1,8 @@
-dist
-node_modules
-public
-.husky
-.vscode
-src/components/Layout/MenuLeft/index.vue
-src/assets
+dist
+node_modules
+public
+.husky
+.vscode
+src/components/Layout/MenuLeft/index.vue
+src/assets
 stats.html

package/deploy-docker.sh

@@ -0,0 +1,271 @@
+#!/bin/sh
+# 静态 SPA Docker 热更新部署：合并 volume、按需 reload nginx / 重建容器。
+# 由 GitLab CI deploy job 调用；依赖环境变量见下方「必需变量」。
+set -e
+
+# --- 必需变量（由 CI job variables 注入）---
+: "${IMAGE_NAME:?IMAGE_NAME is required}"
+: "${NODE_ENV:?NODE_ENV is required}"
+: "${HOST_PORT:?HOST_PORT is required}"
+: "${CONTAINER_PORT:?CONTAINER_PORT is required}"
+
+ASSET_RETENTION_DAYS="${ASSET_RETENTION_DAYS:-14}"
+
+# 构建产物校验（须在 dist-${NODE_ENV} 还原为 dist/ 之前）
+if [ -d "dist-${NODE_ENV}" ]; then
+  test -f "dist-${NODE_ENV}/index.html" || {
+    echo "missing dist-${NODE_ENV}/index.html, abort deploy" >&2
+    exit 1
+  }
+else
+  test -f dist/index.html || {
+    echo "missing dist/index.html, abort deploy" >&2
+    exit 1
+  }
+fi
+
+if [ -d "dist-${NODE_ENV}" ]; then
+  rm -rf dist
+  mv "dist-${NODE_ENV}" dist
+fi
+
+ASSETS_VOL="${IMAGE_NAME}-assets"
+docker volume create "$ASSETS_VOL" || true
+docker build --build-arg NODE_ENV="$NODE_ENV" -t "${IMAGE_NAME}:latest" .
+
+# 合并静态资源到持久卷（entrypoint 执行 cp/find 后 CMD=true 退出，不停正在跑的 nginx）
+docker run --rm \
+  -v "${ASSETS_VOL}:/usr/share/nginx/html" \
+  -e "ASSET_RETENTION_DAYS=${ASSET_RETENTION_DAYS}" \
+  "${IMAGE_NAME}:latest" \
+  true
+
+file_hash_from_image() {
+  _path="$1"
+  _cid=$(docker create "${IMAGE_NAME}:latest")
+  docker cp "$_cid:$_path" /tmp/img-file-hash.bin
+  docker rm -f "$_cid" >/dev/null
+  sha256sum /tmp/img-file-hash.bin | awk '{print $1}'
+}
+
+file_hash_from_container() {
+  _path="$1"
+  docker cp "$IMAGE_NAME:$_path" /tmp/ctr-file-hash.bin 2>/dev/null || return 1
+  sha256sum /tmp/ctr-file-hash.bin | awk '{print $1}'
+}
+
+# 热更新 default.conf：先备份，nginx -t 失败则还原，避免坏配置落盘导致重启起不来
+sync_nginx_conf() {
+  _new=$(file_hash_from_image /etc/nginx/conf.d/default.conf)
+  _old=$(file_hash_from_container /etc/nginx/conf.d/default.conf || true)
+  if [ -z "$_old" ] || [ "$_new" = "$_old" ]; then
+    return 0
+  fi
+
+  _cid=$(docker create "${IMAGE_NAME}:latest")
+  docker cp "$_cid:/etc/nginx/conf.d/default.conf" /tmp/nginx-default-new.conf
+  docker rm -f "$_cid" >/dev/null
+
+  docker exec "$IMAGE_NAME" sh -c \
+    'cp /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.bak'
+  docker cp /tmp/nginx-default-new.conf "$IMAGE_NAME:/etc/nginx/conf.d/default.conf"
+  if ! docker exec "$IMAGE_NAME" nginx -t; then
+    docker exec "$IMAGE_NAME" sh -c \
+      'mv /etc/nginx/conf.d/default.conf.bak /etc/nginx/conf.d/default.conf'
+    echo "nginx -t failed, restored previous default.conf" >&2
+    return 1
+  fi
+  docker exec "$IMAGE_NAME" sh -c 'rm -f /etc/nginx/conf.d/default.conf.bak'
+  docker exec "$IMAGE_NAME" nginx -s reload
+}
+
+need_recreate() {
+  if [ "${FORCE_RECREATE:-0}" = "1" ]; then
+    echo "FORCE_RECREATE=1, will recreate container"
+    return 0
+  fi
+  # 端口映射变化（HostConfig 在 stopped 时仍可读）
+  _bound=$(docker inspect -f \
+    "{{with index .HostConfig.PortBindings \"${CONTAINER_PORT}/tcp\"}}{{(index . 0).HostPort}}{{end}}" \
+    "$IMAGE_NAME" 2>/dev/null || true)
+  if [ "$_bound" != "$HOST_PORT" ]; then
+    echo "port mapping changed (${_bound:-none} -> ${HOST_PORT}), will recreate"
+    return 0
+  fi
+  _new_ep=$(file_hash_from_image /docker-entrypoint.sh)
+  _old_ep=$(file_hash_from_container /docker-entrypoint.sh || true)
+  if [ -n "$_old_ep" ] && [ "$_new_ep" != "$_old_ep" ]; then
+    echo "docker-entrypoint.sh changed, will recreate"
+    return 0
+  fi
+  _new_ngx=$(file_hash_from_image /usr/sbin/nginx)
+  _old_ngx=$(file_hash_from_container /usr/sbin/nginx || true)
+  if [ -n "$_old_ngx" ] && [ "$_new_ngx" != "$_old_ngx" ]; then
+    echo "nginx binary changed, will recreate"
+    return 0
+  fi
+  return 1
+}
+
+start_container() {
+  docker run -d --name "$IMAGE_NAME" --restart always \
+    -p "${HOST_PORT}:${CONTAINER_PORT}" \
+    -v "${ASSETS_VOL}:/usr/share/nginx/html" \
+    -e "ASSET_RETENTION_DAYS=${ASSET_RETENTION_DAYS}" \
+    "${IMAGE_NAME}:latest"
+}
+
+# 探活：优先本机 curl；CI 容器内无 curl 时用 host 网络 curl 容器访问宿主机映射端口
+http_probe() {
+  _port="$1"
+  if command -v curl >/dev/null 2>&1; then
+    curl -sf --connect-timeout 1 "http://127.0.0.1:${_port}/" >/dev/null
+    return $?
+  fi
+  docker run --rm --network host curlimages/curl:8.5.0 \
+    -sf --connect-timeout 1 "http://127.0.0.1:${_port}/" >/dev/null
+}
+
+wait_http() {
+  _port="$1"
+  _attempts="${2:-30}"
+  _i=1
+  while [ "$_i" -le "$_attempts" ]; do
+    if http_probe "$_port"; then
+      return 0
+    fi
+    sleep 0.5
+    _i=$((_i + 1))
+  done
+  return 1
+}
+
+# 收集宿主机已占用 TCP 端口（Docker 映射 + 系统监听）
+collect_used_ports() {
+  _out=""
+  for _id in $(docker ps -q 2>/dev/null); do
+    _chunk=$(docker inspect -f \
+      '{{range $p, $conf := .NetworkSettings.Ports}}{{if $conf}}{{range $conf}}{{.HostPort}}{{"\n"}}{{end}}{{end}}{{end}}' \
+      "$_id" 2>/dev/null || true)
+    _out="${_out}${_chunk}"
+  done
+  if command -v ss >/dev/null 2>&1; then
+    _out="${_out}$(ss -H -ltn 2>/dev/null | awk '{print $4}' | sed -e 's/^\[::\]://' -e 's/^.*://')
+"
+  elif command -v netstat >/dev/null 2>&1; then
+    _out="${_out}$(netstat -ltn 2>/dev/null | awk 'NR>2 {sub(/^.*:/, "", $4); print $4}')"
+  fi
+  echo "$_out" | grep -E '^[0-9]+$' | sort -nu
+}
+
+is_port_in_use() {
+  echo "$USED_PORTS" | grep -qx "$1"
+}
+
+# 在系统临时端口范围内选第一个空闲端口（不依赖 HOST_PORT 偏移）
+pick_available_sidecar_port() {
+  if [ -n "${SIDECAR_HOST_PORT:-}" ]; then
+    if ! is_port_in_use "$SIDECAR_HOST_PORT"; then
+      echo "$SIDECAR_HOST_PORT"
+      return 0
+    fi
+    echo "sidecar: SIDECAR_HOST_PORT=${SIDECAR_HOST_PORT} already in use" >&2
+    return 1
+  fi
+
+  if [ -r /proc/sys/net/ipv4/ip_local_port_range ]; then
+    _range=$(cat /proc/sys/net/ipv4/ip_local_port_range)
+  else
+    _range="32768 60999"
+  fi
+  _min=$(echo "$_range" | awk '{print $1}')
+  _max=$(echo "$_range" | awk '{print $2}')
+
+  _port="$_min"
+  while [ "$_port" -le "$_max" ]; do
+    if ! is_port_in_use "$_port"; then
+      echo "$_port"
+      return 0
+    fi
+    _port=$((_port + 1))
+  done
+  return 1
+}
+
+# 重建前旁路探活：先枚举已用端口，再绑定空闲端口
+start_sidecar_container() {
+  NEXT_NAME="${IMAGE_NAME}-next"
+  TEMP_PORT=""
+
+  docker rm -f "$NEXT_NAME" 2>/dev/null || true
+
+  USED_PORTS=$(collect_used_ports)
+  _used_flat=$(echo "$USED_PORTS" | tr '\n' ' ' | sed 's/ $//')
+  echo "sidecar: in-use host ports: ${_used_flat:-none}" >&2
+
+  TEMP_PORT=$(pick_available_sidecar_port) || TEMP_PORT=""
+
+  if [ -n "$TEMP_PORT" ]; then
+    echo "sidecar: selected free port ${TEMP_PORT}" >&2
+    docker run -d --name "$NEXT_NAME" \
+      -p "127.0.0.1:${TEMP_PORT}:${CONTAINER_PORT}" \
+      -v "${ASSETS_VOL}:/usr/share/nginx/html" \
+      -e "ASSET_RETENTION_DAYS=${ASSET_RETENTION_DAYS}" \
+      "${IMAGE_NAME}:latest"
+    echo "$TEMP_PORT"
+    return 0
+  fi
+
+  echo "sidecar: no free port in ephemeral range, fallback to docker auto-assign" >&2
+  docker run -d --name "$NEXT_NAME" \
+    -p "127.0.0.1::${CONTAINER_PORT}" \
+    -v "${ASSETS_VOL}:/usr/share/nginx/html" \
+    -e "ASSET_RETENTION_DAYS=${ASSET_RETENTION_DAYS}" \
+    "${IMAGE_NAME}:latest"
+  docker port "$NEXT_NAME" "${CONTAINER_PORT}/tcp" | sed 's/.*://'
+}
+
+probe_sidecar_before_recreate() {
+  NEXT_NAME="${IMAGE_NAME}-next"
+  TEMP_PORT=$(start_sidecar_container) || {
+    echo "sidecar container failed to start" >&2
+    exit 1
+  }
+
+  if ! wait_http "$TEMP_PORT"; then
+    echo "sidecar probe failed on port ${TEMP_PORT}" >&2
+    docker logs "$NEXT_NAME" 2>&1 || true
+    docker rm -f "$NEXT_NAME" || true
+    exit 1
+  fi
+
+  docker stop "$NEXT_NAME" && docker rm "$NEXT_NAME"
+}
+
+wait_main_port() {
+  if ! wait_http "$HOST_PORT"; then
+    echo "main port probe failed on ${HOST_PORT}" >&2
+    if docker inspect "$IMAGE_NAME" >/dev/null 2>&1; then
+      docker logs "$IMAGE_NAME" 2>&1 || true
+    fi
+    exit 1
+  fi
+}
+
+if ! docker inspect "$IMAGE_NAME" >/dev/null 2>&1; then
+  start_container
+  wait_main_port
+elif need_recreate; then
+  probe_sidecar_before_recreate
+  docker stop "$IMAGE_NAME" || true
+  docker rm "$IMAGE_NAME" || true
+  start_container
+  wait_main_port
+else
+  # 已停止则先 start，再走同一套 conf 备份 / -t / reload（docker exec 需要运行中）
+  if [ "$(docker inspect -f '{{.State.Running}}' "$IMAGE_NAME")" != "true" ]; then
+    docker start "$IMAGE_NAME"
+  fi
+  sync_nginx_conf
+  wait_main_port
+fi

package/docker-entrypoint.sh

@@ -1,21 +1,21 @@
-#!/bin/sh
-set -e
-
-HTML_ROOT=/usr/share/nginx/html
-DIST_ROOT=/app/dist
-# 保留最近 N 天的历史 hashed 资源，供已打开旧页面继续懒加载
-ASSET_RETENTION_DAYS="${ASSET_RETENTION_DAYS:-14}"
-
-mkdir -p "$HTML_ROOT"
-
-# 合并拷贝：覆盖同名文件（如 index.html），保留卷中已有、本次构建不含的旧 chunk
-if [ -d "$DIST_ROOT" ]; then
-  cp -a "$DIST_ROOT"/. "$HTML_ROOT"/
-fi
-
-# 清理过期静态资源，避免磁盘无限增长（不影响未过期的旧入口）
-if [ -d "$HTML_ROOT/assets" ]; then
-  find "$HTML_ROOT/assets" -type f -mtime "+${ASSET_RETENTION_DAYS}" -delete 2>/dev/null || true
-fi
-
-exec "$@"
+#!/bin/sh
+set -e
+
+HTML_ROOT=/usr/share/nginx/html
+DIST_ROOT=/app/dist
+# 保留最近 N 天的历史 hashed 资源，供已打开旧页面继续懒加载
+ASSET_RETENTION_DAYS="${ASSET_RETENTION_DAYS:-14}"
+
+mkdir -p "$HTML_ROOT"
+
+# 合并拷贝：覆盖同名文件（如 index.html），保留卷中已有、本次构建不含的旧 chunk
+if [ -d "$DIST_ROOT" ]; then
+  cp -a "$DIST_ROOT"/. "$HTML_ROOT"/
+fi
+
+# 清理过期静态资源，避免磁盘无限增长（不影响未过期的旧入口）
+if [ -d "$HTML_ROOT/assets" ]; then
+  find "$HTML_ROOT/assets" -type f -mtime "+${ASSET_RETENTION_DAYS}" -delete 2>/dev/null || true
+fi
+
+exec "$@"

package/eslint.config.mjs.txt

@@ -1,94 +1,94 @@
-// 从 URL 和路径模块中导入必要的功能
-import fs from 'fs';
-import path, { dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-// 从 ESLint 插件中导入推荐配置
-import pluginJs from '@eslint/js';
-import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
-import pluginVue from 'eslint-plugin-vue';
-import globals from 'globals';
-import tseslint from 'typescript-eslint';
-
-// 使用 import.meta.url 获取当前模块的路径
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// 读取 .auto-import.json 文件的内容，并将其解析为 JSON 对象
-const autoImportConfig = JSON.parse(
-  fs.readFileSync(path.resolve(__dirname, '.auto-import.json'), 'utf-8'),
-);
-
-export default [
-  // 指定文件匹配规则
-  {
-    files: ['**/*.{js,mjs,cjs,ts,vue}'],
-  },
-  // 指定全局变量和环境
-  {
-    languageOptions: {
-      globals: {
-        ...globals.browser,
-        ...globals.node,
-      },
-    },
-  },
-  // 扩展配置
-  pluginJs.configs.recommended,
-  ...tseslint.configs.recommended,
-  ...pluginVue.configs['flat/essential'],
-  // 自定义规则
-  {
-    // 针对所有 JavaScript、TypeScript 和 Vue 文件应用以下配置
-    files: ['**/*.{js,mjs,cjs,ts,vue}'],
-
-    languageOptions: {
-      globals: {
-        // 合并从 autoImportConfig 中读取的全局变量配置
-        ...autoImportConfig.globals,
-        // TypeScript 全局命名空间
-        Api: 'readonly',
-        Dict: 'readonly',
-      },
-    },
-    rules: {
-      'no-undef': 'off', // TypeScript 自身已处理未定义变量检查
-      quotes: ['error', 'single'], // 使用单引号
-      semi: ['error', 'never'], // 语句末尾不加分号
-      'no-var': 'error', // 要求使用 let 或 const 而不是 var
-      '@typescript-eslint/no-explicit-any': 'off', // 禁用 any 检查
-      'vue/multi-word-component-names': 'off', // 禁用对 Vue 组件名称的多词要求检查
-      'no-multiple-empty-lines': ['warn', { max: 1, maxEOF: 1 }], // 不允许多个空行
-      'no-unexpected-multiline': 'error', // 禁止空余的多行
-      'no-unused-vars': 'off', // 禁用未使用的变量检查
-      '@typescript-eslint/no-unused-vars': 'off', // 禁用 TypeScript 未使用的变量检查
-    },
-  },
-  // vue 规则
-  {
-    files: ['**/*.vue'],
-    languageOptions: {
-      parserOptions: {
-        parser: tseslint.parser,
-        ecmaFeatures: {
-          jsx: true,
-        },
-      },
-    },
-  },
-  // 忽略文件
-  {
-    ignores: [
-      'node_modules',
-      'dist',
-      'public',
-      '.vscode/**',
-      'src/assets/**',
-      'src/utils/console.ts',
-      'src/api',
-      'src/api/**',
-    ],
-  },
-  // prettier 配置
-  eslintPluginPrettierRecommended,
-];
+// 从 URL 和路径模块中导入必要的功能
+import fs from 'fs';
+import path, { dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+// 从 ESLint 插件中导入推荐配置
+import pluginJs from '@eslint/js';
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import pluginVue from 'eslint-plugin-vue';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+
+// 使用 import.meta.url 获取当前模块的路径
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// 读取 .auto-import.json 文件的内容，并将其解析为 JSON 对象
+const autoImportConfig = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, '.auto-import.json'), 'utf-8'),
+);
+
+export default [
+  // 指定文件匹配规则
+  {
+    files: ['**/*.{js,mjs,cjs,ts,vue}'],
+  },
+  // 指定全局变量和环境
+  {
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+    },
+  },
+  // 扩展配置
+  pluginJs.configs.recommended,
+  ...tseslint.configs.recommended,
+  ...pluginVue.configs['flat/essential'],
+  // 自定义规则
+  {
+    // 针对所有 JavaScript、TypeScript 和 Vue 文件应用以下配置
+    files: ['**/*.{js,mjs,cjs,ts,vue}'],
+
+    languageOptions: {
+      globals: {
+        // 合并从 autoImportConfig 中读取的全局变量配置
+        ...autoImportConfig.globals,
+        // TypeScript 全局命名空间
+        Api: 'readonly',
+        Dict: 'readonly',
+      },
+    },
+    rules: {
+      'no-undef': 'off', // TypeScript 自身已处理未定义变量检查
+      quotes: ['error', 'single'], // 使用单引号
+      semi: ['error', 'never'], // 语句末尾不加分号
+      'no-var': 'error', // 要求使用 let 或 const 而不是 var
+      '@typescript-eslint/no-explicit-any': 'off', // 禁用 any 检查
+      'vue/multi-word-component-names': 'off', // 禁用对 Vue 组件名称的多词要求检查
+      'no-multiple-empty-lines': ['warn', { max: 1, maxEOF: 1 }], // 不允许多个空行
+      'no-unexpected-multiline': 'error', // 禁止空余的多行
+      'no-unused-vars': 'off', // 禁用未使用的变量检查
+      '@typescript-eslint/no-unused-vars': 'off', // 禁用 TypeScript 未使用的变量检查
+    },
+  },
+  // vue 规则
+  {
+    files: ['**/*.vue'],
+    languageOptions: {
+      parserOptions: {
+        parser: tseslint.parser,
+        ecmaFeatures: {
+          jsx: true,
+        },
+      },
+    },
+  },
+  // 忽略文件
+  {
+    ignores: [
+      'node_modules',
+      'dist',
+      'public',
+      '.vscode/**',
+      'src/assets/**',
+      'src/utils/console.ts',
+      'src/api',
+      'src/api/**',
+    ],
+  },
+  // prettier 配置
+  eslintPluginPrettierRecommended,
+];

package/nginx_dev.conf

@@ -1,85 +1,85 @@
-# 自定义日志格式：包含实际转发的后端地址
-log_format proxy_log
-  '[$time_local] $status $request | '
-  'client=$remote_addr upstream=$upstream_addr | '
-  'upstream_status=$upstream_status upstream_time=${upstream_response_time}s | '
-  'referer="$http_referer" agent="$http_user_agent"';
-
-# 根据请求IP分配后端地址（公网IP走公网，默认走内网）
-map $host $dev_backend_addr {
-  # fulfillment-dev.tiantai-jp.com -> 192.168.128.215
-  default                   fulfillment-dev.tiantai-jp.com:11000;   # 默认走内网
-  # ly-dev.tiantai-jp.com -> 14.127.204.225
-  # 
-  120.76.61.203             ly-dev.tiantai-jp.com:11000;      # 公网IP走公网
-}
-
-# HTTP 服务器 - 保持原有配置
-server {
-  <<<listen>>>
-  server_name localhost;
-  charset utf-8;
-
-  resolver 8.8.8.8 1.1.1.1 ipv6=off;
-
-  # 使用自定义日志格式，记录后端转发地址
-  access_log /var/log/nginx/access.log proxy_log;
-
-  root /usr/share/nginx/html;
-  index index.html;
-
-  # 带 hash 的构建资源：长缓存；缺失时返回 404（禁止回退成 index.html，避免把 HTML 当 JS）
-  location /assets/ {
-    try_files $uri =404;
-    expires 1y;
-    add_header Cache-Control "public, max-age=31536000, immutable" always;
-
-    # CORS 配置
-    add_header 'Access-Control-Allow-Origin' '*' always;
-    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
-    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;    
-    <<<assets_CORS配置>>>
-    gzip_static on;
-  }
-
-  # 入口 HTML：禁止缓存，确保新开/刷新拿到最新入口
-  location = /index.html {
-    add_header Cache-Control "no-cache, no-store, must-revalidate" always;
-    add_header Pragma "no-cache" always;
-    add_header Expires "0" always;
-
-    # CORS 配置
-    add_header 'Access-Control-Allow-Origin' '*' always;
-    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
-    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
-    <<<index_html_CORS配置>>>
-  }
-
-  location / {
-    try_files $uri $uri/ /index.html;
-    add_header Cache-Control "no-cache" always;
-    add_header 'Access-Control-Allow-Origin' '*' always;
-    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
-    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
-    <<<index_CORS配置>>>
-  }
-
-  location /dev-api/ {
-    proxy_set_header Host $host;
-    proxy_set_header X-Real-Ip $remote_addr;
-    proxy_set_header X-Forwarded-For $remote_addr;
-
-    # 与前端 TtHttp REQUEST_TIMEOUT 对齐：10 分钟
-    proxy_connect_timeout 600s;
-    proxy_send_timeout 600s;
-    proxy_read_timeout 600s;
-
-    rewrite ^/dev-api/(.*) /$1 break;
-    proxy_pass http://$dev_backend_addr;
-  }
-
-  error_page   500 502 503 504  /50x.html;
-  location = /50x.html {
-    root   html;
-  }
-}
+# 自定义日志格式：包含实际转发的后端地址
+log_format proxy_log
+  '[$time_local] $status $request | '
+  'client=$remote_addr upstream=$upstream_addr | '
+  'upstream_status=$upstream_status upstream_time=${upstream_response_time}s | '
+  'referer="$http_referer" agent="$http_user_agent"';
+
+# 根据请求IP分配后端地址（公网IP走公网，默认走内网）
+map $host $dev_backend_addr {
+  # fulfillment-dev.tiantai-jp.com -> 192.168.128.215
+  default                   fulfillment-dev.tiantai-jp.com:11000;   # 默认走内网
+  # ly-dev.tiantai-jp.com -> 14.127.204.225
+  # 
+  120.76.61.203             ly-dev.tiantai-jp.com:11000;      # 公网IP走公网
+}
+
+# HTTP 服务器 - 保持原有配置
+server {
+  <<<listen>>>
+  server_name localhost;
+  charset utf-8;
+
+  resolver 8.8.8.8 1.1.1.1 ipv6=off;
+
+  # 使用自定义日志格式，记录后端转发地址
+  access_log /var/log/nginx/access.log proxy_log;
+
+  root /usr/share/nginx/html;
+  index index.html;
+
+  # 带 hash 的构建资源：长缓存；缺失时返回 404（禁止回退成 index.html，避免把 HTML 当 JS）
+  location /assets/ {
+    try_files $uri =404;
+    expires 1y;
+    add_header Cache-Control "public, max-age=31536000, immutable" always;
+
+    # CORS 配置
+    add_header 'Access-Control-Allow-Origin' '*' always;
+    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
+    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;    
+    <<<assets_CORS配置>>>
+    gzip_static on;
+  }
+
+  # 入口 HTML：禁止缓存，确保新开/刷新拿到最新入口
+  location = /index.html {
+    add_header Cache-Control "no-cache, no-store, must-revalidate" always;
+    add_header Pragma "no-cache" always;
+    add_header Expires "0" always;
+
+    # CORS 配置
+    add_header 'Access-Control-Allow-Origin' '*' always;
+    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
+    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
+    <<<index_html_CORS配置>>>
+  }
+
+  location / {
+    try_files $uri $uri/ /index.html;
+    add_header Cache-Control "no-cache" always;
+    add_header 'Access-Control-Allow-Origin' '*' always;
+    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
+    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
+    <<<index_CORS配置>>>
+  }
+
+  location /dev-api/ {
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-Ip $remote_addr;
+    proxy_set_header X-Forwarded-For $remote_addr;
+
+    # 与前端 TtHttp REQUEST_TIMEOUT 对齐：10 分钟
+    proxy_connect_timeout 600s;
+    proxy_send_timeout 600s;
+    proxy_read_timeout 600s;
+
+    rewrite ^/dev-api/(.*) /$1 break;
+    proxy_pass http://$dev_backend_addr;
+  }
+
+  error_page   500 502 503 504  /50x.html;
+  location = /50x.html {
+    root   html;
+  }
+}

package/nginx_test.conf

@@ -1,87 +1,87 @@
-# 自定义日志格式：包含实际转发的后端地址
-log_format proxy_log
-  '[$time_local] $status $request | '
-  'client=$remote_addr upstream=$upstream_addr | '
-  'upstream_status=$upstream_status upstream_time=${upstream_response_time}s | '
-  'referer="$http_referer" agent="$http_user_agent"';
-
-# 根据请求IP分配后端地址（公网IP走公网，默认走内网）
-map $host $test_backend_addr {
-  # fulfillment-test.tiantai-jp.com -> 192.168.127.73
-  default                   fulfillment-test.tiantai-jp.com:11000;    # 默认走内网
-  # ly-test.tiantai-jp.com -> 116.6.49.180
-  120.76.61.203             ly-test.tiantai-jp.com:11000;      # 公网IP走公网
-}
-
-# HTTP 服务器 - 保持原有配置
-server {
-  <<<listen>>>
-  server_name localhost;
-  charset utf-8;
-
-  resolver 8.8.8.8 1.1.1.1 ipv6=off;
-
-  # 使用自定义日志格式，记录后端转发地址
-  access_log /var/log/nginx/access.log proxy_log;
-
-  root /usr/share/nginx/html;
-  index index.html;
-
-  # 带 hash 的构建资源：长缓存；缺失时返回 404（禁止回退成 index.html，避免把 HTML 当 JS）
-  location /assets/ {
-    try_files $uri =404;
-    expires 1y;
-    add_header Cache-Control "public, max-age=31536000, immutable" always;
-
-    # CORS 配置
-    add_header 'Access-Control-Allow-Origin' '*' always;
-    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
-    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
-    <<<assets_CORS配置>>>
-    gzip_static on;
-  }
-
-  # 入口 HTML：禁止缓存，确保新开/刷新拿到最新入口
-  location = /index.html {
-    add_header Cache-Control "no-cache, no-store, must-revalidate" always;
-    add_header Pragma "no-cache" always;
-    add_header Expires "0" always;
-
-    # CORS 配置
-    add_header 'Access-Control-Allow-Origin' '*' always;
-    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
-    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
-    <<<index_html_CORS配置>>>
-  }
-
-  location / {
-    try_files $uri $uri/ /index.html;
-    add_header Cache-Control "no-cache" always;
-
-    # CORS 配置
-    add_header 'Access-Control-Allow-Origin' '*' always;
-    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
-    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
-    <<<index_CORS配置>>>
-  }
-
-  location /test-api/ {
-    proxy_set_header Host $host;
-    proxy_set_header X-Real-Ip $remote_addr;
-    proxy_set_header X-Forwarded-For $remote_addr;
-
-    # 与前端 TtHttp REQUEST_TIMEOUT 对齐：10 分钟
-    proxy_connect_timeout 600s;
-    proxy_send_timeout 600s;
-    proxy_read_timeout 600s;
-
-    rewrite ^/test-api/(.*) /$1 break;
-    proxy_pass http://$test_backend_addr;
-  }
-  <<<其他location配置>>>
-
-  error_page   500 502 503 504  /50x.html;
-  location = /50x.html {
-    root   html;
-  }
-}
+# 自定义日志格式：包含实际转发的后端地址
+log_format proxy_log
+  '[$time_local] $status $request | '
+  'client=$remote_addr upstream=$upstream_addr | '
+  'upstream_status=$upstream_status upstream_time=${upstream_response_time}s | '
+  'referer="$http_referer" agent="$http_user_agent"';
+
+# 根据请求IP分配后端地址（公网IP走公网，默认走内网）
+map $host $test_backend_addr {
+  # fulfillment-test.tiantai-jp.com -> 192.168.127.73
+  default                   fulfillment-test.tiantai-jp.com:11000;    # 默认走内网
+  # ly-test.tiantai-jp.com -> 116.6.49.180
+  120.76.61.203             ly-test.tiantai-jp.com:11000;      # 公网IP走公网
+}
+
+# HTTP 服务器 - 保持原有配置
+server {
+  <<<listen>>>
+  server_name localhost;
+  charset utf-8;
+
+  resolver 8.8.8.8 1.1.1.1 ipv6=off;
+
+  # 使用自定义日志格式，记录后端转发地址
+  access_log /var/log/nginx/access.log proxy_log;
+
+  root /usr/share/nginx/html;
+  index index.html;
+
+  # 带 hash 的构建资源：长缓存；缺失时返回 404（禁止回退成 index.html，避免把 HTML 当 JS）
+  location /assets/ {
+    try_files $uri =404;
+    expires 1y;
+    add_header Cache-Control "public, max-age=31536000, immutable" always;
+
+    # CORS 配置
+    add_header 'Access-Control-Allow-Origin' '*' always;
+    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
+    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
+    <<<assets_CORS配置>>>
+    gzip_static on;
+  }
+
+  # 入口 HTML：禁止缓存，确保新开/刷新拿到最新入口
+  location = /index.html {
+    add_header Cache-Control "no-cache, no-store, must-revalidate" always;
+    add_header Pragma "no-cache" always;
+    add_header Expires "0" always;
+
+    # CORS 配置
+    add_header 'Access-Control-Allow-Origin' '*' always;
+    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
+    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
+    <<<index_html_CORS配置>>>
+  }
+
+  location / {
+    try_files $uri $uri/ /index.html;
+    add_header Cache-Control "no-cache" always;
+
+    # CORS 配置
+    add_header 'Access-Control-Allow-Origin' '*' always;
+    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
+    add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization' always;
+    <<<index_CORS配置>>>
+  }
+
+  location /test-api/ {
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-Ip $remote_addr;
+    proxy_set_header X-Forwarded-For $remote_addr;
+
+    # 与前端 TtHttp REQUEST_TIMEOUT 对齐：10 分钟
+    proxy_connect_timeout 600s;
+    proxy_send_timeout 600s;
+    proxy_read_timeout 600s;
+
+    rewrite ^/test-api/(.*) /$1 break;
+    proxy_pass http://$test_backend_addr;
+  }
+  <<<其他location配置>>>
+
+  error_page   500 502 503 504  /50x.html;
+  location = /50x.html {
+    root   html;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dazhicheng/common",
-  "version": "1.0.45",
+  "version": "1.0.47",
   "description": "共享配置文件",
   "type": "module",
   "types": "./src/types/index.d.ts",
@@ -25,6 +25,7 @@
     "tsconfig.json",
     "Dockerfile",
     "docker-entrypoint.sh",
+    "deploy-docker.sh",
     "nginx_dev.conf",
     "nginx_test.conf",
     "sync-common.mjs",

package/pnpm-workspace.yaml

@@ -1,9 +1,9 @@
-minimumReleaseAge: 0
-
-allowBuilds:
-  '@parcel/watcher': true
-  core-js: true
-  es5-ext: true
-  esbuild: true
-  vue-demi: true
-  '@tailwindcss/oxide': true
+minimumReleaseAge: 0
+
+allowBuilds:
+  '@parcel/watcher': true
+  core-js: true
+  es5-ext: true
+  esbuild: true
+  vue-demi: true
+  '@tailwindcss/oxide': true

package/src/types/index.d.ts

@@ -0,0 +1 @@
+export {};

package/sync-common.mjs

@@ -27,6 +27,7 @@ const defaultManagedFiles = [
   "pnpm-workspace.yaml",
   "Dockerfile",
   "docker-entrypoint.sh",
+  "deploy-docker.sh",
   { name: "eslint.config.mjs.txt" },
   "tsconfig.json",
   { name: "nginx_dev.conf" },