@jira-deploy/core 1.0.0

package/constants/defaults.js

@@ -0,0 +1,111 @@
+/**
+ * Jira Issue 建立的預設值及模板
+ */
+
+/** 簽核欄位預設值 */
+export const SIGN_VALUES = {
+  deptManagerSign: '電子表單呈核',
+  authManagerSign: '電子表單呈核',
+  releaseInfo:
+    '上版步驟:依 Jira 流程上版\n退版步驟:依 Jira 流程退版\n上版程式清單:如 Jira ticket 連結',
+};
+
+/** Jira 預設值 */
+export const JIRA_DEFAULTS = {
+  jenkinsBranch: 'master',
+};
+
+/** 欄位值選項 */
+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',
+  },
+};
+
+/** Issue 預設值 */
+export const ASSIGNEE_DEFAULTS = {
+  automatic: '-1',
+};
+
+// ============ Issue Type 範本及說明 ============
+
+export const NOTES_TEMPLATES = {
+  cd: `1. CD 目的在於透過整合完成程式自動化執行。
+2. CD 單目前有兩個功能 : 
+2-1. 程式上版作業 : 佈署 CI 的版本或對應版本的設定檔。
+2-2. 程式重啟作業 : 執行服務重啟，CID_restart_only 請設為 true。
+3. CD 將自動建立表單，請就表單提供資訊，此表單即為作業申請單，無須再檢附檔案於附件中。
+4. 有任何額外參數請以 json 格式填入 CID_extra_vars 欄位。
+5. 請於 CID_server_list 填入欲佈署的目標機器清單後切至 "PREPARE FOR DEPLOY" 狀態下點擊 "Prepare to create deployment ticket" 自動開立 Deployment 單
+   並於佈署前完成簽核流程並將狀態切換至 "WAIT DEPLOY"。
+   UAT/PRD 只能由資管部級主管與代理完成許可。
+   資管主管請記得在 "WAIT APPROVAL" 狀態下點擊 "Approved"。
+6. CD 單已整合 email 作業通知，請設定 CID_預計執行時間 後於作業前在 "WAIT FOR SEND NOTICE EMAIL" 狀態下點擊 "Send maintenance notification email"。
+7. CID_ansible_tags 與 CID_ansible_skip_tags 欄位現階段尚不開放使用，請先忽略。
+8. CID_system_submodule 欄位為彈性設計給獨立 playbook 的系統子模組使用，無子模組系統可忽略。
+9. 配合 CI 單中 增補模組發佈作業，CD 單 CID_extra_vars 中會自動帶入 {"install_mode":"patch"}，後續 deploy 將執行 patch 的差異上版。
+10. PRD 簽核完成後請記得至資管 wiki - 資訊單位PRD上版彙總表 進行登記
+11. PRD 簽核前請務必確認關聯的 CI 單中已執行完 Upload to prd-release.
+12. 已支援 cluster 集群佈署，勾選 CID_cluster_deploy 為 True 即可使用，將以 CD 單中 CID_server_list 的內容設定至 Deployment 單中的 CID_cluster ，按下佈署後將依序佈署完成，並更新佈署結果於 CID_deploy_results 中。
+13. 請注意集群佈署僅支援相同環境與相同 CID_extra_vars 佈署，PRD/DR 請各自開成 PRD 與 DR 的 Deployment 單。
+14. 自動驗證確實完善前請謹慎考慮是否使用集群佈署。`,
+
+  ci: `1. CI 目的在於透過定義好的版本管理流程讓系統 PIC 能更專注於準備上版檔案(Golden image)。
+2. CI 中預設版號取自 pom.xml 的 version 欄位，會於發佈完成後將尾數自動加 1。
+3. CI 中禁止相同版號重複 release 。CI 可重複執行 release ，但版本號將自動增加。
+4. 切 branch 後記得調整 pom.xml 內預設版號。
+5. CI 流程搭配環境管理，可確認該版本的佈署情況。
+6. 因防毒軟體限制，目前暫時無法自動掃毒，release 成功後請從 CID_repo_url 中下載檔案掃毒後附上掃毒結果截圖，並調整 CID_antivirus_passed 欄位為 True。
+7. CID_diff 欄位為 bitbucket 比對機制，將比對兩版 tag 版本，請確認比對版本號是否正確。
+8. 上 PRD/DR 前請於 "WAIT FOR UPLOAD" 狀態下點擊 "Upload to prd-release"。
+9. CI 單可從上方 "More" 選擇 "CI Create linked CD" 建立搭配環境的 CD 單。
+10. CID_dept_code 與 CID_system_code 已完成連動。
+11. CI 單可分為 主程式發佈作業 與 增補模組發佈作業，設計上為共用 CID_system_module 欄位。
+12. 增補模組為依附於主程式下的差異上版，故請記得於 PRD 佈署完成後將所有增補模組差異 merge 回主程式並完成發佈。`,
+
+  grayRelease: `1. GrayRelease 為灰度發佈，適用於單一 module 開發與測試佈署。
+2. GrayRelease 流程為開發流程中一環，完成後請再接續完成正式 release。
+3. GrayRelease 佈署方式為集群佈署，將以 CID_grayrelease_version 為版本依據，佈署至目標 cluster 中所有機器。
+4. GrayRelease 限制為開發使用，不應存在 PRD/DR 環境。
+5. 若需搭配不同分支的 Jenkins pipeline 執行，請設定 CID_jenkinsfile_branch，預設為 master。
+6. 有任何額外參數請以 json 格式填入 CID_extra_vars 欄位。
+7. 集群佈署僅支援相同環境與相同 CID_extra_vars 佈署。
+8. 集群佈署時，CID_deploy_result 代表整個佈署流程的開始或成功與否。
+9. 若佈署時出現任一失敗則將終止整個集群佈署。
+10. CID_grayrelease_version 版本號不支援 '/'，請務必注意以 '-' 取代。`,
+};
+
+/** CD Issue Type 專用選項 */
+export const CD_OPTIONS = {
+  linkType: { containedIn: 'is contained in' },
+};

package/constants/environments.js

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

package/constants/field-ids.js

@@ -0,0 +1,63 @@
+/**
+ * Jira Custom Field ID 映射表
+ * 所有 customfield_XXXXX 在這裡集中管理
+ */
+
+import {ASSIGNEE_DEFAULTS} from './defaults.js';
+
+// ============ 共用欄位 (所有 Issue Type 都用) ============
+export const SHARED_FIELD_IDS = {
+  summary: 'summary',
+  dueDate: 'duedate',
+  description: 'description',
+  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"}）
+};
+// ============ Library 專用欄位 ============
+export const LIBRARY_FIELD_IDS = {
+  ...SHARED_FIELD_IDS,
+  libModuleParent: 'customfield_13702',
+  libModuleChild: 'customfield_13702:1',
+  fortifyScan: 'customfield_13807',
+};
+
+// ============ 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"}）
+};
+
+// ============ GrayRelease 專用欄位 ============
+export const GRAY_RELEASE_FIELD_IDS = {
+  ...SHARED_FIELD_IDS,
+  grayReleaseVersion: 'customfield_14700',
+  clusterList: 'customfield_14701',
+  grayReleaseNotes: 'customfield_14511',
+};

package/constants/index.js

@@ -0,0 +1,53 @@
+/**
+ * Constants 統一匯出
+ * 這個檔案是所有 constants 的入口
+ */
+
+// Field IDs
+export {
+  SHARED_FIELD_IDS,
+  CD_FIELD_IDS,
+  LIBRARY_FIELD_IDS,
+  CI_FIELD_IDS,
+  GRAY_RELEASE_FIELD_IDS,
+} from './field-ids.js';
+
+// System Codes
+export {
+  SYSTEM_CODES,
+  SYSTEM_TO_DEPT_MAP,
+  SYSTEM_CODE_JIRA_IDS,
+  SYSTEM_MODULES,
+  MODULE_TO_REPO_MAP,
+  SYSTEM_TO_CI_REPO_MAP,
+} from './system-codes.js';
+
+// Environments
+export {ENV_CODES, DEPT_CODES, SUPPORTED_ENVS, ENV_LABELS} from './environments.js';
+
+// Servers
+export {SERVERS, SERVER_MODULE_MAP} from './server.js';
+
+// Issue Types
+export {ISSUE_TYPES, ISSUE_TYPE_IDS, JIRA_PROJECT_ID} from './issue-types.js';
+
+// Modules
+export {LIBRARY_MODULE_IDS, GRAY_RELEASE_MODULE_IDS, getModuleId} from './modules.js';
+
+// Defaults
+export {
+  SIGN_VALUES,
+  JIRA_DEFAULTS,
+  FIELD_OPTIONS,
+  ASSIGNEE_DEFAULTS,
+  NOTES_TEMPLATES,
+  CD_OPTIONS,
+} from './defaults.js';
+
+// Users
+export {USER_MAP, resolveAccountId} from './users.js';
+
+// Repos
+export {REPO_MAPS, MODULE_MAP, REPO_LABEL_MAP} from './repos.js';
+
+

package/constants/issue-types.js

@@ -0,0 +1,23 @@
+/**
+ * Jira Issue Type 定義及 ID
+ */
+
+export const ISSUE_TYPES = {
+  LIBRARY: 'Library',
+  CI: 'CI',
+  CD: 'CD',
+  GRAY_RELEASE: 'GrayRelease',
+};
+
+export const ISSUE_TYPE_IDS = {
+  Library: '12501',
+  GrayRelease: '12601',
+  CI: '12305',
+  CD: '12306',
+};
+
+/** Jira Project ID（數字）*/
+export const JIRA_PROJECT_ID_NUMERIC = 13305;
+
+/** Jira Project Key（用於 API）*/
+export const JIRA_PROJECT_ID = 'CID';

package/constants/modules.js

@@ -0,0 +1,55 @@
+/**
+ * 模組 ID 映射
+ */
+
+/** 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'},
+};
+
+/** 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',
+};
+
+/**
+ * 取得模組的 Jira ID
+ * @param {string} issueType - Issue 類型 ('Library', 'GrayRelease' 等)
+ * @param {string} systemCode - 系統代碼
+ * @param {string} moduleName - 模組名稱
+ * @returns {string} 模組 ID
+ */
+export function getModuleId(issueType, systemCode, moduleName) {
+  if (issueType === 'GrayRelease') {
+    return GRAY_RELEASE_MODULE_IDS[moduleName];
+  }
+
+  if (issueType === 'Library') {
+    return LIBRARY_MODULE_IDS[systemCode]?.[moduleName];
+  }
+
+  return undefined;
+}

package/constants/repos.js

@@ -0,0 +1,55 @@
+/**
+ * Bitbucket repo 相關對應表
+ */
+
+/** 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'},
+};
+
+/** 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',
+};

package/constants/server.js

@@ -0,0 +1,100 @@
+/**
+ * Server 配置及部署列表
+ */
+
+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',
+    ],
+  },
+
+  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',
+};

package/constants/system-codes.js

@@ -0,0 +1,79 @@
+/**
+ * 系統代碼及其映射
+ */
+
+export const SYSTEM_CODES = {
+  IBK: 'IBK',
+  CWA: 'CWA',
+  EIB: 'EIB',
+  EVT: 'EVT',
+  NPM: 'NPM',
+  BOF: 'BOF',
+};
+
+/** 系統 → 部門代碼映射 */
+export const SYSTEM_TO_DEPT_MAP = {
+  IBK: 'CH014',
+  CWA: 'CH014',
+  NPM: 'CH014',
+  EVT: 'CH015',
+  EIB: 'CH015',
+  BOF: 'CH015',
+};
+
+/** 系統代碼的 Jira ID */
+export const SYSTEM_CODE_JIRA_IDS = {
+  // Library 中的系統代碼 ID
+  library: {
+    IBK: '15600',
+    EVT: '15509',
+    CWA: '15513',
+    BOF: '15800',
+    EIB: '15803',
+    NPM: '15807',
+  },
+  // CI 中的系統代碼 ID
+  ci: {
+    EVT: '15508',
+    BOF: '15802',
+    EIB: '15806',
+    IBK: '14800',
+    CWA: '15516',
+  },
+};
+
+/** 各系統支援的模組 */
+export const SYSTEM_MODULES = {
+  IBK: ['ibk', 'wealth', 'ssr', 'a11y'],
+  CWA: ['cwa'],
+  BOF: ['web'],
+  EIB: ['web_cust', 'web_agnt'],
+  EVT: ['evt007', 'evt009', 'evt005', 'nextjs_web'],
+  NPM: ['utils'],
+};
+
+/** 模組名稱 → Git Repo 映射 */
+export const MODULE_TO_REPO_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',
+};
+
+/** 系統代碼 → CI 倉庫映射 */
+export const SYSTEM_TO_CI_REPO_MAP = {
+  IBK: 'ch014.ibk.assembly',
+  CWA: 'ch014.cwa.assembly',
+  BOF: 'ch015.bof.assembly',
+  EIB: 'ch015.eib.assembly',
+  EVT: 'ch015.evt.assembly',
+};

package/constants/users.js

@@ -0,0 +1,47 @@
+/**
+ * 使用者名稱 → Jira accountId 對應表
+ * 支援中英文名稱、暱稱等多種別名
+ * 使用方式：resolveAccountId('Solar') → 'BK00129'
+ */
+export const USER_MAP = {
+  // 格式：'名稱/暱稱（不分大小寫）': 'accountId'
+  'Solar Chen': 'BK00619',
+  'Rex Li': 'BK00619',
+  'James Yu': 'BK00619',
+  'Alvin Wang': 'BK00619',
+  'Chester Kuo': 'BK00619',
+  'Riemann Tseng': 'BK00619',
+  // 'Solar Chen': 'BK00129',
+  // 'Rex Li': 'BK00136',
+  // 'James Yu': 'BK00178',
+  // 'Alvin Wang': 'BK00236',
+  // 'Chester Kuo': 'BK00172',
+  // 'Riemann Tseng': 'BK00003',
+};
+
+/**
+ * 依名稱模糊查找 accountId（不分大小寫）
+ * 優先順序：完全相符 → key 包含輸入 → 輸入包含 key
+ * @param {string} name - 顯示名稱或暱稱（例如 "Solar"、"Solar Chen"）
+ * @returns {string|null} accountId 或 null（查無此人）
+ */
+export function resolveAccountId(name) {
+  if (!name) return null;
+  const query = name.toLowerCase();
+
+  // 1. 完全相符
+  const exact = USER_MAP[query];
+  if (exact) return exact;
+
+  const entries = Object.entries(USER_MAP);
+
+  // 2. key 包含輸入（例如 "solar chen" 包含 "solar"）
+  const keyContains = entries.find(([k]) => k.toLowerCase().includes(query));
+  if (keyContains) return keyContains[1];
+
+  // 3. 輸入包含 key（例如 "solar chen" 被輸入，key 是 "solar"）
+  const inputContains = entries.find(([k]) => query.includes(k.toLowerCase()));
+  if (inputContains) return inputContains[1];
+
+  return null;
+}