baiyue-firstleg/firstleg/src/test/java/com/baiyue/firstleg/controller/FbaPricingContractTest.java

package com.baiyue.firstleg.controller;

import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.core.io.ClassPathResource;
import org.springframework.web.bind.annotation.RequestParam;

import java.nio.charset.StandardCharsets;
import java.lang.reflect.Method;

import static org.assertj.core.api.Assertions.assertThat;

@DisplayName("FBA计费OpenAPI契约")
class FbaPricingContractTest {
    @Test
    @DisplayName("客户规则保留客户参数，船司价格使用平台公共作用域")
    void keepsCustomerRuleScopeAndRemovesCarrierRateTenantScope() {
        Method rules = method("rules");
        assertThat(rules.getParameterTypes()[1]).isEqualTo(Long.class);
        assertThat(rules.getParameters()[1].getAnnotation(RequestParam.class).required()).isFalse();

        Method rates = method("rates");
        assertThat(rates.getParameterTypes()).doesNotContain(Long.class);

        for (String scopedMethod : new String[] {"rule", "createRule", "retireRule"}) {
            Method method = method(scopedMethod);
            assertThat(method.getParameterTypes()[1]).isEqualTo(long.class);
            assertThat(method.getParameters()[1].getAnnotation(RequestParam.class).required()).isTrue();
        }

        for (String publicMethod : new String[] {"rate", "createRate", "retireRate"}) {
            assertThat(java.util.Arrays.stream(method(publicMethod).getParameters())
                .map(parameter -> parameter.getAnnotation(RequestParam.class)))
                .allMatch(annotation -> annotation == null);
        }
    }

    @Test
    @DisplayName("契约声明二期边界计费、已发布费用调整和幂等头")
    void documentsPricingLifecycle() throws Exception {
        String openapi = new ClassPathResource("openapi/fba-pricing-v1.yaml")
            .getContentAsString(StandardCharsets.UTF_8);
        assertThat(openapi)
            .contains("/api/platform/v1/fba-pricing/customer-rules/versions:")
            .contains("/api/platform/v1/fba-pricing/carrier-rates/versions:")
            .contains("/api/platform/v1/inbounds/{inboundId}/fees/calculate:")
            .contains("/api/platform/v1/inbounds/{inboundId}/fees/confirm:")
            .contains("/api/platform/v1/inbounds/{inboundId}/fees/send:")
            .contains("/api/platform/v1/inbounds/{inboundId}/fees/published:")
            .contains("Idempotency-Key")
            .contains("主流程已到 WAIT_SPLIT，也可独立试算且不回退主流程状态")
            .contains("区域阶梯渠道可按平台 FBA 仓或海外中转仓的邮编区域")
            .contains("不再以 carrierId、业务 customerId 或客户计费规则作为前置")
            .contains("该动作涉及后续仓储流程，本轮二期验收不调用")
            .contains("不回退 WAIT_SPLIT 状态")
            .doesNotContain("应收")
            .doesNotContain("应付")
            .doesNotContain("待客户确认");
        String customerRules = openapi.substring(
            openapi.indexOf("/api/platform/v1/fba-pricing/customer-rules:"),
            openapi.indexOf("/api/platform/v1/fba-pricing/customer-rules/versions:"));
        assertThat(customerRules)
            .contains("OptionalTenantId")
            .contains("name: ruleCode")
            .doesNotContain("#/components/parameters/Page")
            .doesNotContain("#/components/parameters/Size")
            .doesNotContain("name: customerName")
            .doesNotContain("name: chargeMode")
            .doesNotContain("name: status");
        String carrierRates = openapi.substring(
            openapi.indexOf("/api/platform/v1/fba-pricing/carrier-rates:"),
            openapi.indexOf("/api/platform/v1/fba-pricing/carrier-rates/versions:"));
        assertThat(carrierRates)
            .doesNotContain("OptionalTenantId")
            .contains("name: rateCode");
        assertThat(openapi)
            .contains("OptionalTenantId: {name: tenantId, in: query, required: false")
            .contains("schema: {type: string, pattern: '^[1-9][0-9]*$'}")
            .doesNotContain("format: int64");
    }

    private static Method method(String name) {
        return java.util.Arrays.stream(PlatformFbaMasterDataController.class.getDeclaredMethods())
            .filter(candidate -> candidate.getName().equals(name))
            .findFirst().orElseThrow();
    }
}