@jira-deploy/core 1.0.11 → 1.0.13

package/constants/config.js

@@ -0,0 +1,183 @@
+import { readFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+const EMPTY_OBJECT = Object.freeze({});
+
+const DEFAULT_DEPLOY_CONFIG = {
+  jira: {
+    projectKey: 'PROJ',
+    projectIdNumeric: 10000,
+    releaseProjectKey: 'REL',
+  },
+  fieldIds: {
+    shared: {
+      summary: 'summary',
+      dueDate: 'duedate',
+      description: 'description',
+      assignee: { automatic: '-1' },
+      env: 'customfield_env',
+      deptCode: 'customfield_dept_code',
+      systemCode: 'customfield_system_code',
+      systemModule: 'customfield_system_module',
+      gitBranch: 'customfield_git_branch',
+      jenkinsBranch: 'customfield_jenkins_branch',
+      extraVars: 'customfield_extra_vars',
+      clusterDeploy: 'customfield_cluster_deploy',
+      expectedStartTime: 'customfield_expected_start_time',
+      deptManagerSign: 'customfield_dept_manager_sign',
+      authManagerSign: 'customfield_auth_manager_sign',
+      releaseInfo: 'customfield_release_info',
+    },
+    cd: {
+      systemSubmodule: 'customfield_system_submodule',
+      serverList: 'customfield_server_list',
+      restartOnly: 'customfield_restart_only',
+      linkType: 'issuelinks-linktype',
+      linkIssuesTextarea: 'issuelinks-issues-textarea',
+      linkIssuesSelect: 'issuelinks-issues',
+      cdNotes: 'customfield_cd_notes',
+      deployVersion: 'customfield_deploy_version',
+    },
+    library: {
+      libModuleParent: 'customfield_library_module',
+      libModuleChild: 'customfield_library_module:1',
+      fortifyScan: 'customfield_fortify_scan',
+    },
+    ci: {
+      releaseOpType: 'customfield_release_op_type',
+      antiScanRequired: 'customfield_anti_scan_required',
+      ciNotes: 'customfield_ci_notes',
+      releaseVersion: 'customfield_release_version',
+    },
+    grayRelease: {
+      grayReleaseVersion: 'customfield_grayrelease_version',
+      clusterList: 'customfield_cluster_list',
+      grayReleaseNotes: 'customfield_grayrelease_notes',
+      buildResult: 'customfield_build_result',
+      deployResult: 'customfield_deploy_result',
+    },
+  },
+  issueTypes: {
+    names: { LIBRARY: 'Library', GRAY_RELEASE: 'GrayRelease', CI: 'CI', CD: 'CD' },
+    ids: { Library: '10001', GrayRelease: '10002', CI: '10003', CD: '10004' },
+  },
+  environments: {
+    codes: { dev: 'env_dev', stg: 'env_stg', uat: 'env_uat', prd: 'env_prd', dr: 'env_dr', 'prd/dr': 'env_prd_dr' },
+    deptCodes: { DEMO: 'dept_demo' },
+    supported: {
+      library: ['dev', 'stg', 'uat', 'prd'],
+      ci: ['dev', 'stg'],
+      cd: ['dev', 'stg', 'uat', 'prd/dr', 'prd', 'dr'],
+      grayRelease: ['dev', 'stg', 'uat'],
+    },
+    labels: { dev: 'Development', stg: 'Staging', uat: 'UAT', prd: 'Production', dr: 'DR', 'prd/dr': 'Production+DR' },
+  },
+  fieldOptions: {
+    fortifyScan: { scanned: 'fortify_scanned', notScanned: 'fortify_not_scanned' },
+    restartOnly: { false: 'restart_false', true: 'restart_true' },
+    clusterDeploy: { false: 'cluster_false', true: 'cluster_true' },
+    antiScan: { true: 'anti_scan_true', false: 'anti_scan_false' },
+    releaseOpType: { main: 'release_main' },
+    systemModule: { assembly: 'system_module_assembly' },
+  },
+  systemCodes: { APP: 'APP' },
+  systemToDept: { APP: 'DEMO' },
+  systemCodeJiraIds: {
+    library: { APP: 'library_app' },
+    ci: { APP: 'ci_app' },
+  },
+  systemModules: { APP: ['web'] },
+  moduleToRepo: { web: 'demo-web' },
+  systemToCiRepo: { APP: 'demo-assembly' },
+  libraryModuleIds: { APP: { web: 'library_app_web' } },
+  grayReleaseModuleIds: { web: 'gray_web' },
+  servers: { APP: { dev: ['dev-app-01'], stg: ['stg-app-01'], uat: ['uat-app-01'], prd: ['prd-app-01'], dr: ['dr-app-01'], 'prd/dr': ['prd-app-01', 'dr-app-01'] } },
+  serverModuleMap: { web: 'web' },
+  metaTestNodes: {},
+  moduleName: {
+    systemAliases: {},
+    moduleAliases: { web: 'WEB' },
+  },
+  repos: {
+    maps: {
+      'demo-web': { project: 'DEMO', repoId: '100' },
+      'demo-assembly': { project: 'DEMO', repoId: '101' },
+    },
+    moduleMap: { web: 'demo-web' },
+    labels: { 'demo-web': 'Demo Web' },
+  },
+  users: {
+    aliases: {},
+  },
+  release: {
+    managerSubCalendarId: '',
+    dryRunManager: { name: 'Demo User', accountId: 'demo-user' },
+    grayReleaseUatApprovers: {
+      commentReviewerAlias: 'uat-comment-reviewer',
+      finalApproverAlias: 'uat-final-approver',
+    },
+  },
+  jabber: {
+    domain: 'example.internal',
+  },
+};
+
+let cachedConfig;
+
+function parseJsonConfig(value, source) {
+  try {
+    return JSON.parse(value);
+  } catch (error) {
+    throw new Error(`Invalid ${source}: ${error.message}`);
+  }
+}
+
+function isPlainObject(value) {
+  return value && typeof value === 'object' && !Array.isArray(value);
+}
+
+function deepMerge(base, override) {
+  if (!isPlainObject(override)) return base;
+  const merged = { ...base };
+  for (const [key, value] of Object.entries(override)) {
+    if (isPlainObject(value) && isPlainObject(base[key])) {
+      merged[key] = deepMerge(base[key], value);
+    } else {
+      merged[key] = value;
+    }
+  }
+  return merged;
+}
+
+function expandHomePath(filePath) {
+  if (filePath === '~') return homedir();
+  if (filePath.startsWith('~/')) return join(homedir(), filePath.slice(2));
+  return filePath;
+}
+
+function loadExternalConfig() {
+  if (process.env.JIRA_DEPLOY_CONFIG_PATH) {
+    const configPath = expandHomePath(process.env.JIRA_DEPLOY_CONFIG_PATH);
+    return parseJsonConfig(
+      readFileSync(configPath, 'utf8'),
+      `JIRA_DEPLOY_CONFIG_PATH (${process.env.JIRA_DEPLOY_CONFIG_PATH})`,
+    );
+  }
+  return EMPTY_OBJECT;
+}
+
+export function getDeployConfig() {
+  if (!cachedConfig) {
+    cachedConfig = deepMerge(DEFAULT_DEPLOY_CONFIG, loadExternalConfig());
+  }
+  return cachedConfig;
+}
+
+export function getReleaseProjectKey() {
+  return process.env.JIRA_RELEASE_PROJECT_KEY ?? getDeployConfig().jira.releaseProjectKey;
+}
+
+export function resetDeployConfigForTests() {
+  cachedConfig = undefined;
+}

package/constants/defaults.js

@@ -1,6 +1,6 @@
-/**
- * Jira Issue 建立的預設值及模板
- */
+import {getDeployConfig} from './config.js';
+
+const config = getDeployConfig();
 
 /** 簽核欄位預設值 */
 export const SIGN_VALUES = {
@@ -16,41 +16,7 @@ export const JIRA_DEFAULTS = {
 };
 
 /** 欄位值選項 */
-export const FIELD_OPTIONS = {
-  // Fortify Scan 選項
-  fortifyScan: {
-    scanned: '14602',
-    notScanned: '14603',
-  },
-
-  // 重啟選項
-  restartOnly: {
-    false: '14901',
-    true: '14902',
-  },
-
-  // 集群部署選項
-  clusterDeploy: {
-    false: '15505',
-    true: '15506',
-  },
-
-  // 防毒掃描選項
-  antiScan: {
-    true: '14606',
-    false: '14607',
-  },
-
-  // 發佈操作類型
-  releaseOpType: {
-    main: '15200',
-  },
-
-  // 系統模組 (CI 用)
-  systemModule: {
-    assembly: '14369',
-  },
-};
+export const FIELD_OPTIONS = config.fieldOptions;
 
 /** Issue 預設值 */
 export const ASSIGNEE_DEFAULTS = {

package/constants/environments.js

@@ -1,37 +1,15 @@
-/**
- * 環境設定及其代碼映射
- */
+import {getDeployConfig} from './config.js';
+
+const config = getDeployConfig().environments;
 
 /** 共用環境代碼 */
-export const ENV_CODES = {
-  dev: '14355',
-  stg: '14356',
-  uat: '14357',
-  prd: '14358',
-  dr: '14359',
-  'prd/dr': '14360',
-};
+export const ENV_CODES = config.codes;
 
 /** 部門代碼 */
-export const DEPT_CODES = {
-  CH014: '14520',
-  CH015: '14521',
-};
+export const DEPT_CODES = config.deptCodes;
 
 /** 各 Issue Type 支援的環境列表 */
-export const SUPPORTED_ENVS = {
-  library: ['dev', 'stg', 'uat', 'prd'],
-  ci: ['dev', 'stg'],
-  cd: ['dev', 'stg', 'uat', 'prd/dr', 'prd', 'dr'],
-  grayRelease: ['dev', 'stg', 'uat'],
-};
+export const SUPPORTED_ENVS = config.supported;
 
 /** 環境對應的簡短標籤 */
-export const ENV_LABELS = {
-  dev: '開發',
-  stg: '測試',
-  uat: '驗收',
-  prd: '正式',
-  dr: '災備',
-  'prd/dr': '正式+災備',
-};
+export const ENV_LABELS = config.labels;

package/constants/field-ids.js

@@ -1,66 +1,34 @@
-/**
- * Jira Custom Field ID 映射表
- * 所有 customfield_XXXXX 在這裡集中管理
- */
+import {getDeployConfig} from './config.js';
+import {ASSIGNEE_DEFAULTS} from './defaults.js';
 
-import { ASSIGNEE_DEFAULTS } from './defaults.js';
+const config = getDeployConfig();
+const fieldIds = config.fieldIds;
 
 // ============ 共用欄位 (所有 Issue Type 都用) ============
 export const SHARED_FIELD_IDS = {
-  summary: 'summary',
-  dueDate: 'duedate',
-  description: 'description',
+  ...fieldIds.shared,
   assignee: ASSIGNEE_DEFAULTS,
-  env: 'customfield_13436',
-  deptCode: 'customfield_13434',
-  systemCode: 'customfield_13443',
-  systemModule: 'customfield_13444',
-  gitBranch: 'customfield_13431',
-  jenkinsBranch: 'customfield_14702',
-  extraVars: 'customfield_13437',
-  clusterDeploy: 'customfield_14704',
-  expectedStartTime: 'customfield_13446',
-  deptManagerSign: 'customfield_13903',
-  authManagerSign: 'customfield_13904',
-  releaseInfo: 'customfield_13906',
 };
 
 // ============ CD 專用欄位 ============
 export const CD_FIELD_IDS = {
   ...SHARED_FIELD_IDS,
-  systemSubmodule: 'customfield_14500',
-  serverList: 'customfield_13442',
-  restartOnly: 'customfield_14102',
-  linkType: 'issuelinks-linktype',
-  linkIssuesTextarea: 'issuelinks-issues-textarea',
-  linkIssuesSelect: 'issuelinks-issues',
-  cdNotes: 'customfield_14108',
-  deployVersion: 'customfield_14101', // CID_deploy_version：CD 單的佈署版本號（JSON 格式，如 {"ibk_ap_version":"0.0.11"}）
+  ...fieldIds.cd,
 };
 // ============ Library 專用欄位 ============
 export const LIBRARY_FIELD_IDS = {
   ...SHARED_FIELD_IDS,
-  libModuleParent: 'customfield_13702',
-  libModuleChild: 'customfield_13702:1',
-  fortifyScan: 'customfield_13807',
+  ...fieldIds.library,
 };
 
 // ============ CI 專用欄位 ============
 export const CI_FIELD_IDS = {
   ...SHARED_FIELD_IDS,
-  releaseOpType: 'customfield_14400',
-  antiScanRequired: 'customfield_13812',
-  ciNotes: 'customfield_14107',
-  releaseVersion: 'customfield_13438', // CID_deploy_version：Jenkins build 後寫入的版本號 JSON（如 {"cwa_ap_version":"0.0.12"}）
+  ...fieldIds.ci,
 };
 
 // ============ GrayRelease 專用欄位 ============
 export const GRAY_RELEASE_FIELD_IDS = {
   ...SHARED_FIELD_IDS,
-  grayReleaseVersion: 'customfield_14700',
-  clusterList: 'customfield_14701',
-  grayReleaseNotes: 'customfield_14511',
-  // Field names resolved to customfield IDs at runtime.
-  buildResult: 'customfield_13432',
-  deployResult: 'customfield_13433',
+  ...fieldIds.grayRelease,
 };

package/constants/index.js

@@ -4,6 +4,8 @@
  */
 
 // Field IDs
+export {getDeployConfig, getReleaseProjectKey} from './config.js';
+
 export {
   SHARED_FIELD_IDS,
   CD_FIELD_IDS,
@@ -26,7 +28,7 @@ export {
 export {ENV_CODES, DEPT_CODES, SUPPORTED_ENVS, ENV_LABELS} from './environments.js';
 
 // Servers
-export {SERVERS, SERVER_MODULE_MAP} from './server.js';
+export {SERVERS, SERVER_MODULE_MAP, META_TEST_NODES} from './server.js';
 
 // Issue Types
 export {ISSUE_TYPES, ISSUE_TYPE_IDS, JIRA_PROJECT_ID} from './issue-types.js';

package/constants/issue-types.js

@@ -1,23 +1,11 @@
-/**
- * Jira Issue Type 定義及 ID
- */
+import {getDeployConfig} from './config.js';
 
-export const ISSUE_TYPES = {
-  LIBRARY: 'Library',
-  CI: 'CI',
-  CD: 'CD',
-  GRAY_RELEASE: 'GrayRelease',
-};
+const config = getDeployConfig();
 
-export const ISSUE_TYPE_IDS = {
-  Library: '12501',
-  GrayRelease: '12601',
-  CI: '12305',
-  CD: '12306',
-};
+export const ISSUE_TYPES = config.issueTypes.names;
 
-/** Jira Project ID（數字）*/
-export const JIRA_PROJECT_ID_NUMERIC = 13305;
+export const ISSUE_TYPE_IDS = config.issueTypes.ids;
 
-/** Jira Project Key（用於 API）*/
-export const JIRA_PROJECT_ID = 'CID';
+export const JIRA_PROJECT_ID_NUMERIC = config.jira.projectIdNumeric;
+
+export const JIRA_PROJECT_ID = process.env.JIRA_PROJECT_KEY ?? config.jira.projectKey;

package/constants/modules.js

@@ -1,39 +1,12 @@
-/**
- * 模組 ID 映射
- */
+import {getDeployConfig} from './config.js';
+
+const config = getDeployConfig();
 
 /** Library 中的模組 ID */
-export const LIBRARY_MODULE_IDS = {
-  EVT: {
-    evt005: '15609',
-    evt007: '15610',
-    evt009: '15510',
-    nextjs_web: '15511',
-  },
-  IBK: {
-    ibk: '15601',
-    a11y: '15602',
-    landing: '15603',
-    ssr: '15604',
-    wealth: '15605',
-  },
-  CWA: {cwa: '15514'},
-  BOF: {web: '15801'},
-  EIB: {web_cust: '15804', web_agnt: '15805'},
-  NPM: {utils: '15808'},
-};
+export const LIBRARY_MODULE_IDS = config.libraryModuleIds;
 
 /** GrayRelease 中的模組 ID */
-export const GRAY_RELEASE_MODULE_IDS = {
-  ibk: '15500',
-  a11y: '15501',
-  ssr: '15503',
-  wealth: '15507',
-  cwa: '15515',
-  web: '15809',
-  web_cust: '15810',
-  web_agnt: '15811',
-};
+export const GRAY_RELEASE_MODULE_IDS = config.grayReleaseModuleIds;
 
 /**
  * 取得模組的 Jira ID

package/constants/repos.js

@@ -1,55 +1,7 @@
-/**
- * Bitbucket repo 相關對應表
- */
+import {getDeployConfig} from './config.js';
 
-/** Bitbucket repo metadata（也供 CD release notes 使用） */
-export const REPO_MAPS = {
-  'tw-bank-web': {project: 'CHANNEL', repoId: '110'},
-  'tw-bank-web-ssr': {project: 'CHANNEL', repoId: '787'},
-  'tw-bank-web-wealth': {project: 'CHANNEL', repoId: '1403'},
-  'tw-bank-web-a11y': {project: 'CHANNEL', repoId: '690'},
-  'tw-bank-webapp': {project: 'CHANNEL', repoId: '36'},
-  'tw-bank-admin-web': {project: 'CHANNEL', repoId: '1042'},
-  'tw-bank-enterprise-cust': {project: 'CHANNEL', repoId: '836'},
-  'tw-bank-enterprise-agent': {project: 'CHANNEL', repoId: '850'},
-  'tw-bank-evt': {project: 'CHANNEL', repoId: '827'},
-  'tw-bank-web-evt': {project: 'CHANNEL', repoId: '937'},
-  'tw-bank-npm': {project: 'CHANNEL', repoId: '1274'},
-  'ch014.ibk.assembly': {project: 'LBTWGOL', repoId: '1241'},
-  'ch014.cwa.assembly': {project: 'LBTWGOL', repoId: '1460'},
-  'ch015.bof.assembly': {project: 'LBTWGOL', repoId: '1514'},
-  'ch015.eib.assembly': {project: 'LBTWGOL', repoId: '1516'},
-  'ch015.evt.assembly': {project: 'LBTWGOL', repoId: '1412'},
-};
+const repos = getDeployConfig().repos;
 
-/** moduleChild → repo name 對應 */
-export const MODULE_MAP = {
-  ibk: 'tw-bank-web',
-  ssr: 'tw-bank-web-ssr',
-  wealth: 'tw-bank-web-wealth',
-  a11y: 'tw-bank-web-a11y',
-  cwa: 'tw-bank-webapp',
-  web: 'tw-bank-admin-web',
-  web_cust: 'tw-bank-enterprise-cust',
-  web_agnt: 'tw-bank-enterprise-agent',
-  evt007: 'tw-bank-evt',
-  evt009: 'tw-bank-evt',
-  evt005: 'tw-bank-evt',
-  nextjs_web: 'tw-bank-web-evt',
-  utils: 'tw-bank-npm',
-};
-
-/** repo name → 顯示標籤 */
-export const REPO_LABEL_MAP = {
-  'tw-bank-web': 'IBK',
-  'tw-bank-web-ssr': 'SSR',
-  'tw-bank-web-wealth': 'Wealth',
-  'tw-bank-web-a11y': 'A11y',
-  'tw-bank-webapp': 'CWA',
-  'tw-bank-admin-web': 'BOF Web',
-  'tw-bank-enterprise-cust': 'EIB Cust',
-  'tw-bank-enterprise-agent': 'EIB Agent',
-  'tw-bank-evt': 'EVT',
-  'tw-bank-web-evt': 'EVT Next',
-  'tw-bank-npm': 'NPM',
-};
+export const REPO_MAPS = repos.maps;
+export const MODULE_MAP = repos.moduleMap;
+export const REPO_LABEL_MAP = repos.labels;

package/constants/server.js

@@ -1,100 +1,7 @@
-/**
- * Server 配置及部署列表
- */
+import {getDeployConfig} from './config.js';
 
-export const SERVERS = {
-  IBK: {
-    dev: ['tvdev-ibk-web01'],
-    stg: ['tvstg-ibk-web01', 'tvstg-ibk-web02'],
-    uat: ['tvuat-ibk-web01', 'tvuat-ibk-web02'],
-    prd: [
-      'tvprd-ibk-web01',
-      'tvprd-ibk-web02',
-      'tvprd-ibk-web03',
-      'tvprd-ibk-web04',
-      'tvprd-ibk-web05',
-    ],
-    dr: ['lvprd-ibk-web01', 'lvprd-ibk-web02'],
-    'prd/dr': [
-      'tvprd-ibk-web01',
-      'tvprd-ibk-web02',
-      'tvprd-ibk-web03',
-      'tvprd-ibk-web04',
-      'tvprd-ibk-web05',
-      'lvprd-ibk-web01',
-      'lvprd-ibk-web02',
-    ],
-  },
+const config = getDeployConfig();
 
-  CWA: {
-    dev: ['tvdev-cwa-web01'],
-    stg: ['tvstg-cwa-web01', 'tvstg-cwa-web02'],
-    uat: ['tvuat-cwa-web01', 'tvuat-cwa-web02'],
-    prd: [
-      'tvprd-cwa-web01',
-      'tvprd-cwa-web02',
-      'tvprd-cwa-web03',
-      'tvprd-cwa-web04',
-      'tvprd-cwa-web05',
-    ],
-    dr: ['lvprd-cwa-web01', 'lvprd-cwa-web02'],
-    'prd/dr': [
-      'tvprd-cwa-web01',
-      'tvprd-cwa-web02',
-      'tvprd-cwa-web03',
-      'tvprd-cwa-web04',
-      'tvprd-cwa-web05',
-      'lvprd-cwa-web01',
-      'lvprd-cwa-web02',
-    ],
-  },
-
-  BOF: {
-    dev: ['tvdev-bof-was01'],
-    stg: ['tvstg-bof-was01'],
-    uat: ['tvuat-bof-was01'],
-    prd: ['tvprd-bof-was01'],
-  },
-
-  EIB: {
-    dev: {was: ['tvdev-eib-was01'], web: ['tvdev-eib-web01']},
-    stg: {was: ['tvstg-eib-was01'], web: ['tvstg-eib-web01']},
-    uat: {
-      was: ['tvuat-eib-was01', 'tvuat-eib-was02'],
-      web: ['tvuat-eib-web01', 'tvuat-eib-web02'],
-    },
-    prd: {
-      was: ['tvprd-eib-was01', 'tvprd-eib-was02'],
-      web: ['tvprd-eib-web01', 'tvprd-eib-web02'],
-    },
-    dr: {
-      was: ['lvprd-eib-was01', 'lvprd-eib-was02'],
-      web: ['lvprd-eib-web01', 'lvprd-eib-web02'],
-    },
-    'prd/dr': {
-      was: ['tvprd-eib-was01', 'tvprd-eib-was02', 'lvprd-eib-was01', 'lvprd-eib-was02'],
-      web: ['tvprd-eib-web01', 'tvprd-eib-web02', 'lvprd-eib-web01', 'lvprd-eib-web02'],
-    },
-  },
-
-  EVT: {
-    stg: {web: ['tvstg-evt-web01'], was: ['tvstg-evt-was01']},
-    uat: {
-      web: ['tvuat-evt-web01', 'tvuat-evt-web02'],
-      was: ['tvuat-evt-was01', 'tvuat-evt-was02'],
-    },
-    prd: {
-      web: ['tvprd-evt-web01', 'tvprd-evt-web02'],
-      was: ['tvprd-evt-was01', 'tvprd-evt-was02'],
-    },
-  },
-};
-
-export const SERVER_MODULE_MAP = {
-  web_cust: 'web',
-  web_agnt: 'was',
-  evt005: 'was',
-  evt007: 'was',
-  evt009: 'web',
-  nextjs_web: 'was',
-};
+export const SERVERS = config.servers;
+export const SERVER_MODULE_MAP = config.serverModuleMap;
+export const META_TEST_NODES = config.metaTestNodes;