Add production email notification pipeline

2026-05-02 22:35:36 +08:00
parent ace13c7047
commit 39b1141287
12 changed files with 378 additions and 1 deletions
--- a/jenkins/Jenkinsfile.production-api-build
+++ b/jenkins/Jenkinsfile.production-api-build
@@ -23,6 +23,7 @@ pipeline {
    string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '源码分支，默认 master 最新提交')
    string(name: 'COMMIT_HASH', defaultValue: '', description: '可选，指定属于 SOURCE_BRANCH 的 Git commit')
    string(name: 'BUILD_VERSION', defaultValue: '', description: '发布版本号，留空则使用 Jenkins BUILD_NUMBER')
+    string(name: 'NOTIFICATION_EMAILS', defaultValue: '', description: '本次运行追加通知邮箱；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
    booleanParam(name: 'PUBLISH_AFTER_BUILD', defaultValue: false, description: '构建成功后是否触发 API 发布')
    string(name: 'DEPLOY_JOB_NAME', defaultValue: 'Genarrative-Api-Deploy', description: 'API 发布流水线作业名')
    choice(name: 'DEPLOY_TARGET', choices: ['development', 'release'], description: 'PUBLISH_AFTER_BUILD=true 时的逻辑部署目标；development 使用当前 Linux 开发/构建/开发部署 agent')
@@ -97,6 +98,7 @@ pipeline {
            string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH),
            string(name: 'COMMIT_HASH', value: env.SOURCE_COMMIT),
            string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION),
+            string(name: 'NOTIFICATION_EMAILS', value: params.NOTIFICATION_EMAILS ?: ''),
            string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET),
            booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', value: params.CONFIRM_RELEASE_DEPLOY_AGENT),
            string(name: 'BUILD_JOB_NAME', value: env.JOB_NAME),
@@ -107,6 +109,34 @@ pipeline {
  }

  post {
+    always {
+      script {
+        def notificationParameters = [
+          string(name: 'SOURCE_JOB_NAME', value: env.JOB_NAME),
+          string(name: 'SOURCE_BUILD_NUMBER', value: env.BUILD_NUMBER),
+          string(name: 'SOURCE_BUILD_URL', value: env.BUILD_URL ?: ''),
+          string(name: 'SOURCE_RESULT', value: currentBuild.currentResult ?: 'UNKNOWN'),
+          string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH ?: ''),
+          string(name: 'SOURCE_COMMIT', value: env.SOURCE_COMMIT ?: (params.COMMIT_HASH ?: '')),
+          string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION ?: (params.BUILD_VERSION ?: '')),
+          string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET ?: ''),
+          string(name: 'DATABASE', value: params.DATABASE ?: ''),
+          string(name: 'SUMMARY', value: 'API 构建流水线结束'),
+        ]
+        def notificationRecipients = params.NOTIFICATION_EMAILS?.trim()
+        if (notificationRecipients) {
+          notificationParameters.add(string(name: 'EMAIL_RECIPIENTS', value: notificationRecipients))
+        }
+        try {
+          build job: 'Genarrative-Notify-Email',
+            wait: false,
+            propagate: false,
+            parameters: notificationParameters
+        } catch (error) {
+          echo "邮件通知触发失败: ${error.message}"
+        }
+      }
+    }
    success {
      echo "API 构建完成: version=${env.EFFECTIVE_BUILD_VERSION}, commit=${env.SOURCE_COMMIT}"
    }
--- a/jenkins/Jenkinsfile.production-api-deploy
+++ b/jenkins/Jenkinsfile.production-api-deploy
@@ -16,6 +16,7 @@ pipeline {
    booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', defaultValue: false, description: '确认 release 目标已有独立 release 部署 agent；当前 Linux 开发/构建/开发部署 agent 不可冒充 release 部署机')
    string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '部署脚本来源分支')
    string(name: 'COMMIT_HASH', defaultValue: '', description: '部署脚本来源 commit；上游触发时传实际构建 commit')
+    string(name: 'NOTIFICATION_EMAILS', defaultValue: '', description: '本次运行追加通知邮箱；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
    string(name: 'BUILD_VERSION', defaultValue: '', description: '待发布版本号')
    string(name: 'BUILD_JOB_NAME', defaultValue: 'Genarrative-Api-Build', description: 'API 构建流水线作业名')
    string(name: 'BUILD_NUMBER_TO_DEPLOY', defaultValue: '', description: '要复制归档产物的上游构建号')
@@ -112,6 +113,34 @@ pipeline {
  }

  post {
+    always {
+      script {
+        def notificationParameters = [
+          string(name: 'SOURCE_JOB_NAME', value: env.JOB_NAME),
+          string(name: 'SOURCE_BUILD_NUMBER', value: env.BUILD_NUMBER),
+          string(name: 'SOURCE_BUILD_URL', value: env.BUILD_URL ?: ''),
+          string(name: 'SOURCE_RESULT', value: currentBuild.currentResult ?: 'UNKNOWN'),
+          string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH ?: ''),
+          string(name: 'SOURCE_COMMIT', value: env.SOURCE_COMMIT ?: (params.COMMIT_HASH ?: '')),
+          string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION ?: (params.BUILD_VERSION ?: '')),
+          string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET ?: ''),
+          string(name: 'DATABASE', value: params.DATABASE ?: ''),
+          string(name: 'SUMMARY', value: 'API 发布流水线结束'),
+        ]
+        def notificationRecipients = params.NOTIFICATION_EMAILS?.trim()
+        if (notificationRecipients) {
+          notificationParameters.add(string(name: 'EMAIL_RECIPIENTS', value: notificationRecipients))
+        }
+        try {
+          build job: 'Genarrative-Notify-Email',
+            wait: false,
+            propagate: false,
+            parameters: notificationParameters
+        } catch (error) {
+          echo "邮件通知触发失败: ${error.message}"
+        }
+      }
+    }
    success {
      echo "API 发布完成: version=${params.BUILD_VERSION}"
    }
--- a/jenkins/Jenkinsfile.production-database-export
+++ b/jenkins/Jenkinsfile.production-database-export
@@ -16,6 +16,7 @@ pipeline {
    booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', defaultValue: false, description: '确认 release 目标已有独立 release 部署 agent；当前 Linux 开发/构建/开发部署 agent 不可冒充 release 部署机')
    string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '导出脚本来源分支')
    string(name: 'COMMIT_HASH', defaultValue: '', description: '导出脚本来源 commit')
+    string(name: 'NOTIFICATION_EMAILS', defaultValue: '', description: '本次运行追加通知邮箱；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
    string(name: 'DATABASE', defaultValue: 'genarrative-prod', description: 'SpacetimeDB database')
    string(name: 'SPACETIME_SERVER', defaultValue: 'local', description: 'SpacetimeDB server alias')
    string(name: 'SPACETIME_SERVER_URL', defaultValue: '', description: '显式 SpacetimeDB server URL，填写后优先于 SPACETIME_SERVER')
@@ -191,6 +192,34 @@ pipeline {
  }

  post {
+    always {
+      script {
+        def notificationParameters = [
+          string(name: 'SOURCE_JOB_NAME', value: env.JOB_NAME),
+          string(name: 'SOURCE_BUILD_NUMBER', value: env.BUILD_NUMBER),
+          string(name: 'SOURCE_BUILD_URL', value: env.BUILD_URL ?: ''),
+          string(name: 'SOURCE_RESULT', value: currentBuild.currentResult ?: 'UNKNOWN'),
+          string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH ?: ''),
+          string(name: 'SOURCE_COMMIT', value: env.SOURCE_COMMIT ?: (params.COMMIT_HASH ?: '')),
+          string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION ?: (params.BUILD_VERSION ?: '')),
+          string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET ?: ''),
+          string(name: 'DATABASE', value: params.DATABASE ?: ''),
+          string(name: 'SUMMARY', value: '数据库导出流水线结束'),
+        ]
+        def notificationRecipients = params.NOTIFICATION_EMAILS?.trim()
+        if (notificationRecipients) {
+          notificationParameters.add(string(name: 'EMAIL_RECIPIENTS', value: notificationRecipients))
+        }
+        try {
+          build job: 'Genarrative-Notify-Email',
+            wait: false,
+            propagate: false,
+            parameters: notificationParameters
+        } catch (error) {
+          echo "邮件通知触发失败: ${error.message}"
+        }
+      }
+    }
    success {
      echo "数据库导出完成: target=${params.DEPLOY_TARGET}, database=${params.DATABASE}, file=${env.EFFECTIVE_EXPORT_NAME}"
    }
--- a/jenkins/Jenkinsfile.production-database-import
+++ b/jenkins/Jenkinsfile.production-database-import
@@ -16,6 +16,7 @@ pipeline {
    booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', defaultValue: false, description: '确认 release 目标已有独立 release 部署 agent；当前 Linux 开发/构建/开发部署 agent 不可冒充 release 部署机')
    string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '导入脚本来源分支')
    string(name: 'COMMIT_HASH', defaultValue: '', description: '导入脚本来源 commit')
+    string(name: 'NOTIFICATION_EMAILS', defaultValue: '', description: '本次运行追加通知邮箱；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
    string(name: 'DATABASE', defaultValue: 'genarrative-prod', description: 'SpacetimeDB database')
    string(name: 'SPACETIME_SERVER', defaultValue: 'local', description: 'SpacetimeDB server alias')
    string(name: 'SPACETIME_SERVER_URL', defaultValue: '', description: '显式 SpacetimeDB server URL，填写后优先于 SPACETIME_SERVER')
@@ -308,6 +309,34 @@ pipeline {
  }

  post {
+    always {
+      script {
+        def notificationParameters = [
+          string(name: 'SOURCE_JOB_NAME', value: env.JOB_NAME),
+          string(name: 'SOURCE_BUILD_NUMBER', value: env.BUILD_NUMBER),
+          string(name: 'SOURCE_BUILD_URL', value: env.BUILD_URL ?: ''),
+          string(name: 'SOURCE_RESULT', value: currentBuild.currentResult ?: 'UNKNOWN'),
+          string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH ?: ''),
+          string(name: 'SOURCE_COMMIT', value: env.SOURCE_COMMIT ?: (params.COMMIT_HASH ?: '')),
+          string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION ?: (params.BUILD_VERSION ?: '')),
+          string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET ?: ''),
+          string(name: 'DATABASE', value: params.DATABASE ?: ''),
+          string(name: 'SUMMARY', value: '数据库导入流水线结束'),
+        ]
+        def notificationRecipients = params.NOTIFICATION_EMAILS?.trim()
+        if (notificationRecipients) {
+          notificationParameters.add(string(name: 'EMAIL_RECIPIENTS', value: notificationRecipients))
+        }
+        try {
+          build job: 'Genarrative-Notify-Email',
+            wait: false,
+            propagate: false,
+            parameters: notificationParameters
+        } catch (error) {
+          echo "邮件通知触发失败: ${error.message}"
+        }
+      }
+    }
    success {
      echo "数据库导入流水线完成: target=${params.DEPLOY_TARGET}, database=${params.DATABASE}, dryRun=${params.DRY_RUN}"
    }
--- a/jenkins/Jenkinsfile.production-full-build-and-deploy
+++ b/jenkins/Jenkinsfile.production-full-build-and-deploy
@@ -20,6 +20,7 @@ pipeline {
    string(name: 'COMMIT_HASH', defaultValue: '', description: '可选，指定属于 SOURCE_BRANCH 的 Git commit')
    string(name: 'BUILD_VERSION', defaultValue: '', description: '发布版本号，留空则使用 Jenkins BUILD_NUMBER')
    booleanParam(name: 'RUN_NPM_CI', defaultValue: true, description: 'Web 构建前是否执行 npm ci')
+    string(name: 'NOTIFICATION_EMAILS', defaultValue: '', description: '本次运行追加通知邮箱；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
    string(name: 'WEB_BUILD_JOB_NAME', defaultValue: 'Genarrative-Web-Build', description: 'Web 构建流水线作业名')
    string(name: 'API_BUILD_JOB_NAME', defaultValue: 'Genarrative-Api-Build', description: 'API 构建流水线作业名')
    string(name: 'STDB_BUILD_JOB_NAME', defaultValue: 'Genarrative-Stdb-Module-Build', description: 'Stdb 构建流水线作业名')
@@ -79,6 +80,7 @@ pipeline {
                  string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH),
                  string(name: 'COMMIT_HASH', value: env.SOURCE_COMMIT),
                  string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION),
+                  string(name: 'NOTIFICATION_EMAILS', value: params.NOTIFICATION_EMAILS ?: ''),
                  booleanParam(name: 'RUN_NPM_CI', value: params.RUN_NPM_CI),
                ]
              env.WEB_BUILD_NUMBER = webRun.number.toString()
@@ -95,6 +97,7 @@ pipeline {
                  string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH),
                  string(name: 'COMMIT_HASH', value: env.SOURCE_COMMIT),
                  string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION),
+                  string(name: 'NOTIFICATION_EMAILS', value: params.NOTIFICATION_EMAILS ?: ''),
                ]
              env.API_BUILD_NUMBER = apiRun.number.toString()
            }
@@ -110,6 +113,7 @@ pipeline {
                  string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH),
                  string(name: 'COMMIT_HASH', value: env.SOURCE_COMMIT),
                  string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION),
+                  string(name: 'NOTIFICATION_EMAILS', value: params.NOTIFICATION_EMAILS ?: ''),
                  string(name: 'DATABASE', value: params.DATABASE),
                ]
              env.STDB_BUILD_NUMBER = stdbRun.number.toString()
@@ -128,6 +132,7 @@ pipeline {
            string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH),
            string(name: 'COMMIT_HASH', value: env.SOURCE_COMMIT),
            string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION),
+            string(name: 'NOTIFICATION_EMAILS', value: params.NOTIFICATION_EMAILS ?: ''),
            string(name: 'DATABASE', value: params.DATABASE),
            string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET),
            booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', value: params.CONFIRM_RELEASE_DEPLOY_AGENT),
@@ -146,6 +151,7 @@ pipeline {
            string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH),
            string(name: 'COMMIT_HASH', value: env.SOURCE_COMMIT),
            string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION),
+            string(name: 'NOTIFICATION_EMAILS', value: params.NOTIFICATION_EMAILS ?: ''),
            string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET),
            booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', value: params.CONFIRM_RELEASE_DEPLOY_AGENT),
            string(name: 'BUILD_JOB_NAME', value: params.API_BUILD_JOB_NAME),
@@ -163,6 +169,7 @@ pipeline {
            string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH),
            string(name: 'COMMIT_HASH', value: env.SOURCE_COMMIT),
            string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION),
+            string(name: 'NOTIFICATION_EMAILS', value: params.NOTIFICATION_EMAILS ?: ''),
            string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET),
            booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', value: params.CONFIRM_RELEASE_DEPLOY_AGENT),
            string(name: 'BUILD_JOB_NAME', value: params.WEB_BUILD_JOB_NAME),
@@ -173,6 +180,34 @@ pipeline {
  }

  post {
+    always {
+      script {
+        def notificationParameters = [
+          string(name: 'SOURCE_JOB_NAME', value: env.JOB_NAME),
+          string(name: 'SOURCE_BUILD_NUMBER', value: env.BUILD_NUMBER),
+          string(name: 'SOURCE_BUILD_URL', value: env.BUILD_URL ?: ''),
+          string(name: 'SOURCE_RESULT', value: currentBuild.currentResult ?: 'UNKNOWN'),
+          string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH ?: ''),
+          string(name: 'SOURCE_COMMIT', value: env.SOURCE_COMMIT ?: (params.COMMIT_HASH ?: '')),
+          string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION ?: (params.BUILD_VERSION ?: '')),
+          string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET ?: ''),
+          string(name: 'DATABASE', value: params.DATABASE ?: ''),
+          string(name: 'SUMMARY', value: '全量构建发布编排结束'),
+        ]
+        def notificationRecipients = params.NOTIFICATION_EMAILS?.trim()
+        if (notificationRecipients) {
+          notificationParameters.add(string(name: 'EMAIL_RECIPIENTS', value: notificationRecipients))
+        }
+        try {
+          build job: 'Genarrative-Notify-Email',
+            wait: false,
+            propagate: false,
+            parameters: notificationParameters
+        } catch (error) {
+          echo "邮件通知触发失败: ${error.message}"
+        }
+      }
+    }
    success {
      echo "Full Build-And-Deploy 完成: version=${env.EFFECTIVE_BUILD_VERSION}, commit=${env.SOURCE_COMMIT}"
    }
--- a/jenkins/Jenkinsfile.production-notify-email
+++ b/jenkins/Jenkinsfile.production-notify-email
@@ -0,0 +1,69 @@
+pipeline {
+  agent {
+    label 'linux && genarrative-build'
+  }
+
+  options {
+    disableConcurrentBuilds()
+    skipDefaultCheckout(true)
+    buildDiscarder(logRotator(numToKeepStr: '50', artifactNumToKeepStr: '0'))
+  }
+
+  parameters {
+    string(name: 'EMAIL_RECIPIENTS', defaultValue: '', description: '本次运行追加邮件通知收件人；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
+    string(name: 'SOURCE_JOB_NAME', defaultValue: '', description: '来源流水线名称')
+    string(name: 'SOURCE_BUILD_NUMBER', defaultValue: '', description: '来源构建号')
+    string(name: 'SOURCE_BUILD_URL', defaultValue: '', description: '来源构建 URL')
+    string(name: 'SOURCE_RESULT', defaultValue: 'UNKNOWN', description: '来源流水线结果')
+    string(name: 'SOURCE_BRANCH', defaultValue: '', description: '源码分支')
+    string(name: 'SOURCE_COMMIT', defaultValue: '', description: '源码 commit')
+    string(name: 'BUILD_VERSION', defaultValue: '', description: '发布版本号')
+    string(name: 'DEPLOY_TARGET', defaultValue: '', description: '部署目标')
+    string(name: 'DATABASE', defaultValue: '', description: 'SpacetimeDB database')
+    string(name: 'SUMMARY', defaultValue: '', description: '补充摘要')
+  }
+
+  stages {
+    stage('Send Email') {
+      steps {
+        script {
+          def recipientList = []
+          [env.GENARRATIVE_NOTIFICATION_EMAILS, params.EMAIL_RECIPIENTS].each { rawRecipients ->
+            rawRecipients?.split(',')?.each { recipient ->
+              def normalized = recipient.trim()
+              if (normalized && !recipientList.contains(normalized)) {
+                recipientList.add(normalized)
+              }
+            }
+          }
+          def recipients = recipientList.join(',')
+          if (!recipients) {
+            echo '[notify-email] EMAIL_RECIPIENTS 与 GENARRATIVE_NOTIFICATION_EMAILS 均未配置，跳过邮件发送。'
+            return
+          }
+
+          def result = params.SOURCE_RESULT?.trim() ?: 'UNKNOWN'
+          def jobName = params.SOURCE_JOB_NAME?.trim() ?: 'unknown-job'
+          def buildNumber = params.SOURCE_BUILD_NUMBER?.trim() ?: 'unknown-build'
+          def subject = "[Genarrative][${result}] ${jobName} #${buildNumber}"
+          def body = """Genarrative Jenkins 流水线执行结果
+
+结果: ${result}
+流水线: ${jobName}
+构建号: ${buildNumber}
+构建 URL: ${params.SOURCE_BUILD_URL ?: ''}
+源码分支: ${params.SOURCE_BRANCH ?: ''}
+源码 commit: ${params.SOURCE_COMMIT ?: ''}
+发布版本: ${params.BUILD_VERSION ?: ''}
+部署目标: ${params.DEPLOY_TARGET ?: ''}
+数据库: ${params.DATABASE ?: ''}
+摘要: ${params.SUMMARY ?: ''}
+"""
+
+          mail to: recipients, subject: subject, body: body
+          echo "[notify-email] 已发送邮件: recipients=${recipients}, source=${jobName} #${buildNumber}, result=${result}"
+        }
+      }
+    }
+  }
+}
--- a/jenkins/Jenkinsfile.production-server-provision
+++ b/jenkins/Jenkinsfile.production-server-provision
@@ -14,6 +14,7 @@ pipeline {
  parameters {
    choice(name: 'DEPLOY_TARGET', choices: ['development', 'release'], description: '逻辑部署目标；development 使用当前 Linux 开发/构建/开发部署 agent')
    booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', defaultValue: false, description: '确认 release 目标已有独立 release 部署 agent')
+    string(name: 'NOTIFICATION_EMAILS', defaultValue: '', description: '本次运行追加通知邮箱；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
    booleanParam(name: 'CONFIRM_PROVISION', defaultValue: false, description: '确认执行服务器初始化；未勾选时只允许 dry-run')
    booleanParam(name: 'DRY_RUN', defaultValue: true, description: '只打印将执行的服务器初始化命令，不写入系统配置')
    string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '部署脚本来源分支')
@@ -372,6 +373,34 @@ pipeline {
  }

  post {
+    always {
+      script {
+        def notificationParameters = [
+          string(name: 'SOURCE_JOB_NAME', value: env.JOB_NAME),
+          string(name: 'SOURCE_BUILD_NUMBER', value: env.BUILD_NUMBER),
+          string(name: 'SOURCE_BUILD_URL', value: env.BUILD_URL ?: ''),
+          string(name: 'SOURCE_RESULT', value: currentBuild.currentResult ?: 'UNKNOWN'),
+          string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH ?: ''),
+          string(name: 'SOURCE_COMMIT', value: env.SOURCE_COMMIT ?: (params.COMMIT_HASH ?: '')),
+          string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION ?: (params.BUILD_VERSION ?: '')),
+          string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET ?: ''),
+          string(name: 'DATABASE', value: params.DATABASE ?: ''),
+          string(name: 'SUMMARY', value: '服务器初始化流水线结束'),
+        ]
+        def notificationRecipients = params.NOTIFICATION_EMAILS?.trim()
+        if (notificationRecipients) {
+          notificationParameters.add(string(name: 'EMAIL_RECIPIENTS', value: notificationRecipients))
+        }
+        try {
+          build job: 'Genarrative-Notify-Email',
+            wait: false,
+            propagate: false,
+            parameters: notificationParameters
+        } catch (error) {
+          echo "邮件通知触发失败: ${error.message}"
+        }
+      }
+    }
    success {
      echo "Server provision 完成: target=${params.DEPLOY_TARGET}, dryRun=${params.DRY_RUN}, nginxConfigMode=${params.NGINX_CONFIG_MODE}"
    }
--- a/jenkins/Jenkinsfile.production-stdb-module-build
+++ b/jenkins/Jenkinsfile.production-stdb-module-build
@@ -23,6 +23,7 @@ pipeline {
    string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '源码分支，默认 master 最新提交')
    string(name: 'COMMIT_HASH', defaultValue: '', description: '可选，指定属于 SOURCE_BRANCH 的 Git commit')
    string(name: 'BUILD_VERSION', defaultValue: '', description: '发布版本号，留空则使用 Jenkins BUILD_NUMBER')
+    string(name: 'NOTIFICATION_EMAILS', defaultValue: '', description: '本次运行追加通知邮箱；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
    booleanParam(name: 'PUBLISH_AFTER_BUILD', defaultValue: false, description: '构建成功后是否触发 Stdb module 发布')
    string(name: 'DEPLOY_JOB_NAME', defaultValue: 'Genarrative-Stdb-Module-Publish', description: 'Stdb module 发布流水线作业名')
    choice(name: 'DEPLOY_TARGET', choices: ['development', 'release'], description: 'PUBLISH_AFTER_BUILD=true 时的逻辑部署目标；development 使用当前 Linux 开发/构建/开发部署 agent')
@@ -98,6 +99,7 @@ pipeline {
            string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH),
            string(name: 'COMMIT_HASH', value: env.SOURCE_COMMIT),
            string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION),
+            string(name: 'NOTIFICATION_EMAILS', value: params.NOTIFICATION_EMAILS ?: ''),
            string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET),
            booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', value: params.CONFIRM_RELEASE_DEPLOY_AGENT),
            string(name: 'BUILD_JOB_NAME', value: env.JOB_NAME),
@@ -109,6 +111,34 @@ pipeline {
  }

  post {
+    always {
+      script {
+        def notificationParameters = [
+          string(name: 'SOURCE_JOB_NAME', value: env.JOB_NAME),
+          string(name: 'SOURCE_BUILD_NUMBER', value: env.BUILD_NUMBER),
+          string(name: 'SOURCE_BUILD_URL', value: env.BUILD_URL ?: ''),
+          string(name: 'SOURCE_RESULT', value: currentBuild.currentResult ?: 'UNKNOWN'),
+          string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH ?: ''),
+          string(name: 'SOURCE_COMMIT', value: env.SOURCE_COMMIT ?: (params.COMMIT_HASH ?: '')),
+          string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION ?: (params.BUILD_VERSION ?: '')),
+          string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET ?: ''),
+          string(name: 'DATABASE', value: params.DATABASE ?: ''),
+          string(name: 'SUMMARY', value: 'Stdb module 构建流水线结束'),
+        ]
+        def notificationRecipients = params.NOTIFICATION_EMAILS?.trim()
+        if (notificationRecipients) {
+          notificationParameters.add(string(name: 'EMAIL_RECIPIENTS', value: notificationRecipients))
+        }
+        try {
+          build job: 'Genarrative-Notify-Email',
+            wait: false,
+            propagate: false,
+            parameters: notificationParameters
+        } catch (error) {
+          echo "邮件通知触发失败: ${error.message}"
+        }
+      }
+    }
    success {
      echo "Stdb module 构建完成: version=${env.EFFECTIVE_BUILD_VERSION}, commit=${env.SOURCE_COMMIT}"
    }
--- a/jenkins/Jenkinsfile.production-stdb-module-publish
+++ b/jenkins/Jenkinsfile.production-stdb-module-publish
@@ -16,6 +16,7 @@ pipeline {
    booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', defaultValue: false, description: '确认 release 目标已有独立 release 部署 agent；当前 Linux 开发/构建/开发部署 agent 不可冒充 release 部署机')
    string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '部署脚本来源分支')
    string(name: 'COMMIT_HASH', defaultValue: '', description: '部署脚本来源 commit；上游触发时传实际构建 commit')
+    string(name: 'NOTIFICATION_EMAILS', defaultValue: '', description: '本次运行追加通知邮箱；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
    string(name: 'BUILD_VERSION', defaultValue: '', description: '待发布版本号')
    string(name: 'BUILD_JOB_NAME', defaultValue: 'Genarrative-Stdb-Module-Build', description: 'Stdb module 构建流水线作业名')
    string(name: 'BUILD_NUMBER_TO_DEPLOY', defaultValue: '', description: '要复制归档产物的上游构建号')
@@ -115,6 +116,34 @@ pipeline {
  }

  post {
+    always {
+      script {
+        def notificationParameters = [
+          string(name: 'SOURCE_JOB_NAME', value: env.JOB_NAME),
+          string(name: 'SOURCE_BUILD_NUMBER', value: env.BUILD_NUMBER),
+          string(name: 'SOURCE_BUILD_URL', value: env.BUILD_URL ?: ''),
+          string(name: 'SOURCE_RESULT', value: currentBuild.currentResult ?: 'UNKNOWN'),
+          string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH ?: ''),
+          string(name: 'SOURCE_COMMIT', value: env.SOURCE_COMMIT ?: (params.COMMIT_HASH ?: '')),
+          string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION ?: (params.BUILD_VERSION ?: '')),
+          string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET ?: ''),
+          string(name: 'DATABASE', value: params.DATABASE ?: ''),
+          string(name: 'SUMMARY', value: 'Stdb module 发布流水线结束'),
+        ]
+        def notificationRecipients = params.NOTIFICATION_EMAILS?.trim()
+        if (notificationRecipients) {
+          notificationParameters.add(string(name: 'EMAIL_RECIPIENTS', value: notificationRecipients))
+        }
+        try {
+          build job: 'Genarrative-Notify-Email',
+            wait: false,
+            propagate: false,
+            parameters: notificationParameters
+        } catch (error) {
+          echo "邮件通知触发失败: ${error.message}"
+        }
+      }
+    }
    success {
      echo "Stdb module 发布完成: version=${params.BUILD_VERSION}, database=${params.DATABASE}"
    }
--- a/jenkins/Jenkinsfile.production-web-build
+++ b/jenkins/Jenkinsfile.production-web-build
@@ -17,6 +17,7 @@ pipeline {
    string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '源码分支，默认 master 最新提交')
    string(name: 'COMMIT_HASH', defaultValue: '', description: '可选，指定属于 SOURCE_BRANCH 的 Git commit')
    string(name: 'BUILD_VERSION', defaultValue: '', description: '发布版本号，留空则使用 Jenkins BUILD_NUMBER')
+    string(name: 'NOTIFICATION_EMAILS', defaultValue: '', description: '本次运行追加通知邮箱；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
    booleanParam(name: 'RUN_NPM_CI', defaultValue: true, description: '构建前是否执行 npm ci')
    booleanParam(name: 'PUBLISH_AFTER_BUILD', defaultValue: false, description: '构建成功后是否触发 Web 发布')
    string(name: 'DEPLOY_JOB_NAME', defaultValue: 'Genarrative-Web-Deploy', description: 'Web 发布流水线作业名')
@@ -87,6 +88,7 @@ pipeline {
            string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH),
            string(name: 'COMMIT_HASH', value: env.SOURCE_COMMIT),
            string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION),
+            string(name: 'NOTIFICATION_EMAILS', value: params.NOTIFICATION_EMAILS ?: ''),
            string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET),
            booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', value: params.CONFIRM_RELEASE_DEPLOY_AGENT),
            string(name: 'BUILD_JOB_NAME', value: env.JOB_NAME),
@@ -97,6 +99,34 @@ pipeline {
  }

  post {
+    always {
+      script {
+        def notificationParameters = [
+          string(name: 'SOURCE_JOB_NAME', value: env.JOB_NAME),
+          string(name: 'SOURCE_BUILD_NUMBER', value: env.BUILD_NUMBER),
+          string(name: 'SOURCE_BUILD_URL', value: env.BUILD_URL ?: ''),
+          string(name: 'SOURCE_RESULT', value: currentBuild.currentResult ?: 'UNKNOWN'),
+          string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH ?: ''),
+          string(name: 'SOURCE_COMMIT', value: env.SOURCE_COMMIT ?: (params.COMMIT_HASH ?: '')),
+          string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION ?: (params.BUILD_VERSION ?: '')),
+          string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET ?: ''),
+          string(name: 'DATABASE', value: params.DATABASE ?: ''),
+          string(name: 'SUMMARY', value: 'Web 构建流水线结束'),
+        ]
+        def notificationRecipients = params.NOTIFICATION_EMAILS?.trim()
+        if (notificationRecipients) {
+          notificationParameters.add(string(name: 'EMAIL_RECIPIENTS', value: notificationRecipients))
+        }
+        try {
+          build job: 'Genarrative-Notify-Email',
+            wait: false,
+            propagate: false,
+            parameters: notificationParameters
+        } catch (error) {
+          echo "邮件通知触发失败: ${error.message}"
+        }
+      }
+    }
    success {
      echo "Web 构建完成: version=${env.EFFECTIVE_BUILD_VERSION}, commit=${env.SOURCE_COMMIT}"
    }
--- a/jenkins/Jenkinsfile.production-web-deploy
+++ b/jenkins/Jenkinsfile.production-web-deploy
@@ -16,6 +16,7 @@ pipeline {
    booleanParam(name: 'CONFIRM_RELEASE_DEPLOY_AGENT', defaultValue: false, description: '确认 release 目标已有独立 release 部署 agent；当前 Linux 开发/构建/开发部署 agent 不可冒充 release 部署机')
    string(name: 'SOURCE_BRANCH', defaultValue: 'master', description: '部署脚本来源分支')
    string(name: 'COMMIT_HASH', defaultValue: '', description: '部署脚本来源 commit；上游触发时传实际构建 commit')
+    string(name: 'NOTIFICATION_EMAILS', defaultValue: '', description: '本次运行追加通知邮箱；会与 Jenkins 全局环境变量 GENARRATIVE_NOTIFICATION_EMAILS 合并发送')
    string(name: 'BUILD_VERSION', defaultValue: '', description: '待发布版本号')
    string(name: 'BUILD_JOB_NAME', defaultValue: 'Genarrative-Web-Build', description: 'Web 构建流水线作业名')
    string(name: 'BUILD_NUMBER_TO_DEPLOY', defaultValue: '', description: '要复制归档产物的上游构建号')
@@ -110,6 +111,34 @@ pipeline {
  }

  post {
+    always {
+      script {
+        def notificationParameters = [
+          string(name: 'SOURCE_JOB_NAME', value: env.JOB_NAME),
+          string(name: 'SOURCE_BUILD_NUMBER', value: env.BUILD_NUMBER),
+          string(name: 'SOURCE_BUILD_URL', value: env.BUILD_URL ?: ''),
+          string(name: 'SOURCE_RESULT', value: currentBuild.currentResult ?: 'UNKNOWN'),
+          string(name: 'SOURCE_BRANCH', value: params.SOURCE_BRANCH ?: ''),
+          string(name: 'SOURCE_COMMIT', value: env.SOURCE_COMMIT ?: (params.COMMIT_HASH ?: '')),
+          string(name: 'BUILD_VERSION', value: env.EFFECTIVE_BUILD_VERSION ?: (params.BUILD_VERSION ?: '')),
+          string(name: 'DEPLOY_TARGET', value: params.DEPLOY_TARGET ?: ''),
+          string(name: 'DATABASE', value: params.DATABASE ?: ''),
+          string(name: 'SUMMARY', value: 'Web 发布流水线结束'),
+        ]
+        def notificationRecipients = params.NOTIFICATION_EMAILS?.trim()
+        if (notificationRecipients) {
+          notificationParameters.add(string(name: 'EMAIL_RECIPIENTS', value: notificationRecipients))
+        }
+        try {
+          build job: 'Genarrative-Notify-Email',
+            wait: false,
+            propagate: false,
+            parameters: notificationParameters
+        } catch (error) {
+          echo "邮件通知触发失败: ${error.message}"
+        }
+      }
+    }
    success {
      echo "Web 发布完成: version=${params.BUILD_VERSION}"
    }