def serviceModules = [
    'gateway', 'gateway-overseas', 'auth', 'iam', 'firstleg', 'finance', 'order', 'warehouse', 'file', 'print',
    'integration-service', 'lastleg-service', 'warehouse-overseas-service', 'overseas-security-service', 'event-bridge-service', 'audit-service'
]

def serviceJars = [
    'gateway': 'gateway/target/gateway-1.0.0-SNAPSHOT.jar',
    'gateway-overseas': 'gateway-overseas/target/gateway-overseas-1.0.0-SNAPSHOT.jar',
    'auth': 'auth/target/auth-service-1.0.0-SNAPSHOT.jar',
    'iam': 'iam/target/iam-service-1.0.0-SNAPSHOT.jar',
    'firstleg': 'firstleg/target/firstleg-service-1.0.0-SNAPSHOT.jar',
    'finance': 'finance/target/finance-service-1.0.0-SNAPSHOT.jar',
    'order': 'order/target/order-service-1.0.0-SNAPSHOT.jar',
    'warehouse': 'warehouse/target/warehouse-service-1.0.0-SNAPSHOT.jar',
    'file': 'file/target/file-service-1.0.0-SNAPSHOT.jar',
    'print': 'print/target/print-service-1.0.0-SNAPSHOT.jar',
    'integration-service': 'integration-service/target/integration-service-1.0.0-SNAPSHOT.jar',
    'lastleg-service': 'lastleg-service/target/lastleg-service-1.0.0-SNAPSHOT.jar',
    'warehouse-overseas-service': 'warehouse-overseas-service/target/warehouse-overseas-service-1.0.0-SNAPSHOT.jar',
    'overseas-security-service': 'overseas-security-service/target/overseas-security-service-1.0.0-SNAPSHOT.jar',
    'event-bridge-service': 'event-bridge-service/target/event-bridge-service-1.0.0-SNAPSHOT.jar',
    'audit-service': 'audit-service/target/audit-service-1.0.0-SNAPSHOT.jar'
]

pipeline {
    // 构建在任意 java-builder 节点执行，部署再回到目标环境节点。
    agent none

    options {
        skipDefaultCheckout(true)
        disableConcurrentBuilds()
        timestamps()
        buildDiscarder(logRotator(numToKeepStr: '30'))
    }

    parameters {
        string(name: 'SOURCE_COMMIT', defaultValue: '', description: '必须构建的 Git commit；通常由总控 Job 传入')
        string(name: 'IMAGE_TAG', defaultValue: '', description: '不可变镜像标签；通常使用 Git commit 前 12 位')
        choice(name: 'ENVIRONMENT', choices: ['test', 'development', 'staging', 'production'], description: '部署环境')
        booleanParam(name: 'DEPLOY', defaultValue: false, description: '构建成功后是否部署本服务')
        booleanParam(name: 'SKIP_TESTS', defaultValue: false, description: '是否跳过测试')
        choice(name: 'EVENT_BRIDGE_REGION', choices: ['BOTH', 'CN', 'OVERSEAS', 'SELECT'], description: '仅 event-bridge-service 使用；BOTH 在开发/测试环境同时部署国内和海外实例；SELECT 为总控兼容值')
        string(name: 'IMAGE_REPOSITORY', defaultValue: '172.31.198.7:10082/java-project/baiyue-firstleg', description: '内网共享镜像仓库基础路径，不包含服务名和标签')
        string(name: 'DOCKER_BASE_IMAGE', defaultValue: '172.31.198.7:10082/java-project/eclipse-temurin:17-jre-alpine', description: '内网 Java 17 基础镜像')
    }

    environment {
        REGISTRY_CREDENTIALS = 'gitea-registry-token'
        MAVEN_SETTINGS = 'deploy/maven/settings-ci.xml'
        MAVEN_OPTS = '-Dfile.encoding=UTF-8 -Dmaven.wagon.http.retryHandler.count=3'
    }

    stages {
        stage('构建并发布单服务') {
            agent { label 'java-builder' }
            tools { maven 'maven-3.8.8' }
            stages {
                stage('校验参数并检出指定提交') {
                    steps {
                        checkout scm

                        script {
                            String service = serviceModules.find { candidate ->
                                env.JOB_BASE_NAME?.endsWith("-${candidate}")
                            }
                            String sourceCommit = params.SOURCE_COMMIT?.trim()
                            String imageTag = params.IMAGE_TAG?.trim()
                            String imageRepository = params.IMAGE_REPOSITORY?.trim()

                            if (!sourceCommit) {
                                sourceCommit = sh(script: 'git rev-parse HEAD', returnStdout: true).trim()
                            }
                            if (!imageTag) {
                                imageTag = sh(script: 'git rev-parse --short=12 HEAD', returnStdout: true).trim()
                            }

                            if (!serviceModules.contains(service)) {
                                error("无法从 Job 名称 ${env.JOB_BASE_NAME} 识别服务；名称必须以以下服务之一结尾: ${serviceModules.join(', ')}")
                            }
                            boolean deployBothBridges = service == 'event-bridge-service' &&
                                imageTag?.endsWith('-both')
                            if (deployBothBridges) {
                                imageTag = imageTag.substring(0, imageTag.length() - '-both'.length())
                            }
                            if (!sourceCommit || !(sourceCommit ==~ /(?i)[0-9a-f]{7,40}/)) {
                                error('SOURCE_COMMIT 必须是 7 到 40 位十六进制 Git commit')
                            }
                            if (!imageTag || !(imageTag ==~ /[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}/)) {
                                error('IMAGE_TAG 不是合法的 Docker 镜像标签')
                            }
                            if (!imageRepository || imageRepository.contains('://')) {
                                error('IMAGE_REPOSITORY 不能为空且不能包含协议前缀')
                            }
                            if (!imageRepository.contains('/')) {
                                error('IMAGE_REPOSITORY 必须使用 host[:port]/owner/image 格式')
                            }

                            env.RESOLVED_SERVICE = service
                            env.RESOLVED_SOURCE_COMMIT = sourceCommit
                            env.RESOLVED_IMAGE_TAG = imageTag
                            env.RESOLVED_IMAGE_REPOSITORY = imageRepository
                            env.DEPLOY_BOTH_EVENT_BRIDGES = deployBothBridges ? 'true' : 'false'

                            if (service == 'event-bridge-service' && params.DEPLOY) {
                                String bridgeRegion = params.EVENT_BRIDGE_REGION?.trim()
                                if (!['BOTH', 'SELECT', 'CN', 'OVERSEAS'].contains(bridgeRegion)) {
                                    error('EVENT_BRIDGE_REGION 只能为 BOTH、CN 或 OVERSEAS')
                                }
                                if ((deployBothBridges || ['BOTH', 'SELECT'].contains(bridgeRegion)) &&
                                    !['development', 'test'].contains(params.ENVIRONMENT)) {
                                    error('事件桥 BOTH 仅支持开发或测试环境；预发布和生产必须明确选择 CN 或 OVERSEAS')
                                }
                            }
                        }

                        sh '''
                            if ! git cat-file -e "${RESOLVED_SOURCE_COMMIT}^{commit}" 2>/dev/null; then
                              git fetch --no-tags origin
                            fi
                            git cat-file -e "${RESOLVED_SOURCE_COMMIT}^{commit}"
                            git checkout --detach "${RESOLVED_SOURCE_COMMIT}"
                            test "$(git rev-parse HEAD)" = "$(git rev-parse "${RESOLVED_SOURCE_COMMIT}^{commit}")"
                        '''

                        script {
                            currentBuild.description = "${env.RESOLVED_SERVICE} | ${env.RESOLVED_IMAGE_TAG} | ${params.ENVIRONMENT} | ${env.NODE_NAME}"
                            echo "独立构建服务: ${env.RESOLVED_SERVICE}，提交: ${env.RESOLVED_SOURCE_COMMIT}，节点: ${env.NODE_NAME}"
                        }
                    }
                }

                stage('Maven 测试与打包') {
                    steps {
                        script {
                            boolean coordinatorPinnedCommit = params.SOURCE_COMMIT?.trim() as boolean
                            if (params.ENVIRONMENT == 'production' && params.SKIP_TESTS && !coordinatorPinnedCommit) {
                                error('生产环境手工构建禁止跳过测试；总控流水线可在统一测试通过后执行快速打包')
                            }
                            boolean skipTestExecution = params.ENVIRONMENT == 'test' || params.SKIP_TESTS
                            String testOption = skipTestExecution ? '-DskipTests' : ''
                            if (params.SKIP_TESTS && coordinatorPinnedCommit) {
                                echo "总控已处理提交 ${env.RESOLVED_SOURCE_COMMIT} 的测试门禁，本单服务仅编译测试源码并打包"
                            } else if (params.ENVIRONMENT == 'test') {
                                echo '测试环境快速部署：编译主代码和测试代码，但不重复执行单元测试；完整测试由提交门禁和预发布执行'
                            }
                            sh "mvn --settings ${env.MAVEN_SETTINGS} --batch-mode --errors -pl ${env.RESOLVED_SERVICE} -am clean package ${testOption}"
                        }
                    }
                    post {
                        always {
                            junit allowEmptyResults: true, testResults: '**/target/surefire-reports/TEST-*.xml'
                        }
                    }
                }

                stage('构建并发布单服务镜像') {
                    steps {
                        script {
                            String image = "${env.RESOLVED_IMAGE_REPOSITORY}/${env.RESOLVED_SERVICE}:${env.RESOLVED_IMAGE_TAG}"
                            String contextDir = ".docker-context/${env.RESOLVED_SERVICE}"
                            String jar = serviceJars[env.RESOLVED_SERVICE]
                            String registryHost = env.RESOLVED_IMAGE_REPOSITORY.tokenize('/')[0]
                            String dockerConfigDir = "${pwd(tmp: true)}/docker-auth"
                            sh "mkdir -p '${contextDir}' && cp -f '${jar}' '${contextDir}/app.jar'"

                            echo "推送共享镜像: ${image}"
                            withEnv(["DOCKER_CONFIG=${dockerConfigDir}"]) {
                                sh 'mkdir -p "$DOCKER_CONFIG"'
                                withCredentials([usernamePassword(credentialsId: env.REGISTRY_CREDENTIALS, usernameVariable: 'REGISTRY_USER', passwordVariable: 'REGISTRY_PASSWORD')]) {
                                    try {
                                        sh 'printf %s "$REGISTRY_PASSWORD" | docker login -u "$REGISTRY_USER" --password-stdin "' + registryHost + '"'
                                        sh "docker build -f deploy/docker/Dockerfile --build-arg BASE_IMAGE=${params.DOCKER_BASE_IMAGE} --build-arg JAR_FILE=app.jar -t ${image} '${contextDir}'"
                                        sh "docker push ${image}"
                                    } finally {
                                        sh "docker logout ${registryHost} || true"
                                        sh 'rm -rf "$DOCKER_CONFIG"'
                                    }
                                }
                            }
                            if (params.DEPLOY) {
                                stash name: 'deployment-files', includes: 'deploy/**', useDefaultExcludes: true
                            }
                        }
                    }
                }
            }
        }

        stage('部署开发或测试环境') {
            when {
                beforeAgent true
                expression { params.DEPLOY && ['development', 'test'].contains(params.ENVIRONMENT) }
            }
            agent none
            steps {
                script {
                    String deploySlotLabel = "firstleg-${params.ENVIRONMENT}-deploy-slot"
                    String serviceDeployResource = "firstleg-${params.ENVIRONMENT}-${env.RESOLVED_SERVICE}-deploy"
                    String credentialId = "firstleg-${params.ENVIRONMENT}-env"
                    String targetLabel = params.ENVIRONMENT == 'development' ? 'java-dev' : 'java-test'
                    // 不同服务可以并行，但同一环境的同一服务只能有一个任务更新容器。
                    // resource 未预配置时 Lockable Resources 会创建仅在构建期间存在的临时资源。
                    lock(resource: serviceDeployResource, inversePrecedence: true) {
                        lock(label: deploySlotLabel, quantity: 1, inversePrecedence: true) {
                            node(targetLabel) {
                                deleteDir()
                                try {
                                    unstash 'deployment-files'
                                    echo "在目标节点 ${env.NODE_NAME} 本机部署到 ${params.ENVIRONMENT}"
                                    List bridgeRegions = (env.RESOLVED_SERVICE == 'event-bridge-service' &&
                                        (env.DEPLOY_BOTH_EVENT_BRIDGES == 'true' ||
                                            ['BOTH', 'SELECT'].contains(params.EVENT_BRIDGE_REGION)))
                                        ? ['CN', 'OVERSEAS']
                                        : [params.EVENT_BRIDGE_REGION]
                                    withCredentials([
                                        file(credentialsId: credentialId, variable: 'DEPLOY_ENV_FILE'),
                                        usernamePassword(credentialsId: env.REGISTRY_CREDENTIALS,
                                            usernameVariable: 'REGISTRY_USER', passwordVariable: 'REGISTRY_PASSWORD')
                                    ]) {
                                        bridgeRegions.each { bridgeRegion ->
                                            if (env.RESOLVED_SERVICE == 'event-bridge-service') {
                                                echo "部署事件桥实例: ${bridgeRegion}"
                                            }
                                            withEnv([
                                                'TARGET_IS_LOCAL=true',
                                                "EVENT_BRIDGE_REGION_OVERRIDE=${bridgeRegion}"
                                            ]) {
                                                sh "sh deploy/scripts/deploy-built-service.sh '${params.ENVIRONMENT}' '${env.RESOLVED_IMAGE_REPOSITORY}' '${env.RESOLVED_IMAGE_TAG}' '${env.RESOLVED_SERVICE}' \"\$DEPLOY_ENV_FILE\""
                                            }
                                        }
                                    }
                                } finally {
                                    cleanWs(deleteDirs: true, notFailBuild: true)
                                }
                            }
                        }
                    }
                }
            }
        }

        stage('部署单个服务') {
            when {
                beforeAgent true
                expression { params.DEPLOY && !['development', 'test'].contains(params.ENVIRONMENT) }
            }
            agent {
                label "${params.ENVIRONMENT == 'development' ? 'java-dev' : 'master'}"
            }
            steps {
                deleteDir()
                unstash 'deployment-files'
                script {
                    String credentialId = "firstleg-${params.ENVIRONMENT}-env"
                    String registryHost = env.RESOLVED_IMAGE_REPOSITORY.tokenize('/')[0]
                    boolean localDevelopmentDeploy = params.ENVIRONMENT == 'development' &&
                        env.NODE_LABELS?.tokenize()?.contains('java-dev')

                    withCredentials([usernamePassword(credentialsId: env.REGISTRY_CREDENTIALS, usernameVariable: 'REGISTRY_USER', passwordVariable: 'REGISTRY_PASSWORD')]) {
                        try {
                            sh 'printf %s "$REGISTRY_PASSWORD" | docker login -u "$REGISTRY_USER" --password-stdin "' + registryHost + '"'
                            withEnv([
                                "DEVELOPMENT_DEPLOY_LOCAL=${localDevelopmentDeploy}",
                                "EVENT_BRIDGE_REGION_OVERRIDE=${params.EVENT_BRIDGE_REGION}"
                            ]) {
                                withCredentials([file(credentialsId: credentialId, variable: 'DEPLOY_ENV_FILE')]) {
                                    sh "sh deploy/scripts/deploy-services.sh '${params.ENVIRONMENT}' '${env.RESOLVED_IMAGE_REPOSITORY}' '${env.RESOLVED_IMAGE_TAG}' '${env.RESOLVED_SERVICE}' \"\$DEPLOY_ENV_FILE\""
                                }
                            }
                        } finally {
                            sh "docker logout ${registryHost} || true"
                        }
                    }
                }
            }
            post {
                always {
                    cleanWs(deleteDirs: true, notFailBuild: true)
                }
            }
        }
    }

    post {
        success {
            echo "${env.RESOLVED_SERVICE} 已独立完成构建${params.DEPLOY ? '和部署' : ''}"
        }
    }
}