pwklppg
1 month ago
22 changed files with 1042 additions and 8 deletions
@ -0,0 +1,37 @@ |
|||
--- |
|||
task_id: "2" |
|||
task_hash: "sha256:4395a095f2f5a85abccfe61bca9647cdc1a92ad9febef404ff8726432b4e25f8" |
|||
next: "Wave W2 task 3: city policy query service/controller/DTOs" |
|||
completed: "V41 layered seed: 359 cities, 12 CITY, 347 PROVINCE_FALLBACK" |
|||
evidence: "mvn -Dtest=SalaryCityPolicySeedTest,SalaryMigrationTest,SalaryRepositoryIntegrationTest test: 3/3 passed" |
|||
review: "changes/n05-salary-calc/.superpowers/sdd/reviews/T2.md" |
|||
risk: "Fallback rows require explicit disclosure and later city-level verification" |
|||
commit_start: "79f0646da8a2fa027b8ef9e025ae1096b8ed3903" |
|||
commit_end: "2d315f90e46982e9658da6483f46e2acbe21bcca" |
|||
created_at: "2026-09-20T08:23:29.908Z" |
|||
plan_hash: "sha256:77341d6e000ef1624d59d66b8b361c24e7ef8f1b5d065dd4d648a2a7537e72d5" |
|||
plan_revision: 1 |
|||
--- |
|||
|
|||
# Checkpoint: 2 |
|||
|
|||
## Next |
|||
Wave W2 task 3: city policy query service/controller/DTOs |
|||
|
|||
## Completed |
|||
V41 layered seed: 359 cities, 12 CITY, 347 PROVINCE_FALLBACK |
|||
|
|||
## Evidence |
|||
mvn -Dtest=SalaryCityPolicySeedTest,SalaryMigrationTest,SalaryRepositoryIntegrationTest test: 3/3 passed |
|||
|
|||
## Review |
|||
changes/n05-salary-calc/.superpowers/sdd/reviews/T2.md |
|||
|
|||
## Risk |
|||
Fallback rows require explicit disclosure and later city-level verification |
|||
|
|||
## Commit Start |
|||
79f0646da8a2fa027b8ef9e025ae1096b8ed3903 |
|||
|
|||
## Commit End |
|||
2d315f90e46982e9658da6483f46e2acbe21bcca |
|||
@ -0,0 +1,10 @@ |
|||
{ |
|||
"status": "pass", |
|||
"base": "36c0214723a3fdd1714ff7923a4f38de07d7b042", |
|||
"head": "2d315f90e46982e9658da6483f46e2acbe21bcca", |
|||
"report": ".superpowers\\sdd\\reviews\\W1.md", |
|||
"report_sha256": "sha256:afb12884b78fdfd3b0edb199900c84f19a130e8bb95c1a680255d59aee43343c", |
|||
"plan_hash": "sha256:77341d6e000ef1624d59d66b8b361c24e7ef8f1b5d065dd4d648a2a7537e72d5", |
|||
"plan_revision": 1, |
|||
"recorded_at": "2026-09-20T08:23:35.131Z" |
|||
} |
|||
@ -0,0 +1,7 @@ |
|||
# Task 3 self-review |
|||
|
|||
- Verdict: pass |
|||
- Scope: city list/detail service and controller, STUDENT authorization, data-level response. |
|||
- Evidence: `mvn -Dtest=SalaryCityPolicyServiceTest,SalaryCityPolicyControllerTest test` -> 9 tests, 0 failures, 0 errors. |
|||
- Contract check: all enabled cities returned; unknown/disabled city 9801; COMPANY 403; anonymous 401; detail includes city defaults and dataLevel. |
|||
- Blockers: none. |
|||
@ -0,0 +1,7 @@ |
|||
# Task 4 self-review |
|||
|
|||
- Verdict: pass |
|||
- Scope: BigDecimal salary calculation engine and input/override/result models. |
|||
- Evidence: `mvn -Dtest=SalaryCalculationEngineTest test` -> 6 tests, 0 failures, 0 errors. |
|||
- Contract check: base floor/ceiling, user overrides, contribution rates, special deduction, cumulative month 12, prior withheld tax, annual tax brackets, zero contribution, and 9802 validation. |
|||
- Blockers: none. |
|||
@ -0,0 +1,10 @@ |
|||
{ |
|||
"status": "pass", |
|||
"base": "36c0214723a3fdd1714ff7923a4f38de07d7b042", |
|||
"head": "2d315f90e46982e9658da6483f46e2acbe21bcca", |
|||
"report": ".superpowers\\sdd\\reviews\\W1.md", |
|||
"report_sha256": "sha256:afb12884b78fdfd3b0edb199900c84f19a130e8bb95c1a680255d59aee43343c", |
|||
"plan_hash": "sha256:77341d6e000ef1624d59d66b8b361c24e7ef8f1b5d065dd4d648a2a7537e72d5", |
|||
"plan_revision": 1, |
|||
"recorded_at": "2026-09-20T08:23:35.131Z" |
|||
} |
|||
@ -0,0 +1,8 @@ |
|||
# Wave W2 review |
|||
|
|||
- Verdict: pass |
|||
- Scope: city policy query APIs and BigDecimal calculation engine. |
|||
- Tasks: 3, 4. |
|||
- Evidence: `mvn -Dtest=SalaryCityPolicyServiceTest,SalaryCityPolicyControllerTest,SalaryCalculationEngineTest test` -> 15 tests, 0 failures, 0 errors. |
|||
- Requirements covered: enabled city catalogue, city detail defaults, dataLevel, STUDENT authorization, base clamping, override precedence, personal contributions, serious illness, month index, special deduction, cumulative withholding, tax brackets, result breakdown. |
|||
- Review blockers: none. |
|||
@ -0,0 +1,262 @@ |
|||
package com.mydreamjob.salarycalculator; |
|||
|
|||
import com.mydreamjob.common.exception.BusinessException; |
|||
import com.mydreamjob.common.exception.ErrorCode; |
|||
import org.springframework.stereotype.Component; |
|||
|
|||
import java.math.BigDecimal; |
|||
import java.math.RoundingMode; |
|||
import java.util.List; |
|||
|
|||
@Component |
|||
public class SalaryCalculationEngine { |
|||
|
|||
public static final String TAX_RULES_VERSION = "CN_IIT_2019_V1"; |
|||
|
|||
private static final BigDecimal ZERO = new BigDecimal("0"); |
|||
private static final BigDecimal MONTHLY_BASIC_DEDUCTION = new BigDecimal("5000"); |
|||
private static final BigDecimal MAX_INPUT_AMOUNT = new BigDecimal("10000000"); |
|||
private static final BigDecimal MAX_ILLNESS_FEE = new BigDecimal("10000"); |
|||
private static final BigDecimal MAX_PENSION_RATE = new BigDecimal("0.20"); |
|||
private static final BigDecimal MAX_MEDICAL_RATE = new BigDecimal("0.20"); |
|||
private static final BigDecimal MAX_UNEMPLOYMENT_RATE = new BigDecimal("0.10"); |
|||
private static final BigDecimal MAX_HOUSING_FUND_RATE = new BigDecimal("0.12"); |
|||
private static final int MONEY_SCALE = 2; |
|||
|
|||
private static final List<TaxBracket> ANNUAL_BRACKETS = List.of( |
|||
new TaxBracket(new BigDecimal("36000"), new BigDecimal("0.03"), new BigDecimal("0")), |
|||
new TaxBracket(new BigDecimal("144000"), new BigDecimal("0.10"), new BigDecimal("2520")), |
|||
new TaxBracket(new BigDecimal("300000"), new BigDecimal("0.20"), new BigDecimal("16920")), |
|||
new TaxBracket(new BigDecimal("420000"), new BigDecimal("0.25"), new BigDecimal("31920")), |
|||
new TaxBracket(new BigDecimal("660000"), new BigDecimal("0.30"), new BigDecimal("52920")), |
|||
new TaxBracket(new BigDecimal("960000"), new BigDecimal("0.35"), new BigDecimal("85920")), |
|||
new TaxBracket(null, new BigDecimal("0.45"), new BigDecimal("181920"))); |
|||
|
|||
public SalaryCalculationResult calculate(SalaryCalculationInput input, SalaryCityPolicy policy) { |
|||
if (input == null || policy == null) { |
|||
throw invalidParameter("input and city policy are required"); |
|||
} |
|||
int monthIndex = input.getMonthIndex() == null ? 1 : input.getMonthIndex(); |
|||
BigDecimal gross = requiredMoney(input.getGrossMonthlySalary(), "grossMonthlySalary"); |
|||
BigDecimal specialDeduction = optionalMoney( |
|||
input.getSpecialAdditionalDeduction(), "specialAdditionalDeduction", MAX_INPUT_AMOUNT); |
|||
SalaryOverrideParameters overrides = input.getOverrides(); |
|||
|
|||
if (gross.compareTo(ZERO) <= 0 || gross.compareTo(MAX_INPUT_AMOUNT) > 0) { |
|||
throw invalidParameter("grossMonthlySalary must be within (0, 10000000]"); |
|||
} |
|||
if (monthIndex < 1 || monthIndex > 12) { |
|||
throw invalidParameter("monthIndex must be between 1 and 12"); |
|||
} |
|||
|
|||
BigDecimal pensionRate = effectiveRate( |
|||
overrides == null ? null : overrides.getPensionRate(), |
|||
policy.getPensionRate(), MAX_PENSION_RATE, "pensionRate"); |
|||
BigDecimal medicalRate = effectiveRate( |
|||
overrides == null ? null : overrides.getMedicalRate(), |
|||
policy.getMedicalRate(), MAX_MEDICAL_RATE, "medicalRate"); |
|||
BigDecimal unemploymentRate = effectiveRate( |
|||
overrides == null ? null : overrides.getUnemploymentRate(), |
|||
policy.getUnemploymentRate(), MAX_UNEMPLOYMENT_RATE, "unemploymentRate"); |
|||
BigDecimal housingFundRate = effectiveRate( |
|||
overrides == null ? null : overrides.getHousingFundRate(), |
|||
policy.getHousingFundRate(), MAX_HOUSING_FUND_RATE, "housingFundRate"); |
|||
BigDecimal illnessFee = effectiveFee( |
|||
overrides == null ? null : overrides.getSeriousIllnessMonthlyFee(), |
|||
policy.getSeriousIllnessMonthlyFee()); |
|||
|
|||
BigDecimal socialSecurityBase = effectiveBase( |
|||
overrides == null ? null : overrides.getSocialSecurityBase(), |
|||
gross, |
|||
policy.getSocialSecurityBaseMin(), |
|||
policy.getSocialSecurityBaseMax(), |
|||
"socialSecurityBase"); |
|||
BigDecimal housingFundBase = effectiveBase( |
|||
overrides == null ? null : overrides.getHousingFundBase(), |
|||
gross, |
|||
policy.getHousingFundBaseMin(), |
|||
policy.getHousingFundBaseMax(), |
|||
"housingFundBase"); |
|||
|
|||
if (socialSecurityBase.compareTo(ZERO) == 0 |
|||
&& (pensionRate.signum() != 0 || medicalRate.signum() != 0 |
|||
|| unemploymentRate.signum() != 0)) { |
|||
throw invalidParameter("socialSecurityBase may be zero only when social insurance rates are zero"); |
|||
} |
|||
if (housingFundBase.compareTo(ZERO) == 0 && housingFundRate.signum() != 0) { |
|||
throw invalidParameter("housingFundBase may be zero only when housingFundRate is zero"); |
|||
} |
|||
|
|||
BigDecimal pension = socialSecurityBase.multiply(pensionRate); |
|||
BigDecimal medical = socialSecurityBase.multiply(medicalRate); |
|||
BigDecimal unemployment = socialSecurityBase.multiply(unemploymentRate); |
|||
BigDecimal housingFund = housingFundBase.multiply(housingFundRate); |
|||
BigDecimal monthlySocialInsurance = pension.add(medical).add(unemployment); |
|||
|
|||
BigDecimal cumulativeGross = gross.multiply(BigDecimal.valueOf(monthIndex)); |
|||
BigDecimal cumulativeSocialInsurance = monthlySocialInsurance.multiply(BigDecimal.valueOf(monthIndex)); |
|||
BigDecimal cumulativeHousingFund = housingFund.multiply(BigDecimal.valueOf(monthIndex)); |
|||
BigDecimal cumulativeIllness = illnessFee.multiply(BigDecimal.valueOf(monthIndex)); |
|||
BigDecimal cumulativeBasicDeduction = MONTHLY_BASIC_DEDUCTION.multiply(BigDecimal.valueOf(monthIndex)); |
|||
BigDecimal cumulativeSpecialDeduction = specialDeduction.multiply(BigDecimal.valueOf(monthIndex)); |
|||
|
|||
BigDecimal cumulativeTaxable = nonNegative(cumulativeGross |
|||
.subtract(cumulativeSocialInsurance) |
|||
.subtract(cumulativeHousingFund) |
|||
.subtract(cumulativeIllness) |
|||
.subtract(cumulativeBasicDeduction) |
|||
.subtract(cumulativeSpecialDeduction)); |
|||
BigDecimal cumulativeTaxDue = taxFor(cumulativeTaxable); |
|||
|
|||
int priorMonths = monthIndex - 1; |
|||
BigDecimal priorTaxable = nonNegative(gross.multiply(BigDecimal.valueOf(priorMonths)) |
|||
.subtract(monthlySocialInsurance.multiply(BigDecimal.valueOf(priorMonths))) |
|||
.subtract(housingFund.multiply(BigDecimal.valueOf(priorMonths))) |
|||
.subtract(illnessFee.multiply(BigDecimal.valueOf(priorMonths))) |
|||
.subtract(MONTHLY_BASIC_DEDUCTION.multiply(BigDecimal.valueOf(priorMonths))) |
|||
.subtract(specialDeduction.multiply(BigDecimal.valueOf(priorMonths)))); |
|||
BigDecimal priorTax = taxFor(priorTaxable); |
|||
BigDecimal currentTax = nonNegative(cumulativeTaxDue.subtract(priorTax)); |
|||
BigDecimal netSalary = nonNegative(gross |
|||
.subtract(pension) |
|||
.subtract(medical) |
|||
.subtract(unemployment) |
|||
.subtract(housingFund) |
|||
.subtract(illnessFee) |
|||
.subtract(currentTax)); |
|||
|
|||
return SalaryCalculationResult.builder() |
|||
.cityCode(policy.getCityCode()) |
|||
.cityName(policy.getCityName()) |
|||
.dataLevel(policy.getDataLevel()) |
|||
.policyVersion(policy.getPolicyVersion()) |
|||
.policyEffectiveDate(policy.getPolicyEffectiveDate()) |
|||
.taxRulesVersion(TAX_RULES_VERSION) |
|||
.estimate(true) |
|||
.monthIndex(monthIndex) |
|||
.grossMonthlySalary(money(gross)) |
|||
.specialAdditionalDeduction(money(specialDeduction)) |
|||
.socialSecurityBase(money(socialSecurityBase)) |
|||
.housingFundBase(money(housingFundBase)) |
|||
.pensionRate(rate(pensionRate)) |
|||
.medicalRate(rate(medicalRate)) |
|||
.unemploymentRate(rate(unemploymentRate)) |
|||
.housingFundRate(rate(housingFundRate)) |
|||
.seriousIllnessMonthlyFee(money(illnessFee)) |
|||
.pension(money(pension)) |
|||
.medical(money(medical)) |
|||
.unemployment(money(unemployment)) |
|||
.housingFund(money(housingFund)) |
|||
.cumulativeGrossIncome(money(cumulativeGross)) |
|||
.cumulativeSocialInsurance(money(cumulativeSocialInsurance)) |
|||
.cumulativeHousingFund(money(cumulativeHousingFund)) |
|||
.cumulativeSeriousIllness(money(cumulativeIllness)) |
|||
.cumulativeBasicDeduction(money(cumulativeBasicDeduction)) |
|||
.cumulativeSpecialAdditionalDeduction(money(cumulativeSpecialDeduction)) |
|||
.cumulativeTaxableIncome(money(cumulativeTaxable)) |
|||
.cumulativeTaxDue(money(cumulativeTaxDue)) |
|||
.previouslyWithheldTax(money(priorTax)) |
|||
.currentMonthTax(money(currentTax)) |
|||
.netSalary(money(netSalary)) |
|||
.build(); |
|||
} |
|||
|
|||
private BigDecimal effectiveBase( |
|||
BigDecimal override, BigDecimal gross, BigDecimal min, BigDecimal max, String field) { |
|||
validatePolicyRange(min, max, field); |
|||
if (override != null) { |
|||
BigDecimal value = requiredMoney(override, field); |
|||
if (value.compareTo(ZERO) < 0) { |
|||
throw invalidParameter(field + " must not be negative"); |
|||
} |
|||
if (value.compareTo(ZERO) > 0 && (value.compareTo(min) < 0 || value.compareTo(max) > 0)) { |
|||
throw invalidParameter(field + " must be within city range or zero for an exempt contribution"); |
|||
} |
|||
return value; |
|||
} |
|||
return clamp(gross, min, max); |
|||
} |
|||
|
|||
private BigDecimal effectiveRate( |
|||
BigDecimal override, BigDecimal fallback, BigDecimal max, String field) { |
|||
BigDecimal value = override == null ? fallback : requiredRate(override, field); |
|||
if (value == null || value.compareTo(ZERO) < 0 || value.compareTo(max) > 0) { |
|||
throw invalidParameter(field + " is outside the allowed range"); |
|||
} |
|||
return value; |
|||
} |
|||
|
|||
private BigDecimal effectiveFee(BigDecimal override, BigDecimal fallback) { |
|||
BigDecimal value = override == null ? fallback : requiredMoney(override, "seriousIllnessMonthlyFee"); |
|||
if (value == null || value.compareTo(ZERO) < 0 || value.compareTo(MAX_ILLNESS_FEE) > 0) { |
|||
throw invalidParameter("seriousIllnessMonthlyFee is outside the allowed range"); |
|||
} |
|||
return value; |
|||
} |
|||
|
|||
private BigDecimal taxFor(BigDecimal taxableIncome) { |
|||
if (taxableIncome.compareTo(ZERO) <= 0) { |
|||
return ZERO; |
|||
} |
|||
for (TaxBracket bracket : ANNUAL_BRACKETS) { |
|||
if (bracket.upperBound == null || taxableIncome.compareTo(bracket.upperBound) <= 0) { |
|||
return nonNegative(taxableIncome.multiply(bracket.rate).subtract(bracket.quickDeduction)); |
|||
} |
|||
} |
|||
return ZERO; |
|||
} |
|||
|
|||
private BigDecimal clamp(BigDecimal value, BigDecimal min, BigDecimal max) { |
|||
if (value.compareTo(min) < 0) { |
|||
return min; |
|||
} |
|||
return value.compareTo(max) > 0 ? max : value; |
|||
} |
|||
|
|||
private void validatePolicyRange(BigDecimal min, BigDecimal max, String field) { |
|||
if (min == null || max == null || min.compareTo(ZERO) < 0 || max.compareTo(min) < 0) { |
|||
throw invalidParameter(field + " city range is invalid"); |
|||
} |
|||
} |
|||
|
|||
private BigDecimal requiredMoney(BigDecimal value, String field) { |
|||
if (value == null || value.scale() > MONEY_SCALE) { |
|||
throw invalidParameter(field + " must have at most two decimal places"); |
|||
} |
|||
return value; |
|||
} |
|||
|
|||
private BigDecimal optionalMoney(BigDecimal value, String field, BigDecimal max) { |
|||
BigDecimal effective = value == null ? ZERO : requiredMoney(value, field); |
|||
if (effective.compareTo(ZERO) < 0 || effective.compareTo(max) > 0) { |
|||
throw invalidParameter(field + " is outside the allowed range"); |
|||
} |
|||
return effective; |
|||
} |
|||
|
|||
private BigDecimal requiredRate(BigDecimal value, String field) { |
|||
if (value == null || value.scale() > 6) { |
|||
throw invalidParameter(field + " must have at most six decimal places"); |
|||
} |
|||
return value; |
|||
} |
|||
|
|||
private BigDecimal nonNegative(BigDecimal value) { |
|||
return value.compareTo(ZERO) < 0 ? ZERO : value; |
|||
} |
|||
|
|||
private BigDecimal money(BigDecimal value) { |
|||
return value.setScale(MONEY_SCALE, RoundingMode.HALF_UP); |
|||
} |
|||
|
|||
private BigDecimal rate(BigDecimal value) { |
|||
return value.setScale(6, RoundingMode.HALF_UP); |
|||
} |
|||
|
|||
private BusinessException invalidParameter(String detail) { |
|||
return new BusinessException(ErrorCode.SALARY_INVALID_PARAMETER, detail); |
|||
} |
|||
|
|||
private record TaxBracket(BigDecimal upperBound, BigDecimal rate, BigDecimal quickDeduction) { |
|||
} |
|||
} |
|||
@ -0,0 +1,19 @@ |
|||
package com.mydreamjob.salarycalculator; |
|||
|
|||
import lombok.AllArgsConstructor; |
|||
import lombok.Builder; |
|||
import lombok.Data; |
|||
import lombok.NoArgsConstructor; |
|||
|
|||
import java.math.BigDecimal; |
|||
|
|||
@Data |
|||
@Builder |
|||
@NoArgsConstructor |
|||
@AllArgsConstructor |
|||
public class SalaryCalculationInput { |
|||
private BigDecimal grossMonthlySalary; |
|||
private Integer monthIndex; |
|||
private BigDecimal specialAdditionalDeduction; |
|||
private SalaryOverrideParameters overrides; |
|||
} |
|||
@ -0,0 +1,53 @@ |
|||
package com.mydreamjob.salarycalculator; |
|||
|
|||
import lombok.AllArgsConstructor; |
|||
import lombok.Builder; |
|||
import lombok.Data; |
|||
import lombok.NoArgsConstructor; |
|||
|
|||
import java.math.BigDecimal; |
|||
import java.time.LocalDate; |
|||
|
|||
@Data |
|||
@Builder |
|||
@NoArgsConstructor |
|||
@AllArgsConstructor |
|||
public class SalaryCalculationResult { |
|||
|
|||
private String cityCode; |
|||
private String cityName; |
|||
private SalaryDataLevel dataLevel; |
|||
private String policyVersion; |
|||
private LocalDate policyEffectiveDate; |
|||
private String taxRulesVersion; |
|||
private boolean estimate; |
|||
|
|||
private Integer monthIndex; |
|||
private BigDecimal grossMonthlySalary; |
|||
private BigDecimal specialAdditionalDeduction; |
|||
|
|||
private BigDecimal socialSecurityBase; |
|||
private BigDecimal housingFundBase; |
|||
private BigDecimal pensionRate; |
|||
private BigDecimal medicalRate; |
|||
private BigDecimal unemploymentRate; |
|||
private BigDecimal housingFundRate; |
|||
private BigDecimal seriousIllnessMonthlyFee; |
|||
|
|||
private BigDecimal pension; |
|||
private BigDecimal medical; |
|||
private BigDecimal unemployment; |
|||
private BigDecimal housingFund; |
|||
|
|||
private BigDecimal cumulativeGrossIncome; |
|||
private BigDecimal cumulativeSocialInsurance; |
|||
private BigDecimal cumulativeHousingFund; |
|||
private BigDecimal cumulativeSeriousIllness; |
|||
private BigDecimal cumulativeBasicDeduction; |
|||
private BigDecimal cumulativeSpecialAdditionalDeduction; |
|||
private BigDecimal cumulativeTaxableIncome; |
|||
private BigDecimal cumulativeTaxDue; |
|||
private BigDecimal previouslyWithheldTax; |
|||
private BigDecimal currentMonthTax; |
|||
private BigDecimal netSalary; |
|||
} |
|||
@ -0,0 +1,64 @@ |
|||
package com.mydreamjob.salarycalculator; |
|||
|
|||
import com.mydreamjob.common.api.ApiResponse; |
|||
import com.mydreamjob.common.exception.BusinessException; |
|||
import com.mydreamjob.common.exception.ErrorCode; |
|||
import com.mydreamjob.salarycalculator.dto.SalaryCityDetailResponse; |
|||
import com.mydreamjob.salarycalculator.dto.SalaryCitySummaryResponse; |
|||
import io.swagger.v3.oas.annotations.Operation; |
|||
import io.swagger.v3.oas.annotations.tags.Tag; |
|||
import jakarta.servlet.http.HttpServletRequest; |
|||
import lombok.RequiredArgsConstructor; |
|||
import org.springframework.http.ResponseEntity; |
|||
import org.springframework.security.core.Authentication; |
|||
import org.springframework.security.core.context.SecurityContextHolder; |
|||
import org.springframework.web.bind.annotation.GetMapping; |
|||
import org.springframework.web.bind.annotation.PathVariable; |
|||
import org.springframework.web.bind.annotation.RequestMapping; |
|||
import org.springframework.web.bind.annotation.RestController; |
|||
|
|||
import java.util.List; |
|||
|
|||
@Tag(name = "薪资计算器", description = "城市政策、到手工资估算与历史记录") |
|||
@RestController |
|||
@RequestMapping("/salary-calculator") |
|||
@RequiredArgsConstructor |
|||
public class SalaryCityPolicyController { |
|||
|
|||
private final SalaryCityPolicyService cityPolicyService; |
|||
|
|||
@Operation(summary = "查询启用城市列表", description = "仅 STUDENT；返回全部启用城市摘要，不分页") |
|||
@GetMapping("/cities") |
|||
public ResponseEntity<ApiResponse<List<SalaryCitySummaryResponse>>> listCities( |
|||
HttpServletRequest request) { |
|||
Long userId = resolveUserId(); |
|||
return ResponseEntity.ok(ApiResponse.ok( |
|||
cityPolicyService.listCities(userId), getRequestId(request))); |
|||
} |
|||
|
|||
@Operation(summary = "查询城市默认参数", description = "仅 STUDENT；返回城市元数据和当前整套默认参数") |
|||
@GetMapping("/cities/{cityCode}") |
|||
public ResponseEntity<ApiResponse<SalaryCityDetailResponse>> getCity( |
|||
@PathVariable String cityCode, HttpServletRequest request) { |
|||
Long userId = resolveUserId(); |
|||
return ResponseEntity.ok(ApiResponse.ok( |
|||
cityPolicyService.getCity(userId, cityCode), getRequestId(request))); |
|||
} |
|||
|
|||
private Long resolveUserId() { |
|||
Authentication auth = SecurityContextHolder.getContext().getAuthentication(); |
|||
if (auth == null || !auth.isAuthenticated() |
|||
|| "anonymousUser".equals(String.valueOf(auth.getPrincipal()))) { |
|||
throw new BusinessException(ErrorCode.UNAUTHORIZED); |
|||
} |
|||
try { |
|||
return Long.valueOf(auth.getName()); |
|||
} catch (NumberFormatException ex) { |
|||
throw new BusinessException(ErrorCode.UNAUTHORIZED); |
|||
} |
|||
} |
|||
|
|||
private String getRequestId(HttpServletRequest request) { |
|||
return request.getHeader("X-Request-Id"); |
|||
} |
|||
} |
|||
@ -0,0 +1,81 @@ |
|||
package com.mydreamjob.salarycalculator; |
|||
|
|||
import com.mydreamjob.auth.User; |
|||
import com.mydreamjob.auth.UserRepository; |
|||
import com.mydreamjob.common.exception.BusinessException; |
|||
import com.mydreamjob.common.exception.ErrorCode; |
|||
import com.mydreamjob.salarycalculator.dto.SalaryCityDetailResponse; |
|||
import com.mydreamjob.salarycalculator.dto.SalaryCitySummaryResponse; |
|||
import lombok.RequiredArgsConstructor; |
|||
import org.springframework.stereotype.Service; |
|||
import org.springframework.transaction.annotation.Transactional; |
|||
|
|||
import java.util.List; |
|||
|
|||
@Service |
|||
@RequiredArgsConstructor |
|||
public class SalaryCityPolicyService { |
|||
|
|||
private final SalaryCityPolicyRepository cityPolicyRepository; |
|||
private final UserRepository userRepository; |
|||
|
|||
@Transactional(readOnly = true) |
|||
public List<SalaryCitySummaryResponse> listCities(Long userId) { |
|||
requireStudent(userId); |
|||
return cityPolicyRepository.findByEnabledTrueOrderByProvinceCodeAscCityCodeAsc() |
|||
.stream() |
|||
.map(this::toSummary) |
|||
.toList(); |
|||
} |
|||
|
|||
@Transactional(readOnly = true) |
|||
public SalaryCityDetailResponse getCity(Long userId, String cityCode) { |
|||
requireStudent(userId); |
|||
if (cityCode == null || !cityCode.matches("\\d{6}")) { |
|||
throw new BusinessException(ErrorCode.SALARY_CITY_NOT_FOUND); |
|||
} |
|||
SalaryCityPolicy policy = cityPolicyRepository |
|||
.findByCityCodeAndEnabledTrue(cityCode) |
|||
.orElseThrow(() -> new BusinessException(ErrorCode.SALARY_CITY_NOT_FOUND)); |
|||
return SalaryCityDetailResponse.builder() |
|||
.cityCode(policy.getCityCode()) |
|||
.provinceCode(policy.getProvinceCode()) |
|||
.provinceName(policy.getProvinceName()) |
|||
.cityName(policy.getCityName()) |
|||
.policyVersion(policy.getPolicyVersion()) |
|||
.policyEffectiveDate(policy.getPolicyEffectiveDate()) |
|||
.dataLevel(policy.getDataLevel()) |
|||
.dataSource(policy.getDataSource()) |
|||
.socialSecurityBaseMin(policy.getSocialSecurityBaseMin()) |
|||
.socialSecurityBaseMax(policy.getSocialSecurityBaseMax()) |
|||
.housingFundBaseMin(policy.getHousingFundBaseMin()) |
|||
.housingFundBaseMax(policy.getHousingFundBaseMax()) |
|||
.pensionRate(policy.getPensionRate()) |
|||
.medicalRate(policy.getMedicalRate()) |
|||
.unemploymentRate(policy.getUnemploymentRate()) |
|||
.housingFundRate(policy.getHousingFundRate()) |
|||
.seriousIllnessMonthlyFee(policy.getSeriousIllnessMonthlyFee()) |
|||
.build(); |
|||
} |
|||
|
|||
private SalaryCitySummaryResponse toSummary(SalaryCityPolicy policy) { |
|||
return SalaryCitySummaryResponse.builder() |
|||
.cityCode(policy.getCityCode()) |
|||
.provinceCode(policy.getProvinceCode()) |
|||
.provinceName(policy.getProvinceName()) |
|||
.cityName(policy.getCityName()) |
|||
.policyVersion(policy.getPolicyVersion()) |
|||
.policyEffectiveDate(policy.getPolicyEffectiveDate()) |
|||
.dataLevel(policy.getDataLevel()) |
|||
.build(); |
|||
} |
|||
|
|||
private void requireStudent(Long userId) { |
|||
User user = userRepository.findById(userId) |
|||
.orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); |
|||
if (user.getRoles() == null |
|||
|| user.getRoles().stream().noneMatch(role -> role == User.Role.STUDENT)) { |
|||
throw new BusinessException(ErrorCode.FORBIDDEN); |
|||
} |
|||
} |
|||
} |
|||
@ -0,0 +1,22 @@ |
|||
package com.mydreamjob.salarycalculator; |
|||
|
|||
import lombok.AllArgsConstructor; |
|||
import lombok.Builder; |
|||
import lombok.Data; |
|||
import lombok.NoArgsConstructor; |
|||
|
|||
import java.math.BigDecimal; |
|||
|
|||
@Data |
|||
@Builder |
|||
@NoArgsConstructor |
|||
@AllArgsConstructor |
|||
public class SalaryOverrideParameters { |
|||
private BigDecimal socialSecurityBase; |
|||
private BigDecimal housingFundBase; |
|||
private BigDecimal pensionRate; |
|||
private BigDecimal medicalRate; |
|||
private BigDecimal unemploymentRate; |
|||
private BigDecimal housingFundRate; |
|||
private BigDecimal seriousIllnessMonthlyFee; |
|||
} |
|||
@ -0,0 +1,34 @@ |
|||
package com.mydreamjob.salarycalculator.dto; |
|||
|
|||
import com.mydreamjob.salarycalculator.SalaryDataLevel; |
|||
import lombok.AllArgsConstructor; |
|||
import lombok.Builder; |
|||
import lombok.Data; |
|||
import lombok.NoArgsConstructor; |
|||
|
|||
import java.math.BigDecimal; |
|||
import java.time.LocalDate; |
|||
|
|||
@Data |
|||
@Builder |
|||
@NoArgsConstructor |
|||
@AllArgsConstructor |
|||
public class SalaryCityDetailResponse { |
|||
private String cityCode; |
|||
private String provinceCode; |
|||
private String provinceName; |
|||
private String cityName; |
|||
private String policyVersion; |
|||
private LocalDate policyEffectiveDate; |
|||
private SalaryDataLevel dataLevel; |
|||
private String dataSource; |
|||
private BigDecimal socialSecurityBaseMin; |
|||
private BigDecimal socialSecurityBaseMax; |
|||
private BigDecimal housingFundBaseMin; |
|||
private BigDecimal housingFundBaseMax; |
|||
private BigDecimal pensionRate; |
|||
private BigDecimal medicalRate; |
|||
private BigDecimal unemploymentRate; |
|||
private BigDecimal housingFundRate; |
|||
private BigDecimal seriousIllnessMonthlyFee; |
|||
} |
|||
@ -0,0 +1,23 @@ |
|||
package com.mydreamjob.salarycalculator.dto; |
|||
|
|||
import com.mydreamjob.salarycalculator.SalaryDataLevel; |
|||
import lombok.AllArgsConstructor; |
|||
import lombok.Builder; |
|||
import lombok.Data; |
|||
import lombok.NoArgsConstructor; |
|||
|
|||
import java.time.LocalDate; |
|||
|
|||
@Data |
|||
@Builder |
|||
@NoArgsConstructor |
|||
@AllArgsConstructor |
|||
public class SalaryCitySummaryResponse { |
|||
private String cityCode; |
|||
private String provinceCode; |
|||
private String provinceName; |
|||
private String cityName; |
|||
private String policyVersion; |
|||
private LocalDate policyEffectiveDate; |
|||
private SalaryDataLevel dataLevel; |
|||
} |
|||
@ -0,0 +1,150 @@ |
|||
package com.mydreamjob.salarycalculator; |
|||
|
|||
import com.mydreamjob.common.exception.BusinessException; |
|||
import com.mydreamjob.common.exception.ErrorCode; |
|||
import org.junit.jupiter.api.Test; |
|||
|
|||
import java.math.BigDecimal; |
|||
import java.time.LocalDate; |
|||
|
|||
import static org.assertj.core.api.Assertions.assertThat; |
|||
import static org.assertj.core.api.Assertions.assertThatThrownBy; |
|||
|
|||
class SalaryCalculationEngineTest { |
|||
|
|||
private final SalaryCalculationEngine engine = new SalaryCalculationEngine(); |
|||
|
|||
@Test |
|||
void calculatesBaseCaseWithCumulativeWithholding() { |
|||
SalaryCalculationResult result = engine.calculate(input("10000", 1, "0", null), policy()); |
|||
|
|||
assertThat(result.getSocialSecurityBase()).isEqualByComparingTo("10000.00"); |
|||
assertThat(result.getHousingFundBase()).isEqualByComparingTo("10000.00"); |
|||
assertThat(result.getPension()).isEqualByComparingTo("800.00"); |
|||
assertThat(result.getMedical()).isEqualByComparingTo("200.00"); |
|||
assertThat(result.getUnemployment()).isEqualByComparingTo("50.00"); |
|||
assertThat(result.getHousingFund()).isEqualByComparingTo("1200.00"); |
|||
assertThat(result.getCurrentMonthTax()).isEqualByComparingTo("82.50"); |
|||
assertThat(result.getNetSalary()).isEqualByComparingTo("7667.50"); |
|||
assertThat(result.isEstimate()).isTrue(); |
|||
assertThat(result.getDataLevel()).isEqualTo(SalaryDataLevel.CITY); |
|||
} |
|||
|
|||
@Test |
|||
void clampsBothBasesToFloorAndCeiling() { |
|||
SalaryCalculationResult low = engine.calculate(input("3000", 1, "0", null), policy()); |
|||
SalaryCalculationResult high = engine.calculate(input("30000", 1, "0", null), policy()); |
|||
|
|||
assertThat(low.getSocialSecurityBase()).isEqualByComparingTo("5000.00"); |
|||
assertThat(low.getHousingFundBase()).isEqualByComparingTo("5000.00"); |
|||
assertThat(low.getCurrentMonthTax()).isEqualByComparingTo("0.00"); |
|||
assertThat(low.getNetSalary()).isEqualByComparingTo("1875.00"); |
|||
|
|||
assertThat(high.getSocialSecurityBase()).isEqualByComparingTo("20000.00"); |
|||
assertThat(high.getHousingFundBase()).isEqualByComparingTo("20000.00"); |
|||
assertThat(high.getCurrentMonthTax()).isEqualByComparingTo("615.00"); |
|||
assertThat(high.getNetSalary()).isEqualByComparingTo("24885.00"); |
|||
} |
|||
|
|||
@Test |
|||
void usesPriorCumulativeTaxForTwelfthMonth() { |
|||
SalaryCalculationResult result = engine.calculate(input("20000", 12, "0", null), policy()); |
|||
|
|||
assertThat(result.getCumulativeTaxableIncome()).isEqualByComparingTo("126000.00"); |
|||
assertThat(result.getCumulativeTaxDue()).isEqualByComparingTo("10080.00"); |
|||
assertThat(result.getPreviouslyWithheldTax()).isEqualByComparingTo("9030.00"); |
|||
assertThat(result.getCurrentMonthTax()).isEqualByComparingTo("1050.00"); |
|||
assertThat(result.getNetSalary()).isEqualByComparingTo("14450.00"); |
|||
} |
|||
|
|||
@Test |
|||
void appliesSpecialDeductionAndOverrides() { |
|||
SalaryOverrideParameters overrides = SalaryOverrideParameters.builder() |
|||
.socialSecurityBase(new BigDecimal("8000.00")) |
|||
.housingFundBase(new BigDecimal("10000.00")) |
|||
.pensionRate(new BigDecimal("0.08")) |
|||
.medicalRate(new BigDecimal("0.02")) |
|||
.unemploymentRate(new BigDecimal("0.005")) |
|||
.housingFundRate(new BigDecimal("0.12")) |
|||
.seriousIllnessMonthlyFee(BigDecimal.ZERO) |
|||
.build(); |
|||
|
|||
SalaryCalculationResult result = engine.calculate( |
|||
input("10000", 1, "2000", overrides), policy()); |
|||
|
|||
assertThat(result.getSocialSecurityBase()).isEqualByComparingTo("8000.00"); |
|||
assertThat(result.getPension()).isEqualByComparingTo("640.00"); |
|||
assertThat(result.getCurrentMonthTax()).isEqualByComparingTo("28.80"); |
|||
assertThat(result.getNetSalary()).isEqualByComparingTo("7931.20"); |
|||
} |
|||
|
|||
@Test |
|||
void rejectsOverrideOutsideCityBaseRange() { |
|||
SalaryOverrideParameters overrides = SalaryOverrideParameters.builder() |
|||
.socialSecurityBase(new BigDecimal("4999.99")) |
|||
.build(); |
|||
|
|||
assertThatThrownBy(() -> engine.calculate(input("10000", 1, "0", overrides), policy())) |
|||
.isInstanceOf(BusinessException.class) |
|||
.extracting(ex -> ((BusinessException) ex).getErrorCodeInt()) |
|||
.isEqualTo(ErrorCode.SALARY_INVALID_PARAMETER.getCode()); |
|||
} |
|||
|
|||
@Test |
|||
void zeroContributionRateAllowsZeroBase() { |
|||
SalaryOverrideParameters overrides = SalaryOverrideParameters.builder() |
|||
.socialSecurityBase(BigDecimal.ZERO) |
|||
.housingFundBase(BigDecimal.ZERO) |
|||
.pensionRate(BigDecimal.ZERO) |
|||
.medicalRate(BigDecimal.ZERO) |
|||
.unemploymentRate(BigDecimal.ZERO) |
|||
.housingFundRate(BigDecimal.ZERO) |
|||
.seriousIllnessMonthlyFee(BigDecimal.ZERO) |
|||
.build(); |
|||
|
|||
SalaryCalculationResult result = engine.calculate( |
|||
input("10000", 1, "0", overrides), policy()); |
|||
|
|||
assertThat(result.getPension()).isEqualByComparingTo("0.00"); |
|||
assertThat(result.getMedical()).isEqualByComparingTo("0.00"); |
|||
assertThat(result.getUnemployment()).isEqualByComparingTo("0.00"); |
|||
assertThat(result.getHousingFund()).isEqualByComparingTo("0.00"); |
|||
assertThat(result.getCurrentMonthTax()).isEqualByComparingTo("150.00"); |
|||
assertThat(result.getNetSalary()).isEqualByComparingTo("9850.00"); |
|||
} |
|||
|
|||
private SalaryCalculationInput input( |
|||
String gross, int monthIndex, String specialDeduction, |
|||
SalaryOverrideParameters overrides) { |
|||
return SalaryCalculationInput.builder() |
|||
.grossMonthlySalary(new BigDecimal(gross)) |
|||
.monthIndex(monthIndex) |
|||
.specialAdditionalDeduction(new BigDecimal(specialDeduction)) |
|||
.overrides(overrides) |
|||
.build(); |
|||
} |
|||
|
|||
private SalaryCityPolicy policy() { |
|||
return SalaryCityPolicy.builder() |
|||
.cityCode("110000") |
|||
.provinceCode("110000") |
|||
.provinceName("北京市") |
|||
.cityName("北京市") |
|||
.policyVersion("2026-09-20-v1") |
|||
.policyEffectiveDate(LocalDate.of(2026, 7, 1)) |
|||
.socialSecurityBaseMin(new BigDecimal("5000.00")) |
|||
.socialSecurityBaseMax(new BigDecimal("20000.00")) |
|||
.housingFundBaseMin(new BigDecimal("5000.00")) |
|||
.housingFundBaseMax(new BigDecimal("20000.00")) |
|||
.pensionRate(new BigDecimal("0.080000")) |
|||
.medicalRate(new BigDecimal("0.020000")) |
|||
.unemploymentRate(new BigDecimal("0.005000")) |
|||
.housingFundRate(new BigDecimal("0.120000")) |
|||
.seriousIllnessMonthlyFee(BigDecimal.ZERO) |
|||
.dataLevel(SalaryDataLevel.CITY) |
|||
.enabled(true) |
|||
.build(); |
|||
} |
|||
} |
|||
|
|||
|
|||
@ -0,0 +1,107 @@ |
|||
package com.mydreamjob.salarycalculator; |
|||
|
|||
import com.mydreamjob.auth.JwtTokenProvider; |
|||
import com.mydreamjob.auth.User; |
|||
import com.mydreamjob.auth.UserRepository; |
|||
import org.junit.jupiter.api.Test; |
|||
import org.springframework.beans.factory.annotation.Autowired; |
|||
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc; |
|||
import org.springframework.boot.test.context.SpringBootTest; |
|||
import org.springframework.boot.test.mock.mockito.MockBean; |
|||
import org.springframework.data.redis.core.RedisTemplate; |
|||
import org.springframework.test.context.ActiveProfiles; |
|||
import org.springframework.test.web.servlet.MockMvc; |
|||
|
|||
import java.util.Map; |
|||
import java.util.Set; |
|||
import java.util.concurrent.atomic.AtomicLong; |
|||
|
|||
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; |
|||
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath; |
|||
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; |
|||
|
|||
@SpringBootTest |
|||
@AutoConfigureMockMvc |
|||
@ActiveProfiles("integration-test") |
|||
class SalaryCityPolicyControllerTest { |
|||
|
|||
private static final AtomicLong PHONE = new AtomicLong(950_000_000L); |
|||
|
|||
@Autowired private MockMvc mockMvc; |
|||
@Autowired private JwtTokenProvider jwtTokenProvider; |
|||
@Autowired private UserRepository userRepository; |
|||
|
|||
@MockBean private RedisTemplate<String, Object> redisTemplate; |
|||
|
|||
@Test |
|||
void cities_returnsAllSeededCitiesForStudent() throws Exception { |
|||
long uid = createUser(User.Role.STUDENT); |
|||
|
|||
mockMvc.perform(get("/salary-calculator/cities") |
|||
.header("Authorization", token(uid))) |
|||
.andExpect(status().isOk()) |
|||
.andExpect(jsonPath("$.code").value(200)) |
|||
.andExpect(jsonPath("$.data.length()").value(359)) |
|||
.andExpect(jsonPath("$.data[0].cityCode").value("110000")) |
|||
.andExpect(jsonPath("$.data[0].dataLevel").value("CITY")); |
|||
} |
|||
|
|||
@Test |
|||
void cityDetail_returnsDefaultsAndFallbackLevel() throws Exception { |
|||
long uid = createUser(User.Role.STUDENT); |
|||
|
|||
mockMvc.perform(get("/salary-calculator/cities/110000") |
|||
.header("Authorization", token(uid))) |
|||
.andExpect(status().isOk()) |
|||
.andExpect(jsonPath("$.data.cityCode").value("110000")) |
|||
.andExpect(jsonPath("$.data.dataLevel").value("CITY")) |
|||
.andExpect(jsonPath("$.data.socialSecurityBaseMin").value(7270.00)) |
|||
.andExpect(jsonPath("$.data.housingFundRate").value(0.120000)); |
|||
|
|||
mockMvc.perform(get("/salary-calculator/cities/130100") |
|||
.header("Authorization", token(uid))) |
|||
.andExpect(status().isOk()) |
|||
.andExpect(jsonPath("$.data.dataLevel").value("PROVINCE_FALLBACK")); |
|||
} |
|||
|
|||
@Test |
|||
void missingCity_returns404And9801() throws Exception { |
|||
long uid = createUser(User.Role.STUDENT); |
|||
|
|||
mockMvc.perform(get("/salary-calculator/cities/999999") |
|||
.header("Authorization", token(uid))) |
|||
.andExpect(status().isNotFound()) |
|||
.andExpect(jsonPath("$.code").value(9801)); |
|||
} |
|||
|
|||
@Test |
|||
void companyUser_returns403() throws Exception { |
|||
long uid = createUser(User.Role.COMPANY); |
|||
|
|||
mockMvc.perform(get("/salary-calculator/cities") |
|||
.header("Authorization", token(uid))) |
|||
.andExpect(status().isForbidden()) |
|||
.andExpect(jsonPath("$.code").value(2002)); |
|||
} |
|||
|
|||
@Test |
|||
void anonymous_returns401() throws Exception { |
|||
mockMvc.perform(get("/salary-calculator/cities")) |
|||
.andExpect(status().isUnauthorized()); |
|||
} |
|||
|
|||
private long createUser(User.Role role) { |
|||
User user = userRepository.save(User.builder() |
|||
.phone(String.valueOf(PHONE.getAndIncrement())) |
|||
.roles(Set.of(role)) |
|||
.role(role) |
|||
.active(true) |
|||
.build()); |
|||
return user.getId(); |
|||
} |
|||
|
|||
private String token(long userId) { |
|||
return "Bearer " + jwtTokenProvider.generateAccessToken( |
|||
userId, String.valueOf(PHONE.getAndIncrement()), Map.of("roles", "STUDENT")); |
|||
} |
|||
} |
|||
@ -0,0 +1,106 @@ |
|||
package com.mydreamjob.salarycalculator; |
|||
|
|||
import com.mydreamjob.auth.User; |
|||
import com.mydreamjob.auth.UserRepository; |
|||
import com.mydreamjob.common.exception.BusinessException; |
|||
import com.mydreamjob.common.exception.ErrorCode; |
|||
import com.mydreamjob.salarycalculator.dto.SalaryCityDetailResponse; |
|||
import com.mydreamjob.salarycalculator.dto.SalaryCitySummaryResponse; |
|||
import org.junit.jupiter.api.Test; |
|||
import org.junit.jupiter.api.extension.ExtendWith; |
|||
import org.mockito.InjectMocks; |
|||
import org.mockito.Mock; |
|||
import org.mockito.junit.jupiter.MockitoExtension; |
|||
|
|||
import java.math.BigDecimal; |
|||
import java.time.LocalDate; |
|||
import java.util.List; |
|||
import java.util.Optional; |
|||
import java.util.Set; |
|||
|
|||
import static org.assertj.core.api.Assertions.assertThat; |
|||
import static org.assertj.core.api.Assertions.assertThatThrownBy; |
|||
import static org.mockito.Mockito.when; |
|||
|
|||
@ExtendWith(MockitoExtension.class) |
|||
class SalaryCityPolicyServiceTest { |
|||
|
|||
@Mock private SalaryCityPolicyRepository cityRepository; |
|||
@Mock private UserRepository userRepository; |
|||
@InjectMocks private SalaryCityPolicyService service; |
|||
|
|||
@Test |
|||
void listCities_returnsStableEnabledSummariesForStudent() { |
|||
when(userRepository.findById(10L)).thenReturn(Optional.of(user(10L, User.Role.STUDENT))); |
|||
when(cityRepository.findByEnabledTrueOrderByProvinceCodeAscCityCodeAsc()) |
|||
.thenReturn(List.of(policy("110000", "北京市", SalaryDataLevel.CITY), |
|||
policy("130100", "石家庄市", SalaryDataLevel.PROVINCE_FALLBACK))); |
|||
|
|||
List<SalaryCitySummaryResponse> result = service.listCities(10L); |
|||
|
|||
assertThat(result).extracting(SalaryCitySummaryResponse::getCityCode) |
|||
.containsExactly("110000", "130100"); |
|||
assertThat(result).extracting(SalaryCitySummaryResponse::getDataLevel) |
|||
.containsExactly(SalaryDataLevel.CITY, SalaryDataLevel.PROVINCE_FALLBACK); |
|||
} |
|||
|
|||
@Test |
|||
void getCity_returnsDefaultsAndDataLevel() { |
|||
when(userRepository.findById(10L)).thenReturn(Optional.of(user(10L, User.Role.STUDENT))); |
|||
when(cityRepository.findByCityCodeAndEnabledTrue("110000")) |
|||
.thenReturn(Optional.of(policy("110000", "北京市", SalaryDataLevel.CITY))); |
|||
|
|||
SalaryCityDetailResponse result = service.getCity(10L, "110000"); |
|||
|
|||
assertThat(result.getCityCode()).isEqualTo("110000"); |
|||
assertThat(result.getDataLevel()).isEqualTo(SalaryDataLevel.CITY); |
|||
assertThat(result.getSocialSecurityBaseMin()).isEqualByComparingTo("5000.00"); |
|||
} |
|||
|
|||
@Test |
|||
void nonStudent_isForbidden() { |
|||
when(userRepository.findById(10L)).thenReturn(Optional.of(user(10L, User.Role.COMPANY))); |
|||
|
|||
assertThatThrownBy(() -> service.listCities(10L)) |
|||
.isInstanceOf(BusinessException.class) |
|||
.extracting(ex -> ((BusinessException) ex).getErrorCodeInt()) |
|||
.isEqualTo(ErrorCode.FORBIDDEN.getCode()); |
|||
} |
|||
|
|||
@Test |
|||
void missingOrDisabledCity_returns9801() { |
|||
when(userRepository.findById(10L)).thenReturn(Optional.of(user(10L, User.Role.STUDENT))); |
|||
when(cityRepository.findByCityCodeAndEnabledTrue("999999")).thenReturn(Optional.empty()); |
|||
|
|||
assertThatThrownBy(() -> service.getCity(10L, "999999")) |
|||
.isInstanceOf(BusinessException.class) |
|||
.extracting(ex -> ((BusinessException) ex).getErrorCodeInt()) |
|||
.isEqualTo(ErrorCode.SALARY_CITY_NOT_FOUND.getCode()); |
|||
} |
|||
|
|||
private User user(Long id, User.Role role) { |
|||
return User.builder().id(id).roles(Set.of(role)).role(role).build(); |
|||
} |
|||
|
|||
private SalaryCityPolicy policy(String code, String name, SalaryDataLevel level) { |
|||
return SalaryCityPolicy.builder() |
|||
.cityCode(code) |
|||
.provinceCode("110000") |
|||
.provinceName("测试省") |
|||
.cityName(name) |
|||
.policyVersion("2026-09-20-v1") |
|||
.policyEffectiveDate(LocalDate.of(2026, 7, 1)) |
|||
.socialSecurityBaseMin(new BigDecimal("5000.00")) |
|||
.socialSecurityBaseMax(new BigDecimal("25000.00")) |
|||
.housingFundBaseMin(new BigDecimal("2000.00")) |
|||
.housingFundBaseMax(new BigDecimal("30000.00")) |
|||
.pensionRate(new BigDecimal("0.080000")) |
|||
.medicalRate(new BigDecimal("0.020000")) |
|||
.unemploymentRate(new BigDecimal("0.005000")) |
|||
.housingFundRate(new BigDecimal("0.120000")) |
|||
.seriousIllnessMonthlyFee(BigDecimal.ZERO) |
|||
.dataLevel(level) |
|||
.enabled(true) |
|||
.build(); |
|||
} |
|||
} |
|||
Loading…
Reference in new issue